Formeldesigner in der elektronischen Berichterstellung

In diesem Artikel wird beschrieben, wie den Formel-Designer in der elektronischen Berichterstattung (ER) verwendet wird. Wenn Sie ein Format für ein bestimmtes elektronisches Dokument in EB entwerfen, können Sie Formeln zum Transformieren von Daten verwenden, sodass sie den Anforderungen für die Dokumenterfüllung und Formatierung zu entsprechen. Diese Formeln ähneln Formeln in Microsoft Excel. Unterschiedliche Arten von Funktionen werden in den Formeln unterstützt: Text, Datum und Uhrzeit, Mathematisches, Logisches, Informationen, Datentypumrechnung und andere (domänenspezifische Funktionen des Unternehmens).

Formeldesignerübersicht

EB unterstützt den Formeldesigner. Daher können Sie zum Zeitpunkt des Entwurfs Ausdrücke konfigurieren, die für folgende Aufgaben zur Laufzeit verwendet werden können:

  • Transformieren Sie Daten, die aus einer Datenbank von Microsoft Dynamics 365 for Finance and Operations empfangen wurden, und in ein EB-Datenmodell eingegeben werden sollen, das als Datenquelle für EB-Formate entworfen wurde. (Diese Transformationen können beispielsweise Filterung, Gruppierung und Datentypkonvertierung umfassen.)
  • Formatieren Sie Daten, die an ein generierendes elektronisches Dokument in Übereinstimmung mit dem Layout und den Bedingungen eines spezifischen EB-Formats übermittelt werden müssen. (Die Formatierung kann beispielsweise in Übereinstimmung mit der angeforderten Sprache oder Kultur oder der Codierung erfolgen).
  • Steuern Sie den Prozess der Erstellung elektronischer Dokumente. (Die Ausdrücke können beispielsweise die Ausgabe bestimmter Elemente des Formats aktivieren oder deaktivieren, abhängig von der Verarbeitung von Daten. Sie können auch den Dokumenterstellungsprozess unterbrechen oder Nachrichten an Benutzer auslösen.)

Sie können die Seite Formeldesigner öffnen, wenn Sie irgendeine der folgenden Aktionen ausführen:

  • Binden von Datenquellenartikeln zu den Datenmodellkomponenten.
  • Binden von Datenquellenartikeln zu den Datenformatkomponenten.
  • Verwaltung von berechneten Feldern, die Teil von Datenquellen sind, abschließen.
  • Definition von Sichtbedingungen für Benutzereingabeparameter.
  • Entwurf der Umwandlungen des Formats.
  • Definition der Aktivierung von Bedingungen für die Komponenten des Formats.
  • Definition von Dateinamen für die DATEIkomponenten des Formats.
  • Definition der Bedingungen für Prozesssteuerprüfungen.
  • Definition der Nachrichtentextes für Prozesssteuerprüfungen.

Entwerfen der ER-Formeln

Datenbindung

Der EB-Formeldesigner kann verwendet werden, um einen Ausdruck zu definieren, der Daten transformiert, die von Datenquellen empfangen werden, sodass die Daten beim Datenkonsument zur Laufzeit eingegeben werden können:

  • Von Finance and Operations-Datenquellen und -Laufzeitparametern zu einem EB-Datenmodell
  • Von einem ER-Datenmodell zu einem ER-Format
  • Von Finance and Operations-Datenquellen und -Laufzeitparametern zu einem EB-Format

Die folgende Abbildung zeigt das Design eines Ausdrucks dieses Typs. In diesem Beispiel wird durch den Ausdruck der Wert des Felds Intrastat.AmountMST der Intrastat-Tabelle in Finance and Operations auf zwei Dezimalstellen gerundet und dann der gerundete Wert zurückgegeben.

Datenbindung

Die folgende Abbildung zeigt, wie ein Ausdruck dieses Typs verwendet werden kann. In diesem Beispiel wird das Ergebnis des entworfenen Ausdrucks in die Komponente Transaction.InvoicedAmount des Datenmodells Steuererklärungsmodell eingegeben.

Datenbindung, die verwendet wird

Zur Laufzeit rundet die entworfene Formel ROUND (Intrastat.AmountMST, 2) den Wert des Felds AmountMST für jeden Datensatz in der Intrastat-Tabelle auf zwei Dezimalstellen. Sie gibt dann den gerundeten Wert in der Komponente Transaction.InvoicedAmount des Datenmodells Steuererklärung ein.

Datenformatierung

Der ER-Formeldesigner kann verwendet werden, um einen Ausdruck zu definieren, der Daten umwandelt, die von den Datenquellen empfangen werden, sodass die Daten als Teil zum Erstellen eines elektronischen Dokuments gesendet werden können. Möglicherweise haben Sie Formatierung, die als eine typische Regel angewendet werden muss, die für ein Format erneut verwendet werden muss. In diesem Fall können Sie diese Formatierung einmal in der Formatkonfiguration einführen, als benannte Transformation, die einen Formatierungsausdruck hat. Diese benannte Transformation kann dann mit vielen Formatkomponenten verknüpft werden, wobei die Ausgabe gemäß dem Formatierungsausdruck formatiert werden muss, den Sie erstellt haben.

Die folgende Abbildung zeigt das Design einer Umwandlung dieses Typs. In diesem Beispiel kürzt die TrimmedString-Tansformation eingehende Daten des Datentyps Zeichenfolge, indem führende und nachfolgende Leerzeichen entfernt werden. Sie gibt dann einen gekürzten Zeichenfolgenwert zurück.

Umwandlung

Die folgende Abbildung zeigt, wie die Umwandlung dieses Typs verwendet werden kann. In diesem Beispiel senden mehrere Formatkomponenten Text als Ausgabe an das generierende elektronische Dokument zur Laufzeit. Alle diese Formatkomponenten verweisen auf die Transformation TrimmedString nach Name.

Transformation, die verwendet wird

Wenn Formatkomponenten, wie beispielsweise die Komponente partyName in der vorausgehenden Abbildung, auf die Transformation TrimmedString verweisen, übermittelt die Transformation Text als Ausgabe an das generierende elektronische Dokument. Dieser Text umfasst keine vor- und nachgestellten Leerzeichen.

Wenn Sie eine Formatierung haben, die einzeln angewendet werden muss, kann sie als einzelner Ausdruck der Bindung einer bestimmten Formatkomponente eingeführt werden. Die folgende Abbildung zeigt einen Ausdruck dieses Typs. In diesem Beispiel wird die Formatkomponente partyType an die Datenquelle über einen Ausdruck gebunden, der die eingehenden Daten aus dem Feld Model.Company.RegistrationType in der Datenquelle in Text in Großbuchstaben konvertiert. Der Ausdruck sendet dann diesen Text als Ausgabe an das elektronische Dokument.

Anwenden der Formatierung auf eine einzelne Komponente

Prozessflusssteuerung

Der EB-Formeldesigner kann verwendet werden, um Ausdrücke zu definieren, die den Prozessfluss zum Generieren elektronischer Dokumenten steuern. Die folgenden Aufgaben können ausgeführt werden:

  • Definiert Bedingungen, wenn ein Dokumentenerstellungsprozess gestoppt werden muss.
  • Geben Sie Ausdrücke an, die entweder Nachrichten für den Benutzer über beendete Prozess erstellen oder Ausführungsprotokollnachrichten zum fortlaufenden Prozess der Berichterstellung auslösen.
  • Geben Sie die Dateinamen zum Generieren elektronischer Dokumente an, und steuern Sie die Bedingungen ihrer Erstellung.

Jede Regel der Prozessflusssteuerung ist als einzelne Prüfung entworfen. Die folgende Abbildung zeigt die Überprüfung dieses Typs. Ist hier eine Erläuterung der Konfiguration in diesem Beispiel:

  • Die Überprüfung wird ausgewertet, wenn der INSTAT Knoten während der Generierung der XML-Datei erstellt wird.
  • Wenn die Transaktionsliste leer ist, stoppt die Überprüfung den Ausführungsprozess und gibt FALSCH zurück.
  • Die Überprüfung gibt eine Fehlermeldung zurück, der den Text der Beschriftung SYS70894 von Finance and Operations in der bevorzugten Sprache des Benutzers umfasst.

Validierung

