適用於管理員的 iManage Work
iManage Work for Admins 連接器使管理員能夠自動執行其重複或整合任務，例如新增使用者或更新自訂欄位。
此連接器適用於以下產品和區域：
| 服務 | 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） |
| 連絡人 | |
|---|---|
| 名稱 | iManage 有限責任公司 |
| URL | https://docs.imanage.com |
| cloudsupport@imanage.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | iManage Power Platform 連接器 |
| 網站 | https://imanage.com |
| 隱私策略 | https://imanage.com/about/privacy-notice/ |
| 類別 | 內容和文件;生產力 |
適用於管理員的 iManage Work
iManage 是業界領先的知識工作者文件和電子郵件管理解決方案供應商。 iManage 平台組織和保護文件和電子郵件中的信息，因此專業人員可以搜索他們需要的內容，採取行動並更有效地協作。 適用於管理員的 iManage Work 連接器支援 Control Center 中可用的 iManage Administrator 功能的自動化。 例如，更新中繼資料欄位、新增使用者等。
先決條件
此連接器適用於所有連線到 cloudimanage.com 的 iManage Work 客戶。 首先，iManage Work Admin for Power Automate 應用程式需要由 iManage Work 環境的管理員啟用。 啟用後，您將需要環境的特定URL，以及聯結器可以執行動作的登入帳戶和密碼。 動作會遵循與「工作」中套用的相同權限，因此對於其中許多動作，您必須具有 NRT 管理員或第 1 層或第 2 層支援。 如需詳細資訊，請參閱常見問題集。
如何取得認證
如果您是現有的 iManage Work 使用者，請提供您的 iManage Work 憑證以登入。 否則，請聯絡您的系統管理員以取得協助。
開始使用 iManage Work for Admins 連接器
執行下列步驟以開始使用 iManage Work for Admins 連接器：
- 建立即時雲端流程，然後選取 + 新增步驟。
- 搜尋 iManage Work for Admins 以查看所有可用的 iManage Work 管理員動作。
- 選取所需的 iManage 工作管理員動作。
- 如果您尚未登入 iManage Work，系統會提示您登入。
- 選取 [登入]。
- 輸入您用來連線至 iManage Work 的 URL，例如 cloudimanage.com。
- 輸入您的 iManage 工作使用者 ID。
- 輸入所選帳戶的密碼，然後選擇 登入。 從此時起，所有使用 iManage 工作管理動作的流程都會使用這些使用者認證進行連線。 可以在 「我的連線」 下新增新連線並切換至該連線，以使用不同的 iManage 使用者帳戶。
已知問題與限制
有關已知問題和限制的列表，請訪問 https://docs.imanage.com/power-automate/index.html。
常見錯誤和補救措施
有關常見錯誤和補救措施的列表，請訪問 https://docs.imanage.com/power-automate/index.html。
FAQ
有關常見問題列表，請訪問 https://docs.imanage.com/power-automate/index.html。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 取得「我的事情」類別 |
獲取在“我的事項”中創建的類別。 管理員可以指定使用者 ID 來取得該使用者的「我的事項」類別。 |
| 取得文件庫角色 |
取得文件庫的使用者角色清單。 |
| 取得查閱別名 |
取得指定查閱欄位識別碼的查閱別名清單。 |
| 將使用者指派給程式庫 |
將現有使用者指派給文件庫。 |
| 將捷徑新增至使用者的「我的事項」 |
將工作區捷徑新增至使用者的「我的事項」。 如果指定了類別 ID，則捷徑會放置在該類別下。 |
| 建立使用者 |
建立使用者，並將使用者指派給偏好的檔案庫。 |
| 建立自訂或屬性查詢的別名 |
建立 custom1 到 custom12、custom29 和 custom30 的自訂屬性別名。 |
| 從 CSV 文件取得資料列 |
從 iManage Work 中的 CSV 文件取得列。 |
| 搜尋自訂屬性別名 |
搜尋指定自訂內容的別名。 |
| 新增索引標籤 |
在工作區下新增索引標籤。 |
| 新增資料夾 |
在工作區、標籤或資料夾下新增資料夾。 |
| 更新自訂欄位 |
更新 custom1 到 custom12、custom29 和 custom30 的自訂欄位描述或啟用狀態。 |
| 更新資料夾 |
更新指定資料夾的詳細資料。 若要刪除字串欄位的目前值，請將此欄位的值設定為以單引號或雙引號括住的空字串。 |
| 移動資料夾 |
將資料夾移至指定的目的地。 目的地可以是工作區、索引標籤或相同文件庫中的另一個資料夾。 |
取得「我的事情」類別
獲取在“我的事項”中創建的類別。 管理員可以指定使用者 ID 來取得該使用者的「我的事項」類別。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
user_id | True | string |
指定「我的事項」擁有者的使用者 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料
|
data | array of object | |
|
類型
|
data.category_type | string |
指出類別類型。 可能的值為 'my_matters'、'my_favorites'。 |
|
預設安全性
|
data.default_security | string |
指出類別的預設安全性存取層級。 可能的值為 'inherit'、'public'、'view'、'private'。 |
|
有子資料夾
|
data.has_subfolders | boolean |
指出類別是否有子資料夾。 子資料夾可以是工作區、資料夾或類別。 |
|
ID
|
data.id | string |
指出類別的識別碼。 例如，“ACTIVE_US！987”。 |
|
名稱
|
data.name | string |
指出類別的名稱。 |
|
所有者
|
data.owner | string |
指出類別擁有者的使用者 ID。 |
取得文件庫角色
取得文件庫的使用者角色清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
圖書館 ID
|
libraryId | True | string |
指定目標文件庫的 ID。 |
|
外部程式庫角色
|
is_external | boolean |
指定傳回的物件庫角色是外部角色。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料
|
data | array of object |
指出文件庫的使用者角色清單。 |
|
ID
|
data.id | string |
指出角色的識別碼。 |
|
Description
|
data.description | string |
指出角色的描述。 |
取得查閱別名
取得指定查閱欄位識別碼的查閱別名清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
圖書館 ID
|
libraryId | True | string |
指定目標文件庫的 ID。 |
|
查閱欄位識別碼
|
lookupFieldId | True | string |
指定查閱欄位 ID。 |
|
父別名
|
parentAlias | string |
如果選取 custom2 或 custom30，則指定自訂內容別名的父項。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料
|
data | array of object |
指出指定查閱欄位 ID 的查閱別名清單。 |
|
ID
|
data.id | string |
指出查閱別名的識別碼。 |
|
名稱
|
data.description | string |
指出查閱別名的名稱。 |
將使用者指派給程式庫
將現有使用者指派給文件庫。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
圖書館 ID
|
libraryId | True | string |
指定目標文件庫的 ID。 |
|
使用者識別碼
|
user_id | True | string |
指定要指派給目標檔案庫的使用者名稱。 |
|
Role
|
role | True | string |
指定使用者在目標文件庫中的角色。 |
|
是首選圖書館
|
is_preferred_library | True | boolean |
指定將文件庫 ID 設定為使用者慣用的文件庫。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
用戶編號
|
data.user_num | number |
指出內部使用者編號。 |
將捷徑新增至使用者的「我的事項」
將工作區捷徑新增至使用者的「我的事項」。 如果指定了類別 ID，則捷徑會放置在該類別下。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
使用者識別碼
|
user_id | True | string |
指定「我的事項」擁有者的 ID。 |
|
工作區識別碼
|
workspace_id | True | string |
指定一或多個工作區 ID，以分號分隔。 工作區識別碼的範例是 'ACTIVE_US！123'。 |
|
類別標識碼
|
category_id | string |
在「我的事項」下指定類別的 ID。 類別 ID 的範例是 'ACTIVE_US！123'。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作區捷徑
|
data.shortcuts | array of MyMattersShortcutsInArray |
表示新增至「我的事項」的工作區捷徑集合。 |
|
所有工作區捷徑 ID
|
data.all_workspace_shortcut_ids | string |
指出所有工作區捷徑識別碼的清單，串連為字串，並以分號分隔。 |
建立使用者
建立使用者，並將使用者指派給偏好的檔案庫。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
用戶編號
|
data.user_num | integer |
指出內部使用者編號。 |
|
全名
|
data.full_name | string |
指出使用者的完整名稱。 |
|
使用者識別碼
|
data.id | string |
指出使用者的唯一識別碼。 |
|
用戶首選庫
|
data.preferred_library | string |
指出使用者偏好的 （預設） 程式庫。 |
|
用戶 NOS
|
data.user_nos | integer |
指出使用者的類型。 使用者類型可以是虛擬 （2） 或企業 （6）。 |
|
擴充使用者 ID
|
data.user_id_ex | string |
指出從來源系統 （例如 Active Directory） 接收的使用者 ID 原始值。 |
|
使用者 SSID
|
data.ssid | string |
指出使用者的唯一系統產生 ID。 |
|
密碼永不過期
|
data.pwd_never_expire | boolean |
指出使用者的密碼是否永遠不會過期。 |
|
已鎖定
|
data.is_locked | boolean |
指出使用者是否已鎖定。 |
|
外部使用者
|
data.is_external | boolean |
指出使用者是否為外部使用者。 |
|
有密碼
|
data.has_password | boolean |
指出使用者是否有密碼。 |
|
強制更改密碼
|
data.force_password_change | boolean |
表示使用者必須在下次登入時變更其密碼。 僅適用於虛擬使用者，由值為「2」的使用者 NOS 表示。 |
|
登入失敗
|
data.failed_logins | integer |
指出使用者目前失敗的登入嘗試次數。 |
|
用戶電子郵件
|
data.email | string |
指出使用者的電子郵件地址。 |
|
編輯日期
|
data.edit_date | string |
指出使用者設定檔最近變更的日期和時間 （ISO 8601 格式）。 |
|
建立日期
|
data.create_date | string |
指出建立使用者的日期和時間 （ISO 8601 格式）。 |
|
密碼變更日期
|
data.pwd_changed_ts | string |
指出使用者密碼變更的日期和時間 （ISO 8601 格式）。 |
|
允許登入
|
data.allow_logon | boolean |
指出是否允許使用者登入。 |
|
使用者已建立
|
data.user_created | boolean |
指出使用者是否已成功建立。 如果 ，已 |
建立自訂或屬性查詢的別名
建立 custom1 到 custom12、custom29 和 custom30 的自訂屬性別名。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
傳回
- response
- object
從 CSV 文件取得資料列
從 iManage Work 中的 CSV 文件取得列。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
文件 ID
|
documentId | True | string |
指定文件的 ID。 例如，'ACTIVE_US！453.1'。 |
|
欄名稱
|
column_names | True | string |
指定以逗號分隔的欄名稱清單，或文件 ID，以使用第一列自動擷取欄名稱。 |
|
使用最新版本
|
latest | boolean |
指定使用最新版本文件的內容。 如果為「直欄名稱」欄位提供文件 ID，則會使用該文件最新版本的第一列來擷取直欄名稱。 |
傳回
搜尋自訂屬性別名
搜尋指定自訂內容的別名。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
圖書館 ID
|
libraryId | True | string |
指定目標文件庫的 ID。 |
|
自訂屬性
|
lookupFieldId | True | string |
指定自訂屬性。 |
|
父別名
|
parentAlias | string |
如果自訂屬性是 custom2 或 custom30，則指定父別名。 |
|
|
Alias
|
alias | string |
指定文字以符合自訂內容識別碼。 此搜尋不區分大小寫。 支援萬用字元 （*） 和部分相符。 |
|
|
Description
|
description | string |
指定文字以符合自訂內容描述。 此搜尋不區分大小寫。 支援萬用字元 （*） 和部分相符。 |
|
|
HIPAA 是
|
hipaa | boolean |
指定搜尋符合 HIPAA 加密規範的別名。 |
|
|
別名狀態
|
enabled_state | string |
指定傳回已啟用、停用或兩者兼而有之的自訂屬性別名。 |
新增索引標籤
在工作區下新增索引標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
名稱
|
name | True | string |
指定標籤的名稱。 |
|
父工作區 ID
|
parentId | True | string |
指定目標工作區的 ID。 工作區識別碼的範例是 'ACTIVE_US！123'。 |
|
預設安全性
|
default_security | True | string |
指定索引標籤的預設安全性。 |
|
Description
|
description | string |
指定索引標籤的描述。 |
|
|
索引標籤擁有者
|
owner | string |
指定索引標籤擁有者的使用者 ID。範例使用者 ID 是 'ACASE'。 |
新增資料夾
在工作區、標籤或資料夾下新增資料夾。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
更新自訂欄位
更新 custom1 到 custom12、custom29 和 custom30 的自訂欄位描述或啟用狀態。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
傳回
- response
- object
更新資料夾
更新指定資料夾的詳細資料。 若要刪除字串欄位的目前值，請將此欄位的值設定為以單引號或雙引號括住的空字串。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
body
|
body | True | dynamic |
移動資料夾
將資料夾移至指定的目的地。 目的地可以是工作區、索引標籤或相同文件庫中的另一個資料夾。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
資料夾 ID
|
folder_id | True | string |
指定要移動的資料夾 ID。 例如，'ACTIVE_US！453'。 |
|
目的地 ID
|
destination_id | True | string |
指定目的地的 ID，例如 'ACTIVE_US！453'。 目的地可以是工作區、索引標籤或相同文件庫中的另一個資料夾。 |
定義
MyMattersShortcutsInArray
指出每個捷徑的詳細資料。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ID
|
id | string |
指出捷徑的 ID。 例如，“ACTIVE_US！987”。 |
|
Ws類型
|
wstype | string |
指出物件的 iManage 工作類型。 可能的值是 'workspace_shortcut'。 |
|
ID
|
target.id | string |
指出捷徑的目標工作區識別碼。 例如，“ACTIVE_US！987”。 |
物件
這是類型 'object'。