Smartsheet

連線設定範例

本節列出您在建立連線時設定的各個欄位範例值。

OAuth 2.0 驗證連線類型

個人存取權杖驗證連線類型

您可以使用「Smartsheet 登入」連結建立 Smartsheet 帳戶。

如要進一步瞭解 Smartsheet API，請參閱 Smartsheet API 參考資料。

動作

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

DownloadAttachment 動作

這項動作會從試算表下載附件。

DownloadAttachment 動作的輸入參數

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

DeleteAttachment 動作

這項操作會從試算表中刪除指定附件。

DeleteAttachment 動作的輸入參數

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

CopyRowsToAnotherSheet 動作

這項動作會將資料列從一個工作表複製到另一個工作表。

CopyRowsToAnotherSheet 動作的輸入參數

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

CopySheet 動作

這項動作會將工作表複製到資料夾、主目錄或工作區。

CopySheet 動作的輸入參數

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

MoveRowsToAnotherSheet 動作

這項動作會將資料列從一個工作表移至另一個工作表。

MoveRowsToAnotherSheet 動作的輸入參數

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

MoveSheet 動作

這項動作會將工作表移至資料夾、主目錄或工作區。

MoveSheet 動作的輸入參數

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

動作範例

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

範例 - 下載附件

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

   {
     "SheetId": "5141926996037508",
     "AttachmentID": "1667587811610500"
   }
   

如果動作成功，連接器工作的 connectorOutputPayload 回應參數值會類似於下列內容：

 [
  {
    "Success": "true",
    "URL": "https://s3.amazonaws.com/SmartsheetB1/37540b4438a6466a973d678484c1fac8?response-content-disposition=attachment%3Bfilename%3D%22TestGOOGLE3.txt%22%3Bfilename*%3DUTF-8%27%27TestGOOGLE3.txt&Signature=rVHv4loce%2BrL4lYPlteTgAmkB%2Bk%3D&Expires=1744826533&AWSAccessKeyId=11950YFEZZJFSSKKB3G2",
    "Content": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
  }
]

範例 - 刪除附件

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「DeleteAttachment」動作，然後按一下「完成」。
3. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "SheetId": "5141926996037508",
     "AttachmentID": "1667587811610500"
   }
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

[
  {
    "Success": "true",
  }
]

範例 - 將資料列複製到其他工作表

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「CopyRowsToAnotherSheet」動作，然後按一下「完成」。
3. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Default Value 欄位中輸入類似下列的值：

     {
     "SheetId": "7483321975000964",
     "RowIds": "7935781927128964",
     "DestinationSheetId": "7197099985686404"
   }
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

 [
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

範例 - 複製工作表

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「CopySheet」動作，然後按一下「完成」。
3. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "SheetId": "5141926996037508",
     "DestinationType": "workspace",
     "DestinationId": "4219254305253252",
     "NewName": "Copied sheet appears",
     "Include": "comments"
   }
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

[
  {
    "Success": "true",
  }
]

範例 - 將資料列移至其他工作表

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「MoveRowsToAnotherSheet」動作，然後按一下「完成」。
3. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "SheetId": "7483321975000964",
     "RowIds": "7935781927128964",
     "DestinationSheetId": "7197099985686404"
   }
   

執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

[
  {
  "Success": "true",
	"AffectedRows":"1"
  }
]

範例 - 移動工作表

1. 在 Configure connector task 對話方塊中，按一下 Actions。
2. 選取「MoveSheet」動作，然後按一下「完成」。
3. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Default Value 欄位中輸入類似下列的值：

   {
     "SheetId": "5141926996037508",
     "DestinationType": "workspace",
     "DestinationId": "4219254305253252"
   }
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

[
  {
    "Success": "true",
  }
]

實體作業範例

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

範例 - 列出工作表的所有欄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Columns。
3. 選取 List 作業，然後按一下「完成」。
4. 在「連線器」工作的「工作輸入」部分，您可以根據客戶需求設定 filterClause。