Der EB-Formeldesigner wird auch verwendet, um einen Dateinamen für ein generierendes elektronisches Dokument zu generieren und den Dateierstellungsprozess zu steuern. Die folgende Abbildung zeigt das Design einer Prozessablaufsteuerung dieses Typs. Ist hier eine Erläuterung der Konfiguration in diesem Beispiel:

  • Die Liste der Datensätze aus der Datenquelle model.Intrastat wird in Chargen aufgeteilt. Jede Charge enthält bis zu 1.000 Datensätze.
  • Die Ausgabe erstellt eine ZIP-Datei, die eine Datei im XML-Format für jede Charge enthält, die erstellt wurde.
  • Ein Ausdruck gibt einen Dateinamen für das Generieren von elektronischen Dokumenten zurück, indem er den Dateinamen und die Dateinamenerweiterung verkettet. Für die zweite und alle nachfolgenden Chargen enthält der Dateiname die Chargenkennung als Suffix.
  • Ein Ausdruck aktiviert (durch Rückgabe von WAHR) den Dateierstellungsprozess für Chargen, die mindestens einen Datensatz beinhalten.

Dateisteuerelement

Grundlegende Syntax

Er-Ausdrücke können einzelne oder alle folgenden Elemente enthalten:

  • Konstanten
  • Operatoren
  • Verweise
  • Pfade
  • Funktionen

Konstanten

Wenn Sie Ausdrücke entwerfen, können Sie Text und numerische Konstanten (das heißt Werte, die nicht berechnet werden) verwenden. So verwendet beispielsweise der Ausdruck WERT ("100") + 20 die numerische Konstante 20 und die Zeichenfolgenkonstante "100", und gibt den numerischen Wert 120 zurück. Der EB-Formeldesigner unterstützt Escapesequenzen. Daher können Sie eine Ausdruckszeichenfolge angeben, die anders behandelt werden soll. Beispielsweise gibt der Ausdruck “Leo Tolstoi ""Krieg und Frieden"" Band 1 folgende Textzeichenfolge zurück Leo Tolstoi "Krieg und Frieden" Band 1.

Operatoren

Die folgende Tabelle zeigt die arithmetischen Operatoren, die Sie verwenden können, um grundlegende mathematische Arbeitsgänge auszuführen, wie Addition, Subtraktion, Multiplikation und Division.

Operator Dies bedeutet Beispiel
+ Hinzufügung 1+2
- Subtraktion, Negation 5-2, -1
* Multiplikation 7*8
/ Geschäftsbereich 9/3

In der folgenden Tabelle werden die Vergleichsoperatoren angezeigt, die unterstützt werden. Sie können diese Operatoren verwenden, um zwei Werte zu vergleichen.

Operator Dies bedeutet Beispiel
= Gleich X=Y
> Größer als X>Y
< Kleiner als X<Y
>= Größer oder gleich X>=Y
<= Kleiner oder gleich X<=Y
<> Ungleich X<>Y

Darüber hinaus können Sie auch ein kaufmännisches Und-Zeichen (&) als Textverkettungsoperator verwenden. Auf diese Weise können Sie eine oder mehrere Textzeichenfolgen zu einem einzigen Stück Text verbinden oder verketten.

Bediener Dies bedeutet Beispiel
& Verketten „Nichts zu drucken” & „: ” & „keine Datensätze gefunden”
Vorrangigkeit

Die Reihenfolge, in der die Teile eines zusammengesetzten Ausdrucks ausgewertet werden, ist wichtig. Beispielsweise variiert das Ergebnis des Ausdrucks 1 + 4 / 2, je nachdem, ob der Additionsvorgang oder der Divisionsvorgang zuerst erfolgt. Sie können Klammern verwenden, um explizit zu definieren, wie ein Ausdruck ausgewertet werden soll. Beispielsweise um anzugeben, dass die Addition zuerst ausgeführt werden soll, können Sie den vorhergehenden Ausdruck abändern auf (1 + 4) / 2. Wenn Sie die Reihenfolge der Vorgänge, die in einem Ausdruck ausgeführt werden müssen, nicht explizit angeben, basiert die Reihenfolge auf der standardmäßigen Prioritätsreihenfolge, die den unterstützten Operatoren zugewiesen ist. Die folgende Tabelle zeigt die Prioritätsreihenfolge an, die jedem Operator zugewiesen ist. Operatoren, die eine höhere Rangfolge haben, (beispielsweise 7), werden vor Operatoren ausgewertet, die eine niedrigere Rangfolge haben, (beispielsweise 1).

Priorität Operatoren Syntax
7 Gruppieren ( … )
6 Mitgliedszugriff … . …
5 Funktionsaufrufe … ( … )
4 Multiplikation … * …
… / …
3 Ergänzung … + …
… - …
2 Vergleich … < …
… <= …
… => …
… > …
… = …
… <> …
1 Trennung … , …

Wenn ein Ausdruck mehrere aufeinander folgende Operatoren enthält, die dieselbe Rangfolge haben, werden diese Arbeitsgänge von links nach rechts ausgewertet. Beispielsweise der Ausdruck 1 + 6 / 2 * 3 > 5 gibt WAHR zurück. Es wird empfohlen, dass Sie Klammern verwenden, um die gewünschte Reihenfolge der Arbeitsgänge für Ausdrucke explizit anzugeben, damit Ausdrücke besser lesbar und verwaltbar sind.

Verweise

Alle Datenquellen der aktuellen EB-Komponente, die während des Entwurfs eines Ausdrucks verfügbar sind, können als benannte Referenzen verwendet werden. (Die aktuellen EB-Komponente kann entweder ein Modells oder ein Format sein.) Zum Beispiel enthält das aktuelle EB-Datenmodell die Datenquelle ReportingDate, und diese Datenquelle gibt einen Wert des Datentyps DATETIME zurück. Um diesen Wert ordnungsgemäß zu formatieren, können Sie im generierenden Dokument auf die Datenquelle im Ausdruck als DATETIMEFORMAT (ReportingDate, "dd-MM-yyyy") verweisen.

