De ER-functie FORMAT
De functie FORMAT retourneert de opgegeven tekenreeks als een waarde van het type Tekenreeks nadat deze is ingedeeld door elk exemplaar van %N te vervangen door het Ne argument.
Syntaxis
FORMAT (string, argument 1[, argument 2, …, argument N])
Argumenten
string: Tekenreeks
Een verwijzing naar een gegevensbron van het type Tekenreeks die moet worden ingedeeld. Dit argument is verplicht.
argument 1: Tekenreeks
Het eerste argument, dat wordt gebruikt om exemplaren van %1 te vervangen. Dit argument is verplicht.
argument N: Tekenreeks
Het Ne argument, dat wordt gebruikt om exemplaren van %2, %3, enzovoort te vervangen. Deze aanvullende argumenten zijn optioneel.
Retourwaarden
Tekenreeks
De resulterende tekstwaarde.
Gebruiksaanwijzingen
Als een argument niet voor een parameter wordt verstrekt, wordt de parameter geretourneerd als "%N" in de tekenreeks. Voor waarden van het type Werkelijk wordt de standaard tekenreeksconversie beperkt tot twee decimalen.
Voorbeeld
In de volgende afbeelding retourneert de gegevensbron PaymentModel een lijst met klantrecords met behulp van het onderdeel Klant. De waarde van de verwerkingsdatum wordt geretourneerd met het veld ProcessingDate.
In de ER-indeling (Elektronische rapportage) die is ontworpen om een elektronisch bestand voor geselecteerde klanten te genereren, wordt PaymentModel geselecteerd als een gegevensbron en beheert deze de processtroom. Er treedt een uitzondering op om de gebruiker te informeren wanneer een geselecteerde klant wordt gestopt voor de datum waarop het rapport wordt verwerkt. De formule die is ontworpen voor dit type verwerkingsbesturingselement kan de volgende bronnen gebruiken:
Label SYS70894, met de volgende tekst:
- Voor de taal EN-US: "Nothing to print"
- Voor de taal NL: "Er is niets om af te drukken"
Label SYS18389, met de volgende tekst:
- Voor de taal EN-US: Customer %1 is stopped for %2.
- Voor de taal DE: Debitor '%1' wird für %2 gesperrt.
Hier is de expressie die kan worden ontworpen.
FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d"))
Als een rapport wordt verwerkt voor de klant Litware Retail op 17 december 2015 in de cultuur EN-US en de taal EN-US, retourneert deze formule de volgende tekst, die aan de gebruiker kan worden weergegeven als uitzonderingsbericht:
Er is niets om af te drukken. Customer Litware Retail is stopped for 12/17/2015."
Als hetzelfde rapport voor de klant Litware Retail wordt verwerkt op 17 december 2015 in de cultuur DE en de taal DE, retourneert de formule de volgende tekst die een andere datumnotatie gebruikt:
Nichts zu drucken. Klant "Litware Retail" is gestopt voor 17-12-2015.
Notitie
De volgende syntaxis wordt toegepast in ER-formules voor labels:
- Voor labels van resources in de Microsoft Dynamics 365 Finance-app:@X, waarbij @X de label-id in de Application Object Tree (AOT) is
- Voor labels die zich in ER-configuraties bevinden:@"GER_LABEL:X", waarbij X de label-id in de ER-configuratie is