NUMSEQVALUE, funkcja ER
Funkcja NUMSEQVALUE zwraca wartość typu Ciąg, która reprezentuje nową wygenerowaną wartość sekwencji numerów na podstawie określonej sekwencji numerów, zakres i identyfikatora zakresu. Identyfikator zakresu jest równy kodowi firmy podawanemu przez kontekst, w którym jest uruchamiany format modułu Raportowanie elektroniczne (ER).
Składnia 1
NUMSEQVALUE (number sequence code)
Składnia 2
NUMSEQVALUE (number sequence record ID)
Składnia 3
NUMSEQVALUE (number sequence code, scope type, scope ID)
Argumenty
number sequence code : Ciąg
Wartość tekstowa reprezentująca kod sekwencji numerów, w którym jest wymagana nowa wartość.
number sequence record ID: Int64
Wartość Int64 reprezentująca identyfikator rekordu w tabeli NumberSequenceTable zawierającej definicję sekwencji numerów, w której jest wymagana nowa wartość.
scope type: Wartość wyliczenia
Wartość wyliczenia ERExpressionNumberSequenceScopeType, która definiuje zakres sekwencji numerów, w której jest wymagana nowa wartość. Dostępne typy zakresów to Udostępnione, Podmiot prawny i Firma.
scope ID : Ciąg
Wartość typu Ciąg, która identyfikuje zakres na podstawie określonego typu zakresu.
Wartości zwracane
Ciąg
Wynikowa wartość tekstowa.
Uwagi dotyczące użytkowania
Dla typu zakresu Udostępnione należy określić pusty ciąg jako identyfikator zakresu.
Dla typów zakresów Firma i Podmiot prawny należy podać kod firmy jako identyfikatora zakresu. Jeśli pusty ciąg jako identyfikator zakresu dla tych typów zakresów, zostanie użyty bieżący kod firmy.
Gdy używana jest składnia 1, jest wymagana sekwencja numerów dla typu zakresu Firma, a kod firmy jest dostarczany przez kontekst, w którym jest uruchomiony format ER.
Przykład 1
W formacie ER definiujesz źródło danych AskNumSeq typu Parametr wejściowy użytkownika. To źródło danych odwołuje się do rozszerzonego typu danych (EDT) Opis. Następnie definiujesz źródło danych NumSeq typu Pole obliczeniowe. To źródło danych zawiera wyrażenie NUMSEQVALUE (AskNumSeq). Gdy następuje wywołanie źródła danych NumSeq, jest zwracana nowa wygenerowana wartość sekwencji numerów, która została określona w czasie wykonywania przez wprowadzenie kodu w oknie dialogowym. Sekwencja numerów jest wymagana dla typu zakresu Firma. Kod firmy jest dostarczany przez kontekst, w którym jest uruchamiany format ER.
Przykład 2
W mapowaniu modelu są definiowane następujące źródła danych:
- Źródło danych LedgerParms typu Tabela. To źródło danych odnosi się do tabeli LedgerParameters.
- Źródło danych NumSeq typu Pole obliczeniowe. To źródło danych zawiera wyrażenie
NUMSEQVALUE ( LedgerParameters.'numRefJournalNum()'.NumberSequenceId).
Gdy zostanie wywołane źródło danych NumSeq, zwróci nowo wygenerowaną wartość numeracji skonfigurowanej w oknie Parametry księgi głównej dla firmy dostarczającej kontekst, w którym jest wykonywany format raportowania elektronicznego. Ta numeracja jednoznacznie identyfikuje arkusze i dostarcza numer partii, który łączy transakcje ze sobą.
Przykład 3
W mapowaniu modelu są definiowane następujące źródła danych:
- Źródło danych enumScope w aplikacji Microsoft Dynamics 365 Finance typu wyliczenie. To źródło danych odwołuje się do wyliczenia ERExpressionNumberSequenceScopeType.
- Źródło danych NumSeq typu Pole obliczeniowe. To źródło danych zawiera wyrażenie
NUMSEQVALUE ("Gene_1", enumScope.Company, "").
Gdy zostanie wywołane źródło danych NumSeq, zwróci nowo wygenerowaną wartość numeracji Gene_1 skonfigurowanej dla firmy dostarczającej kontekst, w którym jest wykonywany format raportowania elektronicznego.