SAP ERP

設定事件訂閱

啟用事件訂閱功能後，您必須設定 ABAP SDK。如要瞭解如何設定 ABAP SDK，請參閱「Google Cloud ABAP SDK 總覽」。

在「Event Subscription Details」(事件訂閱詳細資料) 區段中，輸入下列值：

1. 為事件監聽器選取下列任一驗證類型。
   • Google 驗證。啟用這個選項後，請按照「使用 JSON Web Token 進行驗證」一文中的步驟，設定 ABAP SDK 的驗證機制。此外，請確保服務帳戶具有 roles/connectors.listener 角色，其存取權杖用於驗證。
   • API 金鑰驗證。如選取這個選項，您必須先建立 API 金鑰，然後將金鑰儲存為 Secret Manager 密鑰。詳情請參閱「建立 API 金鑰」。
2. 輸入事件類型欄位名稱。這個欄位會指出與傳入事件要求相關聯的事件類型。

   {
   "event_type": "user.created",
   ...
   // other request fields
   ...
   }

3. 選取「啟用私人連線」，在後端應用程式和連線之間建立安全連線。如果選取這個選項，您必須在建立連線後執行額外設定步驟。詳情請參閱「活動訂閱的私人連線」。
4. 輸入無法傳送郵件的設定。如果設定無效信件，連線會將未處理的事件寫入指定的 Pub/Sub 主題。輸入下列詳細資料：
   1. 無法傳送的訊息專案 ID： 您已設定無法傳送的訊息 Pub/Sub 主題的 Google Cloud 專案 ID。
   2. 無效信件主題： 要寫入未處理事件詳細資料的 Pub/Sub 主題。

連線設定範例

以下各節列出建立 SAP ERP 連線時，各個欄位的範例值，以及不同連線類型所需的參數。

連線至分散式 SAP 系統

如果您連線至分散式 SAP 系統 (例如使用負載平衡的系統)，則必須指定下列額外連線屬性。管理員可以在 SAP 系統的「系統項目屬性」對話方塊中，透過「連線」分頁取得這些連線屬性。

• 系統 ID：指定從 SystemId 屬性取得的值。系統 ID 是 SAP 系統的系統 ID/R3Name。系統 ID 為字串，最多三個字元。
• 訊息伺服器：連線至使用負載平衡的 SAP 系統時，必須指定「訊息伺服器」欄位。將這個屬性設為您從 SAP 系統的 MessageServer 屬性取得的值。此外，請在「訊息伺服器」欄位的值前面加上 SAProuter 方塊的值。
• 群組：將這個屬性設為從「群組/伺服器」屬性取得的值。Group 屬性會指定使用的登入群組。預設值為 PUBLIC。

連線至自訂應用程式伺服器

如果您使用專屬應用程式伺服器或自訂應用程式伺服器連線至 SAP 系統，則必須指定下列額外連線屬性。管理員可以從 SAP 系統取得這些連線屬性。

• 系統 ID：指定從 SystemId 屬性取得的值。這是 SAP 系統的系統 ID 或 R3Name。系統 ID 為字串，最多三個字元。
• 主機：指定從應用程式伺服器取得的值。

  這會指定目標系統的主機名稱。這個值可以是正常主機名稱、IP 位址或 SAP 路由器位址。

• 系統編號：指定從 SystemNumber 屬性取得的值。

  SystemNumber 屬性會定義目標系統。

設定安全網路連線

如果管理員已設定安全網路通訊 (SNC)，您必須設定下列額外屬性。在 SAP 系統中，您可以在「System Entry Properties」(系統項目屬性) 對話方塊的「Network」(網路) 分頁中，取得下列 SNC 連線字串屬性。

• SNC 模式：如果 SAP 中已啟用「Activate Secure Network Connections」核取方塊，請將 SNC 模式連線屬性設為 True。否則，請將 SNC 模式連線屬性設為 False。

  SNCMode 連線屬性是布林值，可判斷您是否使用 SNC。預設值為 False。

• SNC PartnerName：SNC PartnerName 會指定應用程式伺服器的 SNC 名稱。例如：p:CN=IDS, OU=IT, O=CSW, C=DE
• SNC 名稱：選填。SNCName 屬性會指定 SNC 連線的名稱。設定這項屬性，確保連線使用正確的 SNC 名稱。
• SNC Qop：將這個屬性設為「安全網路設定」部分中選取的選項。舉例來說，如果選取「完整性」選項，請將 SNCQop 屬性設為 3。

  SNCQop 屬性會指定資料保護的等級 (或品質)。如未指定這項屬性，系統會將這項屬性設為整數 -1。有效值為 1、2、3、8 或 9，分別對應保護等級。

• SNC_Lib 物件 ID：將這個屬性設為 SNC 程式庫的路徑和檔案名稱。指定所用安全防護程式庫的完整路徑，例如 C:\Secude\secude.xll.

