Podpora parametrizovaných volání zdrojů dat ER typu vypočítaného pole

V tomto článku je vysvětleno, jak můžete vytvořit zdroj dat Elektronického vykazování (ER) pomocí typu Vypočítaného pole. Tento zdroj dat může obsahovat výraz ER, který po spuštění může být řízen hodnotami argumentů parametrů, které jsou nakonfigurovány ve vazbě, která volá tento zdroj dat. Konfigurací parametrizovaných volání takového zdroje dat můžete znovu použít jeden zdroj dat v mnoha vazbách, čímž snížíte celkový počet datových zdrojů, které musí být nakonfigurovány v mapování modelu ER nebo ve formátech ER. Také zjednodušuje konfigurovanou komponentu ER, která snižuje náklady na údržbu a náklady na použití ostatních odběratelů.

Předpoklady

Pro dokončení příkladů v tomto článku, musíte mít následující přístup:

• Přístup k jedné z těchto rolí:

  • Návrhář elektronického výkaznictví
  • Funkční konzultant elektronického výkaznictví
  • Správce systému

• Přístup k službám Regulatory Configuration Services (RCS), které byly zřízeny pro stejného klienta jako finance a provoz, pro jednu z následujících rolí:

  • Návrhář elektronického výkaznictví
  • Funkční konzultant elektronického výkaznictví
  • Správce systému

Je také nutné stáhnout a lokálně uložit následující soubory.

Obsah	Název souboru
Vzorová konfigurace datového modelu elektronického výkaznictví	Model pro informace o volání s parametry calls.version.1.xml
Vzorová konfigurace metadat elektronického výkaznictví	Metadata pro informace o volání s parametry calls.version.1.xml
Vzorová konfigurace mapování elektronického výkaznictví	Mapování pro informace o volání s parametry calls.version.1.1.xml
Vzorová konfigurace formátu elektronického výkaznictví	Formát pro informace o volání s parametry calls.version.1.1.xml

Přihlaste se k instanci RCS.

V tomto příkladu vytvoříte konfiguraci pro vzorovou společnost Litware, Inc. Nejprve musíte v RCS dokončit krok v proceduře Vytvoření poskytovatelů konfigurace a jejich označení jako aktivních.

1. Na výchozím řídicím panelu vyberte Elektronické vykazování.

2. Vyberte Konfigurace vykazování.

3. Import stažených konfigurací do RCS v následujícím pořadí: datový model, metadata, mapování modelu, formát. Pro každou konfiguraci ER proveďte následující kroky:

   1. Vyberte Exchange.
   2. Vyberte Načíst ze souboru XML.
   3. Zvolte Procházet a pak vyberte požadovanou konfiguraci elektronického výkaznictví ve formátu XML.
   4. Vyberte OK.

Zkontrolovat poskytnuté řešení ER

Kontrola mapování modelu

1. Ve stromu konfigurace rozbalte obsah položky Model pro seznámení s parametrizovanými voláními.

2. Vyberte Mapování pro informace o voláních s parametry.

3. Vyberte možnost Návrhář.

4. Vyberte možnost Návrhář.

   Toto mapování modelu ER je navrženo k následujícím akcím:

   • Načtení seznamu daňových kódů (Daňový zdroj dat) nacházející se v tabulce TaxTable.

   • Načtení seznamu daňových transakcí (Trans zdroj dat) nacházející se v tabulce TaxTrans:

     • Seskupit seznam načtených transakcí (Gr zdroj dat) podle kódu daně

     • Vypočítat pro seskupené transakce po agregovaných hodnotách podle kódu daně:

       • Součet hodnot základu daně.
       • Součet hodnot daně.
       • Minimální hodnota uplatněné sazby daně.

   Mapování modelu v této konfiguraci implementuje základní datový model pro všechny formáty ER vytvořené pro tento model a prováděné ve financích a provozu. V důsledku toho je obsah zdrojů dat Daň a Gr vystaven pro formáty ER, jako jsou například abstraktní zdroje dat.

   

5. Zavřete stránku Návrhář mapování modelu.

6. Zavřete stránku Mapování modelu.

Zkontrolovat formát

1. Ve stromu konfigurace rozbalte obsah položky Model pro seznámení s parametrizovanými voláními.

2. Vyberte Formát pro informace o voláních s parametry.

