Share via

Korzystanie ze źródeł danych DATA COLLECTION w formatach raportowania elektronicznego

  • Artykuł

Za pomocą projektanta operacji w strukturze elektronicznego modułu sprawozdawczego (ER) można skonfigurować składnik formatu rozwiązania ER używanego do generowania dokumentów wychodzących w różnych formatach. Hierarchiczna struktura skonfigurowanego składnika formatu składa się z elementów formatu różnych typów. Te elementy formatu służą do wypełniania wygenerowanych dokumentów informacjami wymaganymi w czasie wykonywania. Domyślnie w przypadku uruchamiania formatu ER elementy formatu są uruchamiane w tej samej kolejności, w jakiej są przedstawione w hierarchii formatów: jeden po jednym — od góry do dołu.

Gdy ER korzysta z formatu zawierającego powiązanie, zostanie uruchomiona formuła tego powiązania, a element formatu doda wartość do wygenerowanego dokumentu. Na przykład powiązanie może przekazać wartość pola modelu danych do elementu formatu. Źródło danych DATA COLLECTION można skonfigurować w taki sposób, aby zbierało wartości pól modelu danych w czasie wykonywania, sumowało wartości i wypełniało wygenerowany dokument zebranymi wartościami. Aby użyć tej metody, zmień początkowe powiązanie, tak aby skonfigurowane źródło danych DATA COLLECTION było używane do przekazania wartości pola modelu danych do elementu formatu. Przekazując wartości za pośrednictwem źródła danych DATA COLLECTION, można gromadzić wymagane szczegóły do dalszego użycia.

Konfigurując źródło danych DATA COLLECTION, należy określić typ wartości, który będzie zarządzany w źródle danych. Następujące typy danych są obecnie obsługiwane do zbierania wartości:

  • Wartość logiczna
  • Data
  • Data/godzina
  • Identyfikator Guid
  • Int64
  • Wartość całkowita
  • Rzeczywisty
  • Ciąg
  • Godzina

Za pomocą metody źródła danych DATA COLLECTION można przekazać wartość Collect(Value) do źródła danych w celu zbierania. W tej metodzie argument Value jest stałą lub prawidłową ścieżką pola źródła danych odpowiedniego typu danych.

Przy użyciu właściwości Result źródła danych DATA COLLECTION można uzyskać dostęp do listy zebranych wartości. Właściwość ta zwraca listę rekordów. Rekordy listy rekordów zawierają pole Value, które umożliwia dostęp do zebranych wartości.

Domyślnie źródło danych DATA COLLECTION zbiera tylko unikatowe wartości.

Aby zebrać wszystkie wartości, ustaw w polu Zbierz wszystkie wartości skonfigurowanego źródła danych DATA COLLECTION wartość Tak. Gdy w polu Zbierz wszystkie wartości jest ustawiona wartość Tak, dostępna jest parametryzowana właściwość Sum(Flag). Za pomocą tej właściwości można uzyskać sumę wszystkich aktualnie zebranych wartości. W tej właściwości argument Flag jest wartością logiczną, która służy do wskazania, czy wartość całkowita musi zostać zresetowana.

  • Po podaniu wartości False sumowanie jest kontynuowane od poprzednio zebranej kwoty.
  • Po podaniu wartości True rozpoczynane jest nowe sumowanie.

Następujące typy danych są obecnie obsługiwane do sumowania:

  • Int64
  • Wartość całkowita
  • Rzeczywisty

Zapoznaj się z następującym przykładem, aby dowiedzieć się więcej.

Przykład: konfigurowanie formatu ER w celu zliczania i sumowania przy użyciu źródła danych DATA COLLECTION

W tym przykładzie pokazano, w jaki sposób użytkownik występujący w roli Administrator systemu lub Konsultant funkcjonalny raportowania elektronicznego może skonfigurować format raportowania elektronicznego, który ma źródło danych DATA COLLECTION używane do obliczania sum bieżących i zbierania sumowanych wartości.

Zadania przedstawione w tym przykładzie można wykonać w kontekście firmy USMF w aplikacji Microsoft Dynamics 365 Finance.

Przekazywanie i używanie dostarczonego rozwiązania ER

  1. Importuj przykładowe konfiguracje ER.
  2. Aktywuj dostawcę konfiguracji.
  3. Przejrzyj zaimportowane mapowania modelu.
  4. Przeglądanie zaimportowanego formatu.
  5. Uruchamianie zaimportowanego formatu.

Wykonywanie formatu dostarczonego rozwiązania ER

  1. Na stronie Projektant formatów wybierz opcję Uruchom.

  2. W oknie dialogowym Parametry raportu elektronicznego wybierz przycisk OK.

  3. Pobierz plik przez przeglądarkę sieci Web i otwórz go do przeglądu.

    Pobrany plik zawierający wyniki początkowego wykonania formatu

Modyfikowanie formatu rozwiązania ER w celu obliczenia sumy uruchomionego podatku

