使用瀏覽打開主題

關於 SAP IDoc 檔案

SAP 中間文件 (IDoc) 檔案由分組成幾個區段的資料欄位組成。各區段之間彼此具有階層關係。

SAP 是 SAP Aktiengesellschaft (SAP AG) 的商標。

關閉階層範例

醫生為醫院患者所開立的處方必須傳到醫院的藥局。程式從病床傳輸到藥局，此傳遞過程可以透過 IDoc 來實現。

假定 IDoc 具有四個等級的區段階層，如下所示。

患者姓名：張大發

診斷結果：哮吼

診斷結果：脛骨骨折

就診類型：住院

藥名：Codeine

藥名：Amidol

就診類型：複診

藥名：Naprosin

第 1 級：第 1 級：包含的資料一旦經儲存後將維持數年不變，例如患者姓名和住址。

第 2 級：包含的資料在特定疾病過程中維持不變、但會因疾病而變更，例如主治醫師和診斷結果。一位患者可以具有多個第 2 級區段。

第 3 級：包含的資料在特定就診過程中維持不變、但會因每次就診而變更；例如就診類型 (住院或複診) 和主治醫師。患者可能在一次疾病過程中會多次就診。

第 4 級：包含的資料因處方而變更，例如開立處方的醫師、用藥和劑量。一位患者某次特定就診的處方中可能包含多種藥物。

關閉與 SAP 整合

結合系統、應用程式和產品的資料處理 (SAP) 是一種工作流程應用程式，允許第三方應用程式和不相容的資料庫交換資訊，並自動處理大型公司的訂單、訂單履行、客戶服務、供應鏈管理和庫存管理系統。BarTender 使用 IDoc 將資料從 SAP 資料庫移動到您列印的項目。

使用 SAP 的設計師可以選擇透過 BarTender 或 SAP 進行列印。 使用 BarTender 列印項目時，會將資訊從 SAP 傳送到 BarTender。SAP 可以透過以下方法傳送資料：

使用 SAP 系統列印項目時，BarTender 會對 SAP 傳送一組名為印表機碼範本的格式命令。該範本與資料相結合並傳送到印表機。

如需關於從 BarTender 列印項目與從 SAP 系統列印項目的不同之處，若您需要完整的比較，請參閱《SAP 整合方法》白皮書 (請在外部瀏覽器視窗中開啟，且需要網路連線)。

關閉使用 IDoc 檔案

IDoc 是一種方法，可以將資料的欄位分組成彼此具有階層關係的區段。SAP 會維護檔案類型資料庫，但是您可以視需要建立自訂 IDoc 檔案類型。IDoc 檔案是一種訊息，含有從 SAP 連接的程式傳送到 BarTender 的資料。您可以使用「資料庫設定精靈」將 IDoc 檔案新增至 BarTender 文件，並使用「資料庫設定」對話方塊管理連接。您還可以在 Administration Console 的「資料庫」區段的「SAP IDoc 定義」頁面建立自訂 IDoc 定義。

關閉IDoc 類型和區段定義

IDoc 是一種訊息，為了表明在指定的 IDoc 中從哪些位置可以找到各部分資料，因此傳送和接收程式時都必須符合常用慣例。因此，SAP AG 已定義了數百種 IDoc 類型以及大量的區段類型。

傳送程式必須根據這些定義來建構給定類型的 IDoc，而接收程式在對 IDoc 進行分析時必須符合這些定義。這意味著，為了使用 IDoc 中的資料，設定 BarTender 時辨識剖析程式檔是其步驟之一。

IDoc 類型的名稱由六個字母和兩個數字組成。例如，SHPMNT01 就表示有關出貨訊息的 IDoc。SAP 經常會修改 IDoc 的定義，名稱結尾的兩個數字用於辨識修訂的版本。

區段名稱可能會以三位數的版本號碼作結尾。例如，E2KNA1M001 是 DEBMAS02 (客戶控制) IDoc 類型的區段。

SAP 擁有者可以建立自己的自訂 IDoc 類型和區段類型。

由 SAP AG 定義的區段名稱一律以 "E" 開頭，而自訂設計的區段名稱一律以 "Z" 開頭。

關閉剖析程式檔

IDoc 類型的剖析程式檔包含 BarTender 分析 IDoc 所需要的資訊。例如，其中將出現哪些區段、哪些區段是可重複、哪些資料欄位將出現在每個區段中、欄位的順序，以及每個欄位的長度。