Allen Zeichen im Namen einer verweisenden Datenquelle, die keinen Buchstaben des Alphabets darstellen, muss ein einfaches Anführungszeichen (') vorausgehen. Wenn der Name einer verweisenden Datenquelle, der mindestens ein Symbol enthält, das keinen Buchstaben des Alphabets darstellt, muss der Name in einfache Anführungszeichen gesetzt werden. (Diese nichtalphabetischen Symbole können Satzzeichen oder andere geschriebene Symbole sein.) Hier sind einige Beispiele:

  • Auf die Datenquelle Aktuelles Datum & Zeit muss in einem EB-Ausdruck als 'Heutiges Datum & Zeit’ verwiesen werden.
  • Auf die Methode name() der Datenquelle Kunden muss in einem EB-Ausdruck als Customers.'name()' verwiesen werden.

Wenn die Methoden von Finance and Operations-Datenquellen Parameter besitzen, wird der folgende Syntax verwendet, um diese Methoden aufzurufen:

  • Wenn die Methode isLanguageRTL der Datenquelle System einen Parameter EN-US des Datentyps Zeichenfolge hat, muss auf diese Methode in einem EB-Ausdruck als System.'isLanguageRTL'("EN-US") verwiesen werden.
  • Anführungszeichen sind nicht erforderlich, wenn ein Methodenname nur alphanumerische Symbole enthält. Sie sind jedoch für eine Methode einer Tabelle erforderlich, wenn der Name Klammern enthält.

Wenn die Datenquelle System einer EB-Zuordnung hinzugefügt wird, die auf die Finance and Operations-Anwendungsklasse Global verweist, gibt der Ausdruck den booleschen Wert FALSCH zurück. Der geänderte Ausdruck System.' isLanguageRTL'("AR") gibt den booleschen Wert WAHR zurück.

Sie können die Art und Weise eingrenzen, in der Werte an die Parameter dieses Methodentyps übergeben werden:

  • Nur Konstanten können an andere Methoden dieses Typs übergeben werden. Die Werte der Konstanten werden zur Entwurfszeit definiert.
  • Nur primitive (grundlegende) Datentypen werden für Parameter dieses Typs unterstützt. (Die primitiven Datentypen sind ganze Zahl, tatsächlich, boolesch, Zeichenfolge Zeichenfolge, usw.).

Pfade

Wenn ein Ausdruck auf eine strukturierte Datenquelle verweist, können Sie die Pfadbeschreibung verwenden, um ein bestimmtes primitives Element dieser Datenquelle auszuwählen. Ein Punktzeichen (. ) wird verwendet, um einzelne Elemente einer strukturierten Datenquelle zu unterteilen. Zum Beispiel enthält das aktuelle EB-Datenmodell die Datenquelle InvoiceTransactions, und diese Datenquelle gibt eine Liste von Datensätzen zurück. Die InvoiceTransactions-Datensatzstruktur enthält die Felder AmountDebit und AmountCredit, und diese beiden Felder geben numerische Werte zurück. Sie können daher den folgenden Ausdruck zum Berechnen des Rechnungsbetrag wie folgt konzipieren: InvoiceTransactions.AmountDebit - InvoiceTransactions.AmountCredit.

Funktionen

Im nächsten Abschnitt wird die Funktionen beschrieben, die in ER-Ausdrücken verwendet werden können. Alle Datenquellen des Ausdruckskontexts (das aktuelle EB-Datenmodell oder EB-Format) können als Parameter von aufrufenden Funktionen in Übereinstimmung mit der Liste von Argumenten zum Aufrufen von Funktionen verwendet werden. Konstanten können auch als Parameter aufrufender Funktionen verwendet werden. Zum Beispiel enthält das aktuelle EB-Datenmodell die Datenquelle InvoiceTransactions, und diese Datenquelle gibt eine Liste von Datensätzen zurück. Die InvoiceTransactions-Datensatzstruktur enthält die Felder AmountDebit und AmountCredit, und diese beiden Felder geben numerische Werte zurück. Um daher den Rechnungsbetrag zu berechnen, können Sie den folgenden Ausdruck entwerfen, der die integrierte EB-Rundungsfunktion verwendet: ROUND (InvoiceTransactions.AmountDebit - InvoiceTransactions.AmountCredit, 2).

Unterstützte Funktionen

Die folgenden Tabellen beschreiben die Datenmanipulationsfunktion, die Sie verwenden können, um ER-Datenmodelle und ER-Berichte zu entwerfen. Die Liste von Funktionen ist nicht unveränderlich festgelegt. Entwickler können sie erweitern. Um die Liste von Funktionen anzuzeigen, die Sie verwenden können, öffnen Sie den Funktionsbereich im EB-Formeldesigner zu.

Datums- und Zeitfunktionen

Funktion Beschreibung Beispiel
TAG HINZUFÜGEN (Datetime, Tage) Fügt die angegebene Anzahl von Tagen dem angegebenen Datum/Uhrzeit-Wert hinzu. TAGE HINZUFÜGEN (JETZT (), 7) gibt das Datum und die Uhrzeit sieben Tage in der Zukunft zurück.
DATETODATETIME (Datum) Konvertiert den angegebenen Datumswert in einen Datums-/Uhrzeitwert. DATETODATETIME (CompInfo. 'getCurrentDate() ') gibt das Datum der aktuellen Finance and Operations-Sitzung, 24. Dezember 2015, als 12/24/2015 12:00: 00 AM zurück. In diesem Beispiel ist CompInfo eine EB-Datenquelle des Typs Finance and Operations/Tabelle und bezieht sich auf die Tabelle „CompanyInfo”.
JETZT () Gibt das aktuelle Finance and Operations-Anwendungsserverdatum und -uhrzeit als ein Datums-/Uhrzeitwert zurück.
HEUTE () Gibt das aktuelle Finance and Operations-Anwendungs-Serverdatum und die Zeit als ein Datumswert zurück.
NULLDATE () Gibt einen Null-Datumswert zurück.
NULLDATETIME () Gibt einen Null-Datums-/Uhrzeitwert zurück.
DATETIMEFORMAT "datetime, Format) Konvertiert den angegebenen Datums-/Uhrzeitwert in eine Zeichenfolge im angegebenen Format. (Informationen zu unterstützten Formaten, finden Sie unter Standard und Benutzerdefiniert.) DATETIMEFORMAT (NOW(), "dd-MM-yyyy") gibt das laufende Finance and Operations-Anwendungsserverdatum, 24. Dezember 2015, als "24-12-2015" basierend auf dem angegebenen benutzerdefinierten Format zurück.
DATETIMEFORMAT "datetime, Format, Kultur) Konvertiert den angegebenen Datums-/Uhrzeitwert in eine Zeichenfolge im angegebenen Format und Kultur. (Informationen zu unterstützten Formaten, finden Sie unter Standard und Benutzerdefiniert). DATETIMEFORMAT (NOW(), "d", "de") gibt das aktuelle Finance and Operations Anwendungsserverdatum, 24. Dezember 2015, als "24.12.2015" basierend auf der ausgewählten deutschen Kultur zurück.
SESSIONTODAY () Gibt das aktuelle Finance and Operations-Sitzungsdatum als Datumswert zurück.
SESSIONNOW () Gibt das aktuelle Finance and Operations-Sitzungsdatum und -uhrzeit als ein Datums-/Uhrzeitwert zurück.
DATENFORMAT (Datum, Format) Gibt eine Zeichenfolgendarstellung des angegebenen Datums im angegebenen Format zurück. DATEFORMAT (SESSIONTODAY (), "dd-MM-yyyy") gibt das aktuelle Finance and Operations-Sitzungsdatum, 24. Dezember 2015, als "24-12-2015" basierend auf dem angegebenen benutzerdefinierten Format zurück.
DATENFORMAT (Datum, Format, Kultur) Konvertieren Sie den angegebenen Datumswert in eine Zeichenfolge im angegebenen Format und der entsprechenden Kultur. (Informationen zu unterstützten Formaten, finden Sie unter Standard und Benutzerdefiniert). DATETIMEFORMAT (SESSIONNOW (), "d", "de") gibt das aktuelle Finance and Operations-Sitzungsdatum, 24. Dezember 2015, als "24.12.2015" basierend auf der ausgewählten deutschen Kultur zurück.
DAYOFYEAR (Datum) Gibt eine ganzzahlige Darstellung der Anzahl von Tagen zwischen dem 1. Januar dem angegebenen Datum zurück. DAYOFYEAR (DATEVALUE ("01-03-2016", "dd-MM-yyyy")) gibt 61 zurück. DAYOFYEAR (DATEVALUE ("01-01-2016", "dd-MM-yyyy")) gibt 1 zurück.
DAYS (date 1, date 2) Gibt die Anzahl der Tage zwischen dem ersten angegebenen Datum und dem zweiten angegebenen Datum zurück. Gibt einen positiven Wert zurück, wenn das erste Datum nach dem zweiten Datum liegt, gibt 0 (null) zurück, wenn das erste Datum gleich dem zweiten Datum ist oder gibt anderenfalls einen negativen Wert zurück. DAYS (TODAY (), DATEVALUE( DATETIMEFORMAT( ADDDAYS(NOW(), 1), "yyyyMMdd"), "yyyyMMdd")) gibt -1 zurück.

Datenumwandlungsfunktionen

Funktion Beschreibung Beispiel
DATETODATETIME (Datum) Konvertiert den angegebenen Datumswert in einen Datums-/Uhrzeitwert. DATETODATETIME (CompInfo. 'getCurrentDate() ') gibt das Datum der aktuellen Finance and Operations-Sitzung, 24. Dezember 2015, als 12/24/2015 12:00: 00 AM zurück. In diesem Beispiel ist CompInfo eine EB-Datenquelle des Typs Finance and Operations/Tabelle und bezieht sich auf die Tabelle „CompanyInfo”.
DATEVALUE (Zeichenfolge, Format) Gibt eine Datumsdarstellung der angegebenen Zeichenfolge im angegebenen Format zurück. DATEVALUE ("21-Dez-2016", "dd-MMM-yyyy") gibt das Datum 21. Dezember 2016 basierend auf dem benutzerdefinierten Format und der EN-US-Kultur der Standardanwendung zurück.
DATEVALUE (Zeichenfolge, Format, Kultur) Gibt eine Datumsdarstellung der angegebenen Zeichenfolge im angegebenen Format und Kultur zurück. DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "IT") gibt das Datum 21. Januar 2016 basierend auf dem angegebenen benutzerdefinierten Format und Kultur zurück. Allerdings löst DATEVALUE ("21-Gen-2016", "dd-MMM-yyyy", "EN-US") eine Ausnahme aus, um den Benutzer zu informieren, dass die angegebene Zeichenfolge nicht als gültiges Datum anerkannt wird.
DATETIMEVALUE (Zeichenfolge, Format) Gibt eine Datums-/Uhrzeitdarstellung der angegebenen Zeichenfolge im angegebenen Format zurück. DATETIMEVALUE ("21-Dec-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss") gibt 02:55:00 Uhr am 21. Dezember 2016 zurück, basierend auf dem angegebenen benutzerdefinierten Format und der EN-US-Kultur der Standardanwendung.
DATETIMEVALUE (Zeichenfolge, Format, Kultur) Gibt eine Datums-/Uhrzeitdarstellung der angegebenen Zeichenfolge im angegebenen Format und Kultur zurück. DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "IT") gibt 02:55:00 Uhr am 21. Dezember 2016 zurück, basierend auf dem angegebenen benutzerdefinierten Format und Kultur. Allerdings löst DATETIMEVALUE ("21-Gen-2016 02:55:00", "dd-MMM-yyyy hh:mm:ss", "EN-US") eine Ausnahme aus, um den Benutzer zu informieren, dass die angegebene Zeichenfolge nicht als gültiges Datum/Uhrzeit anerkannt wird.

Listenfunktionen

