Eine Konfiguration zur Generierung von Dokumenten im Excel-Format entwerfen

Sie können eine Formatkonfiguration für die elektronische Berichtersterstellung (EB) mit einer EB-Formatkomponente entwerfen, die Sie konfigurieren können, um ein ausgehendes Dokument in einem Microsoft Excel-Arbeitsmappenformat zu generieren. Zu diesem Zweck müssen bestimmte Komponenten des EB-Formats verwendet werden.

Führen Sie die folgenden Schritte im Artikel Konfiguration zum Generieren von Berichten im OPENXML-Format entwerfen aus, um weitere Informationen zu dieser Funktion zu erhalten.

Neues ER-Format hinzufügen

Wenn Sie eine neue EB-Formatkonfiguration hinzufügen, um ein ausgehendes Dokument in einem Excel-Arbeitsmappenformat zu generieren, müssen Sie den Excel-Wert das Attribut Formattyp des Formats auswählen oder das Attribut Formattyp leer lassen.

• Wenn Sie Excel auswählen, können Sie das Format so konfigurieren, dass ein ausgehendes Dokument nur im Excel-Format generiert wird.
• Wenn Sie das Attribut leer lassen, können Sie das Format so konfigurieren, dass ein ausgehendes Dokument in einem beliebigen Format generiert wird, das vom EB-Framework unterstützt wird.

Wählen Sie im Aktionsbereich Designer aus, und öffnen Sie die EB-Formatkomponente zur Bearbeitung im EB-Vorgangs-Designer aus, um die EB-Formatkomponente der Konfiguration zu konfigurieren.

Komponente „Excel-Datei“

Manuelle Eingabe

Sie müssen dem konfigurierten EB-Format eine Excel\Datei-Komponente hinzufügen, um ein ausgehendes Dokument im Excel-Format zu generieren.

Hängen Sie eine Excel-Arbeitsmappe mit der .xlsx-Erweiterung als Vorlage für ausgehende Dokumente an die Excel\Datei-Komponente an, um das Layout des ausgehenden Dokuments festzulegen.

Notiz

Wenn Sie eine Vorlage manuell anhängen, müssen Sie einen Dokumententyp verwenden, der zu diesem Zweck im EB-Parameter konfiguriert wurde.

Wenn Sie das konfigurierte ER-Format ausführen, müssen Sie der Excel\Datei-Komponente die Komponenten Blatt-, Angebot und Zelle hinzufügen, um festzulegen, wie die angehängte Vorlage ausgefüllt wird. Jede verschachtelte Komponente muss mit einem Excel-benannten Element verknüpft sein.

Vorlagenimport

Sie können auf der Registerkarte Importieren des Aktionsbereichs die Option Aus Excel importieren auswählen, um eine neue Vorlage in ein leeres EB-Format zu importieren. In diesem Beispiel wird automatisch eine Excel\Datei-Komponente erstellt und die importierte Vorlage daran angehängt. Alle erforderlichen EB-Komponenten werden ebenfalls automatisch erstellt, basierend auf der Liste der erkannten Excel-benannten Elemente.

Notiz

Wenn Sie das optionale Blatt-Element im bearbeitbaren EB-Format erstellen möchten, legen Sie die Option Excel-Arbeitsblattformat-Element erstellen auf Ja fest.

Komponente „Blatt“

Die Blatt-Komponente gibt ein Arbeitsblatt der angehängten Excel-Arbeitsmappe an, das ausgefüllt werden muss. Der Name des Arbeitsblatts in einer Excel-Vorlage ist in der Blatt-Eigenschaft dieser Komponente definiert.

Notiz

Diese Komponente ist für Excel-Arbeitsmappen, die ein einzelnes Arbeitsblatt enthalten, optional.

Auf der Registerkarte Zuordnung des EB-Vorgangs-Designers können Sie die Eigenschaft Aktiviert für eine Blatt-Komponente konfigurieren, um anzugeben, ob die Komponente in ein generiertes Dokument eingefügt werden muss:

• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Wahr zur Laufzeit oder wenn überhaupt kein Ausdruck konfiguriert ist, wird das entsprechende Arbeitsblatt im generierten Dokument ausgefüllt.
• Wenn ein Ausdruck der Eigenschaft Aktiviert ist für die Rückgabe von Falsch zur Laufzeit konfiguriert ist, enthält das generierte Dokument kein Arbeitsblatt.

Komponente „Bereich“

Verschachtelte Komponenten

Daten-Typisierung

Die Komponente Bereich kann weitere verschachtelte ER-Komponenten enthalten, die zur Eingabe von Werten in die entsprechenden Bereiche verwendet werden.

• Wenn eine Komponente der Gruppe Text für die Eingabe von Werten verwendet wird, erfolgt die Eingabe des Werts in einem Excel-Bereich als Textwert.

  Notiz

  Verwenden Sie dieses Muster, um eingegebene Werte basierend auf dem in der Anwendung definierten Gebietsschema zu formatieren.

• Wenn die Zelle-Komponente der Excel-Gruppe zur Eingabe von Werten verwendet wird, wird der Wert in einem Excel-Bereich als Wert des Datentyps eingegeben, der durch die Bindung dieser Zelle-Komponente definiert ist. Der Datentyp kann zum Beispiel String, Real oder Integer sein.

  Notiz

  Verwenden Sie dieses Muster, damit die Excel-Anwendung eingegebene Werte basierend auf dem Gebietsschema des lokalen Computers formatieren kann, der das ausgehende Dokument öffnet.

