Verwenden einer XML-Zuordnung als Teil einer Dokumentgenerierungslösung in Word 2010 (maschinell übersetzt)

Zusammenfassung:  Sie erhalten Informationen zur Verwendung der Inhaltssteuerelemente und XML-Zuordnung als Teil des Dokumentgenerierungsszenarios. Bei diesem Artikel handelt es sich um eine überarbeitete Version eines Artikels mit einem Video zur Vorgehensweise: Zuordnen von Word 2007-Inhaltsstuerelementen zu benutzerdefiniertem XML mithilfe des XMLMapping-Objekts.

Letzte Änderung: Montag, 11. April 2011

Gilt für: Office 2007 | Office 2010 | Open XML | Visual Studio Tools for Microsoft Office | Word 2007 | Word 2010

Inhalt dieses Artikels
Verstehen, Inhaltssteuerelemente und XML-Zuordnung
Document Generation-Szenario
Zuordnen von XML-Knoten, um Content-Steuerelemente
Schlussbemerkung
Weitere Ressourcen

Veröffentlicht:  Februar 2011

Zur Verfügung gestellt von: Microsoft Corporation

Inhalt

• Verstehen, Inhaltssteuerelemente und XML-Zuordnung

• Document Generation-Szenario

• Zuordnen von XML-Knoten, um Content-Steuerelemente

• Schlussbemerkung

• Weitere Ressourcen

Verstehen, Inhaltssteuerelemente und XML-Zuordnung

verbessern die Arbeitsweise Dokumente mit benutzerdefinierten XML-Code, wodurch eine einfache Zuordnung von externen Daten für Inhaltssteuerelemente, Office Word 2007 und Word 2010. Sie können Inhaltssteuerelemente mit einer Fülle von Informationen mithilfe von XML-Zuordnung zuordnen benutzerdefinierte XML-Daten laden.

Inhaltssteuerelemente sind vordefinierte Inhalte. Es gibt mehrere Arten von Inhaltssteuerelementen. Dazu gehören Textblöcke, Dropdownmenüs, Kombinationsfelder, Kalender-Steuerelemente, Kontrollkästchen und Bilder. Sie können diese Inhaltssteuerelemente auf ein Element in einer XML-Datei zuordnen. Mithilfe von XPath-Ausdrücken können Sie Inhalte in einer XML-Datei programmgesteuert einem Inhaltssteuerelement zuordnen. Auf diese Weise können Sie eine einfache und kurze Anwendung zum Bearbeiten und Ändern von Daten in einem Dokument zu schreiben.

XML-Zuordnung ist eine Eigenschaft für ein Inhaltssteuerelement, verknüpft oder bindet den Inhalt des Inhaltssteuerelements an ein XML-Element in einem Datenspeicher, der mit dem Dokument gespeichert ist. In der Open XML-Formate sind Teile eines Office-Dokuments in eine komprimierte XML-Dokument enthaltenen XML-Dateien enthalten. In der komprimierten Dokument in ihre eigenen spezifischen Verzeichnissen befinden sich XML-Dateien mit Daten, die Inhaltssteuerelemente zugeordnet.

Mithilfe von XML-Zuordnung ist XML-Daten aus der Präsentation des Dokuments getrennt, so dass es einfacher, die sowohl Daten als auch die Formatierung programmgesteuert zu ändern ist. Diese Trennung von Daten aus der Formatierung können Sie stabilere Dokumente als Sie mit früheren Versionen von Word könnten zu erstellen. Wenn die XML-Daten beschädigt ist, wird das Dokument selbst geändert.

Document Generation-Szenario

Dokumente sind in einem Document Generation-Lösung programmgesteuert generiert und mit Geschäftsdaten gefüllt. Ein Ansatz, mit denen Sie implementieren eine Document Generation-Lösung umfasst die Verwendung Inhaltssteuerelemente und XML-Zuordnung an benutzerdefinierte XML.

Bei diesem Ansatz wird mein Dokument erstellt, das als ein Vorlage für die Generierung von Dokumenten dient. Inhaltssteuerelemente im Dokument Vorlage sind an benutzerdefinierte XML-Zeichenfolge gebunden. Neue Dokumente werden dann programmgesteuert als Kopien des Dokuments Vorlage generiert. Die Inhaltssteuerelemente in neuen Dokumenten halten Sie die XML-Zuordnung in das Vorlage-Dokument erstellt. Jedes neue Dokument wird ein eindeutiger benutzerdefinierter XML-Teil-Datenspeicher hinzugefügt. Wenn das neue Dokument geöffnet wird, werden die Platzhalter-Inhaltssteuerelemente im Dokument mit Geschäftsdaten aus dem angehängten benutzerdefinierten XML-Teil gefüllt.

