Função de ER NUMSEQVALUE
A função NUMSEQVALUE devolve um valor Cadeia que representa o novo valor gerado de uma sequência de números, com base na sequência de números especificada, no âmbito e no ID de âmbito. O ID de âmbito é igual ao código da empresa fornecido pelo contexto em que o formato de Relatórios eletrónicos (ER) é executado.
Sintaxe 1
NUMSEQVALUE (number sequence code)
Sintaxe 2
NUMSEQVALUE (number sequence record ID)
Sintaxe 3
NUMSEQVALUE (number sequence code, scope type, scope ID)
Argumentos
number sequence code: Cadeia
Um valor de texto que representa o código da sequência numérica em que um novo valor é exigido.
number sequence record ID: Int64
Um valor Int64 que representa o ID de registo de um registo na tabela NumberSequenceTable que contém a definição da sequência numérica em que um novo valor é necessário.
scope type: Valor Enum
Um valor de enumeração da enumeração ERExpressionNumberSequenceScopeType que define o âmbito da sequência numérica em que um novo valor é necessário. Os tipos de âmbito disponíveis são Partilhado, Entidade legal e Empresa.
scope ID: Cadeia
Um valor Cadeia que identifica o âmbito, com base no tipo de âmbito especificado.
Valores de retorno
Cadeia
O valor de texto resultante.
Notas de utilização
Para o tipo de âmbito Partilhado, especifique uma cadeia vazia como o ID de âmbito.
Para os tipos de âmbito Empresa e Entidade legal, especifique o código da empresa como o ID de âmbito. Se especificar uma cadeia vazia como o ID de âmbito para estes tipos de âmbito, é utilizado o código da empresa atual.
Quando a sintaxe 1 é utilizada, a sequência numérica é solicitada para o tipo de âmbito Empresa e o código da empresa é fornecido pelo contexto em que o formato de ER é executado.
Exemplo 1
No formato de ER, defina a origem de dados AskNumSeq do tipo Parâmetro de entrada de utilizador. Esta origem de dados refere-se ao tipo de dados expandidos (EDT) Descrição. Em seguida, defina a origem de dados NumSeq do tipo Campo calculado. Esta origem de dados contém a expressão NUMSEQVALUE (AskNumSeq). Quando a origem de dados NumSeq é chamada, devolve o novo valor gerado da sequência numérica que foi especificada durante a execução introduzindo o respetivo código na caixa de diálogo. A sequência numérica é solicitada para o tipo de âmbito Empresa. O código de empresa é fornecido pelo contexto em que o formato de ER é executado.
Exemplo 2
As seguintes origens de dados são definidas no mapeamento de modelos:
- A origem de dados LedgerParms do tipo Tabela. Esta origem de dados refere-se à tabela LedgerParameters.
- A origem de dados NumSeq do tipo Campo calculado. Esta origem de dados contém a expressão
NUMSEQVALUE ( LedgerParameters.'numRefJournalNum()'.NumberSequenceId).
Quando a origem de dados NumSeq é chamada, devolve o novo valor gerado da sequência numérica que foi configurada nos Parâmetros de razão geral para a empresa que fornece o contexto em que o formato de ER é executado. Esta sequência numérica identifica apenas diários e atua como um número de lote que associa as transações em conjunto.
Exemplo 3
As seguintes origens de dados são definidas no mapeamento de modelos:
- A origem de dados enumScope do tipo enumeração do Microsoft Dynamics 365 Finance. Esta origem de dados refere-se à enumeração ERExpressionNumberSequenceScopeType.
- A origem de dados NumSeq do tipo Campo calculado. Esta origem de dados contém a expressão
NUMSEQVALUE ("Gene_1", enumScope.Company, "").
Quando a origem de dados NumSeq é chamada, devolve o novo valor gerado da sequência numérica Gene_1 que foi configurada para a empresa que fornece o contexto em que o formato de ER é executado.