Behandlung von Zeilen

Die Komponente Bereich kann als vertikal repliziert konfiguriert werden, so dass mehrere Zeilen in einem Excel-Arbeitsblatt erzeugt werden. Die Zeilen können von der übergeordneten Bereich-Komponente oder von deren verschachtelten Bereich-Komponenten erzeugt werden.

In Version 10.0.26 und später können Sie ein generiertes Arbeitsblatt dazu zwingen, die generierten Zeilen auf derselben Seite zu halten. Legen Sie im ER-Formatdesigner die Option Zeilen zusammenhalten auf Ja für die übergeordnete Komponente Bereich im bearbeitbaren ER-Format fest. ER wird dann versuchen, alle Inhalte, die von diesem Bereich generiert werden, auf derselben Seite zu halten. Wenn die Höhe des Inhalts den verbleibenden Platz auf der aktuellen Seite überschreitet, wird ein Seitenumbruch eingefügt, und der Inhalt beginnt am Anfang der nächsten neuen Seite.

Notiz

Wir empfehlen Ihnen, die Option Zeilen zusammenhalten nur für Bereiche zu konfigurieren, die sich über die gesamte Breite eines generierten Dokuments erstrecken.

Die Option Zeilen zusammenhalten gilt nur für Excel > Datei Komponenten, die für die Verwendung einer Excel Arbeitsmappenvorlage konfiguriert sind.

Die Option Zeilen zusammenhalten kann nur verwendet werden, wenn die Funktion Verwendung der EPPlus-Bibliothek im Electronic Reporting Framework aktivieren aktiviert ist.

Diese Funktion kann für Bereich-Komponenten verwendet werden, die sich unter der Seite-Komponente befinden. Es gibt jedoch keine Garantie dafür, dass Seitenfußsummen durch die Verwendung von Datensammlung-Datenquellen korrekt berechnet werden.

Um zu erfahren, wie Sie diese Option verwenden, folgen Sie den Beispielschritten in Entwerfen Sie ein ER-Format, um Zeilen auf derselben Excel-Seite zusammenzuhalten.

Wiederholung

Die Eigenschaft Replikationsrichtung gibt an, ob und wie ein Bereich in einem generierten Dokument wiederholt wird:

• Keine Replikation - Der entsprechende Excel-Bereich wird in dem generierten Dokument nicht wiederholt.

• Vertikal - Der entsprechende Excel-Bereich wird im generierten Dokument vertikal wiederholt. Jeder replizierte Bereich wird in einer Excel-Vorlage unter den ursprünglichen Bereich gestellt. Die Anzahl der Wiederholungen wird durch die Anzahl der Datensätze in einer Datenquelle des Typs Datensatzliste definiert, der an diese EB-Komponente gebunden ist.

• Horizontal - Der entsprechende Excel-Bereich wird in dem generierten Dokument horizontal wiederholt. Jeder replizierte Bereich wird in einer Excel-Vorlage rechts neben dem Originalbereich eingefügt. Die Anzahl der Wiederholungen wird durch die Anzahl der Datensätze in einer Datenquelle des Typs Datensatzliste definiert, der an diese EB-Komponente gebunden ist.

  Führen Sie die Schritte unter Horizontal erweiterbare Bereiche verwenden, um Spalten in Excel-Berichten dynamisch hinzuzufügen aus, um weitere Informationen zu erhalten.

Wird aktiviert

Auf der Registerkarte Zuordnung des EB-Vorgangs-Designers können Sie die Eigenschaft Aktiviert für eine Bereich-Komponente konfigurieren, um anzugeben, ob die Komponente in ein generiertes Dokument eingefügt werden muss:

• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Wahr zur Laufzeit oder wenn überhaupt kein Ausdruck konfiguriert ist, wird der entsprechende Bereich im generierten Dokument ausgefüllt.
• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Falsch zur Laufzeit konfiguriert ist und dieser Bereich nicht sämtliche Zeilen oder Spalten darstellt, wird der entsprechende Bereich nicht im generierten Dokument ausgefüllt.
• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Falsch zur Laufzeit konfiguriert ist und dieser Bereich sämtliche Zeilen oder Spalten darstellt, enthält das Dokument diese Zeilen und Spalten als ausgeblendete Zeilen und Spalten.

Ändern der Größe

Sie können Ihre Excel-Vorlage so konfigurieren, dass Zellen zur Darstellung von Textdaten verwendet werden. Um sicherzustellen, dass der gesamte Text in einer Zelle in einem generierten Dokument sichtbar ist, können Sie diese Zelle so konfigurieren, dass der Text darin automatisch umgebrochen wird. Sie können die Zeile, die diese Zelle enthält, auch so konfigurieren, dass ihre Höhe automatisch angepasst wird, wenn der umgebrochene Text nicht vollständig sichtbar ist. Weitere Informationen finden Sie im Abschnitt „Text in einer Zelle umbrechen“ in Korrigieren von unvollständig angezeigten Daten in Zellen.

Notiz