Zuordnen von XML-Knoten, um Content-Steuerelemente

In dieser exemplarischen Vorgehensweise veranschaulicht, wie Inhaltssteuerelemente an Elemente in einem benutzerdefinierten XML-Komponente binden, die an ein Dokument angefügt ist, mithilfe des XMLMapping -Objekts. Dazu müssen Sie die folgenden Schritte durchführen:

• Erstellen das Vorlagendokument

• Erstellen die benutzerdefinierte XML-Datei

• Zuordnen von Inhaltssteuerelementen zu Knoten in der benutzerdefinierten XML-Datei

Erstellen das Vorlagendokument

Das Vorlage-Dokument, das Sie in dieser exemplarischen Vorgehensweise erstellen enthält vier Inhaltssteuerelemente, die Informationen zu einem Kundenkontakt anzeigen.

Inhaltssteuerelemente hinzufügen, indem mithilfe der Registerkarte "Entwicklertools" auf der Office Fluent-Multifunktionsleiste

1. Starten Sie Microsoft Word 2010.

2. Entwickler in der Multifunktionsleiste anzeigen.

   Hinweis

   Um Entwickler in der Multifunktionsleiste anzeigen möchten, klicken Sie auf Datei, klicken Sie auf Optionen, und klicken Sie dann auf der Menüband anpassen. Überprüfen Sie unter Menüband anpassenHauptregisterkarten in der Dropdown-Liste ausgewählt ist. Wählen Sie Entwicklerunter Hauptregisterkartenund klicken Sie dann auf OK.

3. Öffnen Sie in Word 2010 ein neues Dokument.

4. Fügen Sie mithilfe der Registerkarte Entwickler und Titel vier nur-Text-Inhalt die Steuerelemente, um die Oberfläche des Dokuments in der folgenden Reihenfolge:

   1. CompanyName

   2. Kontaktname

   3. ContactTitle

   4. Rufnummer

5. Speichern Sie das Dokument als c:\CustomerLetter.docx.

Erstellen die benutzerdefinierte XML-Datei

Mit dem Vorlage-Dokument erstellt haben erstellen Sie die benutzerdefinierte XML-Datei, die die XML-Daten enthält, die Sie in die Inhaltssteuerelemente im Dokument Vorlage binden.

So erstellen Sie die benutzerdefinierte XML-Datei

1. Öffnen Sie eine neue Textdatei für die Bearbeitung.

2. Kopieren Sie Folgendes in die Textdatei und speichern Sie es c:\CustomerData.Xml.

   <?xml version="1.0"?>
   <Customer> 
      <CompanyName>Adventure Works</CompanyName> 
      <ContactName>Terry Adams</ContactName>
      <ContactTitle>Sales Representative</ContactTitle>
      <Phone>030-0074321</Phone>
   </Customer>
   

Um Inhaltssteuerelemente benutzerdefinierte XML mithilfe der XML-Zuordnung Word-Funktion zuordnen, muss eine benutzerdefinierte XML-Komponente zum Dokument hinzugefügt werden, und die XML-Datei muss in der benutzerdefinierten XML-Komponente geladen werden.

Zuordnen von Inhaltssteuerelementen zu Knoten in der benutzerdefinierten XML-Datei

Um ein Inhaltssteuerelement an einen Knoten in einem benutzerdefinierten XML-Datei binden, muss die benutzerdefinierte XML-Datei des Dokuments Word beizufügen. Durch Hinzufügen eines benutzerdefinierten XML-Teil-Datenspeichers des Dokuments und laden dann die benutzerdefinierte XML-Datei in den benutzerdefinierten XML-Komponente fügen Sie benutzerdefinierte XML-Dateien zu einem Dokument Word.

Um eine neue benutzerdefinierte XML-Komponente hinzuzufügen, verwenden Sie die CustomXMLParts.Add -Methode der CustomXMLParts -Auflistung. Dies fügt eine neue, leere benutzerdefinierte XML-Komponente im Dokument. Da er leer ist, können nicht Sie noch verwenden. Als Nächstes laden Sie XML aus einer XML-Datei in den benutzerdefinierten XML-Komponente durch Aufrufen der CustomXMLPart.Load -Methode des CustomXMLPart-Objekts, das einen Pfad einer XML-Datei als Parameter verwendet. Die folgenden Schritte zeigen, wie ein Inhaltssteuerelement an einen Knoten im Datenspeicher des Dokuments gebunden.

Das Dokument eine benutzerdefinierte XML-Komponente hinzu

