Udostępnij za pośrednictwem

FORMAT, funkcja ER

  • Artykuł

Funkcja FORMAT zwraca określoną wartość typu Ciąg po jej sformatowaniu przez zastąpienie wszystkich wystąpień elementu %NN-tym argumentem.

Składnia

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

Argumenty

string : Ciąg

Odwołanie do źródła danych typu Ciąg, które musi zostać sformatowany. Ten argument jest wymagany.

argument 1 : Ciąg

Pierwszy argument, który jest używany do zastępowania wystąpień %1. Ten argument jest wymagany.

argument N : Ciąg

N-ty argument, który jest używany do zastępowania wystąpień %2, %3 itd. Te dodatkowe argumenty są opcjonalne.

Wartości zwracane

Ciąg

Wynikowa wartość tekstowa.

Uwagi dotyczące użytkowania

Jeśli dla parametru nie podano argumentu, parametr jest zwracany w ciągu jako "%N". Dla wartości typu Rzeczywista domyślna konwersja ciągu jest ograniczona do dwóch miejsc dziesiętnych.

Przykład

Na poniższej ilustracji źródło danych PaymentModel zwraca listę rekordów klientów przy użyciu składnika Klient. Zwraca wartość daty przetwarzania przy użyciu pola ProcessingDate.

Źródło danych PaymentModel

W formacie raportowania elektronicznego (ER) przeznaczonym do generowania pliku elektronicznego dla wybranych klientów PaymentModel jest wybrane jako źródło danych i kontroluje przebieg procesu. Jeśli wybrany klient jest zablokowany w dniu generowania raportu, następuje zgłoszenie wyjątku w celu powiadomienia użytkownika. Formuła przeznaczona dla tego typu kontroli przetwarzania może skorzystać z poniższych zasobów:

  • Etykieta SYS70894, która ma następujący tekst:

    • W języku polskim: „Nie ma nic do wydrukowania”
    • W języku niemieckim: „Nichts zu drucken”

  • Etykieta SYS18389, która ma następujący tekst:

    • W języku polskim: „Klient %1 jest zablokowany do %2”.
    • W języku niemieckim: „Debitor '„%1” wird für %2 gesperrt”.

Poniżej przedstawiono wyrażenie, które można zaprojektować.

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

Jeśli raport jest przetwarzany dla odbiorcy Litware Retail w dniu 17 grudnia 2015 r. w kulturze PL i języku PL, formuła zwraca następujący tekst, który może być prezentowany użytkownikowi jako komunikat o wyjątku:

Nie ma nic do wydrukowania. Odbiorca Litware Retail jest zablokowany do 17.12.2015.

Jeśli ten sam raport będzie przetwarzany dla odbiorcy Litware Retail w dniu 17 grudnia 2015 w języku DE i kulturze DE, formuła zwraca następujący tekst:

Nichts zu drucken. Debitor 'Litware Retail' wird für 17.12.2015 gesperrt.

Banknot

W formułach raportowania elektronicznego dla etykiet jest stosowana następująca składnia:

  • Etykiety aplikacji Microsoft Dynamics 365 Finance:@X, gdzie X oznacza identyfikator etykiety w drzewie obiektów aplikacji (AOT)
  • Etykiety, które znajdują się w konfiguracjach ER:@"GER_LABEL:X", gdzie X oznacza identyfikator etykiety w konfiguracji raportowania elektronicznego

Dodatkowe zasoby

Funkcje tekstowe