Wegen einer bekannten Excel-Einschränkung, selbst wenn Sie Zellen so konfigurieren, dass Text umgebrochen wird, und Sie die Zeilen, die diese Zellen enthalten, so konfigurieren, dass ihre Höhe automatisch an den umgebrochenen Text angepasst wird, können Sie die Excel-Funktionen AutoFit und Zeilenumbruch für verbundene Zellen und die Zeilen, die sie enthalten, eventuell nicht verwenden.

Ab Dynamics 365 Finance-Version 10.0.23 können Sie ER zwingen, beim Arbeiten in einem generierten Dokument die Höhe jeder Zeile zu berechnen, die so konfiguriert wurde, dass ihre Höhe automatisch an den Inhalt verschachtelter Zellen angepasst wird, wenn diese Zeile mindestens eine verbundene Zelle enthält, die zum Umbrechen des Texts in der Zelle konfiguriert war. Die berechnete Höhe wird dann verwendet, um die Größe der Zeile zu ändern, um sicherzustellen, dass alle Zellen in der Zeile im generierten Dokument sichtbar sind.

Notiz

Beachten Sie, dass diese Funktion möglicherweise nicht wie erwartet funktioniert, wenn eine benutzerdefinierte Schriftart zum Formatieren einer verbundenen Zelle verwendet wird. Da Excel keine benutzerdefinierten Schriftarten einbettet, werden keine Informationen zur benutzerdefinierten Schriftgröße bereitgestellt. Daher kann die Größe der verbundenen Zelle falsch geschätzt werden.

Gehen Sie folgendermaßen vor, um diese Funktion beim Ausführen von EB-Formaten zu verwenden, die für die Verwendung von Excel-Vorlagen zum Generieren ausgehender Dokumente konfiguriert wurden.

1. Wechseln Sie zu Organisationsverwaltung>Arbeitsbereiche>Elektronische Berichterstellung.
2. Wählen Sie auf der Seite Lokalisierungskonfigurationen im Bereich Zugehörige Links die Option Parameter für elektronische Berichterstellung aus.
3. Auf der Seite Parameter für elektronische Berichterstellung legen Sie auf der Registerkarte Runtime die Option Zeilenhöhe automatisch anpassen auf Ja fest.

Wenn Sie diese Regel für ein einzelnes EB-Format ändern möchten, aktualisieren Sie die Entwurfsversion dieses Formats, indem Sie wie folgt vorgehen.

1. Wechseln Sie zu Organisationsverwaltung>Arbeitsbereiche>Elektronische Berichterstellung.

2. Auf der Seite Lokalisierungskonfigurationen im Abschnitt Konfigurationen wählen Sie die Kachel Berichterstellungskonfigurationen.

3. Wählen Sie auf der Seite Konfigurationen in der Konfigurationsstruktur im linken Bereich eine EB-Konfiguration aus, die für die Verwendung einer Excel-Vorlage zum Generieren ausgehender Dokumente ausgelegt ist.

4. Wählen Sie im Inforegister Versionen die Konfigurationsversion mit dem Status Entwurf aus.

5. Wählen Sie im Aktivitätsbereich Designer aus.

6. Wählen Sie auf der Seite Formatdesigner in der Formatstruktur im linken Bereich die Excel-Komponente aus, die mit einer Excel-Vorlage verknüpft ist.

7. Wählen Sie auf der Registerkarte Format im Feld Zeilenhöhe anpassen einen Wert aus, um anzugeben, ob EB zur Runtime gezwungen werden soll, die Zeilenhöhe in einem ausgehenden Dokument zu ändern, das vom bearbeiteten EB-Format generiert wird:

   • Standard: Verwenden Sie die allgemeine Einstellung, die im Feld Zeilenhöhe automatisch anpassen auf der Seite Parameter der elektronischen Berichterstellung.
   • Ja: Die allgemeinen Einstellungen werden überschrieben und die Zeilenhöhe zur Runtime geändert.
   • Nein: Die allgemeinen Einstellungen werden überschrieben und die Zeilenhöhe zur Runtime nicht geändert.

Komponente „Zelle“

Die Komponente Zelle wird verwendet, um Excel-benannte Zellen, Formen und Bilder auszufüllen. Wenn Sie ein Excel-benannte Objekt, das von einer EB-Komponente vom Typ Zelle ausgefüllt werden muss, angeben möchten, müssen Sie den Namen dieses Objekts in der Eigenschaft Excel-Bereich der Komponente Zelle festlegen.

Auf der Registerkarte Zuordnung des EB-Vorgangs-Designers können Sie die Eigenschaft Aktiviert für eine Bereich-Komponente konfigurieren, um festzulegen, ob das Objekt in einem generierten Dokument ausgefüllt werden muss:

• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Wahr zur Laufzeit oder wenn überhaupt kein Ausdruck konfiguriert ist, wird das entsprechende Objekt im generierten Dokument ausgefüllt. Die Bindung dieser Komponente vom Typ Zelle gibt einen Wert an, der in das entsprechende Objekt eingefügt wird.
• Wenn ein Ausdruck der Eigenschaft Aktiviert für die Rückgabe von Falsch zur Laufzeit konfiguriert ist, wird das entsprechende Objekt nicht im generierten Dokument ausgefüllt.