Öffnen Sie den Microsoft Visual Basic-Editor, und führen Sie den folgenden VBA-Code die Vorlage-Dokument einen Datenspeicher hinzu.

    ' Add a new, empty custom XML part to the document.
    ActiveDocument.CustomXMLParts.Add 
    ' Load XML from CustomerData.xml file.
    ActiveDocument.CustomXMLParts(4).Load ("c:\CustomerData.xml")

Als Nächstes legen Sie XML-Zuordnung für ein Inhaltssteuerelement, das auf einem Knoten in der hinzugefügten benutzerdefinierten XML-Teil-Datenspeicher verweist. Um eine XML-Zuordnung zu erstellen, verwenden Sie einen XPath-Ausdruck auf den Knoten in der benutzerdefinierten XML-Komponente, die um ein Inhaltssteuerelement zugeordnet werden soll. Nachdem Sie eine benutzerdefinierte XML-Komponente hinzufügen, und laden eine gültige XML-Datei hinein, können Sie einen der Knoten einem Inhaltssteuerelement zuordnen.

Hierzu übergeben Sie eine Zeichenfolge, die einen gültigen XPath-Ausdruck ein ContentControl -Objekt mithilfe der SetMapping -Methode des Objekts XMLMapping (mithilfe der XMLMapping-Eigenschaft des Objekts ContentControl) enthält.

Einen Knoten in der benutzerdefinierten XML-Komponente ein Inhaltssteuerelement zugeordnet

Fügen Sie im Editor für Visual Basic nach dem Code, der in der letzten Prozedur eingegeben den folgenden VBA-Code um Inhaltssteuerelemente an Elemente in den Datenspeicher zu binden.

    Dim strXPath1 As String
    strXPath1 = "/Customer/CompanyName" 
    ActiveDocument.ContentControls(1).XMLMapping.SetMapping strXPath1
    
    Dim strXPath2 As String
    strXPath2 = "/Customer/ContactName" 
    ActiveDocument.ContentControls(2).XMLMapping.SetMapping strXPath2
    
    Dim strXPath3 As String
    strXPath3 = "/Customer/ContactTitle" 
    ActiveDocument.ContentControls(3).XMLMapping.SetMapping strXPath3
    
    Dim strXPath4 As String
    strXPath4 = "/Customer/Phone" 
    ActiveDocument.ContentControls(4).XMLMapping.SetMapping strXPath4

Dieser Code erstellt die Zuordnung erforderlich, um eine benutzerdefinierte XML-Datei für Inhaltssteuerelemente in einem Word verbinden 2007 oder Word 2010-Dokument. Wenn das Dokument geöffnet wird, werden die gebundenen Steuerelemente mit Daten aus der zugeordneten benutzerdefinierten XML-Komponente gefüllt.

Schlussbemerkung

Der Microsoft Office-System 2007 und Office 2010 ordnen jede XML-Zuordnung mit eindeutigen XML innerhalb der XML-Datenspeicher des Dokuments. Speichern der Daten in einem Word 2007 oder in der CustomXMLParts-Eigenschaft des Objekts DocumentWord 2010 Document-Objektmodell enthalten ist. Die CustomXMLParts-Eigenschaft gibt eine CustomXMLParts-Auflistung, die CustomXMLParts-Objekte enthält. Sie verweist auf alle benutzerdefinierten XML-Komponenten, die in einem Dokument gespeichert sind. Ein CustomXMLParts-Objekt repräsentiert eine einzelne benutzerdefinierte XML-Komponente im Datenspeicher.

Sie können programmgesteuert Inhaltssteuerelemente an Elemente in einem benutzerdefinierten XML-Komponente mithilfe des XMLMapping-Objekts an ein Dokument angefügt zuordnen. Sie können auch die Inhaltssteuerelemente an Elemente in einem benutzerdefinierten XML-Komponente mithilfe der Office-Open XML-Formate zuordnen. Das Word XML-Format mit zwei Ansätze können bearbeitet werden:

• Programmgesteuert mithilfe der Open XML SDK 2.0 für Microsoft Office SDK [System.IO.Packaging] Klasse Dokumentpaket bearbeiten und Erstellen von benutzerdefinierten XML-Komponenten und die entsprechenden Beziehungen.

• Manuell aktualisieren von Beziehungen und die benutzerdefinierten XML-Komponenten zu einem Dokumentpaket hinzufügen.

Weitere Ressourcen

• Word-Developer-Ressourcen-Center

• Ressourcencenter für Content-Steuerelemente

• Verwenden markierter Inhaltssteuerelemente zum Lösen von Szenarios mit strukturierten Dokumenten in Word 2010