NUMSEQVALUE ER-funktion
NUMSEQVALUE
-funktionen returnerar ett Sträng-värde som representerar det nya genererade värdet för en nummerserie, baserat på den angivna nummersekvensen, omfattningen och omfattnings-ID. Omfattnings-ID är lika med företagskoden som tillhandahålls av kontexten som ER-formatet (elektronisk rapportering) körs under.
Syntax 1
NUMSEQVALUE (number sequence code)
Syntax 2
NUMSEQVALUE (number sequence record ID)
Syntax 3
NUMSEQVALUE (number sequence code, scope type, scope ID)
Argument
number sequence code
: Sträng
Ett textvärde som representerar koden för den nummerserie som ett nytt värde krävs i.
number sequence record ID
: Int64
Ett Int64-värde som representerar post-ID för en post i tabellen NumberSequenceTable som innehåller definitionen av den nummerserie som ett nytt värde krävs i.
scope type
: Uppräknat värde
Ett numreringsvärde för uppräkningen ERExpressionNumberSequenceScopeType som definierar omfattningen för den nummerserie som ett nytt värde krävs i. Tillgängliga omfattningstyper är delade, juridisk person och företag.
scope ID
: Sträng
Ett sträng värde som identifierar scopet baserat på den angivna omfattningstypen.
Returvärden
Sträng
Det resulterande textvärdet.
Användningsanteckningar
För omfattningstypen delad, ange en tom sträng som områdes-ID.
För omfattningstypen företag och juridisk person, ange företagskoden som områdes-ID. Om du anger en tom sträng som områdes-ID för dessa omfattningstyper, används aktuella företagskoden.
När syntax 1 används begärs nummerserien för omfattningstypen företag och företagskoden tillhandahålls av kontexten som ER-formatet körs under.
Exempel 1
I ER-format definierar du AskNumSeq-datakällan för parametertypen Användarindataparametrar. Den här datakällan refererar till den utökade datatypen Beskrivning (EDT). Därefter definierar NumSeq-datakällan för typen beräknade fält. Datakällan innehåller uttrycket NUMSEQVALUE (AskNumSeq)
. När NumSeq-datakällan anropas returneras det nya genererade värdet för den nummersekvens som angavs vid körningen genom att ange dess kod i dialogrutan. Nummerserien begärs för omfattningstypen företag. Företagskoden tillhandahålls av kontexten som ER-formatet körs under.
Exempel 2
Du definierar följande datakällor i din modellmappning:
- Datakällan LedgerParms för typen tabell. Den här datakällan refererar till tabellen LedgerParameters.
- NumSeq-datakällan för typen beräknade fält. Datakällan innehåller uttrycket
NUMSEQVALUE ( LedgerParameters.'numRefJournalNum()'.NumberSequenceId)
.
När datakällan NumSeq kallas, returneras det nya genererade värdet för nummerserien som har konfigurerats i Redovisningsparametrar för det företag som tillhandahåller den kontext som ER-formatet körs under. Den här nummerserien identifierar unikt journaler och fungerar som ett batchnummer som kopplar ihop transaktionerna.
Exempel 3
Du definierar följande datakällor i din modellmappning:
- enumScope-datakällan för Microsoft Dynamics 365 Finance typen uppräkning. Den här datakällan refererar till den utökade uppräkningen ERExpressionNumberSequenceScopeType.
- NumSeq-datakällan för typen beräknade fält. Datakällan innehåller uttrycket
NUMSEQVALUE ("Gene_1", enumScope.Company, "")
.
När datakällan NumSeq kallas, returneras det nya genererade värdet för nummerserien Gene_1 som har konfigurerats för det företag som tillhandahåller den kontext som ER-formatet körs under.