Tipos de dados primitivos compatíveis com as fórmulas de relatório eletrônico
Este artigo fornece informações sobre os tipos de dados primitivos que são compatíveis com as expressões de relatório eletrônico (ER). Veja a seguir uma lista dos tipos de dados primitivos:
Booleano
O tipo de dados primitivo booliano contém um valor que é avaliado como true ou false. Você pode usar as palavras-chave literais reservadas True e False sempre que uma expressão booliana é esperada. O valor padrão é false.
A representação interna de um booliano é um inteiro. O valor inteiro 0 (zero) é avaliado como false e todos os outros valores inteiros são avaliados como true. Quando você valida uma expressão configurada que retorna um booliano no designer de fórmulas de ER, o painel de resultado do teste apresenta 0 (zero) quando uma expressão retorna como false. Caso contrário, o painel de resultado do teste apresentará 1.
Um booliano não tem conversões implícitas. No entanto, você pode usar a função TEXT para converter explicitamente um booliano em uma cadeia de caracteres:
- O valor false é convertido na cadeia de caracteres de texto False.
- O valor true é convertido na cadeia de caracteres de texto True.
Observação
Essa conversão não depende do contexto de linguagem e cultura fornecidos.
Os operadores de comparação são o único tipo de operador que pode ser usado com o tipo de dados booliano. Os seguintes operadores podem ser usados para comparar dois valores boolianos: <> e =.
Data
O tipo de dados primitivo data contém o dia, o mês e o ano. As datas podem ser iniciadas usando as seguintes funções:
O tipo de dados data pode conter datas entre 1º de janeiro de 1900 e 31 de dezembro de 2154. O valor padrão é nulo, e a representação interna é a data de 1º de janeiro de 1900.
Uma data não tem conversões implícitas. No entanto, você pode usar as seguintes funções de conversão explícitas:
A função ADDDAYS permite adicionar e subtrair dias de datas. Dessa forma, você pode mover a data para um número específico de dias no futuro e no passado. A função DAYS permite subtrair datas umas das outras e calcular a diferença em dias. Para obter mais informações sobre a transformação dos valores de data, consulte Lista de funções ER na categoria Data e hora.
Os operadores de comparação são o único tipo de operador que pode ser usado com o tipo de dados data. Os seguintes operadores podem ser usados para comparar dois valores de data: <>, <, <=, =, > e >=.
Datetime
O tipo de dados primitivo datetime combina o tipo de data e um valor que representa o tempo que passou desde a meia-noite. O tempo é expresso em horas, minutos, segundos e frações de segundo. Um valor de datetime também contém informações sobre o fuso horário.
O tipo de dados datetime pode conter datas entre 1º de janeiro de 1900 (1900-01-01T00:00:00.0000000+00:00 no formato de ida e volta) e 31 de dezembro de 2154 (2154/12/31T11:59:59.9999999+00:00 no formato de ida e volta). A menor unidade de tempo em um datetime é um décimo milionésimo de um segundo.
Observação
When the especificadorhh é usado para horas, os valores de hora acima de 12:59:59:9999999 não podem ser interpretados como horas válidas.
Quando o especificador HH é usado por horas, os valores de tempo acima de 23:59:59:9999999 não podem ser interpretados como tempos válidos.
O valor padrão é nulo, e a representação interna é a data de 1º de janeiro de 1900 (1900-01-01T00:00:00.0000000+00:00 no formato de ida e volta).
Os datetimes podem ser iniciados usando as seguintes funções:
Um datetime não tem conversões implícitas. No entanto, você pode usar as seguintes funções de conversão explícitas:
Para obter mais informações sobre a transformação dos valores de datetime, consulte Lista de funções ER na categoria Data e hora.
Os operadores de comparação são o único tipo de operador que pode ser usado com o tipo de dados datetime. Os seguintes operadores podem ser usados para comparar dois valores de datetime: <>, <, <=, =, > e >=.
Enumeração
O tipo de dados primitivo enumeração é uma lista de literais. Você pode usar enumerações definidas no código-fonte do aplicativo. Você também pode introduzir suas próprias enumerações no modelo de dados de ER e nos componentes do formato de ER.
Uma enumeração de aplicativo pode ser usada em expressões de qualquer mapeamento de modelo de ER e formato de ER.
A ilustração a seguir mostra como você pode adicionar a enumeração do modelo CustVendCorrectiveReasonCode ao modelo de dados de ER editável.
Uma enumeração do modelo pode ser usada em expressões de qualquer mapeamento do modelo de ER e formato de ER que foram criados sob um modelo de dados em que a enumeração foi introduzida.
A ilustração a seguir mostra como você pode adicionar a enumeração de formato Lista de subcategorias de encargos revertidos da Natura ao formato de ER editável.
Uma enumeração de formato só pode ser usada em expressões do formato de ER em que a enumeração foi introduzida.
É necessário usar o tipo apropriado de fontes de dados de ER para trazer uma enumeração específica a um componente de ER configurado como uma constante ou como um valor que o usuário que está executando uma solução de ER definiu na caixa de diálogo no runtime.
As enumerações do aplicativo podem ser acessadas usando as fontes de dados Dynamics 365 for Operations\Enumeração e Geral\Parâmetros de entrada do usuário. A ilustração a seguir mostra como você pode adicionar ao formato de ER editável as fontes de dados appenumNoYes e uipNoYes que se referem à enumeração do aplicativo NoYes.
As enumerações de modelo de dados podem ser acessadas usando as fontes de dados Modelo de dados\Enumeração e Modelo de dados\Parâmetros de entrada do usuário de enumeração. A ilustração a seguir mostra como você pode adicionar ao formato de ER editável a fonte de dados CustVendCorrectiveReasonCode que se refere à enumeração do modelo de dados CustVendCorrectiveReasonCode.
As enumerações de formato podem ser acessadas usando as fontes de dados Formato\Enumeração e Formato\Parâmetros de entrada do usuário de enumeração. A ilustração a seguir mostra como você pode adicionar ao formato de ER editável a fonte de dados NaturaReverseCharge que se refere à enumeração de formato Subcategorias de encargos revertidos da Natura.
Uma enumeração não tem conversões implícitas. No entanto, você pode usar a função de conversão TEXT para converter uma enumeração em uma cadeia de caracteres de texto. Esta conversão não depende da linguagem. Para saber como você pode associar um valor de enumeração aos rótulos específicos de linguagem apropriados, consulte os exemplos de uso das funções LISTOFFIELDS e GETENUMVALUEBYNAME.
Os operadores de comparação são o único tipo de operador que pode ser usado com o tipo de dados de enumeração. Os seguintes operadores podem ser usados para comparar dois valores de enumeração: <> e =.
Guid
O tipo de dados primitivo guid contém um valor de identificador global exclusivo (GUID). Um GUID é um valor que pode ser usado em todos os computadores e redes, sempre que um identificador exclusivo for necessário. É improvável que o número seja duplicado. Um GUID válido atende a todas as seguintes especificações:
- Deve haver 32 dígitos hexadecimais.
- Além disso, deve haver quatro caracteres de traço incorporados nos seguintes locais: 8-4-4-4-12.
- Além disso, chaves opcionais {} podem ser adicionadas no início e no final da cadeia de caracteres. Por exemplo, {2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212} e 2CDB0FE7-D7B3-4938-A0F0-FE28FB8FE212 são cadeias de caracteres GUID válidas.
- Portanto, deve haver um total de 36 ou 38 caracteres, dependendo se as chaves são adicionadas.
- As letras que são usadas como dígitos hexadecimais podem ser maiúsculas (A-F), minúsculas (a-f) ou mistas.
As seguintes funções de conversão explícitas podem ser usadas:
Os operadores de comparação são o único tipo de operador que pode ser usado com o tipo de dados guid. Os seguintes operadores podem ser usados para comparar dois valores guid: <> e =.
Inteiro
O tipo de dados primitivo inteiro representa um número que não possui casas decimais. Os inteiros são usados como variáveis de controle em instruções repetitivas ou como índices em listas de registros.
Um literal inteiro é o inteiro, pois é inserido diretamente em uma expressão de ER (fórmula), como 12345. Um inteiro tem 32 bits de largura. O valor padrão é 0, e a representação interna é um número longo. Um inteiro é automaticamente convertido em um real.
Além disso, as seguintes funções de conversão explícitas podem ser usadas:
O intervalo de um inteiro é [-2.147.483.647 : 2.147.483.647]. Todos os inteiros deste intervalo podem ser usados como literais.
Todos os operadores de comparação e matemática podem ser usados com o tipo de dados inteiro.
Int64
O tipo de dados primitivo int64 representa um número que não possui casas decimais. Os valores int64 são usados como variáveis de controle em instruções repetitivas ou como identificadores de registros.
Um int64 tem 64 bits de largura. O valor padrão é 0, e a representação interna é um número longo. Um int64 é automaticamente convertido em um real.
Além disso, as seguintes funções de conversão explícitas podem ser usadas:
O intervalo de um int64 é [-9,223,372,036,854,775,807 : 9,223,372,036,854,775,807].
Todos os operadores de comparação e matemática podem ser usados com o tipo de dados int64.
Real
O tipo de dados primitivo real pode conter valores decimais, além de inteiros. Você pode usar literais decimais em qualquer lugar em que um real seja esperado. Um literal decimal é o decimal, pois é inserido diretamente no código, como 2.19.
Observação
Nas expressões de ER, um período (.) é sempre usado como separador decimal.
Os reais podem ser usados em todas as expressões e podem ser usados com operadores de comparação e aritméticos. Um real tem uma precisão de 16 dígitos significativos. O valor padrão para um real é 0,0, e a representação interna é um número digital com codificação binária (BCD). A codificação BCD permite representações exatas de valores múltiplos de 0,1. O intervalo de uma variável real é -(10)127 a (10)127. Todos os reais neste intervalo podem ser usados como literais em expressões de ER.
Um real não tem conversões implícitas. No entanto, você pode usar as seguintes funções para converter explicitamente um real em outros tipos de dados e outros tipos de dados em um real:
Todos os operadores de comparação e matemática podem ser usados com o tipo de dados real.
Sequência de caracteres
O tipo de dados primitivo cadeia de caracteres representa uma sequência de caracteres que são usados como textos, números de contas, endereços e números de telefone.
Os literais de cadeia de caracteres são caracteres colocados entre aspas (""). Os literais de cadeia de caracteres podem ser usados sempre que valores de cadeia de caracteres são esperados em expressões de ER. Você pode usar cadeias de caracteres em expressões lógicas, como comparações. Também é possível concatenar valores de cadeia de caracteres usando o operador & ou a função CONCATENATE.
Observação
Se você concatenar dois valores de cadeia de caracteres e quiser que a cadeia de caracteres resultante se estenda por mais de uma linha, use o separador de quebra de linha entre os valores. Para a saída TEXT, este separador pode ser um caractere gerado usando a expressão CHAR(10) ou CHAR(13). Para HTML, pode ser o rótulo <br>.
O valor padrão de uma cadeia de caracteres é uma cadeia de caracteres de texto em branco que não tem caracteres, e a representação interna é uma lista de caracteres.
Não há conversões automáticas para cadeias de caracteres. No entanto, as seguintes funções de conversão explícitas podem ser usadas:
Para saber mais sobre a transformação dos valores de cadeia de caracteres, consulte Lista de funções ER na categoria de texto.
Uma cadeia de caracteres pode conter um número indefinido de caracteres.
Todos os operadores de comparação podem ser usados com o tipo de dados cadeia de caracteres.
Recursos adicionais
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de