Función NUMSEQVALUE de ER
La función NUMSEQVALUE
devuelve un valor de tipo Cadena que representa el nuevo valor generado de una secuencia numérica, basado en la secuencia numérica especificada, el ámbito y el id. de ámbito. El id. de ámbito es igual al código de empresa suministrado por el contexto en el que se ejecuta el formato de informes electrónicos (ER).
Sintaxis 1
NUMSEQVALUE (number sequence code)
Sintaxis 2
NUMSEQVALUE (number sequence record ID)
Sintaxis 3
NUMSEQVALUE (number sequence code, scope type, scope ID)
Argumentos
number sequence code
: Cadena
Un valor de texto que representa el código de la secuencia numérica en la que se requiere un nuevo valor.
number sequence record ID
: Int64
Un valor de tipo Int64 que representa el id. de registro de un registro de la tabla NumberSequenceTable que contiene la definición de la secuencia numérica en la que se requiere un nuevo valor.
scope type
: Valor de enumeración
Un valor de enumeración de ERExpressionNumberSequenceScopeType que define el ámbito de la secuencia numérica en la que se requiere un nuevo valor. Los tipos de ámbito disponibles son Compartido, Entidad jurídica y Empresa.
scope ID
: Cadena
Valor de tipo Cadena que identifica el ámbito en función del tipo de ámbito especificado.
Valores de retorno
Cadena
El valor de texto resultante.
Notas de uso
Para el ámbito de tipo Compartido, especifique una cadena vacía como identificador de ámbito.
Para los ámbitos de tipo Empresa y Entidad jurídica, especifique el código de empresa como identificador de ámbito. Si especifica una cadena vacía como el identificador de ámbito para estos tipos de ámbito, se usa el código de la empresa actual.
Cuando se utiliza la sintaxis 1, se solicita la secuencia numérica para el tipo de ámbito Empresa y el código de empresa lo suministra el contexto en el que se ejecuta el formato de ER.
Ejemplo 1
En su formato de ER, usted define el origen de datos AskNumSeq del tipo Parámetro de entrada del usuario. Este origen de datos hace referencia a la tipo de datos extendido (EDT) Descripción. A continuación, define el origen de datos NumSeq del tipo Campo calculado. Este origen de datos contiene la expresión NUMSEQVALUE (AskNumSeq)
. Cuando se llama al origen de datos NumSeq, devuelve el nuevo valor generado de la secuencia numérica que se especificó en tiempo de ejecución al introducir su código en el cuadro de diálogo. Se solicita la secuencia numérica para el ámbito de tipo Empresa. El código de empresa lo suministra el contexto en el que se ejecuta el formato de ER.
Ejemplo 2
Los siguientes orígenes de datos se definen en la asignación del modelo:
- El origen de datos LedgerParms del tipo Tabla. Este origen de datos hace referencia a la tabla LedgerParameters.
- El origen de datos NumSeq del tipo de datos Campo calculado. Este origen de datos contiene la expresión
NUMSEQVALUE ( LedgerParameters.'numRefJournalNum()'.NumberSequenceId)
.
Cuando se llama al origen de datos NumSeq, devuelve el nuevo valor generado a partir de la secuencia numérica que se ha configurado en los parámetros de contabilidad general para la empresa que proporciona el contexto donde se ejecuta el formato de ER. Esta secuencia numérica identifica de forma exclusiva los diarios y actúa como número de lote que vincula las transacciones.
Ejemplo 3
Los siguientes orígenes de datos se definen en la asignación del modelo:
- El origen de datos enumScope del tipo enumeración de Microsoft Dynamics 365 Finance. Este origen de datos hace referencia a la enumeración ERExpressionNumberSequenceScopeType.
- El origen de datos NumSeq del tipo de datos Campo calculado. Este origen de datos contiene la expresión
NUMSEQVALUE ("Gene_1", enumScope.Company, "")
.
Cuando se llama al origen de datos NumSeq, devuelve el nuevo valor generado a partir de la secuencia numérica Gene1 que se ha configurado para la empresa que proporciona el contexto donde se ejecuta el formato de ER.