ApplicationServer 連線類型

如要連線至應用程式伺服器，必須在網路端點群組 (NEG) 和健康狀態檢查中，使用 SAP 系統 IP 和 33XX 連接埠設定 Private Service Connect 和負載平衡器。其中 XX 是所用 SAP 系統的系統或執行個體編號。下表列出 ApplicationServer 連線類型的範例設定值。請參閱管理中心的連線建立介面，瞭解必填和選填欄位。

訊息伺服器 (群組伺服器) 連線類型

• 您必須在網路端點群組 (NEG) 和健康狀態檢查中，使用通訊埠 33XX 和 36XX 上的 SAP 系統 IP 設定 Private Service Connect 和負載平衡器。其中 XX 是所用 SAP 系統的系統或執行個體編號。
• 您必須在 Cloud DNS 上建立 DNS 區域，並將應用程式伺服器的端點附件對應至 SAP 系統的主機名稱，該端點附件是在 33XX 連接埠上設定。
• 只有在訊息伺服器傳回應用程式伺服器的完整網域名稱 (FDQN) 位址時，您才能透過訊息伺服器 (群組伺服器) 連線至 SAP 系統。如果訊息伺服器傳回 IP 位址，您就無法透過訊息伺服器 (群組伺服器) 連線至 SAP 系統。
• 應用程式提出要求時，訊息伺服器必須回應應用程式需要連線的應用程式伺服器 DNS。
• 應用程式伺服器的 DNS 必須是專屬的，且不得用於任何其他 SAP 系統。
• 在 SAP 應用程式中，應用程式伺服器和訊息伺服器的端點附件 IP 必須保留在 gw/alternative_hostnames 參數下。
  1. 前往 Tcode - RZ10，並在執行個體設定檔中輸入「gw/alternative_hostname」參數。
  2. 將 ms/lg\_with\_hostname 參數設為 1，即可設定 7.53 之前的 SAP 訊息伺服器版本傳回主機名稱。7.53 以上版本預設會傳回主機名稱。
  3. 重新啟動 SAP 應用程式，讓參數生效。

下表列出 Group Server 連線類型的範例設定值：

X509 憑證連線類型

如要使用 X509 連線進行安全網路通訊 (SNC)，必須在網路端點群組 (NEG) 和健康狀態檢查中，使用 SAP 系統 IP 和通訊埠 48XX 設定 Private Service Connect 和負載平衡器。其中 XX 是所用 SAP 系統的系統或執行個體編號。下表列出 X509 certificate 連線類型的範例設定值。請參閱管理中心的連線建立介面，瞭解必填和選填欄位。

實體、作業和動作

所有整合連接器都會為所連應用程式的物件提供抽象層。您只能透過這個抽象化程序存取應用程式的物件。抽象化會以實體、作業和動作的形式呈現。

• 實體： 實體可以視為已連結應用程式或服務中的物件，或是屬性集合。實體的定義因連接器而異。舉例來說，在資料庫連接器中，資料表是實體；在檔案伺服器連接器中，資料夾是實體；在訊息系統連接器中，佇列是實體。

  不過，連接器可能不支援或沒有任何實體，在這種情況下，Entities 清單會是空白。

• 作業： 作業是指您可以在實體上執行的活動。您可以對實體執行下列任一操作：
  • 列出
  • 取得
  • 建立
  • 更新
  • 刪除

  從可用清單中選取實體，系統會產生該實體可用的作業清單。如需作業的詳細說明，請參閱 Connectors 工作的實體作業。 不過，如果連接器不支援任何實體作業，系統就不會在 Operations 清單中列出這些不支援的作業。

• 動作： 動作是透過連接器介面提供給整合的第一類函式。動作可讓您變更一或多個實體，且因連接器而異。一般來說，動作會有一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，此時 Actions 清單會是空白。

動作

本節提供 RFC 相關資訊，並列出連接器支援的動作。如要瞭解如何設定動作，請參閱動作範例。

使用 RFC

本節提供必要 RFC 的相關資訊，以及如何使用 RFC。

必要 RFC

如果缺少任何必要 RFC，部分或所有功能可能無法運作。您可以使用 T-Code SE37 查看 SAP 中可用的函式模組。

SAP ERP 連接器會使用下列 RFC。

• DDIF_FIELDINFO_GET
• RFC_GET_FUNCTION_INTERFACE
• RFC_GET_STRUCTURE_DEFINITION
• RFC_GET_SYSTEM_INFO
• RFC_GET_UNICODE_STRUCTURE
• RFC_READ_TABLE
• SLDAG_CHECK_FOR_UNICODE

讀取大量資料

本節說明從 SAP 後端讀取大量資料時，必須採取的做法。