Funktion Beschreibung Beispiel
TEILEN (Eingabe, Länge) Teilen Sie die angegebene Eingabezeichenfolge in Teilzeichenfolgen, von denen jede die angegebene Länge hat. Geben Sie das Ergebnis als neue Liste zurück. TEILEN ("abcd", 3) gibt eine neue Liste zurück, die aus zwei Datensätzen besteht, die ein Feld ZEICHENFOLGE haben. Das Feld im ersten Datensatz enthält den Text "ABC" und das Feld im zweiten Datensatz beinhaltet den Text "D".
TEILUNGSLISTE (Liste, Nummer) Teilt die angegebene Liste in Chargen, die jeweils die angegebene Anzahl von Datensätzen enthalten. Geben Sie das Ergebnis als neue Liste von Chargen zurück, die die folgenden Elemente enthält:
  • Chargen als regelmäßige Listen (Wert-Komponente)
  • Die aktuelle Chargennummer (Chargennummer-Komponente)
In der folgenden Abbildung wird eine Datenquelle Positionen als eine Datensatzliste von drei Datensätze erstellt. Diese Liste wird in Chargen aufgeteilt, die jeweils bis zu zwei Datensätze enthalten.

Data source that is divided into batches

Die folgende Abbildung zeigt das entworfene Formatlayout. In diesem Formatlayout werden die Bindungen an die Datenquelle Positionen erstellt, mit Ausgabe im XML-Format zu generieren. Dies Ausgabe präsentiert einzelne Knoten für jede Charge und die darin befindlichen Datensätze.

Format layout that has bindings to a data source

Die folgende Abbildung zeigt das Ergebnis, wenn das entworfene Format ausgeführt wird.

Result of running the format
LIST (record 1 [, record 2, …]) Gibt eine neue Liste zurück,, die von den angegebenen Argumenten erstellt wird. LISTE (model.MainData, model.OtherData) gibt einen leeren Datensatz zurück, in dem die Liste der Felder alle Felder der Hauptdaten und der Anderen Daten der Datensatzliste enthält.
LISTJOIN (list 1, list 2, …) Gibt eine neue Liste zurück, die von den angegebenen Argumenten erstellt wird. LISTJOIN (SPLIT ("abc", 1), SPLIT ("def", 1)) gibt eine Liste von sechs Datensätzen zurück, in der ein Feld des Datentyps ZEICHENFOLGE einzelne Buchstaben enthält.
ISEMPTY (Liste) Gibt WAHR zurück, wenn die angegebene Liste keine Elemente enthält. Andernfalls wird FALSCH zurückgegeben.
EMPTYLIST (Liste) Gibt eine leere Liste zurück, indem die angegebene Liste wie eine Quelle für die Listenstruktur verwendet wird. EMPTYLIST (SPLIT ("abc", 1)) gibt eine neue leere Liste zurück, die dieselbe Struktur wie die Liste hat, die durch Funktion TEILEN zurückgegeben wird.
ZUERST (Liste) Gibt den ersten Datensatz der angegebenen Liste zurück, wenn dieser Datensatz nicht leer ist. Andernfalls ergibt sich eine Ausnahme.
FIRSTORNULL (Liste) Gibt den ersten Datensatz der angegebenen Liste zurück, wenn dieser Datensatz nicht leer ist. Andernfalls wird ein NULL Datensatz zurückgegeben.
LISTOFFIRSTITEM (Liste) Gibt eine Liste zurück, die nur das erste Element der gegebenen Liste enthält.
ALLITEMS (Pfad) Gibt eine neue vereinfachte Liste zurück, die alle Elemente darstellt, die mit dem angegebenen Pfad übereinstimmen. Der Pfad muss als gültiger Datenquellenpfad eines Datenquellenelements eines Datensatzlisten-Datentyps definiert werden. Datenelemente, wie beispielsweise die Pfadzeichenfolge und Datum, sollten ein Fehler im EB-Ausdrucksgenerator zur Entwurfszeit erzeugen. Wenn Sie TEILEN ("abcdef", 2) als Datenquelle (DS) eingeben, wird ANZAHL (ALLITEMS (DS.Value)) zurückgegeben 3.
ORDERBY (Liste [, Ausdruck 1, Ausdruck 2,...]) Geben Sie die angegebenen Liste zurück, nachdem sie gemäß der angegebenen Argumente sortiert wurde. Diese Argumente können als Ausdrücke definiert werden. Wenn Lieferant als EB-Datenquelle konfiguriert wurde, die sich auf die Tabelle „VendTable” bezieht, gibt ORDERBY (Vendors, Vendors.'name()') eine Liste von Lieferanten zurück, die nach Name in aufsteigender Reihenfolge sortiert ist.
UMKEHREN (Liste) Gibt die angegebene Liste in umgekehrter Sortierreihenfolge zurück. Wenn Lieferant als EB-Datenquelle konfiguriert wurde, die sich auf die Tabelle „VendTable” bezieht, gibt REVERSE (ORDERBY (Vendors, Vendors.'name()')) ) eine Liste von Kreditoren zurück, die nach Namen in absteigender Reihenfolge sortiert ist.
WO (Liste, Bedingung) Gibt die angegebene Liste zurück, nachdem sie gemäß der angegebenen Bedingung gefiltert wurde. Die angegebene Bedingung wird auf die Liste im Arbeitsspeicher angewendet. Hierin unterscheidet sich die Funktion WO von der Funktion FILTER. Wenn Lieferant als EB-Datenquelle konfiguriert wurde, die sich auf die Tabelle „VendTable” bezieht, gibt WHERE(Vendors, Vendors.VendGroup = "40") eine Liste von ausschließlich den Lieferanten zurück, die zur Lieferantengruppe 40 gehören.
Aufzählung (LISTE) Gibt eine neue Liste zurück, die aus aufgezählten Datensätzen der angegebenen Liste besteht und die folgende Elemente verfügbar macht:
  • Angegebene Listendatensätze als regelmäßige Listen (Wert-Komponente)
  • Der Index des aktuellen Datensatzes (Nummer-Komponente)
In der folgenden Abbildung wird eine Datenquelle Aufgezählt als Aufzählungsliste von Lieferantendatensätzen von der Datenquelle Lieferanten erstellt, die sich auf die Tabelle „VendTable” bezieht.

Enumerated data source

Die folgende Abbildung zeigt das Format. In diesem Format werden Datenbindungen erstellt, um eine Ausgabe im XML-Format zu generieren. In dieser Ausgabe werden einzelne Lieferanten als aufgezählte Knoten präsentiert.

Format that has data bindings

Die folgende Abbildung zeigt das Ergebnis, wenn das entworfene Format ausgeführt wird.

Result of running the format
ZÄHLEN (Liste) Gibt die erste Zahl des Datensatzes der angegebenen Liste zurück, wenn dieser Datensatz nicht leer ist. Andernfalls wird 0 (Null) zurückgegeben. ANZAHL (TEILEN ("abcd", 3)) gibt 2 zurück, da die Funktion TEILEN eine Liste erstellt, die aus zwei Datensätzen besteht.
LISTOFFIELDS (Pfad) Gibt eine Datensatzliste zurück, die von einem Argument von einem der folgenden Typen erstellt wird:
  • Modellenumeration
  • Formatenumeration
  • Behälter

Die Liste, die erstellt wird, besteht aus Datensätzen, die die folgenden Felder haben:

  • Name
  • Beschriftung
  • Beschreibung
Zur Laufzeit geben die Felder Beschriftung und Beschreibung Werte basierend auf den Spracheinstellungen des Formats zurück.
In der folgenden Abbildung wird eine Aufzählung in einem Datenmodell vorgestellt.

Enumeration in a model

Die folgende Abbildung zeigt diese Details an:

  • Die Modellaufzählung ist eingefügt in einen Bericht als Datenquelle.
  • Ein EB-Ausdruck verwendet die Modellaufzählung als Parameter der Funktion LISTOFFIELDS.
  • Eine Datenquelle des Datensatzlistentyp wird in einen Bericht eingefügt mithilfe des EB-Ausdrucks, der erstellt wird.

Format

Das folgende Beispiel zeigt die EB-Formatelemente, die an die Datenquelle des Datensatzlistentyps gebunden sind, der mithilfe der Funktion LISTOFFIELDS erstellt wurde.

Format design

Die folgende Abbildung zeigt das Ergebnis, wenn das entworfene Format ausgeführt wird.

Format output

[!NOTE]
Basierend auf den Spracheinstellungen des Formats von übergeordneten DATEI- und ORDNER-Elementen, wird übersetzter Text für Beschriftungen und Beschreibungen in der Ausgabe des EB-Formats eingegeben.
LISTOFFIELDS (path, language) Gibt eine Datensatzliste zurück, die aus einem Argument erstellt wurde, wie beispielsweise eine Modellaufzählung, eine Formataufzählung oder ein Container. Die Liste, die erstellt wird, besteht aus Datensätzen, die die folgenden Felder haben:
  • Name
  • Beschriftung
  • Beschreibung
  • IstÜbersetzt