3. Vyberte možnost Návrhář. Tento formát ER je navržen k následujícím akcím:

   • Generujte daňový výkaz ve formátu XML.
   • V daňovém výkazu prezentujte následující úrovně zdanění: normální, snížené a žádné.
   • Prezentujte více podrobností na každé úrovni zdanění, které mají různý počet podrobností na každé úrovni.

   

4. Vyberte Mapování.

5. Rozbaltepoložky Model, Data a Souhrnné .

   Vpočítané pole Model.Data.Summary.Leve obsahuje výraz vracející kód úrovně zdanění (Pravidelný, Snížený, Žádný nebo Jiný) jako textovou hodnotu pro libovolný kód daně, který lze načíst ze zdroje dat Model.Data.Summary za běhu.

   

6. Rozbalte položku Model.Data2.

7. Rozbalte položku Model.Data2.Summary2.

   Datový zdroj Model.Data2.Summary2 je konfigurováno pro seskupení podrobností transakcí datového zdroje Model.Data.Summary podle úrovně zdanění (vráceno vypočítaným polem Model.Data.Summary.Level) a výpočet agregací.

   

8. Zkontrolujte vypočítaná pole Model.Data2.Level1, Model.Data2.Level2 a Model.Data2.Level3. Tato vypočítaná pole slouží k filtrování seznamu záznamů Model.Data2.Summary2 a vrátí pouze záznamy, které reprezentují určitou úroveň zdanění.

9. Zavřete stránku Návrhář formátu.

Vytvoření odvozeného formátu

Poskytnutý formát lze zlepšit přidáním jednoho vypočítaného pole pro filtrování požadované úrovně zdanění namísto použití existujících tří polí: Model.Data2.Level1, Model.Data2.Level2 a Model.Data2.Level3. Požadovanou úroveň zdanění lze zadat v místě, kde bude voláno nové vypočtené pole.

1. Ve stromu konfigurace rozbalte obsah položky Model pro seznámení s parametrizovanými voláními.
2. Vyberte Formát pro informace o voláních s parametry.
3. Vyberte Vytvořit konfiguraci.
4. Vyberte možnost Odvozeno od názvu: Formát pro informace o parametrizovaných volání, Microsoft.
5. Do pole Název zadejte Formát pro učení parametrizovaných volání (vlastní).
6. Vyberte Vytvořit konfiguraci.

Konfigurace parametrizovaného vypočítaného pole, které vrací seznam záznamů

Začít přidávat nové počítané pole

1. Vyberte možnost Návrhář.
2. Vyberte Rozbalit/sbalit pro rozbalení všechn položek formátu.
3. Vyberte Mapování.
4. Rozbalte položku Model.
5. Vyberte položku Model.Data2.
6. Vyberte přidat.
7. Vyberte Funkce\vypočítané pole.
8. Do pole Název zadejte Úrovně.
9. Vyberte možnost Upravit vzorec.

Definovat parametr pro přidání vypočítaného pole

1. Vyberte Parametry.

2. Zvolte Nové.

3. Do pole Název zadejte Úroveň zdanění.

4. V poli Typ vyberte Řetězec.

   K zadání typu argumentu parametru lze použít pouze primitivní datové typy. Proto nelze pro tento účel použít typy Seznam záznamů, Záznam a Výčet.

   Maximální počet parametrů, které lze zadat pro jedno vypočtené pole, je 8.

   

5. Vyberte OK.

Přidáte-li tento parametr, zadáte podmínku, která musí být na místě, aby bylo možné toto vypočtené pole volat. Při volání tohoto vypočítaného pole je nutné zadat argument parametru Úroveň zdanění jako hodnotu s formátem Řetězec.

Ujistěte se, že definujete parametry pouze pro vypočítaná pole, která jsou uložena v kontejneru (Seznam záznamů, Záznam nebo Kontejner).

Konfigurovaný parametr je k dispozici v seznamu zdrojů dat pro toto vypočtené pole. Chcete-li přidat parametr do konfigurovaného výrazu, vyberte možnost Přidat zdroj dat.

Definovat výraz pro přidání vypočítaného pole