SAP ERP 連接器會使用 SAP RFC_READ_TABLE 函式從 SAP 表格取得資料，而這個函式的大小固定為 512 位元組。每個資料列都可以緩衝，因此您選取的資料欄數量不得超過緩衝區可容納的數量。如果選取超過 512 個位元組，執行整合時會發生 DATA_BUFFER_EXCEEDED 例外狀況，表示您已超過每列允許的緩衝區大小上限，因此需要選取較少的資料欄。

如要解決這個問題，您可以加入 Custom RFC_READ_TABLE 的程式碼，這與 SAP RFC_READ_TABLE 類似，但緩衝區較大，可解決 DATA_BUFFER_EXCEEDED 問題。

使用自訂讀取資料表函式

這個連接器支援類似於 SAP RFC_READ_TABLE 的 Custom RFC_READ_TABLE，但緩衝區較大，因此可以解決 DATA_BUFFER_EXCEEDED 問題。

在 SAP 後端建立自訂 RFC_READ_TABLE

請按照下列步驟使用 範例自訂 RFC_READ_TABLE。

1. 將 RFC_READ_TABLE 函式做為新函式的範本：選取交易代碼 SE37 和 SDTX 函式群組，然後將 RFC_READ_TABLE 複製到新的函式群組或工作函式群組。在本例中，RFC_READ_TABLE 會複製到 Z_CUSTOM_RFC_TABLE。
2. 在 SAP 頁面的「Attributes」分頁中，選取「Remote Enabled Module」。
3. 在「Tables」分頁中，將 DATA 參數設為 CHAR8000 (您可能需要按一下滑鼠右鍵，然後依序點選「Display」->「Change」)。
4. 在「Source Code」(原始碼) 分頁中，輸入自訂讀取資料表 RFC 程式碼。如需參考資料，請參閱範例 Z_CUSTOM_RFC_TABLE_function.txt。
5. 按一下 [儲存]。
6. 請按照提供的自訂讀取資料表文件，定義匯入項目、資料表和例外狀況。
7. 啟用函式模組。

ABAP 7.52 的自訂讀取資料表

如果您使用 ABAP 7.52 以上版本，請參閱範例 Z_CUSTOM_RFC_TABLE_function_ABAP752.txt。 範例函式適用於 ABAP 7.52 以上版本。這與 Z_CUSTOM_RFC_TABLE 函式類似，但會利用 ABAP 7.52 中新提供的關鍵字，在資料庫中執行分頁，而不是在 ABAP 指令碼本身中執行。這可大幅提升分頁效率，並改善處理大型表格時的效能。建議盡可能使用 Z_CUSTOM_RFC_TABLE_752 RFC。

存取 RFC_READ_TABLE 函式

本節提供資訊，說明要指派給 SAP 使用者的角色，才能存取 RFC_READ_TABLE 函式。這項函式是支援遠端作業的函式模組，可讓您以一般方式讀取任意資料表。

如要在設定 SAP ERP 連接器工作時，將資料表列在「實體」下方，您必須在 SAP ERP 連線層級使用 RFC_READ_TABLE 函式，並授權存取 R/3 函式 RFC_READ_TABLE

為活動 03 (顯示) 新增授權 S_TABU_DIS，並為函式 RFC_READ_TABLE 新增授權群組「SC」。

以下是 RFC_READ_TABLE 的部分技術限制：

• 系統只能讀取含有簡單資料類型的資料表。系統不支援 STRING 或 XSTRING 欄位。
• 每行最多 512 個字元。
• 傳回的記錄數量會受到記憶體門檻限制。

BAPI_MATERIAL_SAVEDATA 動作

這項動作可讓您執行特定工作。舉例來說，您可以使用這項服務在 SAP ERP 中建立或變更物料主檔資料。

BAPI_MATERIAL_SAVEDATA 動作的輸入參數

BAPI_MATERIAL_SAVEDATA 動作的輸出參數

如果動作成功，這項操作會傳回狀態 200 (OK)。

如要瞭解如何設定 BAPI_MATERIAL_SAVEDATA 動作，請參閱「動作範例」。

ZFM_GCP_MULTIDATA_TAB 動作

使用者可透過這項動作執行特定工作。舉例來說，您可以在 SAP ERP 中建立多種資料型別的資料。

ZFM_GCP_MULTIDATA_TAB 動作的輸入參數

ZFM_GCP_MULTIDATA_TAB 動作的輸出參數

如果動作成功，這項操作會傳回狀態 200 (OK)。

如要瞭解如何設定 ZFM_GCP_MULTIDATA_TAB 動作，請參閱動作範例。

PushIDoc Action

這項動作可讓您執行特定工作。舉例來說，您可以將資料從 SAP 轉移至外部系統。

PushIDoc 動作的輸入參數

PushIDoc 動作的輸出參數

