Excel Online

實體、作業和動作

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

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

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

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

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

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

動作

本節列出連接器支援的動作。如要瞭解如何設定動作，請參閱「動作範例」。

新增工作表動作

將工作表新增至現有的 Excel Online 活頁簿。

AddWorksheet 動作的輸入參數

AddWorksheet 動作的輸出參數

如需 AddWorksheet 動作的設定範例，請參閱「範例」。

範例

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

行動號召範例

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

範例：執行 AddWorksheet 動作

這個範例會將工作表新增至現有的 Excel Online 活頁簿。

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取 AddWorksheet 動作，然後按一下「Done」。
3. 在「資料對應」專區中，按一下 Open Data Mapping Editor，然後在 Input 欄位中輸入類似下列的值：

   {   
   "WorkbookId": "01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL",
   "Title": "Worksheet_SP1"
   }

如果動作成功，AddWorksheet 工作項的 connectorOutputPayload 回應參數會包含類似以下的值：

[{
  "Success": "true",
  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#workbookWorksheet",
  "@odata.type": "#microsoft.graph.workbookWorksheet",
  "@odata.id": "/drives('b%21p_648NCXwk6hJ1pfyn0SeFaithFnRM1JmYNur9asmHAs2k8qe5UsR5a1cX6luuD0')/items('01M7ENMYA2QJVY77NPOFD3WQIJ6PNNX5VL')/workbook/worksheets(%27%7BD9372F53-CB1B-4082-9E13-02E65C2FC233%7D%27)",
  "id": "{D9372F53-CB1B-4082-9E13-02E65C2FC233}",
  "name": "Worksheet_SP1",
  "position": "1",
  "visibility": "Visible"
}]

實體操作範例

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

範例：列出所有雲端硬碟

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

範例：列出所有 SharedDocuments

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

範例：列出所有工作簿

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

範例 - 取得雲端硬碟

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

範例 - 取得 SharedDocument

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

示例 - 取得工作簿

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

範例：從書籍中刪除資料

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

範例：建立 Formulae_Sheet_List 的公式

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

    {
     "Excel_Sheet": "Old_Excel",
     "B": "=SUM(C8:D8)",
     "C": "6",
     "D": "6"
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 8.0
     } 
     

Example - Create With_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

    {
       "Name": "workbooknew",
       "Type": "newly created",
       "Sl no": 5.0
     }
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 6.0
     }
     

Example - Create Without_Headers

1. In the Configure connector task dialog, click Entities.
2. Select Book 4567_Book4567_Sheet1 from the Entity list.
3. Select the Create operation, and then click Done.
4. In the Data mapper section of the Task click OpenDataMapping editor and then enter a value similar to the following in the field:

     {
       "A": "6",
       "B": "Halo",
       "C": "Stardust"
     } 
     
   Running this example, returns a response similar to the following in the Connector
     task's connectorOutputPayload output variable:
     
   {
     "Id": 7.0
     } 
     

Example - Update an Formula for Formulae_Sheet_List

1. In the Configure connector task dialog, click Entities.
2. Select Formulae_Sheet_List from the Entity list.
3. Select the Update operation, and then click Done.
4. Set the entity ID to Update a Formulae_Sheet_List. To set the entity ID, in the Data mapper section of the Tasks, click entityId and then enter 8.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:

    
     {
     "B": "=MAX(C8:D8)",
     "C": "7",
     "D": "10"
     } 
     

執行這個範例時，會傳回類似以下的回應，其中包含連接器任務的 connectorOutputPayload 輸出變數：

 
  {   
  "Id": 8.0
  }
  

範例 - 更新 Without_Header

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Book 4567_Book4567_Sheet1。
3. 選取 Update 運算，然後按一下「Done」。
4. 將實體 ID 設為 Update a Book 4567_Book4567_Sheet1。如要設定實體 ID，請在「Tasks」的「Data Mapper」部分，點選「entityId」，然後在指定欄位中輸入 7.0。
5. 在「Task」的「Data Mapper」專區中，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值

    
      {
       "B": "cosmically",
       "C": "interlinked"
     }  
     

執行這個範例時，會傳回類似以下的回應，其中包含連接器任務的 connectorOutputPayload 輸出變數：

 
  {   
  "Id": 7.0
  }
  

範例 - Update_With_Header

1. 在 Configure connector task 對話方塊中，按一下 Entities。
li>從 Entity 清單中選取 Book 4567_Book4567_Sheet1。
2. 選取 Update 運算，然後按一下「Done」。
3. 設定實體 ID 以更新書籍 4567_Book4567_Sheet1。如要設定實體 ID，請在「Tasks」的「Data Mapper」部分，點選「entityId」，然後在指定欄位中輸入 6.0。
4. 在「Task」的「Data Mapper」專區中，按一下 OpenDataMapping 編輯器，然後在 field: 中輸入類似下列的值

    
      {
       "Name": "updated",
       "Type": "newupdate"
     }
     

執行這個範例時，會傳回類似以下的回應，其中包含連接器任務的 connectorOutputPayload 輸出變數：

 
  {   
  "Id": 6.0
  }