Funkce el. výkaznictví FORMAT
Funkce FORMAT
vrátí zadaný řetězec jako hodnotu typu řetězec po jeho zformátování nahrazením všech výskytů %Nn-tým argumentem.
Syntaxe
FORMAT (string, argument 1[, argument 2, …, argument N])
Argumenty
string
: Řetězec
Odkaz na zdroj dat typu řetězec, který má být formátován. Tento argument je povinný.
argument 1
: Řetězec
První argument, který se použije k nahrazení výskytů %1. Tento argument je povinný.
argument N
: Řetězec
N-tý argument, který se použije k nahrazení výskytů %2, %3 atd. Tyto další argumenty jsou nepovinné.
Vrácené hodnoty
Řetězec
Výsledná textová hodnota.
Poznámky k použití
Pokud pro parametr není zadán argument, parametr je vrácen jako "%N" v řetězci. Co se týká hodnot typu reálné číslo, výchozí převod řetězce je omezen na dvě desetinná místa.
Příklad
Na následujícím obrázku vrátí zdroj dat PaymentModel (platební model) seznam záznamů zákazníků pomocí součásti Customer (odběratel). Vrátí hodnotu data zpracování pomocí pole ProcessingDate (datum zpracování).
Ve formátu elektronického výkaznictví, který je určený ke generování elektronického souboru pro vybrané odběratele, je vybrán řetězec PaymentModel jako zdroj dat, který řídí tok procesu. Jestliže je vybraný odběratel zastaven k datu zpracování sestavy, je vyvolána výjimka pro informování uživatele. Vzorec, který je určen pro tento typ ovládacího prvku pro zpracování, může využít následující zdroje:
Popisek SYS70894, který má následující text:
- U jazyka EN-US: "Nothing to print"
- U jazyka DE: "Nichts zu drucken"
Popisek SYS18389, který má následující text:
- U jazyka EN-US: "Customer %1 is stopped for %2."
- U jazyka DE: "Debitor '%1' wird für %2 gesperrt."
Zde je výraz, který lze vytvořit.
FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d"))
Pokud je sestava zpracovávána pro odběratele Litware Retail 17. prosince 2015, v národním prostředí EN-US a jazyce EN-US, tento vzorec vrátí následující text, který může být uživateli nabídnut ve formě zprávy výjimky:
Nic k tisku. Customer Litware Retail is stopped for 12/17/2015.
Jestliže je stejná sestava zpracována pro odběratele Litware Retail 17. prosince 2015 v jazykové verzi DE a jazyce DE, vzorec vrátí následující text, který používá jiný formát data:
Nichts zu drucken. Debitor 'Litware Retail' wird für 17.12.2015 gesperrt.
Poznámka
Následující syntaxe je použita ve vzorcích elektronického výkaznictví pro popisky:
- Popisky ze zdrojů aplikace Microsoft Dynamics 365 Finance:@X, kde X je ID popisku ve stromu aplikačních objektů (AOT)
- Popisky, které se nachází v konfiguracích elektronického výkaznictví:@"GER_LABEL:X", kde X je ID popisku v konfiguraci elektronického výkaznictví