如果動作成功，這項操作會傳回狀態 200 (OK)。

如要瞭解如何設定 PushIDoc 動作，請參閱「動作範例」。

ExecuteCustomQuery 動作

這項操作可讓您執行自訂查詢。

如要建立自訂查詢，請按照下列步驟操作：

1. 請按照詳細說明 新增連接器工作。
2. 設定連接器工作時，請在要執行的動作類型中選取「動作」。
3. 在「動作」清單中，選取「執行自訂查詢」，然後按一下「完成」。

   

4. 展開「Task input」(工作輸入) 區段，然後執行下列操作：
   1. 在「Timeout after」(逾時時間) 欄位中，輸入查詢執行前的等待秒數。

      預設值：180 秒。

   2. 在「資料列數量上限」欄位中，輸入要從資料庫傳回的資料列數量上限。

      預設值為 25。

   3. 如要更新自訂查詢，請按一下「編輯自訂指令碼」。「指令碼編輯器」對話方塊隨即開啟。

      

   4. 在「指令碼編輯器」對話方塊中輸入 SQL 查詢，然後按一下「儲存」。

      您可以在 SQL 陳述式中使用問號 (?) 代表單一參數，該參數必須在查詢參數清單中指定。舉例來說，下列 SQL 查詢會從 Employees 資料表選取與 LastName 資料欄指定值相符的所有資料列：

      SELECT * FROM Employees where LastName=?

   5. 如果您在 SQL 查詢中使用問號，請為每個問號點按「+ 新增參數名稱」，加入參數。執行整合時，這些參數會依序取代 SQL 查詢中的問號 (?)。舉例來說，如果您新增了三個問號 (?)，就必須依序新增三個參數。

      

      如要新增查詢參數，請按照下列步驟操作：

      1. 在「類型」清單中，選取參數的資料類型。
      2. 在「值」欄位中輸入參數值。
      3. 如要新增多個參數，請按一下「+ 新增查詢參數」。

執行成功後，這項動作會傳回狀態 200 (OK)，以及含有查詢結果的回應內容。

動作範例

範例 - 建立記錄

本例使用 BAPI_MATERIAL_SAVEDATA 動作建立物料記錄。

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 BAPI_MATERIAL_SAVEDATA 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
   "CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
   }

如果動作成功，BAPI_MATERIAL_SAVEDATA 工作的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

範例 - 更新記錄

這個範例會使用 BAPI_MATERIAL_SAVEDATA 動作更新物料記錄。

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 BAPI_MATERIAL_SAVEDATA 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
   "CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
   "MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
   }

如果動作成功，BAPI_MATERIAL_SAVEDATA 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

範例 - 刪除記錄

這個範例會使用 BAPI_MATERIAL_SAVEDATA 動作刪除物料記錄。

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 BAPI_MATERIAL_SAVEDATA 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
   "CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
   "CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
   }

如果動作成功，BAPI_MATERIAL_SAVEDATA 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

範例 - 建立多資料類型資料

本例使用 ZFM_GCP_MULTIDATA_TAB 動作建立多資料類型資料。

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 ZFM_GCP_MULTIDATA_TAB 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
   "IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
   }

如果動作成功，ZFM_GCP_MULTIDATA_TAB 工作項目的 connectorOutputPayload 回應參數會包含類似下列內容的值：

[{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

範例 - 推送 IDoc

這個範例會將 IDoc 推送至 SAP ERP。

1. 在「Configure connector task」對話方塊中，按一下 Actions。
2. 選取 PushIDoc 動作，然後按一下「完成」。
3. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入內容) 區段中，按一下 connectorInputPayload，然後在 Default Value 欄位中輸入類似下列的值：

   {
   "Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
   "FileType": "XML",
   "Mode": "ASync"
   }

。如果動作成功，PushIDoc 工作的 connectorOutputPayload 回應參數值會類似以下內容：

[{
"Result": "Success",
"Message": "Push IDoc success"
}]

實體作業範例

本節說明如何使用這個連接器執行部分實體作業。

範例 - 列出所有記錄

這個範例會列出 T001 實體中的所有記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 T001。
3. 選取「List」作業，然後按一下「完成」。
4. (選用) 在「連結器」工作的「工作輸入」部分，您可以指定篩選子句，篩選結果集。請一律在單引號 (') 內指定篩選子句值。

範例 - 從實體取得記錄

這個範例會從 T001 實體取得具有指定 ID 的記錄。

1. 在「Configure connector task」對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 T001。
3. 選取「Get」作業，然後按一下「完成」。
4. 在「Connectors」(連結器) 任務的「Task Input」(任務輸入) 區段中，按一下「EntityId」，然後在「Default Value」(預設值) 欄位中輸入 0001。

   其中 0001 是 T001 實體中的專屬記錄 ID。