Jeśli wielkość transakcji jest znacznie większa niż objętość w bieżącym przykładzie, czas wymagany na sumowanie może ulec wydłużeniu i spowodować problemy z wydajnością. Zmiana ustawień formatu pozwala uniknąć tych problemów z wydajnością. Ponieważ są dostępne wartości podatku w celu uwzględnienia ich w generowanym raporcie, można użyć tych informacji do zsumowania wartości podatku.

  1. Na stronie Projektant formatów, na karcie Mapowanie wybierz Dodaj źródło.

  2. W oknie dialogowym Dodawanie źródła danych wybierz kolejno pozycje Funkcje>Zbieranie danych.

  3. W oknie dialogowym Właściwości źródła danych „Zbieranie danych” wykonaj następujące czynności:

    1. W polu Nazwa wpisz CollectedTaxValues.
    2. W polu Typ przedmiotu wybierz Rzeczywisty.
    3. W polu Zbierz wszystkie wartości wybierz opcję Tak.
    4. Kliknij przycisk OK.

  4. Wybierz liczbowy element formatu Raport\Wiersze\Rekord\TaxAmount.

    Banknot

    Obecnie dla tego elementu jest skonfigurowane powiązanie @.Value. Z tego powodu generowany dokument jest wypełniany wartościami podatku z pola model.Data.List.Value.

  5. Wybierz opcję Edytuj formułę.

  6. Na stronie Projektant formuł wykonaj następujące kroki:

    1. W polu Formuła zmień wartość @.Value na CollectedTaxValues.Collect(@.Value).
    2. Zapisz zmiany i zamknij stronę.

    Banknot

    Nowe powiązanie przekaże te same wartości podatku do wygenerowanego dokumentu. Jednak te wartości są także zbierane w źródle danych CollectedTaxValues.

  7. Wybierz liczbowy element formatu Raport\Wiersze\Rekord\RunnintTotal.

  8. Wybierz opcję Edytuj formułę.

  9. Na stronie Projektant formuł wykonaj następujące kroki:

    1. W polu Formuła wpisz CollectedTaxValues.Sum(false).
    2. Zapisz zmiany i zamknij stronę.

    Banknot

    Nowe powiązanie przekaże do wygenerowanego dokumentu sumę wartości podatku, które zostały już wprowadzone.

    Elementy liczbowe, które zaktualizowały powiązania na stronie Projektant formatów

  10. Wybierz Zapisz i następnie wybierz Uruchom.

  11. W oknie dialogowym Parametry raportu elektronicznego wybierz przycisk OK.

  12. Pobierz plik przez przeglądarkę sieci Web i otwórz go do przeglądu.

    Pobrany plik zawierający wyniki zmodyfikowanego wykonania formatu

Modyfikowanie formatu, aby ocenić listę zebranych wartości podatku

  1. Na stronie Projektant formatów, na karcie Format wybierz element liczbowy formatu Report\Wiersze\Rekord\RunningTotal, a następnie wykonaj następujące kroki:

    1. W polu Typ liczbowy zmień wartość z Rzeczywisty na Całkowity.
    2. W polu Format liczbowy zmień wartość z F2 na F0.

  2. Na karcie Mapowanie wybierz opcję Edytuj formułę.

  3. Na stronie Projektant formuł wykonaj następujące kroki:

    1. W polu Formuła wpisz COUNT(CollectedTaxValues.Result).
    2. Zapisz zmiany i zamknij stronę.

    Banknot

    Nowe powiązanie przekaże do wygenerowanego dokumentu liczbę rekordów z listy, na której są zbierane wartości podatku.

  4. Wybierz Zapisz i następnie wybierz Uruchom.

  5. W oknie dialogowym Parametry raportu elektronicznego wybierz przycisk OK.

  6. Pobierz plik przez przeglądarkę sieci Web i otwórz go do przeglądu.

    Pobrany plik zawierający wyniki innego zmodyfikowanego wykonania formatu

Często zadawane pytania

Jaka jest różnica między używaniem źródła danych DATA COLLECTION a wbudowanych funkcji DATA COLLECTION, jeśli są obliczane sumy bieżące i zbierane dane?

Zarówno źródła danych DATA COLLECTION, jak i wbudowanych funkcji DATA COLLECTION można używać do zbierania danych, sumowania i zliczania na podstawie informacji przekazywanych do wygenerowanego dokumentu wychodzącego. Jednak, gdy próbujesz zdecydować, której metody użyć, musisz wziąć pod uwagę następujące kwestie.

Źródło danych Funkcje wbudowane
Zbierane są tylko wartości.

Zbierane są nazwane wartości. W związku z tym sumy można obliczać dla oddzielnych grup wartości.

Ponadto grupy mogą być wyodrębnione jako listy.

Można także zbierać wartości tekstowe.
Unikatowe wartości są zbierane automatycznie. Dodatkowe ustawienia są wymagane, aby wyodrębnić listę unikatowych wartości ze zebranych wartości.
Wydajność zależy od objętości zebranych wartości. W praktyce wydajność nie zależy od objętości zebranych wartości.
Ta technika działa ze wszystkimi typami dokumentów wychodzących. Ta technika działa tylko z dokumentami tekstowymi i XML.

Dodatkowe zasoby