Zur Laufzeit geben die Felder Beschriftung und Beschreibung Werte basierend auf den Spracheinstellungen des Formats und der angegebenen Sprache zurück. Das Feld Wurde übersetzt gibt an, dass das Feld Beschriftung in die angegebene Sprache übersetzt wurde.

Beispielsweise verwenden Sie den Datenquellentyp Berechnetes Feld, um die Datenquellen enumType_de und enumType_deCH für die Datenmodellaufzählung enumType zu konfigurieren:
  • enumType_de = LISTOFFIELDS (enumType, "de")
  • enumType_deCH = LISTOFFIELDS (enumType, "de-CH")
In diesem Fall können Sie den folgenden Ausdruck verwenden, um die Beschriftung des Aufzählungswerts in Schweizer Deutsch abzurufen, wenn diese Übersetzung verfügbar ist. Wenn die Schweizerdeutsche Übersetzung nicht verfügbar ist, ist diese Beschriftung auf Deutsch: IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label).
STRINGJOIN (Liste, Feldname, Trennzeichen) Gibt eine Zeichenfolge zurück, die aus verketteten Werten des angegebenen Felds aus der angegebenen Liste besteht. Die Werte sind durch das angegebene Trennzeichen getrennt. Wenn Sie SPLIT("abc" , 1) als Datenquelle eingeben, gibt der Ausdruck STRINGJOIN (DS, DS.Value, ":") den Wert "a🅱️c" zurück.
SPLITLISTBYLIMIT (Liste, Grenzwert, Grenzquelle) Teilt die angegebene Liste in eine neue Liste von Unterlisten und gibt das Ergebnis im Datensatz-Listeninhalt zurück. Der Begrenzungswertparameter definiert den Wert der Begrenzung für die Teilung der ursprünglichen Liste. Der Begrenzungsquellparameter gibt den Schritt an, in dem die Gesamtsumme erhöht wird. Die Begrenzung wird auf keinen einzelnen Artikel der ursprünglichen Liste angewendet, wenn die Begrenzungsquelle die definierte Begrenzung überschreitet. Die folgenden Abbildungen zeigen ein Format und die Datenquellen an, die dafür verwendet werden.

Format

Data sources

Die folgende Abbildung zeigt das Ergebnis an, wenn Format ausgeführt wird. In diesem Fall ist die Ausgabeliste eine flache Liste von Warenartikeln.

Output

In den folgenden Abbildungen ist dasselbe Format so angepasst worden, dass es die Liste der Warenpositionen in Chargen präsentiert, wenn eine einzelne Charge Waren enthalten muss und das Gesamtgewicht nicht die Begrenzung von 9 überschreiten sollte.

Adjusted format

Data sources for the adjusted format

Die folgende Abbildung zeigt das Ergebnis, wenn das angepasste Format ausgeführt wird.

Output of the adjusted format

[!NOTE]
Die Begrenzung wird nicht auf den letzten Artikel der ursprünglichen Liste angewendet, weil der Wert (11) der Begrenzungsquelle (Gewicht) die definierte Begrenzung (9) überschreitet. Verwenden Sie entweder die Funktion WO oder den Ausdruck Aktiviert des entsprechenden Formatelements, um Unterlisten während der Berichtgenerierung, nach Bedarf, zu ignorieren (zu überspringen).
FILTER (Liste, Bedingungen) Gibt die angegebene Liste zurück, nachdem die Abfrage geändert wurde, um nach der angegebenen Bedingung zu filtern. Diese Funktion unterscheidet sich von der Funktion WO, da die angegebene Bedingung auf jede beliebige EB-Datenquelle des Typs Tabellendatensätze auf Datenbankebene angewendet wird. Die Liste und die Bedingung können definiert werden, indem Tabellen und Relationen verwendet werden. Wenn Lieferant als EB-Datenquelle konfiguriert wurde, die sich auf die Tabelle „VendTable” bezieht, gibt FILTER (Vendors, Vendors.VendGroup = "40") eine Liste von ausschließlich den Lieferanten zurück, die zur Lieferantengruppe 40 gehören. Wenn Lieferant als eine EB-Datenquelle konfiguriert ist, die sich auf die Tabelle VendTable bezieht und die parmVendorBankGroup, die als EB-Datenquelle konfiguriert ist, den Wert im Zeichenfolgendatentyp zurückgibt, gibt FILTER (Vendor.'<Relations'.VendBankAccount, Vendor.'<Relations'.VendBankAccount.BankGroupID = parmVendorBankGroup) eine Liste von ausschließlich den Lieferantenkonten zurück, die zu einer bestimmten Bankgruppe gehören.

Logische Funktionen