若要將剖析程式檔與特定的 IDoc 類型相關聯，請使用 Administration Console 的「資料庫」區段的「SAP IDoc 定義」頁面。

關閉將 IDoc 階層資料轉換成平構記錄

由於子區段中的資料總是與其父區段中的資料相關聯，因此對於 IDoc 中某樹狀結構的任何非分支路徑，從頂部節點到底部節點這個區段可視為像是表格導向資料庫中的記錄一樣的記錄。

關閉範例

以下列資料階層為例，其中每個區段都只有一個欄位：

患者姓名：張大發

診斷結果：哮吼

診斷結果：脛骨骨折

就診類型：住院

藥名：Codeine

藥名：Amidol

就診類型：複診

藥名：Naprosin

患者張大發曾在不同時期接受過針對哮吼和脛骨骨折的治療。(第一個疾病沒有詳細的記錄。)第一次因骨折前往醫院就診時，醫生開立了 Codeine 和 Amidol 兩種藥品。而第二次就診時，醫生開立了 Naprosin。

脛骨骨折和 Naprosin 處方藥的路徑可以摺疊為平構記錄，如下所示。

患者姓名

診斷結果

就診

藥名

張大發

脛骨骨折

複診

Naprosin

其他兩個完整路徑則可以摺疊為如下的平構記錄。

患者姓名

診斷結果

就診

藥名

張大發

脛骨骨折

住院

Codeine

張大發

脛骨骨折

住院

Amidol

BarTender 在讀取 IDoc 時，會將資料樹摺疊成為平構記錄。從這些記錄中，您可以選取範本中物件所需的欄位。

關閉主區段

對於可能從 IDoc 資料階層中產生的每則記錄而言，並非一律都需要列印的項目。您可以設定 BarTender，使其在列印時只選取某些記錄，而對於一些從 IDoc 提取資料的文件，即使在一般情況下也不需要所有可能產生的記錄。BarTender 使用「主區段」這個概念來協助您只從 IDoc 產生您需要的記錄。

「主區段」的定義如下：對設計需要而言，主區段中的資料是您注目的焦點。對於您在 IDoc 中指定為主區段的資料，BarTender 會對每一個區段產生一則記錄。

關閉範例

以介紹範例中顯示的資料樹為例。如果醫院需要為所開立的每一種藥物都產生一個標籤，則會將主區段設定為第四級。於是 BarTender 就會產生三則記錄，如下所示。

患者姓名

診斷結果

就診

藥名

張大發

脛骨骨折

住院

Codeine

張大發

脛骨骨折

住院

Amidol

張大發

脛骨骨折

複診

Naprosin

假設醫院將患者每次就診時的檔案都分開保管，並希望產生一些標籤來供資料夾使用。患者每次就診時僅需一個標籤。這種情況下，可以將主區段設定為第三級，而 BarTender 將產生兩則記錄，如下所示。

患者姓名

診斷結果

就診

藥名

張大發

脛骨骨折

住院

Codeine、Amidol

張大發

脛骨骨折

複診

Naprosin

在第一則記錄中，BarTender 包含了主區段之下的級別中的「藥名」欄位，並將較低級別區段中的所有資料都連結在一起。

由於 BarTender 會對主區段的每個執行個體產生一則記錄，因此完成以下語句將有助於確定要用什麼作為您的主區段。

一般在執行這個 IDoc 所產生的項目時，我希望為每個 (每次) _____________產生一個要列印的項目。

在此範例中，如果使用「就診」完成語句，則第三級可能是主區段級別的最佳選擇。如果使用「開立的處方藥」完成語句，則第四級可能是最佳選取。

關閉SAP IDoc 定義檔案

SAP IDoc 定義檔案是一個清單，其中包含目前可用於 BarTender 的 IDoc 類型，以及目前與各個類型關聯的預設 IDoc 檔案、別名和剖析程式檔。

無論何時新增、修改或刪除 IDoc 類型，您都要修改 SAP IDoc 定義檔案。您可以在 Administration Console 的「資料庫」區段的「SAP IDoc 定義」頁面中建立自訂 IDoc 定義檔案。

在安裝 BarTender 後，該定義檔案會設定在 <安裝目錄>\SAP\default.itd。您可以從 Administration Console 的「檔案位置」頁面切換到不同的 IDoc 定義檔案。

如果將 BarTender 安裝到另一台電腦上，並且希望它與執行 BarTender 的其他電腦使用相同的 SAP IDoc 定義檔案，則您要變更 SAP IDoc 定義檔案。