Função de ER FORMAT
A função FORMAT retorna a cadeia de caracteres especificada como um valor de Cadeia de caracteres após ela ser formatada, substituindo todas as ocorrências de %N pelo Nº argumento.
Sintaxe
FORMAT (string, argument 1[, argument 2, …, argument N])
Argumentos
string: Cadeia de caracteres
Uma referência a uma fonte de dados do tipo Cadeia de caracteres que deve ser formatada. Esse argumento é obrigatório.
argument 1: Cadeia de caracteres
O primeiro argumento, que é usado para substituir as ocorrências de %1. Esse argumento é obrigatório.
argument N: Cadeia de caracteres
O Nº argumento, que é usado para substituir as ocorrências de %2, %3 etc. Esses argumentos adicionais são opcionais.
Valores de retorno
Sequência de caracteres
O valor de texto resultante.
Notas de uso
Se o argumento não é fornecido para um parâmetro, o parâmetro será devolvido como "%N" na cadeia de caracteres. Para valores do tipo Real, a conversão de cadeia de caracteres padrão é limitada a duas casas decimais.
Exemplo
Na ilustração a seguir, a fonte de dados PaymentModel retorna uma lista de registros de clientes usando o componente Cliente. Ela retorna o valor de data de processamento usando o campo ProcessingDate.
No formato de relatório eletrônico (ER) que foi projetado para gerar um arquivo eletrônico para clientes selecionados, PaymentModel é selecionada como uma fonte de dados e controla o fluxo do processo. Se um cliente selecionado for interrompido na data em que o relatório é processado, uma exceção será gerada para informar o usuário. A fórmula que é criada para este tipo de controle de processamento pode usar os seguintes recursos:
Rótulo SYS70894, que tem o texto a seguir:
- Para o idioma EN-US: "Nothing to print"
- Para o idioma DE "Nichts zu drucken"
Rótulo SYS18389, que tem o texto a seguir:
- Para o idioma EN-US: "Customer %1 is stopped for %2".
- Para o idioma DE: "Debitor '%1' wird für %2 gesperrt".
Veja a expressão que pode ser criada.
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 retornará o seguinte texto, que pode ser apresentado ao usuário como uma mensagem de exceção.
Nada para imprimir. O cliente Litware Retail é interrompido para 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, esta fórmula retornará o seguinte texto, que usa um formato de data diferente:
Nichts zu drucken. Debitor 'Litware Retail' wird für 17.12.2015 gesperrt.
Observação
A seguinte sintaxe será aplicada em fórmulas de ER para rótulos:
- Para rótulos de recursos no aplicativo Microsoft Dynamics 365 Finance:@X, em que X é a ID da etiqueta na AOT (Árvore de Objetos de Aplicativo)
- Para as etiquetas que residem nas configurações de ER:@"GER_LABEL:X", em que X é a ID da etiqueta na configuração de ER