Funktion Beschreibung Beispiel
CASE (expression, option 1, result 1 [, option 2, result 2] … [, default result]) Auswerten des angegebenen Ausdruckswert anhand der angegebenen alternativen Optionen. Gibt das Ergebnis der Option zurück, die gleich dem Wert des Ausdrucks ist. Andernfalls wird das optionale Standardergebnis zurückgegeben, wenn ein Standardergebnis angegeben ist. (Das Standardergebnis ist der letzte Parameter, dem keine Option vorangestellt ist). FALL (DATETIMEFORMAT (NOW (), "MM"), "10 ", "WINTER", "11 ", "WINTER", "12 ", "WINTER", "") gibt die Zeichenfolge zurück "WINTER", wenn das aktuelle Finance and Operations-Sitzungsdatum zwischen Oktober und Dezember ist. Andernfalls wird eine leere Zeichenfolge zurückgegeben.
WENN (Bedingung, Wert 1, Wert 2) Gibt den ersten angegebenen Wert zurück, wenn die angegebene Bedingung zutrifft. Gibt anderenfalls den zweiten angegebenen Wert zurück. Wenn Wert 1 und Wert 2 Datensätze oder Datensatzlisten sind, hat das Ergebnis nur die Felder, die in beiden Listen vorhanden sind. WENN (1=2, "Bedingung erfüllt", "Bedingung erfüllt wird nicht erfüllt)" gibt die Zeichenfolge "Bedingung wird nicht erfüllt zurück.
NICHT (Bedingung) Geben Sie den umgekehrten logischen Wert der angegebenen Bedingung zurück. NICHT (WAHR=) gibt FALSCH zurück.
AND (condition 1[, condition 2, …]) Gibt WAHR zurück, wenn alle angegebenen Bedingungen erfüllt sind. Andernfalls wird FALSCH zurückgegeben. UND (1=1, "a " = "a") gibt WAHR zurück. UND (1=2, "a " = "a") gibt FALSCH zurück.
OR (condition 1[, condition 2, …]) Gibt FALSCH zurück, wenn alle angegebenen Bedingungen falsch sind. Gibt WAHR zurück, wenn eine angegebenen Bedingungen erfüllt ist. ODER (1=2, "a " = "a") gibt WAHR zurück.

Rechenoperationen

Funktion Beschreibung Beispiel
ABS (Nummer) Gibt den absoluten Wert der angegebenen Zahl zurück. (In anderen Worten gibt sie die Zahl ohne des Vorzeichens zurück). ABS (-1) gibt 1 zurück.
LEISTUNG (Zahl, Leistung) Gibt das Ergebnis der angehobenen spezifischen positiven Zahl der angegebenen Leistung zurück. LEISTUNG (10, 2) gibt 100 zurück.
ZAHLENWERT (Zeichenfolge, Dezimaltrennzeichen, Zifferngruppierungstrennzeichen) Konvertiert die angegebene Zeichenfolge zu einer Nummer. Das angegebene Dezimaltrennzeichen wird zwischen der ganzen Zahl und den Bruchteilen einer Dezimalzahl verwendet. Das angegebene Zifferngruppierungstrennzeichen wird als Tausendertrennzeichen verwendet. ZAHLENWERT ("1234,56 ", ",", " ") gibt den Wert 1234.56 zurück.
WERT (Zeichenfolge) Konvertiert die angegebene Zeichenfolge zu einer Nummer. Kommas und Punktzeichen (.) gelten als Dezimaltrennzeichen und es wird ein führender Bindestrich (-) als ein negatives Vorzeichen verwendet. Löst eine Ausnahme aus, wenn die angegebene Zeichenfolge andere nichtnumerische Zeichen enthält. WERT ("1 "234,56 ") löst eine Ausnahme aus.
RUNDEN (Zahl, Dezimalen) Gibt die angegebene Zahl zurück, nachdem sie auf die angegebene Zahl von Dezimalstellen gerundet wurde:
  • Wenn der Wert des Dezimalstellenparameters größer als 0 (null) ist, wird die angegebene Zahl auf genau so viele Dezimalstellen gerundet.
  • Wenn der Wert des Dezimalstellenparameters 0 (null) ist, wird die angegebene Zahl auf die nächste ganze Zahl gerundet.
  • Wenn der Wert des Dezimalstellenparameters kleiner als 0 (null) ist, wir die angegebene Zahl links der Dezimalstelle gerundet.
RUNDUNG (1200.767, 2) Rundet auf zwei Dezimalstellen und gibt den Wert 1200.77 zurück.. RUNDUNG (1200.767, -3) Rundet auf das nächste Vielfache von 1,000 und gibt den Wert 1000 zurück.
ABRUNDEN (Zahl, Dezimalen) Gibt die angegebene Zahl zurück, nachdem sie auf die angegebene Zahl von Dezimalstellen abgerundet wurde.
[!NOTE]
Diese Funktion verhält sich wie RUNDUNG, rundet die angegebene Zahl aber immer ab (in Richtung null).
ABRUNDUNG (1200.767, 2) Rundet auf zwei Dezimalstellen ab und gibt den Wert 1200.76 zurück. ABRUNDUNG (1700.767, -3) Rundet auf das nächste Vielfache von 1,000 ab und gibt den Wert 1000 zurück.
AUFRUNDEN (Zahl, Dezimalen) Gibt die angegebene Zahl zurück, nachdem sie auf die angegebene Zahl von Dezimalstellen aufgerundet wurde.
[!NOTE]
Diese Funktion verhält sich wie RUNDUNG, rundet die angegebene Zahl aber immer auf (weg von null).
AUFRUNDUNG (1200.763, 2) Rundet auf zwei Dezimalstellen auf und gibt den Wert 1200.77 zurück. -AUFRUNDUNG (1200.767, -3) Rundet auf das nächste Vielfache von 1,000 auf und gibt den Wert 2000 zurück.

Datenumwandlungsfunktionen

Funktion Beschreibung Beispiel
WERT (Zeichenfolge) Konvertiert die angegebene Zeichenfolge zu einer Nummer. Kommas und Punktzeichen (.) gelten als Dezimaltrennzeichen und es wird ein führender Bindestrich (-) als ein negatives Vorzeichen verwendet. Löst eine Ausnahme aus, wenn die angegebene Zeichenfolge andere nichtnumerische Zeichen enthält. WERT ("1 "234,56 ") löst eine Ausnahme aus.
ZAHLENWERT (Zeichenfolge, Dezimaltrennzeichen, Zifferngruppierungstrennzeichen) Konvertiert die angegebene Zeichenfolge zu einer Nummer. Das angegebene Dezimaltrennzeichen wird zwischen der ganzen Zahl und den Bruchteilen einer Dezimalzahl verwendet. Das angegebene Zifferngruppierungstrennzeichen wird als Tausendertrennzeichen verwendet. NUMBERVALUE("1 234,56", ",", " ") gibt 1234.56 zurück.
INTVALUE (Zeichenfolge) Gibt eine Darstellung der angegebenen Zeichenfolge in ganzen Zahlen zurück. Sämtliche Dezimalstellen werden abgeschnitten. INTVALUE ("100.77") gibt 100 zurück.
INTVALUE (Zahl) Gibt eine Darstellung der angegebenen Zahl als ganze Zahl zurück. Sämtliche Dezimalstellen werden abgeschnitten. INTVALUE (-100,77) gibt -100 zurück.
INT64VALUE (Zeichenfolge) Gibt eine int64-Darstellung der angegebenen Zeichenfolge zurück. Sämtliche Dezimalstellen werden abgeschnitten. INT64VALUE ("22565422744") gibt 22565422744 zurück.
INT64VALUE (Nummer) Gibt eine int64-Darstellung der angegebenen Zahl zurück. Sämtliche Dezimalstellen werden abgeschnitten. INT64VALUE (22565422744.00) gibt 22565422744 zurück.

Datensatzfunktionen

Funktion Beschreibung Beispiel
NULLCONTAINER (Liste) Gibt einen NULL-Datensatz zurück, der die gleiche Struktur beinhaltet, wie die angegebene Datensatzliste oder Datensatz.
[!NOTE]
Diese Funktion ist veraltet. Verwenden Sie stattdessen EMPTYRECORD.
NULLCONTAINER (TEILEN ("abc", 1)) gibt einen neuen leeren Datensatz zurück, der dieselbe Struktur wie die Liste beinhaltet, die durch Funktion TEILEN zurückgegeben wird.
LEERER DATENSATZLIST (Datensatz) Gibt einen NULL-Datensatz zurück, der die gleiche Struktur beinhaltet, wie die angegebene Datensatzliste oder Datensatz.
[!NOTE]
Ein Datensatz NULL ist ein Datensatz, in dem alle Felder einen leeren Wert haben. Ein leerer Wert ist 0 (null) für Zahlen, eine leere Zeichenfolge für Zeichenfolgen usw.
LEERER DATENSATZ (TEILEN ("abc", 1)) gibt einen neuen leeren Datensatz zurück, der dieselbe Struktur wie die Liste beinhaltet, die durch Funktion TEILEN zurückgegeben wird.

Textfunktionen

Funktion Beschreibung Beispiel
GROSSBUCHSTABE (Zeichenfolge) Gibt die angegebene Zeichenfolge zurück, nachdem sie in Großbuchstaben konvertiert wurde. GROSSBUCHSTABE ("Beispiel") gibt "BEISPIEL" zurück.
KLEINBUCHSTABEN (Zeichenfolge) Gibt die angegebene Zeichenfolge zurück, nachdem sie in Kleinbuchstaben konvertiert wurde. KLEINBUCHSTABEN ("Beispiel") gibt "Beispiel" zurück.
LINKS (Zeichenfolge, Anzahl Zeichen) Gibt die angegebene Anzahl von Zeichen ab Beginn einer Textzeichenfolge zurück. LINKS ("Beispiel", 3) gibt "Sam" zurück.
RECHTs (Zeichenfolge, Anzahl Zeichen) Gibt die angegebene Anzahl von Zeichen ab Ende einer bestimmten Textzeichenfolge zurück. RECHTS ("Beispiel", 3) gibt "ple" zurück.
MITTE (Zeichenfolge, Startposition, Anzahl Zeichen) Gibt die angegebene Anzahl von Zeichen ab Beginn einer Textzeichenfolge zurück. MITTE ("Beispiel", 2, 3) gibt "amp" zurück.
LEN (Zeichenfolge) Gibt die Anzahl von Zeichen in einer Textzeichenfolge zurück. LEN ("Beispiel") gibt 6 zurück.
CHAR (Nummer) Gibt die Zeichenfolge von Zeichen zurück, die von der angegebene Unicode-Zahl angegeben wird. CHAR (255) gibt "Ÿ" zurück.
[!NOTE]
Die Zeichenfolge, die diese Funktion zurück gibt, hängt von der Codierung ab, die im übergeordneten DATEI-Formatelement ausgewählt ist. Die Liste unterstützter Codierungen finden Sie unter Codierungsklasse.
VERKETTEN (Zeichenfolge 1, [, Zeichenfolge 2, ...]) Gibt alle angegebenen Textzeichenfolgen zurück, nachdem sie zu einer Zeichenfolge verknüpft wurden. VERKETTEN ("ABC", "def") gibt "abcdef" zurück.
[!NOTE]
Der Ausdruck "abc" & "def" gibt auch "abcdef" zurück.
ÜBERSETZEN (Zeichenfolge, Muster, Ersetzung) Gibt die angegebene Zeichenfolge zurück, nachdem alle Vorkommen der Zeichen in der angegebenen Musterzeichenfolge durch die Zeichen in der entsprechenden Position in der angegebenen Austauschzeichenfolge ersetzt wurden. ÜBERSETZEN ("abcdef", "cd", "GH") ersetzt das Muster "cd" durch die Zeichenfolge "GH" und gibt "abGHef" zurück.
ERSETZEN (Zeichenfolge, Muster, Ersetzung, Markierung des regulären Ausdrucks) Wenn die angegebene Markierung des regulären Ausdrucks wahr ist, wird die angegebene Zeichenfolge zurückgegeben, nachdem sie durch Anwendung des normalen Ausdruck geändert wurde, der als ein Musterargument für diese Funktion angegeben ist. Dieser Ausdruck wird verwendet, um Zeichen zu finden, die ersetzt werden müssen. Zeichen des angegebenen Ersetzungsarguments werden verwendet, um Zeichen zu ersetzen, die gefunden werden. Wenn die angegebene Markierung des regulären Ausdrucks falsch ist, verhält sich diese Funktion wie ÜBERSETZEN. ERSETZEN ("+1 923 456 4971", "[^0-9]", "", true) übernimmt einen regulären Ausdruck, der alle nicht numerischen Symbole entfernt und "19234564971" zurückgibt. ERSETZEN ("abcdef", "cd", "GH", false) ersetzt das Muster "cd" mit der Zeichenfolge "GH" und gibt "abGHef" zurück.
TEXT (Eingabe) Gibt die angegebene Eingabe zurück, nachdem sie in eine Textzeichenfolge konvertiert wurde, die gemäß den Servergebietsschemaeinstellungen der aktuellen Finance and Operations-Instanz formatiert ist. Für Werte für den tatsächlich Typ, wird die Zeichenkonvertierung auf zwei Dezimalstellen beschränkt. Wenn das Servergebietsschema der Finance and Operations-Instanz als EN-US, TEXT (NOW ()) definiert wird, wird das aktuelle Finance and Operations-Sitzungsdatum, 17. Dezember 2015, als Textzeichenfolge "12/17/2015 07:59:23 AM" zurückgegeben. TEXT (1/3) gibt "0.33" zurück.
FORMAT (string 1, string 2[, string 3, …]) Geben Sie die angegebene Zeichenfolge zurück, nachdem sie formatiert wurde, indem sämtliche Vorkommnisse von %N durch das n. Argument ersetzt werden. Die Argumente sind Zeichenfolgen. Wenn eine Anfrage nicht für einen Parameter angegeben wird, wird der Parameter als "%N" in der Zeichenfolge zurückgegeben. Für Werte für den tatsächlich Typ, wird die Zeichenkonvertierung auf zwei Dezimalstellen beschränkt. In der folgenden Abbildung gibt die Datenquelle PaymentModel die Liste von Kundendatensätzen über die Komponente -Kunde und den Verarbeitungsdatumswert über das Feld ProcessingDate zurück.

PaymentModel data source

Im ER-Format, das entworfen wurde, um eine Datei für ausgewählte Debitoren zu generieren, wird PaymentModel als Datenquelle ausgewählt, um den Prozessablauf zu steuern. Eine Ausnahme wird ausgelöst, um den Benutzer zu informieren, wann ein Kunde für das Datum angehalten wird, an dem der Bericht verarbeitet wird. Die Formel, die für diese Art von Prozesssteuerung entworfen wurde, kann die folgenden Ressourcen verwenden:

  • Finance and Operations-Beschriftung SYS70894, die den folgenden Text hat:
    • Für die EN-US-Sprache: "Nichts zu drucken"
    • Für deutsche Sprache: "Nichts zu drucken"
  • Finance and Operations-Beschriftung SYS18389, die den folgenden Text hat:
    • Für die EN-US-Sprache: "Debitor %1 wird beendet für %2."
    • Für deutsche Sprache: "Debitor "%1 "wird für %2 gesperrt."

Hier die Formel, die gestaltet werden kann:

FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d"))

Wenn ein Bericht für den Kunden Litware Retail am 17. Dezember 2015 in der EN-US-Kultur und in der EN-US-Sprache verarbeitet wird, gibt diese Formel den folgenden Text zurück, der als Ausnahmenachricht für den Benutzer präsentiert werden kann:

"Nichts zu drucken. Debitor Litware Retail wird auf 12/17/2015" beendet.

Wenn derselbe Bericht für den Kunden Litware Retail am 17. Dezember 2015 in der DE-Kultur und in der DE-Sprache verarbeitet wird, gibt diese Formel den folgenden Text zurück, der ein anderes Datumsformat verwendet:

"Nichts-zu drucken. Schuldner-"Litware Einzelhandel" wird für 17.12.2015 gesperrt."

[!NOTE]
Die folgende Syntax wird in EB-Formeln für Beschriftungen angewendet:
  • Für Beschriftungen aus Finance and Operations-Ressourcen: @"X", wobei X die Beschriftungs-ID im Application Object Tree (AOT) ist
  • Für Beschriftungen, die sich in ER-Konfigurationen befinden: @"GER_LABEL:X", wobei X die Beschriftungs-ID in der ER-Konfiguration ist
ZAHLENFORMAT (Zahl, Format) Gibt eine Zeichenfolgendarstellung der angegebenen Zahl im angegebenen Format zurück. (Informationen zum die unterstützten Formaten, finden Sie unter Standard und Custom.) Im Kontext, dass diese Funktion ausgeführt wird, bestimmt die Kultur, die den Formatnummern verwendet wird. Für EN-US Kultur ZAHLENFORMAT (0.45, "p") gibt "45,00 %" zurück. ZAHLENFORMAT (10,45, "#") gibt "10" zurück.
NUMERALSTOTEXT (Nummer, Sprache, Währung, Drucktwährungsnamenmarkierung, Dezimaltrennzeichen) Gibt die angegebene Zahl zurück, nachdem sie in Textzeichenfolgen in der angegebenen Sprache formuliert (konvertiert) wurde. Der Sprachcode ist optional. Wenn er als leere Zeichenfolge definiert ist, wird stattdessen der Sprachcode für den ausgeführten Kontext verwendet. (Der ausgeführte Kontextsprachcode wird für einen generierenden Ordner oder Datei definiert.) Der Währungscode ist auch optional. Wenn dieser als leere Zeichenfolge definiert ist, wird die Unternehmenswährung verwendet.
[!NOTE]
Die Parameter für Druckwährungsnamen-Kennzeichen und Dezimalstellen werden nur für die folgenden Sprachcodes analysiert: CS, ET, HU, LT, LV, PL und RU. Darüber hinaus wird der Druckwährungsnamen-Kennzeichenparameter nur für Finance and Operations-Unternehmen analysiert, bei denen der Landes- oder Regionenkontext die Deklinierung von Währungsnamen unterstützt.
NUMERALSTOTEXT (1234.56, "EN", "", false, 2) gibt "Eintausendzweihundertvierunddreißig und 56" zurück. NUMERALSTOTEXT (120, "PL", "", false, 0) gibt "Sto dwadzieścia" zurück. NUMERALSTOTEXT (120.21, "RU", "EUR", true, 2) gibt "Сто двадцать евро 21 евроцент" zurück.
PADLEFT (Zeichenfolge, Länge, Zeichen auffüllen) Gibt eine Zeichenfolge mit der angegebenen Länge zurück, bei der der Anfang der angegebenen Zeichenfolge mit den angegebenen Zeichen aufgefüllt ist. PADLEFT ("1234", 10, " ") gibt die Textzeichenfolge "      1234" zurück.
TRIM (Zeichenfolge) Gibt die angegebene Textzeichenfolge zurück, nachdem führende und nachfolgende Leerzeichen abgeschnitten wurden und nachdem mehrfache Leerzeichen zwischen Wörtern entfernt wurden. TRIM ("     Sample     text     ") gibt "Beispieltext" zurück.
GETENUMVALUEBYNAME (Enumerationsdatenquellenpfad, Enumerationswertbeschriftungstext) Gibt einen Wert der angegebenen Aufzählungsdatenquelle basierend auf dem angegebenen Text und der Aufzählungsbeschriftung zurück. In der folgenden Abbildung wird die Aufzählung ReportDirection in einem Datenmodell eingeführt. Beachten Sie, dass Beschriftungen für Enumerationswerte definiert werden.

Available values for data model enumeration

Die folgende Abbildung zeigt diese Details an:

  • Die Modellaufzählung ReportDirection wird in einen Bericht als Datenquelle eingefügt, $Direction.
  • Ein EB-Ausdruck $IsArrivals ist dazu konzipiert, die Modellaufzählung als Parameter dieser Funktion zu verwenden. Der Wert dieses Ausdrucks ist WAHR
Example of data model enumeration

Datenumwandlungsfunktionen

Funktion Beschreibung Beispiel
TEXT (Eingabe) Gibt die angegebene Eingabe zurück, nachdem sie in eine Textzeichenfolge konvertiert wurde, die gemäß den Servergebietsschemaeinstellungen der aktuellen Finance and Operations-Instanz formatiert ist. Für Werte für den tatsächlich Typ, wird die Zeichenkonvertierung auf zwei Dezimalstellen beschränkt. Wenn das Servergebietsschema der Finance and Operations-Instanz als EN-US definiert ist, gibt TEXT (NOW ()) das aktuelle Finance and Operations-Sitzungsdatum, 17. Dezember 2015, als die Textzeichenfolge "12/17/2015 07:59:23 AM" zurück. TEXT (1/3) gibt "0.33" zurück.
QRCODE (Zeichenfolge) Gibt ein QR-Codebild im base64-Binärformat für die angegebene Zeichenfolge zurück. QRCODE ("Beispieltext") gibt U2FtcGxlIHRleHQ= zurück.

Datensammlungsfunktionen

Funktion Beschreibung Beispiel
FORMATELEMENTNAME () Gibt den Namen des Elements des aktuellen Formats zurück. Gibt eine leere Zeichenfolge zurück, wenn das Kennzeichen Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist. Um mehr darüber zu erfahren, wie diese Funktion verwendet wird, finden Sie Informationen im Aufgabenleitfaden EB – Verwendung von Daten der Formatausgabe für Inventur und Summierungen, der Teil des Geschäftsprozesses IT-Dienstleistungs-/-Lösungskomponenten anschaffen/entwickeln ist.
SUMIFS (Schlüsselzeichenfolge zum Summieren, Kriterien Range1 Zeichenfolge [, Kriterien Value1 Zeichenfolge [,Kriterien Range2 Zeichenfolge, Kriterien Value2 Zeichenfolge, …]) Gibt die Summe von Werten von XML-Knoten (bei denen der Name als Schlüssel definiert ist) zurück, die während der Ausführung des Formats gesammelt wurde und die angegebenen Bedingungen erfüllt (Koppelungen von Bereichen und Werten). Gibt einen Wert 0 (null) zurück, wenn das Kennzeichen Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist.
SUMIF (Schlüsselzeichenfolge zum Summieren, Kriterien-Bereichszeichenfolge, Kriterien-Wertzeichenfolge) Gibt die Summe von Werten von XML-Knoten (bei denen der Name als Schlüssel definiert ist) zurück, die während der Ausführung des Formats gesammelt wurde und die angegebene Bedingung erfüllt (Bereich und Wert). Gibt einen Wert 0 (null) zurück, wenn das Kennzeichen Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist.
COUNTIFS (Kriterien Range1 Zeichenfolge, Kriterien Value1 Zeichenfolge [, Kriterien Range2 Zeichenfolge, Kriterien Value2 Zeichenfolge…]) Gibt die Zahl von XML-Knoten zurück, die während der Ausführung des Formats gesammelt wurde, und die die angegebenen Bedingungen erfüllt (Koppelungen von Bereichen und Werten). Gibt einen Wert 0 (null) zurück, wenn das Kennzeichen Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist.
COUNTIF (Kriterien-Bereichszeichenfolge, Kriterien-Wertzeichenfolge) Gibt Zahl von XML-Knoten zurück, die während der Ausführung des Formats gesammelt wurde und die eingegebene Bedingung erfüllt (Bereich und Wert). Gibt einen Wert 0 (null) zurück, wenn das Kennzeichen Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist.
COLLECTEDLIST (Kriterien Range1 Zeichenfolge, Kriterien Value1 Zeichenfolge [, Kriterien Range2-Zeichenfolge, Kriterien Value2 Zeichenfolge…]) Gibt die Liste von Werten von XML-Knoten von XML zurück, die während der Ausführung des Formats gesammelt wurde, und die die eingegebenen Bedingungen erfüllt (Bereich und Wert). Gibt eine leere Liste zurück, wenn die Markierung Ausgabedetails sammeln der aktuellen Dateien deaktiviert ist.

Andere (geschäftsdomänenspezifische) Funktionen

Funktion Beschreibung Beispiel
CONVERTCURRENCY (Betrag, Quellwährung, Zielwährung, Datum, Unternehmen) Konvertiert den angegebenen Geldbetrag aus der angegebenen Quellwährung in die angegebene Zielwährung, indem die Einstellungen des angegebenen Finance and Operations-Unternehmens am angegebenen Datum verwendet werden. CONVERTCURRENCY (1, "EUR", "USD", HEUTE (), "DEMF") gibt die Entsprechung von einem Euro in US Dollar am Datum der aktuellen Sitzung, auf den Einstellungen für das DEMF-Unternehmen zurück.
ROUNDAMOUNT (Anzahl, Dezimalstellen, Rundungsregel) Rundet den angegebenen Betrag auf die angegebene Zahl von Dezimalstellen gemäß der angegebenen Rundungsregel.
[!NOTE]
Die Rundenregel muss als Wert der RoundOffType-Aufzählung von Finance and Operations angegeben werden.
Wenn der Parameter model.RoundOff auf Abwärts festgelegt ist, gibt ROUNDAMOUNT (1000.787, 2, model.RoundOff) den Wert 1000.78 zurück. Wenn der model.RoundOff-Parameter entweder auf Normal oder Aufrunden ROUNDAMOUNT (1000.787, 2, model.RoundOff) festgelegt wird, wird der Wert 1000.79 zurückgegeben.
CURCredRef (Ziffern) Gibt eine Gläubigerreferenz basierend auf den Ziffern der angegebenen Rechnungsnummer zurück. CURCredRef ("VEND-200002") gibt "2200002" zurück.
MOD_97 (Ziffern) Gibt eine Gläubigerreferenz als MOD97 Ausdruck zurück, basierend auf den Ziffern der angegebenen Rechnungsnummer. MOD_97 ("VEND-200002") gibt "20000285" zurück.
ISOCredRef (Ziffern) Gibt eine Gläubigerreferenz der Internationale Organisation für Normung (ISO) basierend auf den Ziffern und alphabetischen Symbolen der angegebenen Rechnungsnummer zurück.
[!NOTE]
Um Symbole aus Alphabeten zu entfernen, die nicht ISO-kompatibel sind, muss der Eingabeparameter übersetzt werden, bevor er an diese Funktion übergeben wird.
ISOCredRef ("VEND-200002") gibt "RF23VEND-200002" zurück.
CN_GBT_AdditionalDimensionID (Zeichenfolge, Zahl) Ruft die zusätzliche Finanzdimensions-ID ab. Dimensionen werden in dieser Zeichenfolge als durch Trennzeichen getrennte IDs dargestellt. In dieser Zeichenfolge definieren Zahlen den Sequenzcode der angeforderten Dimension. CN_GBT_AdditionalDimensionID ("AA,BB,CC,DD,EE,FF,GG,HH",3) gibt "CC" zurück.
GetCurrentCompany () Gibt die Textdarstellung des Codes für die juristische Person (Unternehmen) zurück, bei dem ein Benutzer derzeit angemeldet ist. GETCURRENTCOMPANY () gibt USMF für einen Benutzer zurück, der beim Unternehmen Contoso Entertainment System USA in Finance and Operations angemeldet ist.
CH_BANK_MOD_10 (Stellen) Gibt eine Gläubigerreferenz als MOD10-Ausdruck zurück, basierend auf den Ziffern der angegebenen Rechnungsnummer. CH_BANK_MOD_10 ("VEND-200002") gibt 3 zurück.
FA_SUM (Anlagencode, Wertmodellcode, Startdatum, Enddatum) Gibt den vorbereiteten Datencontainer des Anlagenbetrags für die angegebene Periode zurück. FA_SUM ("COMP-000001", "Current", Date1, Date2) gibt den vorbereiteten Datenconteiner der Anlage "COMP-000001" zurück, der das Wertmodell "Current" für eine Periode von Date1 bis Date2 hat.
FA_BALANCE (Anlagencode, Wertmodellcode, Berichtsjahr, Meldedatum) Gibt den vorbereiteten Datencontainer des Anlagensaldos zurück. Das Berichterstellungsjahr muss als Wert der Aufzählung AssetYear in Finance and Operations angegeben werden. FA_SUM ("COMP-000001", "Current", AxEnumAssetYear.ThisYear, SESSIONTODAY ()) gibt den vorbereiteten Datencontainer von Salden für Anlage "COMP-000001" zurück, der das Wertmodell "Current" zum aktuellen Finance and Operations-Sitzungsdatum hat.
TABLENAME2ID (Zeichenfolge) Gibt eine ganzzahlige Darstellung einer Tabellenkennung für den angegebenen Tabellennamen zurück. TABLENAME2ID ("Intrastat") gibt 1510 zurück.
ISVALIDCHARACTERISO7064 (Zeichenfolge) Gibt den booleschen Wert WAHR zurück, wenn die angegebene Zeichenfolge eine gültige internationale Bankkontonummer (IBAN) darstellt. Gibt anderenfalls den booleschen Wert FALSCH zurück. ISVALIDCHARACTERISO7064 ("AT61 1904 3002 3457 3201") gibt WAHR zurück. ISVALIDCHARACTERISO7064 ("AT61") gibt FALSCH zurück.

Listenerweiterung der Funktionen

ER ermöglicht es Ihnen, die Liste von Funktionen zu verlängern, die in ER-Ausdrücken verwendet werden. Etwas technischer Aufwand ist erforderlich. Ausführliche Informationen finden Sie unter Erweitern der Liste der elektronischen Berichtsfunktion.

Siehe auch

Überblick über die elektronische Berichterstellung

Erweitert die Liste der elektronischen Berichtsfunktion (ER)