Wenn eine Komponente vom Typ Zelle für die Eingabe eines Werts in eine Zelle konfiguriert ist, kann sie an eine Datenquelle gebunden werden, die den Wert eines primitiven Datentyps zurückgibt (z. B. Zeichenfolge, Gleitkommazahl oder Ganzzahl). In diesem Fall wird der Wert als Wert desselben Datentyps in die Zelle eingegeben.

Wenn eine Komponente vom Typ Zelle für die Eingabe eines Werts in ein Excel-Shape konfiguriert ist, kann sie an eine Datenquelle gebunden werden, die einen Wert eines primitiven Datentyps zurückgibt (z. B. Zeichenfolge, Gleitkommazahl oder Ganzzahl). In diesem Fall wird der Wert als Text dieses Shapes in das Excel-Shape eingegeben. Für Werte von anderen Datentypen als Zeichenfolge erfolgt die Konvertierung in Text automatisch.

Notiz

Sie können eine Komponente vom Typ Zelle so konfigurieren, dass ein Shape nur in den Fällen ausgefüllt wird, in denen eine Shape-Text-Eigenschaft unterstützt wird.

Wenn eine Komponente vom Typ Zelle für die Eingabe eines Werts in ein Excel-Bild konfiguriert ist, kann sie an eine Datenquelle gebunden werden, die einen Wert des Datentyps Container zurückgibt, der ein Bild im Binärformat darstellt. In diesem Fall wird der Wert als Bild in das Excel-Bild eingegeben.

Notiz

Jedes Excel-Bild und -Shape gilt als durch die obere linke Ecke in einer bestimmten Excel-Zelle oder einem bestimmten Excel-Bereich verankert. Wenn Sie ein Excel-Bild oder Excel-Shape replizieren möchten, müssen Sie die Zelle oder den Bereich, in dem es verankert ist, als replizierte Zelle oder Bereich konfigurieren.

Tipp

Wenn Sie zur Laufzeit ein Bild mit benutzerdefinierter Skalierung und benutzerdefiniertem Seitenverhältnis verwenden möchten, empfehlen wir Ihnen, die Option Bildskalierung beachten der übergeordnete Excel-Dateikomponente auf Ja zu aktivieren, um die Skalierung und das Seitenverhältnis als Platzhalter dieses Bildes in der von Ihnen verwendeten Excel-Vorlage anzuwenden.

Weitere Informationen zum Einbetten von Bildern und Shapes finden Sie unter Bilder und Shapes in Dokumente einbetten, die mit EB generiert werden.

Komponente „Seitenumbruch“

Die Komponente PageBreak erzwingt das Starten einer neuen Seite in Excel. Diese Komponente ist nicht erforderlich, wenn Sie das Standard-Paging von Excel verwenden möchten, aber Sie sollten sie verwenden, wenn Sie möchten, dass Excel Ihrem ER-Format folgt, um das Paging zu strukturieren.

Seitenkomponente

Übersicht

Sie können die Seiten-Komponente verwenden, wenn Sie möchten, dass Excel Ihr ER-Format befolgt und die Paginierung in einem generierten ausgehenden Dokument strukturiert. Wenn ER-Formatkomponenten ausgeführt werden, die sich unter der Seiten-Komponente befinden, werden die erforderlichen Seitenumbrüche automatisch hinzugefügt. Dabei werden die Größe des generierten Inhalts, der Seitenaufbau der Excel-Vorlage und das in der Excel-Vorlage gewählte Papierformat berücksichtigt.

Wenn Sie ein generiertes Dokument in verschiedene Abschnitte aufteilen müssen, von denen jeder eine andere Paginierung besitzt, können Sie mehrere Seiten-Komponenten in jeder Blatt-Komponente konfigurieren.

Struktur

Wenn die erste Komponente unter der Komponente Seite eine Bereich-Komponente ist, bei der die Eigenschaft Replikationsrichtung auf Keine Replikation gesetzt ist, wird dieser Bereich als Seitenkopf für die Paginierung betrachtet, die auf den Einstellungen der aktuellen Seiten-Komponente basiert. Der dieser Formatkomponente zugeordnete Excel-Bereich wird oben auf jeder Seite wiederholt, die mit den Einstellungen der aktuellen Seiten-Komponente generiert wird.

Notiz

Für eine korrekte Paginierung, wenn der Bereich Oben zu wiederholenden Zeilen in Ihrer Excel-Vorlage konfiguriert ist, muss die Adresse dieses Excel-Bereichs mit der Adresse des Excel-Bereichs übereinstimmen, der mit der zuvor beschriebenen Bereich-Komponente verknüpft ist.

Wenn die letzte Komponente unter der Komponente Seite eine Bereich-Komponente ist, bei der die Eigenschaft Replikationsrichtung auf Keine Replikation gesetzt ist, wird dieser Bereich als Seitenfußzeile für die Paginierung betrachtet, die auf den Einstellungen der aktuellen Seiten-Komponente basiert. Der dieser Formatkomponente zugeordnete Excel-Bereich wird unten auf jeder Seite wiederholt, die mit den Einstellungen der aktuellen Seiten-Komponente generiert wird.

Notiz

Für eine korrekte Paginierung darf die Größe der Excel-Bereiche, die den Bereich-Komponenten zugeordnet sind, während der Runtime nicht geändert werden. Es wird nicht empfohlen, Zellen dieses Bereichs mit den Optionen Text in eine Zelle umbrechen und Zeilenhöhe automatisch anpassenin Excel zu formatieren.

