遞延執行 ER 格式的序列元素

概觀

您可以使用電子報表 (ER) 架構的作業設計工具來設定 ER 解決方案的格式組件，用於產生文字格式的輸出文件。 設定的格式組件的階層由各種類型的格式元素組成。 這些格式元素用於在執行階段用所需資訊填入產生的文件。 在預設情況下，當您執行 ER 格式時，格式元素的執行順序與它們在格式階層中的顯示順序相同：一個接一個，從上到下。 但是，在設計階段，您可以更改已設定格式組件的任何序列元素的執行順序。

透過打開設定格式的序列格式元素的 遞延執行 選項，您可以遞延 (遞延) 該元素的執行。 在這種情況下，該元素不會執行，直到其父元素的所有其他元素都已執行。

若要進一步了解此函數，請完成本主題中的範例。

限制

遞延執行 選項僅支援為 ER 格式設定的序列元素，該格式用於產生文字格式的 輸出 文件。

遞延執行 選項不適用於已設定為最大長度受限的修剪序列的序列。

範例：遞延執行 ER 格式的序列元素

以下步驟說明系統管理員或電子報表函數顧問角色的使用者如何設定包含序列元素的ER格式，其中執行順序與格式階層中的順序不同。

這些步驟可以在 Microsoft Dynamics 365 Finance 的 USMF 公司中進行。

先決條件

若要完成此範例，您必須有權存取 Finance 中的 USMF 公司並擔任以下角色之一：

• 電子報表函數
• 系統管理員

如果您還沒有完成 遞延執行 ER 格式的 XML 元素主題中的範例，請下載以下 ER 解決方案樣本的設定。

內容描述	檔案名稱
ER 資料模型設定	學習已遞延元素的模型.版本.1.xml
ER 模型對應設定	學習已遞延元素的對應.版本.1.1.xml

在您開始之前，您還必須下載並儲存以下樣本 ER 解決方案的設定。

內容描述	檔案名稱
ER 格式設定	學習已遞延序列元素的格式.版本.1.1.xml

匯入樣本 ER 設定

1. 進入 組織管理>工作區>電子報表。

2. 選取 報表設定。

3. 在 設定 頁面，如果設定樹狀結構中沒有 Model to learn deferred elements 設定，請匯入 ER 資料模型設定。

   1. 選取 Exchange，然後選取 從 XML 檔案載入。
   2. 選取 瀏覽，找到並選取 學習已遞延元素的模型.1.xml，然後選取 確定。

4. 如果設定樹狀結構中沒有 學習已遞延元素的對應 設定，請匯入 ER 模型的對應設定。

   1. 選取 Exchange，然後選取 從 XML 檔案載入。
   2. 選取 瀏覽，找到並選取 學習已遞延元素的對應.1.1.xml，然後選取 確定。

5. 匯入 ER 格式設定：

   1. 選取 Exchange，然後選取 從 XML 檔案載入。
   2. 選取 瀏覽，找到並選取 學習已遞延序資料列的格式.1.1.xml，然後選取 確定。

6. 在設定樹狀結構中，展開 學習已遞延元素的模型。

7. 查閱設定樹狀結構中匯入的 ER 設定清單。

   

啟用設定提供者

1. 進入 組織管理>工作區>電子報表。

