Função de ER FORMAT
A função FORMAT devolve a cadeia especificada como um valor Cadeia depois de ter sido formatada substituindo quaisquer ocorrências de %N com o argumento Enésimo.
Sintaxe
FORMAT (string, argument 1[, argument 2, …, argument N])
Argumentos
string: Cadeia
Uma referência a uma origem de dados do tipo Cadeia que tem de ser formatada. Este argumento é obrigatório.
argument 1: Cadeia
O primeiro argumento, que é utilizado para substituir ocorrências de %1. Este argumento é obrigatório.
argument N: Cadeia
O argumento Enésimo, que é utilizado para substituir ocorrências de %2, %3, etc. Estes argumentos adicionais são opcionais.
Valores de retorno
Cadeia
O valor de texto resultante.
Notas de utilização
Se um argumento não for previsto para um parâmetro, o parâmetro é devolvido como "%N" na cadeia. Para valores do tipo Real, a conversão de cadeia predefinida é limitada a duas casas decimais.
Exemplo
Na ilustração seguinte, a origem de dados PaymentModel devolve uma lista de registos de clientes utilizando o componente Cliente. Devolve o valor de data de processamento utilizando o campo ProcessingDate.
No formato de Relatórios eletrónicos (ER) estruturado para gerar um ficheiro eletrónico para clientes selecionados, PaymentModel é selecionado como origem de dados e controla o fluxo de processo. Se um cliente selecionado for interrompido para a data em que o relatório é processado, uma exceção é iniciada para notificar o utilizador. A fórmula estruturada para este tipo de controlo de processamento pode utilizar os seguintes recursos:
Etiqueta SYS70894, com o seguinte texto:
- Para o idioma EN-US: "Nothing to print"
- Para o idioma DE: "Nichts zu drucken"
Etiqueta SYS18389, com o seguinte texto:
- Para o idioma EN-US: "Customer %1 is stopped for %2."
- Para o idioma DE: "Debitor '%1' wird für %2 gesperrt."
Aqui está a expressão que pode ser estruturada.
FORMAT (CONCATENATE (@"SYS70894", ". ", @"SYS18389"), model.Customer.Name, DATETIMEFORMAT (model.ProcessingDate, "d"))
Se um relatório for processado para o cliente Litware Retail em 17 de dezembro de 2015, na cultura EN-US e no idioma EN-US, esta fórmula devolve o seguinte texto, que pode ser apresentado ao utilizador como uma mensagem de exceção:
Nada para imprimir. Cliente Litware Retail parado em 17/12/2015.
Se o mesmo relatório for processado para o cliente Litware Retail em 17 de dezembro de 2015, na cultura DE e no idioma DE, a fórmula devolve o seguinte texto, que utiliza um formato de data diferente:
Nichts zu drucken. Debitor 'Litware Retail' wird für 17.12.2015 gesperrt.
Nota
A seguinte sintaxe é aplicada nas fórmulas de ER para etiquetas:
- Para etiquetas a partir de recursos na aplicação do Microsoft Dynamics 365 Finance: @X, em que X é o ID da etiqueta na Árvore de Objetos Aplicacionais (AOT)
- Para etiquetas que residem em configurações de ER: @"GER_LABEL:X", em que X é o ID da etiqueta na configuração de ER