Sie können mehrere andere Bereich-Komponenten zwischen den optionalen Bereich-Komponenten hinzufügen, um anzugeben, wie ein generiertes Dokument ausgefüllt wird.

Wenn der Satz der verschachtelten Bereich-Komponenten unter der Seite-Komponente nicht mit der zuvor beschriebenen Struktur übereinstimmt, tritt ein Validierungsfehler zur Entwurfszeit im ER-Formatdesigner auf. Die Fehlermeldung weist Sie darauf hin, dass das Problem zur Runtime zu Problemen führen kann.

Notiz

Um eine korrekte Ausgabe zu generieren, geben Sie keine Bindung für eine Bereich-Komponente unter der Seite-Komponente an, wenn die Eigenschaft Replikationsrichtung für diese Bereich-Komponente auf Keine Replikation festgelegt ist, und der Bereich so konfiguriert ist, um Seitenkopfzeilen oder Seitenfußzeilen zu generieren.

Wenn Sie eine paginierungsbezogene Summierung und Zählung wünschen, um laufende Summen und Summen pro Seite zu berechnen, empfehlen wir Ihnen, die erforderliche Datenquelle Datensammlung zu konfigurieren. Um zu lernen, wie man die Seite-Komponente verwendet, um ein generiertes Excel-Dokument zu paginieren, führen Sie die Verfahren in Ein ER-Format verwenden, um ein generiertes Dokument im Excel-Format zu paginieren aus.

Einschränkungen

Wenn Sie die Seite-Komponente für die Excel-Paginierung verwenden, wissen Sie die endgültige Seitenzahl in einem generierten Dokument erst, wenn die Paginierung abgeschlossen ist. Daher können Sie die Gesamtseitenzahl nicht mithilfe von ER-Formeln berechnen und die richtige Seitenzahl eines generierten Dokuments auf einer Seite vor der letzten Seite drucken.

Tipp

Um dieses Ergebnis in einer Excel-Kopf- oder Fußzeile zu erreichen, verwenden Sie die spezielle Excel-Formatierung für Kopf- und Fußzeilen.

Konfigurierte Seite-Komponenten werden nicht berücksichtigt, wenn Sie eine Excel-Vorlage im bearbeitbaren Format in der Dynamics 365 Finance-Version 10.0.22 aktualisieren. Diese Funktionalität wird für weitere Versionen von Finance in Betracht gezogen.

Wenn Sie Ihre Excel-Vorlage zur Verwendung der bedingten Formatierung konfigurieren, funktioniert sie in manchen Fällen möglicherweise nicht wie erwartet.

Anwendbarkeit

Die Seite-Komponente funktioniert für das Format Excel-Datei nur, wenn diese Komponente zur Verwendung einer Vorlage in Excel konfiguriert ist. Wenn Sie die Excel-Vorlage durch eine Word-Vorlage ersetzen und dann das bearbeitbare ER-Format ausführen, wir die Seite-Komponente ignoriert.

Die Seite-Komponente funktioniert nur, wenn die Funktion Aktivieren Sie die Verwendung der EPPlus-Bibliothek im Rahmen für elektronische Berichte aktiviert ist. Zur Laufzeit wird eine Ausnahme ausgelöst, wenn ER versucht, die Seite-Komponente zu verarbeiten, während diese Funktion deaktiviert ist.

Notiz

Zur Laufzeit wird eine Ausnahme ausgelöst, wenn ein ER-Format die Seite-Komponente für eine Excel-Vorlage verarbeitet, die mindestens eine Formel enthält, die auf eine ungültige Zelle verweist. Um Laufzeitfehler zu vermeiden, korrigieren Sie die Excel-Vorlage wie in So korrigieren Sie einen #REF!-Fehler beschrieben.

Fußzeilenkomponente

Die Fußzeile-Komponente wird verwendet, um Fußzeilen am unteren Rand eines generierten Arbeitsblatts in einer Excel-Arbeitsmappe auszufüllen.

Notiz

Sie können diese Komponente für jede Blatt-Komponente zum Angeben verschiedener Fußzeilen für verschiedene Arbeitsblätter in einer generierten Excel-Arbeitsmappe hinzufügen.

Wenn Sie eine individuelle Fußzeile-Komponente konfigurieren, können Sie die Eigenschaft Kopf-/Fußzeilendarstellung zum Angeben der Seiten verwenden, für die die Komponente verwendet werden soll. Folgende Werte sind verfügbar:

• Beliebig – Führt die konfigurierte Fußzeile-Komponente für eine beliebige Seite des übergeordneten Excel-Arbeitsblatts aus.
• Zuerst – Führt die konfigurierte Fußzeile-Komponente nur für die erste Seite des übergeordneten Excel-Arbeitsblatts aus.
• Gerade – Führt die konfigurierte Fußzeile-Komponente nur für die geraden Seiten des übergeordneten Excel-Arbeitsblatts aus.
• Ungerade – Führt die konfigurierte Fußzeile-Komponente nur für die ungeraden Seiten des übergeordneten Excel-Arbeitsblatts aus.

Einer einzelnen Blatt-Komponente können Sie mehrere Fußzeile-Komponenten hinzufügen, von denen jede einen anderen Wert in der Eigenschaft Kopf-/Fußzeilendarstellung besitzt. Auf diese Weise können Sie verschiedene Fußzeilen für verschiedene Seitentypen in einem Excel-Arbeitsblatt generieren.