2. 在 本地化設定 頁面，在 設定提供者 區段，確保列出 Litware, Inc. (http://www.litware.com) 樣本公司的設定提供者，並且被標記為有效。 如果此設定提供者未列出，或者未標記為有效，按照建立設定提供者並將其標記為有效中的步驟。

   

查閱匯入的資料對應

查看 ER 模型對應組件的設定，該組件設定為存取稅務交易並根據要求公開存取的資料。

1. 進入 組織管理>工作區>電子報表。

2. 選取 報表設定。

3. 在 設定 頁面上，在左側窗格中的設定樹狀結構中，展開 學習已遞延元素的模型。

4. 選取 學習已遞延元素的對應 設定。

5. 選取 設計工具 開啟對應清單。

6. 選取 設計工具 查看對應詳情。

7. 選取 顯示詳情。

8. 查閱設定為存取稅務交易的資料來源：

   • 資料表記錄 類型的 交易 資料來源被設定為存取 TaxTrans 申請表的記錄。

   • 導出欄位 類型的 憑證 資料來源被設定為以記錄清單的形式返回所需的憑證代碼 (INV-10000349 和 INV-10000350)。

   • 導出欄位 類型的 已過濾 資料來源被設定為從 交易 資料來源中只選取所需憑證的稅務交易。

   • 導出欄位 類型的 $TaxAmount 欄位是為 已過濾 資料來源新增的，以揭露具有相反符號的稅值。

   • 分組依據 類型的 已分組 資料來源設定為對 已過濾 資料來源的過濾稅務交易進行分組。

   • 已分組 資料來源的 TotalSum 彙總欄位設定為匯總該資料來源的所有已過濾稅務交易的 已過濾 資料來源的 $TaxAmount 欄位的值。

     

9. 查看設定的資料來源如何繫結到資料模型，以及它們如何公開存取的資料以使其以 ER 格式可用：

   • 已過濾 資料來源繫結到資料模型的 Data.List 欄位。
   • 已過濾 資料來源的 $TaxAmount 欄位繫結到資料模型的 Data.List.Value 欄位。
   • 已分組 資料來源的 TotalSum 欄位繫結到資料模型的 Data.Summary.Total 欄位。

   

10. 關閉 模型對應設計工具 和 模型對應 頁。

查閱已匯入的格式

1. 在 設定 頁面上，在左側窗格中的設定樹狀結構中，選取 學習已遞延序列的格式 設定。

2. 選取 設計工具 查看格式詳情。

3. 選取 顯示詳情。

4. 查看 ER 格式組件的設定，這些組件設定為產生文字格式的輸出文件，其中包括稅務交易的詳情：

   • 將 報告\明細 序列格式元素設定為用從巢狀的序列元素 (標題、記錄，和 摘要) 產生的單明細來填入輸出文件。

     

   • 將 報告\明細\標題 序列格式元素設定為使用單個標題明細填入輸出文件，該標題節點顯示處理開始的日期和時間。

   • 將 報告\明細\記錄 序列格式元素設定為使用單個記錄節點填入輸出文件，該記錄節點顯示單個稅務交易的詳情。 這些稅務交易以分號分隔。

     

   • 將 報告\明細\摘要 序列格式元素設定為使用單個匯總明細填入輸出文件，該節點包括來自已處理稅務交易的稅務值的總和。

5. 在 對應 索引標籤上，查看以下詳情：

   • 報告\明細\標題 元素不必繫結到資料來源以在輸出文件中產生單個明細。
   • 這 Prefix1 元素產生 P1 符號表示新增的明細是報表標題明細。
   • ExecutionDateTime 元素產生新增標題明細時的日期和時間 (包括毫秒)。
   • 將 報告\明細\記錄 元素繫結到 model.Data.List 清單，以便為繫結清單中的每條記錄產生單個明細。
   • Prefix2 元素產生 P2 符號，表明所新增的明細是用於稅收交易細節。
   • 將 TaxAmount 元素繫結到 model.Data.List.Value (在相對路徑視圖中顯示為 @.Value) 以產生現行的稅務交易。
   • RunningTotal 元素是稅值執行總計的預留位置。 現行，該元素沒有輸出，因為沒有為其設定繫結或預設值。
   • ExecutionDateTime 元素產生在此報告中處理現行交易的日期和時間 (包括毫秒)。
   • 報告\明細\摘要 元素不必繫結到資料來源以在輸出文件中產生單個明細。
   • Prefix3 元素產生 P3 符號，表示被新增的明細包含總的稅值。
   • 將 TotalTaxAmount 元素繫結到 model.Data.Summary.Total 以產生已處理稅務交易的稅值總和。
   • ExecutionDateTime 元素產生新增摘要明細時的日期和時間 (包括毫秒)。

   

執行已匯入的格式

1. 在 格式設計工具 頁面上，選取 執行。

2. 下載網路瀏覽器提供的檔案，然後打開它以供查看。

   

請注意，匯總明細 22 顯示已處理交易的稅值總和。 因為將格式設定為使用 model.Data.Summary.Total 繫結來回傳這個總和，這個總和是透過調用使用模型對應的 GroupBy 類型的 Grouped 資料來源的 TotalSum 彙總來計算的。 若要計算這個彙總，模型對應在所有在 已過濾 資料來源中被選中的交易上進行反覆運算。 透過比較明細 21 和明細 22 的執行時間，您可以確定總和的計算花費了 10 毫秒 (ms)。 透過比較明細 2 和明細 21 的執行時間，您可以確定，產生所有交易性的明細需要 7 毫秒。 因此，總共需要 17 毫秒。

修改格式，以便在產生的輸出基礎上進行求和

如果交易量遠大於現行範例中的量，則求和時間可能會增加並導致效能問題。 透過更改格式設定，您可以幫助防止這些效能問題。 因為您存取稅值以將它們包含在產生的報告中，所以您可以重複使用此資訊來求和稅值。 如需相關資訊，請參閱設定格式進行計數和求和。

1. 在 格式設計工具 頁面上，在 格式 索引標籤上，選取格式樹狀結構中的 報告 檔案元素。

2. 將 收集輸出詳情 選項設定 是。 現在您可以透過使用現有的報告內容作為資料來源來設定這種格式，可以透過使用資料收集類別中的內建 ER 函數來存取。

3. 在 對應 索引標籤上，選取 報告\明細 序列元素。

4. 將 收集的資料鍵名稱 運算式設定為 WsColumn。

5. 將 收集的資料鍵值 運算式設定為 WsRow。

   

6. 選取 報告\明細\記錄\營業稅額 數字元素。

7. 將 收集的資料鍵名稱 運算式設定為 SummingAmountKey。

   

   您可以將此設定視為虛擬工作表的實現，其中儲存格 A1 的值附加了每個已處理稅收交易的稅額值。

8. 選取 報告\明細\記錄\執行總計 數字元素，然後選取 編輯公式。

9. 透過使用內建的SUMIF ER 函數設定 SUMIF(SummingAmountKey, WsColumn, WsRow) 運算式。

10. 選取 儲存。

    

11. 關上 公式設計工具 頁面。

12. 選取 儲存，然後選取 執行。

13. 下載並查看網路瀏覽器提供的檔案。

    

    明細 21 包含使用產生的輸出作為資料來源為所有已處理交易計算的稅值的執行總計。 此資料來源從報告的開頭開始，一直持續到最後一個稅務交易。 明細 22 包含所有處理過的交易的稅值之和，這些稅值是透過使用 GroupBy 類型的資料來源在模型對應中計算出來的。 請注意，這些值是相等的。 因此，可以用基於輸出的求和法來代替 GroupBy。 透過比較明細 2 和明細 21 的執行時間，您可以確定，產生所有交易性的明細和求和需要 9 毫秒。 因此，就產生細目和匯總稅值而言，修改後的格式比原來的格式快了大約兩倍。

14. 選取 報告\明細\摘要\營業稅額總計 數字元素，然後選取 編輯公式。

15. 輸入 SUMIF(SummingAmountKey, WsColumn, WsRow) 運算式而不是現有運算式。

16. 選取 儲存，然後選取 執行。

17. 下載並查看網路瀏覽器提供的檔案。

    

    請注意，最後一筆交易明細明細中的稅款總額現在等於摘要明細的總和。

將基於輸出的求和值放在報表標題中

例如，如果您必須在報表標題中顯示稅值總和，您可以修改格式。

1. 在 格式設計工具 頁面上，在 格式 索引標籤上，選取 報告\明細\摘要 序列元素。

2. 選取 上移。

3. 選取 儲存，然後選取 執行。

4. 下載並查看網路瀏覽器提供的檔案。

   

   請注意，摘要明細 2 的稅值之和現在等於 0 (零)，因為這個總和現在是根據產生的輸出計算的。 當產生明細 2 時，產生的輸出還不包含有交易細節的明細。 您可以設定這種格式，遞延執行 報告\明細\摘要 序列元素，直到 報告\明細\記錄 序列元素對所有稅務交易執行完畢。

遞延匯總序列元素的執行，以便使用計算的總數

1. 在 格式設計工具 頁面上，在 格式 索引標籤上，選取 報告\明細\摘要 序列元素。

2. 將 遞延執行 選項設定為 是。

   

3. 選取 儲存，然後選取 執行。

4. 下載並查看網路瀏覽器提供的檔案。

   

   現在，報告\明細\摘要 序列元素只有在巢狀在其父元素 報告\明細 下的所有其他項目被執行後才會被執行。 因此，它是在對 model.Data.List 資料來源的所有稅務交易執行了 報告\明細\記錄 序列元素後執行的。 明細 1、2、3 和最後一則明細 22 的執行時間揭示了這個事實。

其他資源

• 設定格式進行計數和求和
• 追蹤 ER 格式的執行，以解決效能問題
• 遞延執行 ER 格式的 XML 元素