公共 360
Public 360 是北歐市場領先的 ECM 系統。 Public 360 連接器可讓使用者建立流程,將案例、文件和檔案封存到 Public 360。 Public 360 連接器將使用戶能夠更輕鬆地存檔! 這包括歸檔社交媒體帖子、Outlook 項目或 OneDrive 文檔。
此連接器適用於以下產品和區域:
| 服務 | 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) |
| 連絡人 | |
|---|---|
| 名稱 | 360 度支援 |
| URL | https://tieto.service-now.com/tsc |
| public360.support@tietoevry.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | Tietoevry 挪威 |
| 網站 | https://www.tietoevry.com/ |
| 隱私策略 | https://www.tietoevry.com/siteassets/files/privacy-notice/privacy-notice-public-360-power-automate-connetor.pdf |
| 類別 | 內容和文件;生產力 |
Public 360° 是北歐市場領先的企業內容管理系統。 Public 360° 連接器透過 SIF(簡單整合框架)API 整合系統,並能直接在 Public 360° 中自動建立案件、文件與檔案。 像是電子郵件、社群媒體貼文或雲端儲存文件等資訊,都能以一致且有結構的方式被捕捉與整理。 透過簡化公共360°紀錄的建立,該連接器幫助組織擴展數位流程,同時確保可靠且合規的記錄保存。
先決條件
使用此連接器時,請確保符合以下要求:
- 有效的 Azure 訂用帳戶
- 在你的 Microsoft Entra ID 中建立授權使用者帳號
- 存取及歸檔公共360°資料所需的權限
如何取得認證
公共 360° 連接器透過 Azure Active Directory(AAD)進行承載憑證驗證。 要連線,您必須在公開 360° 實例中擁有活躍的使用者帳號。 使用你的公開 360° 憑證登入,透過 AAD 認證你,並產生建立連線所需的持有人令牌。 這種連結是個人的,無法分享。 如果使用 此連接器的 Power App 與另一使用者共享,該使用者將被明確提示建立自己的連線。 若不確定自己是否擁有必要的帳號或權限,請聯絡您的公共360°管理員。
已知問題與限制
該連接器目前支援三種操作:在 Public 360° 建立新案件、將文件上傳並歸檔至現有案件,以及將檔案附加到文件或直接在 Public 360° 中。 連接器介面中直接可用的參數數量有限,但未列出的參數仍可透過 AdditionalFields 參數進行配置。 我們計劃在不久的將來擴大可用服務範圍,並根據用戶反饋推出改進。 為了簡化流程並減少有效載荷大小,我們建議使用 Public 360° 的預設值集。 如需透過 AdditionalFields 設定參數、使用預設值集或優化連接器其他方面的指引,請聯繫您的 360° 管理員尋求協助。
常見錯誤和補救措施
使用接頭時可能出現的問題包括:
-
401 Unauthorized:當認證失敗時會發生。 若提供用於存取 SIF API 的憑證無效、過期或遺失,或使用者沒有足夠權限執行所請求的動作,就可能發生這種情況。 -
502 Bad Gateway這表示連接器無法成功與公共360°服務通訊。 常見原因包括暫時性服務中斷、網路問題或 API 端點設定錯誤。 一個常見的錯誤是在主機網址中包含 https:// 前綴;主機應在不包含該欄位的情況下指定(例如,使用 my360.com 代替 https://my360.com)。 在其他情況下,HTTP 回應碼會是 200,即使底層的 SIF API 呼叫失敗。 SIF API 呼叫的實際結果由回應主體中的 Successful 屬性表示。 若成功值為否,則該操作未成功。 關於錯誤的詳細資訊可在 ErrorMessage 和 ErrorDetails 屬性中找到。
此連接器使用 SIF API 與 Public 360 通訊。 如需詳細資訊,請流覽 https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 創建檔案 |
此操作使用 SIF API 在 Public 360 中建立檔案。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
| 建立文件 |
此操作用於使用 SIF API 在 Public 360 中建立文件,並支援已註冊與未註冊文件。 必填欄位包括標題、檔案庫、分類與狀態。 註冊文件必須包含案件編號。 未註冊文件不需案件,但必須包含三個額外欄位:來源(ToOrigin)、CF_ExtSystem()及已提交(Commited)。 未註冊文件的檔案必須設定為「匯入檔案」(預設編號:7)。 我們建議使用 Public 360 中的預設值集合功能來預先設定這些數值。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
| 建立案例 |
此操作用於使用 SIF API 在 Public 360 中建立案件。 必填欄位包括職稱、案件類型,以及負責人電子郵件/識別號碼或責任企業編號。 我們建議使用 Public 360 中的預設值集功能,預先設定案件、文件和檔案的這些值。 這在從表單自動建立文件或透過與外部系統整合時特別有用。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf |
創建檔案
此操作使用 SIF API 在 Public 360 中建立檔案。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
主機 URL
|
hosturl | True | string |
主機 URL 指向公用 360 解決方案。 |
|
Title
|
Title | True | string |
檔案的標題。 |
|
文件編號
|
DocumentNumber | string |
此檔案所屬文件的文件編號。 必須提供文件編號或文件記錄。 |
|
|
文件彙編
|
DocumentRecno | integer |
該檔案所屬文件的檔案收藏。 必須提供文件編號或文件記錄。 |
|
|
格式
|
Format | True | string |
在建立檔案期間要傳遞的檔案類型(例如「txt」、「htm」)。 |
|
資料
|
Base64Data | True | string |
檔案內容,編碼為「Base64」。 |
|
名稱
|
Name | string |
功能變數的名稱。 這個名稱是 360° 元模型中的名稱(不一定與 360° 圖形介面中相同)。 |
|
|
價值觀
|
Value | string |
現場要設定的價值。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
雷克諾
|
Recno | integer |
雷克諾 |
|
成功
|
Successful | boolean |
成功 |
|
錯誤訊息
|
ErrorMessage | string |
錯誤訊息 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
建立文件
此操作用於使用 SIF API 在 Public 360 中建立文件,並支援已註冊與未註冊文件。 必填欄位包括標題、檔案庫、分類與狀態。 註冊文件必須包含案件編號。 未註冊文件不需案件,但必須包含三個額外欄位:來源(ToOrigin)、CF_ExtSystem()及已提交(Commited)。 未註冊文件的檔案必須設定為「匯入檔案」(預設編號:7)。 我們建議使用 Public 360 中的預設值集合功能來預先設定這些數值。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
主機 URL
|
hosturl | True | string |
主機 URL 指向公用 360 解決方案。 |
|
Title
|
Title | True | string |
文件的標題。 |
|
案例編碼
|
CaseNumber | string |
本文件所屬案例的案例編號。 |
|
|
預設值集
|
DefaultValueSet | string |
文件實體的定義值集,用於建立文件,如果未傳遞,則這些值為預設值 |
|
|
非正式稱號
|
UnofficialTitle | string |
文件的非官方標題。 |
|
|
負責人電子郵件
|
ResponsiblePersonEmail | string |
負責該文件的人。 |
|
|
類別
|
Category | string |
文件的類別。 例如:內部備忘錄編號:60005,無需後續跟進 |
|
|
地位
|
Status | string |
文件的狀態。 例如:recno:1 為預留,recno:6 為正式登記 |
|
|
檔案館
|
Archive | string |
此文件的文件封存 |
|
|
註釋
|
Notes | string |
文件的註釋。 |
|
|
Role
|
Role | string |
特定文件的聯絡人角色。 可以是 code 或 recno。 |
|
|
參考編號
|
ReferenceNumber | string |
參考號碼是私人的個人身份證號碼和企業的企業號碼。 |
|
|
名稱
|
Name | string |
功能變數的名稱。 這個名稱是 360° 元模型中的名稱(不一定與 360° 圖形介面中相同)。 |
|
|
價值觀
|
Value | string |
現場要設定的價值。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
雷克諾
|
Recno | integer |
雷克諾 |
|
DocumentNumber
|
DocumentNumber | string |
DocumentNumber |
|
成功
|
Successful | boolean |
成功 |
|
錯誤訊息
|
ErrorMessage | string |
錯誤訊息 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |
建立案例
此操作用於使用 SIF API 在 Public 360 中建立案件。 必填欄位包括職稱、案件類型,以及負責人電子郵件/識別號碼或責任企業編號。 我們建議使用 Public 360 中的預設值集功能,預先設定案件、文件和檔案的這些值。 這在從表單自動建立文件或透過與外部系統整合時特別有用。 欲了解更多信息,請訪問: https://help.360online.com/ReleaseInformation/SIF%20APIs%20-%20Documentation.pdf
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
主機 URL
|
hosturl | True | string |
主機 URL 指向公用 360 解決方案。 |
|
Title
|
Title | True | string |
案例的標題。 |
|
預設值集
|
DefaultValueSet | string |
一組定義的案例實體值,若未傳遞,則用來建立案例,預設值為該值。 |
|
|
非正式稱號
|
UnofficialTitle | string |
案件的非正式標題。 |
|
|
案例類型
|
CaseType | string |
代碼或 recno 值,例如 “Case” 或 “recno:2”。 參考案例類型代碼表。 |
|
|
負責人電子郵件
|
ResponsiblePersonEmail | string |
案件負責人。 |
|
|
負責人識別號碼
|
ResponsiblePersonIdNumber | string |
指的是有效的聯絡人外部識別碼。負責任人員電子郵件的替代方案。 |
|
|
責任企業編號
|
ResponsibleEnterpriseNumber | string |
根據外部 ID 或參考編號查詢企業。 責任人電子郵件及識別號碼的替代方案。 |
|
|
進度計劃標識符
|
ProgressPlanId | integer |
進度計劃識別碼,將案例連線至進度計劃。 進度計劃 ID 可以是 recno、工作單位 ID 或描述。 |
|
|
名稱
|
Name | string |
功能變數的名稱。 這個名稱是 360° 元模型中的名稱(不一定與 360° 圖形介面中相同)。 |
|
|
價值觀
|
Value | string |
現場要設定的價值。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
雷克諾
|
Recno | integer |
雷克諾 |
|
CaseNumber
|
CaseNumber | string |
CaseNumber |
|
成功
|
Successful | boolean |
成功 |
|
錯誤訊息
|
ErrorMessage | string |
錯誤訊息 |
|
ErrorDetails
|
ErrorDetails | string |
ErrorDetails |