Notiz

Vergewissern Sie sich, dass jede Fußzeile-Komponente, die Sie einer einzelnen Blatt-Komponenten hinzufügen, einen anderen Wert in der Eigenschaft Kopf-/Fußzeilendarstellung besitzt. Ansonsten tritt Prüfungsfehler auf. Die Fehlermeldung, die Sie erhalten, benachrichtigt Sie über die Inkonsistenz.

Fügen Sie unter der hinzugefügten Fußzeile-Komponente die erforderlichen verschachtelten Komponenten der Typen Text\String, Text\DateTime oder eines anderen Typs hinzu. Konfigurieren Sie die Bindungen für diese Komponenten, um anzugeben, wie Ihre Seitenfußzeile ausgefüllt werden soll.

Sie können auch spezielle Formatierungscodes verwenden, um den Inhalt einer generierten Fußzeile korrekt zu formatieren. Befolgen Sie die Schritte in Beispiel 1 im weiteren Verlauf des Artikels, um zu erfahren, wie Sie diesen Ansatz verwenden.

Notiz

Berücksichtigen Sie beim Konfigurieren von EB-Formaten unbedingt die Spezifikationen und Beschränkungen in Excel sowie die maximale Zeichenanzahl für eine einzelne Kopf- oder Fußzeile.

Kopfzeilenkomponente

Die Kopfzeile-Komponente wird verwendet, um Kopfzeilen am oberen Rand eines generierten Arbeitsblatts in einer Excel-Arbeitsmappe auszufüllen. Sie wird wie die Fußzeile-Komponente verwendet.

Hinzugefügtes EB-Format bearbeiten

Vorlage aktualisieren

Sie können auf der Registerkarte Importieren des Aktionsbereichs die Option Aus Excel importieren auswählen, um eine aktualisierte Vorlage in ein bearbeitbares EB-Format zu importieren. Während dieses Vorgangs wird eine Vorlage der ausgewählten Excel\Datei-Komponente durch eine neue Vorlage ersetzt. Der Inhalt des bearbeitbaren EB-Formats wird mit dem Inhalt der aktualisierten EB-Vorlage synchronisiert.

• Für jeden Excel-Namen wird automatisch eine neue EB-Format-Komponente erstellt, wenn die EB-Format-Komponente nicht im bearbeitbaren Format gefunden wird.
• Jede EB-Format-Komponente wird aus dem bearbeitbaren EB-Format gelöscht, wenn kein entsprechender Excel-Name dafür gefunden wird.

Notiz

Legen Sie die Option Excel-Arbeitsblattformat-Element erstellen auf Ja fest, wenn Sie das optionale Blatt-Element im bearbeitbaren EB-Format erstellen möchten.

Wenn das bearbeitbare EB-Format ursprünglich Blatt-Elemente enthielt, wird empfohlen, dass Sie die Option Excel-Arbeitsblattformat-Element erstellen auf Ja festlegen, wenn Sie eine aktualisierte Vorlage importieren. Anderfalls werden alle verschachtelten Elemente des ursprünglichen Blatt-Elements von Grund auf neu erstellt. Daher gehen alle Bindungen der neu erstellten Formatelemente im aktualisierten EB-Format verloren.

Ab Version 10.0.28 können Sie die Option Excel-Kopfzeilen- und Excel-Fußzeilenformatelemente aktualisieren verwenden.

• Wenn Sie diese Option auf Nein setzen, bleiben die Formatelemente Excel-Kopfzeile und Excel-Fußzeile unverändert, auch wenn die entsprechenden Kopf- oder Fußzeilen in den Arbeitsblättern der importierten Vorlage im Excel-Arbeitsmappenformat aktualisiert wurden.

• Wenn Sie diese Option auf Ja setzen, werden die Formatelemente Excel-Kopfzeile und Excel-Fußzeile verändert, wenn die entsprechenden Kopf- oder Fußzeilen in den Arbeitsblättern der importierten Vorlage im Excel-Arbeitsmappenformat aktualisiert werden.

  • Wenn die Struktur einer Kopf- oder Fußzeile eines Arbeitsblatts nicht geändert oder nur angehängt wurde, wird die Struktur des entsprechenden Formatelements Excel-Kopfzeile oder Excel-Fußzeile aktualisiert. Bindungen von Formatelementen, die unter diesem Formatelement Excel-Kopfzeile oder Excel-Fußzeile verschachtelt sind, bleiben erhalten.
  • Wenn die Struktur einer Kopf- oder Fußzeile eines Arbeitsblatts geändert wird, wird das entsprechende Formatelement der Excel-Kopfzeile oder Excel-Fußzeile neu erstellt. Bindungen von Formatelementen, die unter diesem Formatelement Excel-Kopfzeile oder Excel-Fußzeile verschachtelt sind, werden entfernt.

Führen Sie die Schritte unter Elektronische Berichterstellungsformate ändern, indem Microsoft Excel-Vorlagen erneut angewendet werden, um weitere Informationen zu dieser Funktion zu erhalten.

EB-Format überprüfen

