FORMAT EB-Funktion

Die Funktion FORMAT gibt den angegebenen Zeichenfolgenwert mit dem Wert String zurück, nachdem sie durch Ersetzen sämtlicher Vorkommnisse von %N durch das N. Argument formatiert wurde.

Syntax

FORMAT (string, argument 1[, argument 2, …, argument N])

Argumente

string: Zeichenfolge

Ein Verweis auf die Datenquelle des Typs String, die formatiert werden muss. Dieses Argument ist erforderlich.

argument 1: Zeichenfolge

Das erste Argument, das verwendet wird, um Vorkommnisse von %1 zu ersetzen. Dieses Argument ist erforderlich.

argument N: Zeichenfolge

Das N. Argument, das verwendet wird, um Vorkommnisse von %2, %3 usw. zu ersetzen. Diese zusätzlichen Argumente sind optional.

Rückgabewerte

Zeichenfolge

Der resultierende Textwert.

Anwendungshinweise

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 Typ Real, wird die Standard-Zeichenkonvertierung auf zwei Dezimalstellen beschränkt.

Beispiel

In der folgenden Abbildung gibt die Datenquelle PaymentModel eine Liste der Kundendatensätze zurück, indem die Komponente Debitor verwendet wird. Sie gibt den Wert des Verarbeitungsdatums über das Feld ProcessingDate zurück.

Im Format für die elektronische Berichterstellung (EB), das entworfen wurde, um eine Datei für ausgewählte Debitoren zu generieren, wird PaymentModel als Datenquelle ausgewählt, um den Prozessablauf zu steuern. Wenn ein ausgewählter Debitor zu dem Datum angehalten wird, an dem der Bericht verarbeitet wird, wird zur Benachrichtigung des Benutzers eine Ausnahme ausgelöst. Die Formel, die für diese Art von Prozesssteuerung entworfen wurde, kann die folgenden Ressourcen verwenden:

• Beschriftung SYS70894, die den folgenden Text hat:

  • Für die EN-US-Sprache: "Nichts zu drucken"
  • Für deutsche Sprache: "Nichts zu drucken"

• Beschriftung SYS18389, die den folgenden Text hat:

  • Für die Sprache EN-US: "Debitor %1 wird für %2 beendet."
  • Für die Sprache DE: "Debitor '%1' wird für %2 gesperrt."

Hier ist der Ausdruck, der 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 dann 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.

Notiz

Die folgende Syntax wird in EB-Formeln für Beschriftungen angewendet:

• Für Bezeichnungen aus Ressourcen in der Microsoft Dynamics 365 Finance-App:@X, wobei X die Bezeichnungs-ID in der Entwicklungsumgebung ist
• Für Beschriftungen, die sich in ER-Konfigurationen befinden:@GER_LABEL:X, wobei X die Beschriftungs-ID in der EB-Konfiguration ist

Zusätzliche Ressourcen

Textfunktionen