1. Do pole Vzorec zdejte:

   WHERE(@.Summary2, @.Summary2.grouped.Level =

2. V seznamu zdrojů dat vyberte parametr Úroveň zdanění.

3. Vyberte Přidat zdroj dat.

4. V poli Vzorec dokončete výraz jako:

   WHERE(@.Summary2, @.Summary2.grouped.Level = 'Taxation Level')

5. Zvolte možnost Uložit.

   

6. Zavřete stránku Návrhář vzorce.

Dokončete přidávávání nových počítaných polí

• Vyberte OK.

Na stránce Návrhář formátu je v konfigurovaných vypočítaných polích Úrovně vyžadován argument Řetězec.

Použít nakonfigurované počítané pole pro prvky formátu vazby

1. Výběrem Model.Data2.Levels vyberte nakonfigurované počítané pole.

2. Vyberte prvek formátu Statement.Taxation.Regular.

3. Vyberte možnost vazba.

4. Vyberte možnost Ano, pokud chcete potvrdit nahrazení aktuálně používaného zdroje dat Level1 novým zdrojem dat Levels ve všech vnořených formátovacích prvcích vybraného prvku formátu.

   Použitá vazba byla sestavena jako volání parametrizovaného počítaného pole. Standardně se název prvku vázaného formátu používá jako argument pro parametrizované počítané pole za následujících podmínek:

   • Vypočítané pole je nakonfigurováno pro použití jediného parametru.
   • Datový typ tohoto parametru je definován jako Řetězec.

   Je-li název prvku vázaného formátu prázdný, bude název zdroje dat tohoto prvku použit v použité vazbě.

5. Vyberte prvek formátu Statement.Taxation.Reduced.

6. Vyberte možnost vazba.

7. Vyberte možnost Ano, pokud chcete potvrdit nahrazení aktuálně používaného zdroje dat Level2 novým zdrojem dat Levels ve všech vnořených formátovacích prvcích vybraného prvku formátu.

8. Vyberte prvek formátu Statement.Taxation.None.

9. Vyberte možnost vazba.

10. Vyberte možnost Ano, pokud chcete potvrdit nahrazení aktuálně používaného zdroje dat Level3 novým zdrojem dat Levels ve všech vnořených formátovacích prvcích vybraného prvku formátu.

Když zadáte argument parametrizovaného pole pro prvek XML představující úroveň zdanění (například Model.Data2.Levels("Reduced") jako textovou hodnotu), nemusíte provádět stejnou akci pro vnořené atributy XML – jejich vazby automaticky zdědí hodnotu argumentu definovaného na nadřazené úrovni (Model.Data2.Levels.aggregated.Base, nikoli Model.Data2.Levels("Reduced").aggregated.Base).

Opakující se volání jakéhokoliv parametrizovaného pole nejsou podporována.

Můžete vybrat možnost Upravit vzorec a změnit argument vyrovnáno podle výchozího pole ve vybrané vazbě. Pokud tento argument chybí, může způsobit chyby za běhu – uživatelé jsou informováni o takové situaci, když je aktuální formát ověřen.

Konfigurace parametrizovaného vypočítaného pole pro návrat záznamu

Pokud parametrizované pole vrací záznam, je nutné podporovat vazby jednotlivých polí tohoto záznamu k formátování prvků. V takovém případě nebude existovat žádná nadřazená vazba, která obsahuje hodnotu argumentu pro volání parametrizovaného počítaného pole - tato hodnota musí být definována ve vazbě pole jednoho záznamu.

Začít přidávat nové počítané pole

1. Vyberte položku Model.Data2.
2. Vyberte přidat.
3. Vyberte Funkce\vypočítané pole.
4. Do pole Název zadejte LevelRecord.
5. Vyberte možnost Upravit vzorec.

Definovat parametr pro přidání vypočítaného pole

1. Vyberte Parametry.
2. Zvolte Nové.
3. Do pole Název zadejte Úroveň zdanění.
4. V poli Typ vyberte Řetězec.
5. Vyberte OK.

Definovat výraz pro přidání vypočítaného pole

1. V poli Vzorec zadejte následující:

   FIRSTORNULL(@.Levels(

2. Vyberte parametr Úroveň zdanění.

3. Vyberte Přidat zdroj dat.

4. V poli Vzorec přidejte "Úroveň zdanění")) do stavu, který jste zadali v kroku 1 a dokončete výraz na:

   FIRSTORNULL(@.Levels('Taxation Level'))

5. Zvolte možnost Uložit.

6. Zavřete stránku Návrhář vzorce.

Dokončete přidávávání nových počítaných polí

• Vyberte OK.

Použít nakonfigurované počítané pole pro svázání prvků formátu

1. Rozbalením Model.Data2.LevelRecord vyberte nakonfigurované počítané pole.
2. Rozbalte kontejner Model.Data2.LevelRecord.aggregated nakonfigurovaného počítaného pole.
3. Vyberte pole Model.Data2.LevelRecord.aggregated.Base.
4. Vyberte prvek formátu Statement.Taxation.None.
5. Vyberte možnost Zrušit vazbu.
6. Vyberte prvek formátu Statement.Taxation.None.Base.
7. Vyberte možnost vazba.
8. Vyberte možnost Upravit vzorec.
9. Změňte výraz na Model.Data2.LevelRecord("None").aggregated.Base.

Odebrat vypočtená pole, která nejsou použita

1. Vyberte Model.Data2.Level1.
2. Zvolte Odstranit.
3. Vyberte Model.Data2.Level2.
4. Zvolte Odstranit.
5. Vyberte Model.Data2.Level3.
6. Zvolte Odstranit.
7. Zvolte možnost Uložit.

Poznámka

Znovu jste použili stejný model počítaného pole Model.Data2.Levels několikrát ve formátu vazeb. Je mnohem jednodušší použít a udržovat jedno vypočítané pole namísto více podobných polí.

8. Zavřete stránku Návrhář formátu.

Dokončete upravenou verzi odvozeného formátu

1. Na pevné záložce Verze vyberte možnost Stav změny.
2. Zvolte Dokončit.

Exportujte dokončenou verzi odvozeného formátu

1. Vyberte Formát pro učení parametrizovaných volání (vlastní) ve stromu konfigurací.
2. Na pevné záložce Verze vyberte dokončenou verzi 1.1.1.
3. Vyberte Exchange.
4. Vyberte Exportovat jako soubor XML.
5. Uloží staženou konfiguraci místně ve formátu XML.

Testovat formáty ER

Chcete-li se ujistit, že nakonfigurovaná počítaná pole fungují správně, můžete spustit počáteční a vylepšené formáty ER.

Import konfigurací ER

Revidované konfigurace lze importovat z RCS pomocí úložiště ER typu RCS. Pokud jste již provedli kroky v článku, Import konfigurací elektronického výkaznictví (ER) z Regulatory Configuration Services (RCS), použijte nakonfigurované úložiště ER pro import konfigurací popsaných dříve v tomto článku do vašeho prostředí. V opačném případě postupujte takto:

1. Vyberte společnost DEMF a na výchozím řídicím panelu vyberte možnost Elektronické vykazování.

2. Vyberte Konfigurace vykazování.

3. Import stažených konfigurací z Microsoft Download Center v následujícím pořadí: datový model, mapování modelu, formát. Pro každou konfiguraci ER proveďte následující kroky:

   1. Vyberte Exchange.
   2. Vyberte Načíst ze souboru XML.
   3. Zvolte Procházet a vyberte požadovanou konfiguraci elektronického výkaznictví ve formátu XML.
   4. Vyberte OK.

4. Importujte exportované z RCS dokončené verze 1.1.1 Formát pro učení parametrizovaných volání (vlastní):

   1. Vyberte Exchange.
   2. Vyberte Načíst ze souboru XML.
   3. Vyberte Procházet a vyberte místně uložený soubor Formát pro učení parametrizovaných volání (vlastní) ve formátu XML.
   4. Vyberte OK.

Spustit formáty ER

1. Ve stromu konfigurace rozbalte obsah položky Model pro seznámení s parametrizovanými voláními.
2. Vyberte Formát pro informace o voláních s parametry.
3. Vyberte Spustit na horním pásu.
4. Uložte místně generovaný výstup.
5. Vyberte položku Formát pro učení parametrizovaných volání (vlastní).
6. Vyberte Spustit na horním pásu.
7. Uložte generovaný výstup místně.
8. Porovnejte obsah generovaných výstupů.

Další prostředky

• Návrhář receptur v elektronickém výkaznictví
• Zlepšete výkon řešení elektronického výkaznictví přidáním parametrizovaných zdrojů dat typu POČÍTANÉ POLE