Wenn Sie ein bearbeitbares EB-Format überprüfen, wird eine Konsistenzprüfung durchgeführt, um sicherzustellen, dass der Excel-Name in der aktuell verwendeten Excel-Vorlage vorhanden ist. Sie werden über etwaige Inkonsistenzen informiert. Bei einigen Inkonsistenzen ist die Option zur automatischen Behebung von Problemen verfügbar.

Berechnung von Excel-Formeln steuern

Wenn ein ausgehendes Dokument in einem Microsoft Excel-Arbeitsmappenformat generiert wird, enthalten einige Zellen dieses Dokuments möglicherweise Excel-Formeln. Wenn die Funktion Die Verwendung der EPPlus-Bibliothek im Framework der elektronischen Berichterstellung aktivieren aktiviert ist, können Sie steuern, wann die Formeln berechnet werden, indem Sie den Wert des Berechnungsoptionen-Parameters in der verwendeten Excel-Vorlage ändern:

• Wählen Sie Automatisch aus, um alle abhängigen Formeln jedes Mal neu zu berechnen, wenn ein generiertes Dokument an neue Bereiche, Zellen usw. angehängt wird.

  Notiz

  Dies kann zu Leistungsproblemen bei Excel-Vorlagen führen, die mehrere verwandte Formeln enthalten.

• Wählen Sie Manuell aus, um eine Neuberechnung der Formel beim Generieren eines Dokuments zu vermeiden.

  Notiz

  Die Neuberechnung der Formel wird manuell erzwungen, wenn ein generiertes Dokument in Excel zur Vorschau geöffnet wird. Verwenden Sie diese Option nicht, wenn Sie ein EB-Ziel konfigurieren, das die Verwendung eines generierten Dokuments ohne Vorschau in Excel (PDF-Konvertierung, E-Mail usw.) voraussetzt, da das generierte Dokument möglicherweise keine Werte in Zellen enthält, die Formeln enthalten.

Beispiel 1: Fußzeileninhalt formatieren

1. Verwenden Sie die bereitgestellten EB-Konfigurationen, um ein druckbares Freitext-Dokument (Free Text Invoice, FTI) zu generieren .

2. Überprüfen Sie die Fußzeile des generierten Dokuments. Beachten Sie, dass es Informationen zur aktuellen Seitenzahl und zur Gesamtzahl der Seiten im Dokument enthält.

   

3. Öffnen Sie im EB-Formatdesigner das Beispiel-EB-Format zur Überprüfung.

   Die Fußzeile des Arbeitsblattes Rechnung wird basierend auf den Einstellungen von zwei String-Komponenten generiert, die sich unter der Fußzeile-Komponente befinden:

   • Die erste String-Komponente füllt die folgenden speziellen Formatierungscodes aus, um Excel zu zwingen, bestimmte Formatierungen anzuwenden:

     • &C – Mittiges Ausrichten des Fußzeilentextes.
     • &"Segoe UI,Regular"&8 – Darstellen des Fußzeilentextes in der Schrift "Segoe UI Regular" und in einer Größe von 8-Punkt.

   • Die zweite String-Komponente füllt den Text aus, der die aktuelle Seitenzahl und die Gesamtzahl der Seiten im aktuellen Dokument enthält.

   

4. Passen Sie das Beispiel-EB-Format an, um die aktuelle Seitenfußzeile zu ändern:

   1. Erstellen Sie ein abgeleitetes Freitextrechnung (Excel) benutzerdefiniert-EB-Format, das auf dem Beispiel-EB-Format basiert.

   2. Fügen Sie das erste neue Paar an String-Komponenten für die Fußzeile-Komponente des Arbeitsblattes Rechnung hinzu:

      1. Fügen Sie eine String-Komponente hinzu, die den Firmennamen links ausrichtet und in der Größe 8-Punkt in der Schriftart "Segoe UI Regular" ("&L&"Segoe UI,Regular"&8") darstellt.
      2. Fügen Sie eine String-Komponente hinzu, die den Firmennamen ausfüllt (model.InvoiceBase.CompanyInfo.Name).

   3. Fügen Sie das zweite neue Paar an String-Komponenten für die Fußzeile-Komponente des Arbeitsblattes Rechnung hinzu:

      1. Fügen Sie eine String-Komponente hinzu, die das Verarbeitungsdatum rechts ausrichtet und in der Größe 8-Punkt in der Schriftart "Segoe UI Regular" ("&L&"Segoe UI,Regular"&8") darstellt.
      2. Fügen Sie eine String-Komponente hinzu, die das Verarbeitungsdatum in einem benutzerdefinierten Format ausfüllt (" "&DATEFORMAT(SESSIONTODAY(), "JJJJ-MM-TT")).

      

   4. Vervollständigen Sie die Entwurfsversion des abgeleiteten Freitextrechnung (Excel) benutzerdefiniert-EB-Formats.

5. Konfigurieren Sie die Druckverwaltung zur Verwendung des abgeleiteten Freitextrechnung (Excel) benutzerdefiniert-EB-Formats anstelle des Beispiel-EB-Formats.

6. Generieren Sie ein druckbares FTI-Dokument, und überprüfen Sie die Fußzeile des generierten Dokuments.

   

Beispiel 2: Behebung des EPPlus-Problems mit verbundenen Zellen

