OnePlan （預覽版）
OnePlan AI 提供支援人工智慧的策略投資組合、財務、資源和工作管理平台，可滿足每個組織的需求。 OnePlan 與 Microsoft Project、Microsoft Planner、Azure DevOps、Jira、Smartsheet 等連接，以全面了解整個企業的所有工作。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | OnePlan 支援 |
| URL | https://support.oneplan.ai/ |
| support@oneplan.ai |
| 連接器中繼資料 | |
|---|---|
| Publisher | OnePlan， LLC |
| 網站 | https://oneplan.ai/ |
| 隱私權原則 | https://oneplan.ai/privacy-policy |
| 類別 | 商業管理;生產力 |
OnePlan 連接器
OnePlan 提供支援人工智慧的策略投資組合、財務、資源和工作管理平台，可滿足每個組織的需求。 OnePlan 與 Microsoft Project、Microsoft Planner、Azure DevOps、Jira、Smartsheet 等連接，以全面了解整個企業的所有工作。
發行商： OnePlan AI
先決條件
您將需要以下內容才能繼續：
使用者入門
建立新的 OnePlan 群組。 前往配置頁面（右上角的齒輪圖示）並請求啟用進階設定。 啟用進階設定後，請前往「整合」頁面，然後新增驗證金鑰。 使用該金鑰來建立 OnePlan Power Automate 連接器。 聯繫客戶支持尋求幫助。
支援的作業
“獲取計劃”：
描述：根據計劃 ID 從您的 OnePlan 群組取得個別計劃。包括計劃的內建欄位和自訂欄位。
參數：計劃識別碼
傳回：WorkPlan
“更新計劃”：
描述：使用計劃 ID 更新計劃。 需要計劃 ID 和需要更新的欄位。 將更新的計劃傳回至動作。
參數：計劃 ID、工作計劃主體
傳回：更新的工作計劃
“郵票映射”：
描述：此動作會將對應資訊戳記到計劃上。 這會讓計劃知道它與外部系統的連線。
參數：計劃 ID、流程 ID、外部系統 ID、外部系統 URL
傳回：成功訊息
「取得對應的計劃項目標識符」
描述：此動作將使用流程識別碼和外部項目識別碼來傳回它所屬的計劃識別碼。 當您想要尋找外部項目的計劃時非常有用。
參數：流程 ID、外部項目 ID
傳回：計劃識別碼
「查詢資源識別碼」
根據提供的電子郵件地址與名稱回傳資源的唯一識別碼（UUID），實現工作流程間的無縫整合與精確自動化。
參數：資源名稱，或資源電子郵件
傳回：計劃識別碼
「查詢工作計畫」
說明：回傳所有符合指定欄位條件的工作計畫，方便連結你的資料。
參數：查詢欄位、查詢值
申報表：符合條件的工作計畫
「依計畫ID查詢任務」
說明：回傳所選計畫中符合指定任務欄位條件的任務。
參數：計畫 ID、查詢欄位、查詢值
申報表：符合條件的工作計畫
「取得狀態報告，Docx」
說明：產生並檢索所選專案或計畫的 DOCX 格式狀態報告。
參數：狀態報告 ID
退貨：Docx 狀態報告
「取得對應的計劃項目標識符」
描述：此動作將使用流程識別碼和外部項目識別碼來傳回它所屬的計劃識別碼。 當您想要尋找外部項目的計劃時非常有用。
參數：流程 ID、外部項目 ID
傳回：計劃識別碼
「取得資源選擇欄位」
說明：回傳所有可用的選項 Resource-Level 欄位的價值選項。
參數：無
回報：資源選擇欄位
「取得任務選擇欄位」
說明：回傳所有可用的選項 Task-Level 欄位的價值選項。
參數：無
回報：任務選擇欄位
「取得工作計畫選擇欄位」
說明：回傳所有可用的選項 WorkPlan-Level 欄位的價值選項。
參數：無
回報：工作計畫選擇欄位
“步驟更新”：
描述：可讓您自動更新工作計劃的處理步驟，變更工作計劃目前所處的階段。
參數：工作計劃 ID、步驟名稱、步驟 ID
傳回：成功訊息
“步驟批准”：
說明：對於閘道步驟，可讓您自動核准流程步驟。
參數：方案 ID、狀態
傳回：成功訊息
支援的觸發器
“步驟變更觸發器”：
步驟變更時觸發動作
必要參數：無
「計劃更新觸發器」：
計劃更新時觸發動作
必要參數：無
取得憑證
導覽至 my.oneplan.ai，設定試用群組，並遵循上線程式。 如有任何疑問，請聯繫 OnePlan 支持
已知問題和限制
連接器目前不支援「工作計劃」動作。
部署指示
使用指定的 API 定義檔案建立自訂連接器、驗證，然後在「測試」區段中新增連線。 若要取得金鑰，請移至 OnePlan 群組的設定頁面。 從左側欄導航到集成並添加新的身份驗證密鑰。 複製與連接器值相同的索引鍵，以連線到 OnePlan 環境。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| OnePlan 區域 | 字串 | 您的 OnePlan 集團區域 <>OnePlan.AI | 對 |
| 金鑰名稱 | securestring | OnePlan 的認證金鑰名稱 | 對 |
| 索引鍵值 | securestring | OnePlan 的認證金鑰值 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 依整合資訊取得方案識別碼 |
根據流程 ID 和外部項目 ID 取得整合計劃的計劃 ID |
| 依計劃識別碼取得計劃詳細資料 |
取得工作計劃 |
| 依計劃識別碼更新程序步驟 |
依計劃編號步驟更新計畫流程。 |
| 依計劃識別碼更新計劃 |
依圖紙 ID 更新圖紙欄位 |
| 依計畫編號查詢任務 |
回傳符合指定欄位標準的計畫任務。 |
| 依識別碼取得資源 |
以資源 ID 回傳內建及自訂資源欄位 |
| 取得任務欄位列表 |
取得任務欄位清單。 |
| 取得任務欄位名稱列表 |
取得任務欄位清單。 |
| 取得任務選擇欄位 |
回傳 Task-Level 欄位所有可用的選項值選項。 |
| 取得工作計畫欄位名稱列表 |
取得一份工作計畫欄位清單。 |
| 取得工作計畫選擇欄位 |
回傳 WorkPlan-Level 欄位所有可用的選項值選項。 |
| 取得方案類型識別碼 |
會回傳計畫類型 ID，並依計畫類型名稱。 |
| 取得最後狀態報告 |
返回最新的狀態報告。 |
| 取得狀態報告 Docx |
產生並檢索所選專案或計畫的狀態報告，格式為 DOCX 格式。 |
| 取得資源選擇欄位 |
回傳 Resource-Level 欄位所有可用的選項值選項。 |
| 建立新任務 |
建立新的 OnePlan 任務 |
| 建立新計劃 |
建立新計劃 |
| 新增或更新計劃的整合 |
新增或更新計劃整合資訊 |
| 更新現有任務 |
更新現有的 OnePlan 任務。 |
| 查詢工作計畫 |
回傳所有符合欄位條件的工作計畫，讓連結資料更方便 |
| 查閱資源識別碼 |
回傳一個資源 UUID，使用電子郵件和名稱。 |
| 核准計劃的流程步驟 |
核准計畫的流程步驟 |
依整合資訊取得方案識別碼
根據流程 ID 和外部項目 ID 取得整合計劃的計劃 ID
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
流程 ID
|
IntegrationId | True | string |
流程 ID |
|
外部識別碼
|
ExternalItemId | True | string |
外部系統識別碼 |
依計劃識別碼取得計劃詳細資料
取得工作計劃
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
PlanId | True | string |
回傳指定圖序 ID 的內建及自訂欄位。 |
傳回
依計劃識別碼更新程序步驟
依計劃編號步驟更新計畫流程。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
工作計劃 ID |
|
處理步驟名稱
|
StepName | string |
處理步驟名稱 （字串） |
|
|
處理步驟 ID
|
StepId | string |
程序步驟識別碼（UUID） |
傳回
依計劃識別碼更新計劃
依圖紙 ID 更新圖紙欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
工作計劃 ID |
|
工作計劃
|
WorkPlan | True | dynamic |
依計畫編號查詢任務
回傳符合指定欄位標準的計畫任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
工作計畫識別碼（UUID） |
|
欄位名稱
|
FilterField | True | string |
你想查詢的欄位 |
|
篩選值
|
FilterValue | True | string |
你查詢的欄位值 |
|
Built-In 球場
|
BuiltInField | True | boolean |
內建野戰旗 |
依識別碼取得資源
以資源 ID 回傳內建及自訂資源欄位
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源標識碼
|
id | True | string |
資源識別碼（UUID） |
取得任務欄位列表
取得任務欄位清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
名稱
|
name | string | |
|
標籤
|
label | string |
取得任務欄位名稱列表
取得任務欄位清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
名稱
|
name | string | |
|
標籤
|
label | string |
取得任務選擇欄位
回傳 Task-Level 欄位所有可用的選項值選項。
取得工作計畫欄位名稱列表
取得一份工作計畫欄位清單。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
|
array of object | ||
|
名稱
|
name | string | |
|
標籤
|
label | string |
取得工作計畫選擇欄位
回傳 WorkPlan-Level 欄位所有可用的選項值選項。
取得方案類型識別碼
會回傳計畫類型 ID，並依計畫類型名稱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
計劃類型名稱
|
Name | True | string |
計劃類型名稱 （字串） |
取得最後狀態報告
返回最新的狀態報告。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
方案標識碼
|
PlanId | True | string |
依計劃識別碼傳回內建和自訂欄位 |
取得狀態報告 Docx
產生並檢索所選專案或計畫的狀態報告，格式為 DOCX 格式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
狀態報告 ID
|
id | True | string |
狀態報告 ID |
取得資源選擇欄位
回傳 Resource-Level 欄位所有可用的選項值選項。
建立新任務
建立新的 OnePlan 任務
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
工作計畫識別碼（UUID） |
|
工作名稱
|
Name | string |
任務名稱（字串） |
|
|
工作小組
|
IntegrationPost | True | dynamic |
任務欄位需更新 |
建立新計劃
建立新計劃
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃主體
|
IntegrationPost | True | dynamic |
要更新的工作計劃欄位 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
新增或更新計劃的整合
新增或更新計劃整合資訊
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
是進口郵票
|
IsImport | True | boolean |
這是來自外部系統的項目嗎 |
|
方案標識碼
|
PlanId | True | string |
方案的唯一識別碼 |
|
流程 ID
|
IntegrationId | True | string |
整合的唯一識別碼 （在我們的案例中為流程 ID） |
|
外部系統識別碼
|
ItemId | True | string |
對應至外部系統的專案識別碼 |
|
外部系統 URL
|
ItemUrl | True | string |
外部系統中對應項目的 URL |
更新現有任務
更新現有的 OnePlan 任務。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
工作計畫識別碼（UUID） |
|
任務標識符
|
taskid | True | string |
任務識別碼（UUID） |
|
工作小組
|
IntegrationPost | True | dynamic |
任務欄位需更新 |
查詢工作計畫
回傳所有符合欄位條件的工作計畫，讓連結資料更方便
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
欄位名稱
|
FilterField | True | string |
你想查詢的欄位 |
|
申報價值
|
FilterValue | True | string |
你查詢的欄位值 |
|
Built-In 球場
|
BuiltInField | True | boolean |
表示該欄位是否為內建工作計畫欄位 |
查閱資源識別碼
回傳一個資源 UUID，使用電子郵件和名稱。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資源名稱
|
Name | string |
資源名稱 （字串） |
|
|
資源電子郵件
|
string |
資源電子郵件 （字串） |
核准計劃的流程步驟
核准計畫的流程步驟
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
工作計劃 ID
|
id | True | string |
WorkPlan ID 以核准 |
|
核准狀態
|
state | True | string |
核准狀態 |
|
評論
|
comment | string |
可選的核准註解 |
傳回
觸發程序
| 更新計劃時 |
按列表劃分的事件 |
| 當處理程序步驟變更時 |
按列表劃分的事件 |
| 當計畫加入時 |
按列表劃分的事件 |
更新計劃時
按列表劃分的事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
觸發程式名稱
|
Strategy | True | string |
OnePlan 活動名稱 |
|
觸發器
|
Triggers | True | array of integer |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Id
|
Id | string |
Id |
|
名稱
|
Name | string |
名稱 |
當處理程序步驟變更時
按列表劃分的事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
觸發程式名稱
|
Strategy | True | string |
OnePlan 活動名稱 |
|
觸發器
|
Triggers | True | array of integer |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
Name | string |
名稱 |
|
Id
|
Id | string |
Id |
|
當前步驟
|
Values.CurrentStep | string |
目前步驟 |
|
新步驟
|
Values.NewStep | string |
新步驟 |
|
連結計劃
|
Values.LinkToPlan | string |
連結至計劃 |
當計畫加入時
按列表劃分的事件
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
觸發程式名稱
|
Strategy | True | string |
OnePlan 活動名稱 |
|
觸發器
|
Triggers | True | array of integer |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
Name | string |
名稱 |
|
Id
|
Id | string |
Id |
|
當前步驟
|
Values.CurrentStep | string |
目前步驟 |
|
新步驟
|
Values.NewStep | string |
新步驟 |
|
連結計劃
|
Values.LinkToPlan | string |
連結至計劃 |