篩選子句的值必須以單引號 (') 括住。您可以使用 filterClause，根據資料欄篩選記錄。

範例 - 取得工作表的資料欄詳細資料

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Columns。
3. 選取 Get 作業，然後按一下「完成」。
4. 將 entityId 設為「849633317179268」，這是要傳遞的鍵。如要設定 entityId，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "849633317179268"，並選擇 entityId 做為本機變數。

應直接傳遞 entityId 的值，例如「849633317179268」。其中「849633317179268」是必須傳遞的專屬主鍵值

在某些情況下，由於有兩個複合鍵，傳遞 entityId 可能會擲回錯誤。 在這種情況下，您可以使用 filterClause 並傳遞值，例如 id='849633317179268'。

範例 - 刪除工作表中的資料列

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Team_Task_List_by_Priority。
3. 選取 Delete 作業，然後按一下「完成」。
4. 將 entityId 設為「849633317179268」，這是要傳遞的鍵。如要設定 entityId，請在「資料對應」的「資料對應器」部分，按一下「開啟資料對應編輯器」，然後在「輸入值」欄位中輸入 "849633317179268"，並選擇 entityId 做為本機變數。

如果實體有兩個複合式商家或主鍵，而非指定 entityId，您也可以將 filterClause 設為 id='849633317179268'。

範例 - 建立試算表附件

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Attachments。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {
     "SheetId": "5141926996037508",
     "RowId": "8196592918597508",
     "Name": "Random.txt",
     "ContentEncoded": "VGhpcyBpcyBhIHRlc3QgYXR0YWNobWVudC4="
   }
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"Id": "7144235189178244" }
   

範例 - 使用甘特圖樣式版面配置，在同一列中建立專案並設定固定期限

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Gantt_Project_with_Hard_Deadline。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660"}
   

範例 - 在試算表列中建立團隊工作

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Team_Task_List_by_Priority。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660"}
   

範例 - 在試算表的一列中建立銷售活動

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Sales_Activity_Tracking_by_Rep_Month。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660"}
   

範例 - 在試算表列中建立銷售商機

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Simple_Sales_Pipeline。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660" }
   

範例 - 在試算表列中建立銷售報表

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Report_Sales_Activity_And_Team_Objectives。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660" }
   

範例 - 在工作表的列中建立訂單

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Customer_Order_Tracking_History。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "Created from googlecloud"}
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {"RowId": "7860088629366660" }
   

範例 - 在工作表中建立新資料欄

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Columns。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {
     "SheetId": "3315287605596036",
     "Title": "newexposedcolumn",
     "Index": 2,
     "Type": "DATE"
   }
   

   執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
     "Id": "550917885349764"
   }
   

範例 - 在工作區中建立新資料夾

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Folders。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {
     "ParentFolderId": "8716915511191428",
     "Name": "sub-folder-p2"
   }
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
     "Id": "550917885349764"
   }
   

範例 - 在帳戶中建立新的工作區

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Workspaces。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {
     "Name": "new workspace (newly exposed)"
   }
   

   執行這個範例後，Connector 工作的 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
     "Id": "550917885349764"
   }
   

範例 - 在帳戶中建立新使用者

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Info_Users。
3. 選取 Create 作業，然後按一下「完成」。
4. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {
     "FirstName": "charlie",
     "Email": "charlie@altostrat.com",
     "LastName": "c",
     "Admin": true,
     "LicensedSheetCreator": true
   }
   

   執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

   {
     "Id": "550917885349764"
   }
   

範例 - 在試算表中更新專案詳細資料

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Gantt_Project_with_Hard_Deadline。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，按一下 entityId，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

    {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}

範例 - 更新試算表中的團隊工作

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Team_Task_List_by_Priority。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，按一下 entityId，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}

範例 - 更新試算表中的銷售活動

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Sales_Activity_Tracking_by_Rep_Month。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，點選「entityId」，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

    {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}

範例 - 更新試算表中的銷售商機

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Simple_Sales_Pipeline。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，點選「entityId」，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}

範例 - 更新試算表中的銷售報表

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Report_Sales_Activity_And_Team_Objectives。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，點選「entityId」，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}

範例 - 更新工作表中的訂單

1. 在 Configure connector task 對話方塊中，按一下 Entities。
2. 從 Entity 清單中選取 Sheet_Customer_Order_Tracking_History。
3. 選取 Update 作業，然後按一下「完成」。
4. 在「Tasks」(工作) 的「Data mapper」(資料對應工具) 區段中設定 entityId，點選「entityId」，然後在指定欄位中輸入 849633317179268。
5. 在「工作」的「資料對應器」部分，按一下 Open Data Mapping 編輯器，然後在 Input Value 欄位中輸入類似下列的值：

   {"Task Name": "updated from googlecloud"}
   

執行這個範例後，連接器工作 connectorOutputPayload 輸出變數會傳回類似下列內容的回應：

{
  "RowId": null
}