Sie können ein EB-Format ausführen, um ein ausgehendes Dokument in einem Excel-Arbeitsmappenformat zu generieren. Wenn die Die Nutzung der EPPlus-Bibliothek im Rahmen der elektronische Berichterstellung aktivieren-Funktion ist im Funktionsverwaltung-Arbeitsplatz aktiviert ist, wird die EPPlus-Bibliothek verwendet, um eine Excel-Ausgabe zu erstellen. Allerdings können Sie wegen eines bekannten Excel-Verhaltens und einer Einschränkung der EPPlus-Bibliothek auf die folgende Ausnahme stoßen: „Verbundene Zellen können nicht gelöscht/überschrieben werden. Ein Bereich wird teilweise mit einem anderen zusammengeführten Bereich zusammengeführt.“ Um zu erfahren, welche Art von Excel-Vorlagen diese Ausnahme verursachen können und wie Sie das Problem beheben können, führen Sie das folgende Beispiel durch.

1. Erstellen Sie in der Excel-Desktopanwendung eine neue Excel-Arbeitsmappe.

2. Fügen Sie auf Arbeitsblatt Sheet1 den ReportTitle-Namen für Zelle A2 hinzu.

3. Zellen A1 und A2 verbinden.

   

4. Auf der Seite Konfigurationenein neues EB-Format hinzufügen, um ein ausgehendes Dokument im Format einer Excel-Arbeitsmappe zu generieren.

5. Auf der Formatdesigner-Seite die gestaltete Excel-Arbeitsmappe als neue Vorlage für ausgehende Dokumente in das hinzugefügte ER-Format importieren.

6. Konfigurieren Sie auf der Zuordnung-Registerkarte die Bindung für die ReportTitle-Komponente des Typs Zelle.

7. Führen Sie as konfigurierte EB-Format aus. Beachten Sie, dass die folgende Ausnahme ausgelöst wird: „Verbundene Zellen können nicht gelöscht/überschrieben werden. Ein Bereich wird teilweise mit einem anderen zusammengeführten Bereich zusammengeführt.“

   

Sie können das Problem auf eine der folgenden Arten beheben:

• Einfacher, aber nicht zu empfehlen: Aktivieren Sie im Funktionsverwaltung-Arbeitsbereich die Funktion Die Nutzung der EPPlus-Bibliothek im Rahmen der elektronischen Berichterstellung aktivieren. Obwohl dieser Ansatz einfacher ist, können bei seiner Verwendung andere Probleme auftreten, da einige EB-Funktionen nur unterstützt werden, wenn die Die Nutzung der EPPlus-Bibliothek im Rahmen der elektronischen Berichterstellung aktivieren-Funktion aktiviert ist.

• Empfohlen: Führen Sie die folgenden Schritte aus:

  1. Ändern Sie in der Excel-Desktop-Anwendung die Excel-Arbeitsmappe auf eine der folgenden Weisen:

     • Haben Sie Auf Arbeitsblatt Blatt1 die Zusammenführung der Zellen A1 und A2 auf.
     • Ändern Sie die Referenz für den ReportTitle-Namen von =Sheet1!$A$2 auf =Sheet1!$A$1.

     

  2. Auf der Formatdesigner-Seite die modifizierte Excel-Arbeitsmappe in das bearbeitbare EB-Format importieren, um die vorhandene Vorlage zu aktualisieren.

  3. Führen Sie das geänderte EB-Format aus.

     

Einschränkungen

Bekannte Einschränkungen der EPPlus Bibliothek

Externe Datenquellen

Wenn eine Ihrer Vorlagen eine PivotTable enthält, die auf einem PowerPivot-Modell basiert, das auf eine externe Datenquelle verweist, und die Funktion Die Verwendung der EPPlus-Bibliothek im Framework der elektronischen Berichterstellung aktivieren aktiviert ist, erhalten Sie die folgende Fehlermeldung, wenn Sie ein ER-Format ausführen, das diese Vorlage verwendet, um einen ausgehenden Beleg im Excel-Format zu erzeugen: „The cachesource is not a worksheet“. Um dieses Problem zu beheben, haben Sie die folgenden Möglichkeiten:

• Empfohlen: Überarbeiten Sie die Excel-Lösung, die Sie verwenden:

  1. Isolieren Sie den Teil, der Pivots enthält, in einer separaten Excel-Arbeitsmappe (Arbeitsmappe A).
  2. Verwenden Sie ER, um eine zweite Excel-Arbeitsmappe (Arbeitsmappe B) aus Finance zu erstellen, die die erforderlichen Details enthält.
  3. Verweisen Sie in Arbeitsmappe A auf Arbeitsmappe B, sobald Arbeitsmappe B erstellt wird.

• Deaktivieren Sie die Funktion Die Nutzung der EPPlus-Bibliothek im Rahmen der elektronische Berichterstellung aktivieren, um eine andere Option als EPPlus zu verwenden.

Zusätzliche Ressourcen

Überblick über die elektronische Berichterstellung

Eine Konfiguration zum Generieren von Berichten im OpenXML-Format entwerfen

Ändern von elektronisches Berichterstellungsformaten, indem Excel-Vorlagen erneut angewendet werden

Horizontal erweiterbare Bereiche zum dynamischen Hinzufügen von Spalten in Excel-Berichten verwenden

Einbetten von Bildern und Formen in generierten Dokumenten mithilfe von ER

Konfigurieren elektronischer Berichterstattung (EB), um Daten in Power BI einzubeziehen