SAP ASE (Sybase)

實體、作業和動作

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

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

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

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

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

• 動作： 動作是透過連接器介面提供給整合項目的一流函式。動作可讓您變更實體或多個實體，而這些變更會因連接器而異。通常，動作會包含一些輸入參數和輸出參數。不過，連接器可能不支援任何動作，在這種情況下，Actions 清單會為空白。

行動號召範例

本節說明如何在這個連接器中執行部分動作。

範例：建立資料表

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   CREATE TABLE customqueries98(
        ID   INT ,
        NAME VARCHAR (20),
        AGE  INT,
        City  CHAR (25) ,
        SALARY   DECIMAL (18, 2)  );

這個範例會執行自訂查詢來建立新資料表。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

範例：變更資料表

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   ALTER TABLE customqueries98 ADD CONSTRAINT ID PRIMARY KEY (ID)

這個範例會顯示「執行自訂查詢」來變更資料表。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

範例：截斷資料表

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   TRUNCATE TABLE customqueries99

這個範例會執行自訂查詢，以截斷資料表。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

範例：捨棄資料表

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   DROP TABLE customqueries99

本範例會說明如何執行自訂查詢來刪除資料表。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

範例 - 驗證 SUM

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT SUM(SALARY) as Total FROM EMPLOYEES

這個範例會顯示「執行自訂查詢」畫面，以驗證匯總函式中的 SUM 函式。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Total": 7500.0
  }] 

範例 - 驗證 AVG

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT AVG(SALARY) as Average FROM EMPLOYEES

這個範例會執行自訂查詢，驗證匯總函式中的 AVG。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Average": 7500.0
  }] 

範例 - 驗證 MAX

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT MAX(SALARY) as Max_Salary FROM EMPLOYEES

這個範例會說明如何執行自訂查詢，驗證匯總函式中的 MAX。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Max_Salary": 7500.0
  }] 

範例 - 驗證 MIN

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT MIN(SALARY) as Min_Salary FROM EMPLOYEES

這個範例會執行自訂查詢，驗證匯總函式中的 MIN。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Min_Salary": 7500.0    
  }]

範例 - 驗證 COUNT

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   select count(*) from EMPLOYEES

這個範例會執行自訂查詢，驗證匯總函式中的 Count。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "": 1.0
  }]

範例：使用 Join 和 GroupBy

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT SmallMoney.amount, Sum(Testsybase.clone) AS Total
     FROM Testsybase
     INNER JOIN SmallMoney
     ON Testsybase.id = SmallMoney.id
     GROUP BY SmallMoney.amount;

本範例會示範如何使用 Join 和 GroupBy 執行自訂查詢。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
    "amount": 1122.56,
    "Total": 14.0
  }, {
    "amount": 123.4567,
    "Total": 11.0
  }, {
    "amount": 1123.45,
    "Total": 13.0
  }]

範例：使用 Join 和查詢參數

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT e.payload,e.rest,ed.id FROM Testsybase e, Smallmoney ed where e.id=ed.id and ed.id=?

這個範例會說明如何使用 Join 和 Query 參數執行自訂查詢。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 [{
    "payload": 5678.9,
    "rest": 13.6666,
    "id": 2.0
  }] 

範例 - 使用 GroupBy、Having 和 Count

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   select payload, count(payload) from Testsybase group by payload having count(payload)>=1

本範例說明如何使用 GroupBy、Having 和 Count 執行自訂查詢。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
    "payload": 1234.56,
    "": 1.0
  }, {
    "payload": 2345.67,
    "": 1.0
  }, {
    "payload": 4352.78,
    "": 1.0
  }, {
    "payload": 6789.12,
    "": 1.0
  }]

示例 - 使用資料欄轉換、LIKE 和其他運算子

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   select e.id,e.clone from Testsybase e where e.payload>10 and e.rest LIKE '%1%' AND e.id<>3 order by e.id;

這個範例會使用資料欄轉換、LIKE 和其他運算子 (例如 <>) 執行自訂查詢。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會具有類似以下的值：

[{
    "id": 1.0,
    "clone": 10.0
  }, {
    "id": 2.0,
    "clone": 99.0
  }, {
    "id": 4.0,
    "clone": 14.0
  }]

範例：在整合中提供輸入內容來執行函式

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   SELECT dbo.MultiplyNumbers(5, 10) AS Result

這個範例說明如何透過在整合中提供輸入內容，執行自訂查詢函式。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 [{
    "Result": 50.0
  }] 

範例：在整合中提供輸入內容來建立函式

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   CREATE FUNCTION MultiplyNumbersTest1
     (@num1 INT, @num2 INT) 
     RETURNS INT AS RETURN @num1 * @num2

這個範例說明如何透過執行自訂查詢，在整合中提供輸入內容來建立函式。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

範例：在整合中提供輸入內容來執行程序

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「資料對應」專區中，點選 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {
     "@EmpID": 1.0
     } 
     

本範例說明如何透過在整合中提供一些輸入內容，執行自訂查詢。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

 [{
    "EmpID": 1.0,
    "LastName": "Test",
    "FirstName": "Bcone",
    "Address": "Noida",
    "City": "UP"
  }] 
  

範例：在整合中提供輸入內容來建立程序

1. 在 Configure Connector 對話方塊中，選取 Region, Connection and Actions。
2. 從動作中選取 Execute Custom Query，然後按一下「完成」。
3. 在「Connector」的「Task Input」部分，按一下 Edit Custom Script，然後在 Custom Query 欄位中輸入類似以下的值：

   CREATE PROCEDURE SelectAllEmployees2 @EmpID int
     AS
     SELECT * FROM Employees WHERE EmpID = @EmpID

這個範例說明如何透過在整合中提供輸入內容，執行自訂查詢來建立程序。如果動作成功，Execute Custom Query 工作項的 connectorOutputPayload 回應參數會傳回空白酬載。

實體操作範例

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

範例：列出所有記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 numbers_table。
3. 選取 List 作業，然後按一下「Done」。

範例：從實體取得記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 numbers_table。
3. 選取 Get 作業，然後按一下「Done」。
4. 將實體 ID 設為 Get single numbers_table。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 1.0，並選擇「EntityId」做為「Local」變數。

範例：建立記錄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 numbers_table。
3. 選取 Create 運算，然後按一下「Done」。
4. 在「Task」的「Data Mapper」專區中，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值

   {
   "bigint_column": 1.2345678901234516E16,
   "usmallint_column": 124.0,
   "numeric_column": 987.664,
   "real_column": 67.88999938964847,
   "uint_column": 125.0,
   "ubigint_column": 1.2345678901234516E16,
   "decimal_column": 124.459,
   "smallint_column": 16.0,
   "int_column": 125.0,
   "floatn_column": 154.45,
   "tinyint_column": 127.0,
   "id": 20.0
   }

   執行這個範例時，會傳回類似以下的回應，並顯示在連接器工作項的 connectorOutputPayload 輸出變數中：

   {
   "Success": true 
   }
   

Example - Update a record

1. In the Configure connector task dialog, click Entities.
2. Select numbers_table from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a numbers_table. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 20.0 in the given field.
5. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    
   {
   "uint_column": 128.0,
   "floatn_column": 154.95
   }

執行這個範例時，成功時會傳回空白酬載。

範例：刪除資料表中的資料

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 numbers_table。
3. 選取 Delete 作業，然後按一下「Done」。
4. 將實體 ID 設為 Delete numbers_table。如要設定實體 ID，請在「資料對應」的「資料對應」專區中，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 2.0，並選擇「EntityId」做為「Local」變數。