Vorgehensweise: Hinzufügen von Feldern zu einem Word-Berichtlayout
Ein Berichtsdataset kann aus Feldern bestehen, die Bezeichnungen, Daten und Bilder anzeigen. In diesem Thema wird das Verfahren zum Hinzufügen von Feldern aus einem Berichtsdatasets in ein bestehendes Word-Berichtslayout für einen Bericht beschrieben. Fügen Sie Felder hinzu, indem Sie benutzerdefinierte XML-Abschnitt in Words für den Bericht verwenden und Inhaltssteuerelemente hinzufügen, die den Feldern des Berichtsdatasets zugeordnet sind. Beim Hinzufügen von Feldern ist es erforderlich, dass Sie einiges Wissen über das Dataset des Berichts haben, damit Sie die Felder identifizieren können, die Sie dem Layout hinzufügen möchten.
Hinweis
Sie können keine integrierten Berichtslayouts in ändern.
Um den benutzerdefinierten XML-Abschnitt für den Bericht in Word zu öffnen
Wenn nicht bereits offen, öffnen Sie den Word-Berichtlayoutbeleg in Word.
Weitere Informationen finden Sie unter Vorgehensweise: Erstellen und bearbeiten eines benutzerdefinierten Berichts- oder Dokumentenlayout.
Zeigen Sie die Registerkarte Entwickler im Menüband von Microsoft Word an.
Standardmäßig wird die Registerkarte Entwickler nicht im Menüband angezeigt. Weitere Informationen finden Sie unter Vorgehensweise: Anzeigen der Entwickler-Registerkarte auf dem Menüband.
Wählen Sie auf der Registerkarte Entwickler die Option XML-Zuordnungs-Bereich aus.
Im Bereich XML-Zuordnung in der Dropdownliste Benutzerdefinierter XML-Abschnitt wählen Sie den benutzerdefinierten XML-Abschnitt für ADD INCLUDE-Bericht, normalerweise der letzte in der Liste. Der Name des benutzerdefinierten XML-Abschnitts hat folgendes Format:
urn:microsoft-dynamics-nav/reports/report_name/ID
reportnameentspricht dem Namen, der dem Berichtsobjekt in zugeordnet ist.
ID ist die Kennnummer des Berichts.
Nachdem Sie den benutzerdefinierten XML-Abschnitt auswählen, zeigt der XML-Zuordnungsbereich die Beschriftungen und die Feldsteuerelemente an, die für den Bericht verfügbar sind.
Um eine Beschriftung oder ein Datenfeld hinzufügen
Setzen Sie den Cursor in dem Beleg an der Stelle ab, an dem Sie das Steuerelement hinzufügen möchten.
Klicken Sie im XML-Zuordnung-Bereich auf das Steuerelement, das Sie hinzufügen möchten, und klicken Sie dann mit der rechten Maustaste auf Inhaltssteuerelement einfügen und dann auf Reiner Text.
Hinweis
Sie können kein Feld hinzufügen, indem Sie manuell den Datasetfeldnamen in das Inhaltssteuerelement eingeben. Sie müssen den XML-Zuordnung-Bereich verwenden, um die Felder zuzuordnen.
Um wiederholente Zeilen aus Datenfeldern hinzufügen, um eine Liste zu erstellen
Fügen Sie in einer Tabelle eine Tabellenzeile hinzu, die eine Spalte für jedes Feld umfasst, das wiederholt werden soll.
Diese Zeile fungiert als als Platzhalter für wiederkehrenden Felder.
Wählen Sie die gesamte Zeile aus.
Klicken Sie im XML-Zuordnung-Bereich mit der rechten Maustaste auf das Steuerelement, das dem Berichtsdatenelement entspricht, das die Felder enthält, die wiederholt werden sollen, und wählen Sie dann Inhaltssteuerelement einfügen und Wiederholt.
Fügen Sie die wiederkehrenden Felder der Zeile hinzu, wie folgt:
Setzen Sie den Mauszeiger in einer Spalte ab.
Klicken Sie im XML-Zuordnung-Bereich auf das Steuerelement, das Sie hinzufügen möchten, und klicken Sie dann mit der rechten Maustaste auf Inhaltssteuerelement einfügen und dann auf Reiner Text.
Wiederholen Sie die Schritte a und b für jedes Feld.
Hinzufügen von Bild-Feldern
Ein Berichtsdataset kann einen Feld enthalten, das ein Bild enthält, beispielsweise ein Firmenlogo oder ein Bild eines Artikels. Um ein Bild aus dem Berichtsdataset hinzuzufügen, fügen Sie ein Bild-Inhaltssteuerelement ein.
Bilder werden im linken oberen Teil des Inhaltssteuerelements ausgerichtet und ändern automatisch Ihre Größe proportional entsprechend den Grenze des Inhaltssteuerelements.
Wichtig
Außerdem können Sie Bilder nur hinzufügen, die in einem Format vorliegen, das von Word unterstützt wird, wie .bmp, .jpeg und PNG-Datei-Typen. Wenn Sie ein Bild hinzufügen, das ein Format hat, das nicht von Word unterstützt wird, erhalten Sie einen Fehler, wenn Sie den Bericht im ADD INCLUDE-Client ausführen.
Um ein Bild hinzuzufügen
Setzen Sie den Zeiger in dem Beleg an der Stelle ab, an dem Sie das Steuerelement hinzufügen möchten.
Klicken Sie im XML-Zuordnung-Bereich auf das Steuerelement, das Sie hinzufügen möchten, und klicken Sie dann mit der rechten Maustaste auf Inhaltssteuerelement einfügen und dann auf Bild.
Um die Bildgröße zu erhöhen oder zu verringern, ziehen Sie einen der Ziehpunkte zur Mitte des Inhaltssteuerelements hin oder von der Mitte weg.
Benutzerdefinierter XML-Teil, Übersicht
Word-Berichtlayouts werden anhand von benutzerdefinierten XML-Abschnitten erstellt. Ein kundenspezifischer XML-Abschnitt für einen Bericht besteht aus Elementen, die den Datenelementen, den Spalten und den Beschriftungen entsprechen, die das Dataset des Berichts enthalten, wie im Berichts-DataSet-Designer in definiert. Der benutzerdefinierte XML-Abschnitt wird verwendet, um die Daten in einem Bericht zuzuordnen, wenn der Bericht ausgeführt wird.
XML-Struktur des benutzerdefinierten XML-Abschnitts
Die folgende Tabelle enthält eine vereinfachte Übersicht der XML eines benutzerdefinierten XML-Abschnitts.
XML-Elemente | Description |
---|---|
<?xml version="1.0" encoding="utf-16"?> |
Header |
<WordReportXmlPart xmlns="urn:microsoft-dynamics-365/report/<reportname>/<id>/" |
XML-Namespacespezifikation. <reportname> ist der Namee, der dem Bericht zugewiesen ist. <id> ist die ID, die dem Bericht zugewiesen ist. |
..<Labels> ....<ColumnNameCaption>ColumnNameCaption</ColumnNameCaption> ....<LabelName>LabelCaption</LabelName> ..</Labels> |
Enthält alle Beschriftungen für den Bericht. - Beschriftungs-Elemente, die mit Spalten verknüpft sind, die das Format <ColumnNameCaption>ColumnNameCaption</ColumnNameCaption> haben.- Bezeichnungselemente haben das Format <LabelName>LabelName</LableName .- Beschriftungen sind in alphabetischer Reihenfolge aufgeführt. |
..<DataItem1> ....<DataItem1Column1>DataItem1Column1</DataItem1Column1> |
Dateneinträge und Spalten auf oberster Ebene. Spalten werden in alphabetischer Reihenfolge aufgeführt. |
....<DataItem2> ......<DataItem2Column1>DataItem2Column1</DataItem2Column1> ....</DataItem2> ....<DataItem3> ......<DataItem3Column1>DataItem3Column1</DataItem3Column1> ....</DataItem3> |
Datenelemente und Spalten, die im Dateneintrag auf oberster Ebene verschachtelt sind. Spalten werden in alphabetischer Reihenfolge unter dem entsprechenden Dateneintrag aufgelistet. |
..</DataItem1> </WordReportXmlPart> |
Abschließendes Element. |
Benutzerdefinierter XML-Abschnitt in Word
In Word öffnen Sie den benutzerdefinierten XML-Abschnitt im XML-Zuordnung-Bereich und verwenden anschließend diesen Bereich, um Elemente zu den Inhaltssteuerelementen im Word-Dokument zuzuordnen. Der Bereich XML-Zuordnungist zugänglich von der Registerkarte Entwickler (weitere Informationen unter Vorgehensweise: Anzeigen der Entwickler-Registerkarte auf dem Menüband).
Die Elemente im XML-Zuordnung-Bereich erscheinen in einer Struktur ähnlich dem XML-Quellcode. Beschriftungsfelder werden unter einem allgemeinen element Beschriftungen gruppiert, und Dateneintrag und Spalten sind in einer hierarchischen Struktur angeordnet, die der XML-Quelle entspricht, wobei die Spalten in alphabetischer Reihenfolge aufgeführt werden. Elemente werden durch ihren Namen, wie durch die Eigenschaft "Name" im Berichts-DataSet-Designer in ADD INCLUDE definiert, identifiziert.
In der folgenden Abbildung wird der einfache benutzerdefinierte XML-Abschnitt aus dem vorherigen Abschnitt im XML-Zuordnung-Bereich eines Word-Dokuments dargestellt.
Um dem Layout eine Beschriftung oder ein Feld hinzuzufügen, fügen Sie ein Inhaltssteuerelement ein, das dem Element im XML-Zuordnung-Bereich zugeordnet ist.
Um wiederholen Zeilen aus Spalten zu erstellen, fügen Sie ein Wiederholen-Inhaltssteuerelement für das übergeordnete Datenelement ein, und fügen Sie dann ein Inhaltssteuerelement für die Spalten hinzu.
Bei Beschriftungen ist der tatsächliche Text, der im generierten Angabe erscheint, der Wert der Caption-Eigenschaft für das Feld in der Datenelementtabelle (wenn die Beschriftung mit der Spalte im Berichtsdataset verknüpft ist), oder entspricht einer Beschriftung im Berichts-Bezeichnungs-Designer (wenn die Beschriftung nicht mit einer Spalte im Dataset verknüpft ist).
Die Sprache der Beschriftung, die angezeigt wird, wenn Sie den Bericht ausführen, hängt von der Spracheneinstellung des Berichtsobjekts ab.
Siehe auch
Vorgehensweise: Erstellen und bearbeiten Sie einen benutzerdefinierten Bericht