Mavim-iMprove

此連接器適用於以下產品和區域：

服務	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）

連絡人​​
名稱	Mavim 服務台
URL	https://my.mavim.com
Email	servicedesk@mavim.com

連接器中繼資料
Publisher	馬維姆
網站	https://www.mavim.com/
隱私策略	https://trustcenter.mavim.com/
類別	商業管理;通敵

使用 Mavim iMprove Power Platform 連接器，您可以創建;挽回;更新和刪除主題。 更新欄位和建立;挽回;更新和刪除關係。

Mavim 主題以分層方式存儲。 其中「Mavim 資料庫」稱為根主題。 在根主題下方存在三個子項，其中黃色櫃子是工作區域;綠色機櫃包含已建立的 （唯讀） 版本 （作為子項），紫色機櫃包含 （唯讀） 匯入的版本 （作為子項）。

只有在黃色櫃中，您才能更改主題;欄位和關係。 所有主題;關係和欄位具有稱為 DCV 代碼的唯一識別碼。 只有根主題具有靜態識別元 （d0c2v0）。 所有其他項目都獲得 Mavim 數據庫提供的生成編號。

請注意，對於某些主題（例如「回收筒」和「關係類別」），適用業務規則。

若要以更視覺化的方式查看資料，您可以使用也用於 Microsoft Power Platform 的認證和下列 URL 登入 Mavim iMprove Web 應用程式： https://improve.mavimcloud.com/

先決條件

若要能夠使用 Mavim Power Platform 連接器，您必須擁有 Mavim 雲端資料庫，並從您自己的租用戶登入 Microsoft Entra ID。

• 您需要 Mavim Cloud 資料庫識別碼 （dbid）;
• 使用者帳戶應具有連結至其帳戶的有效電子郵件地址。

如何取得認證

在上線程式期間，我們會要求提供 Microsoft Entra ID 登入名稱。 這將註冊為 Mavim 雲數據庫的管理員用戶。 當雲數據庫準備就緒時，Mavim 將提供數據庫標識符，也稱為 dbid。

開始使用連接器

動作 GetRootTopic 是取得階層式樹狀結構的起點。 這將傳回根主題及其所有屬性。 模擬動作是用於取得特定主題的 GetTopic;GetTopicChildren 取得所有子主題;GetSiblings 來取得主題的所有同層級。

所有對操作的調用都需要 dbid 連接到您自己的 Mavim 數據庫和語言代碼。 API 支援的資料語言為英文 （en） 和荷蘭文 （nl）。 Mavim 資料庫中的主題具有唯一的 DCV 程式碼，這是特定主題的標識符，也稱為 topicid。

MavimiMprove.GetTopicRoot（dbid，datalanguage）;

取得根主題。

回應 （範例）

{
    "business": {
        "canCreateChildTopic": false,
        "canCreateTopicAfter": false,
        "canDelete": false,
        "isReadOnly": true
    },
    "dcv": "d0c2v0",
    "hasChildren": true,
    "icon": "TreeIconID_DbGreen",
    "isInRecycleBin": false,
    "name": "Mavim Database",
    "orderNumber": -1,
    "typeCategory": "mavimElementContainer"
}

MavimiMprove.GetTopic（dbid，datalanguage，topicId）

通過 DCV 標識符獲取特定主題。

回應 （範例）

    "business": {
        "canCreateChildTopic": true,
        "canCreateTopicAfter": true,
        "canDelete": true,
        "isReadOnly": false
    },
    "dcv": "d16730231c28607v0",
    "hasChildren": true,
    "icon": "TreeIconID_YellowOpen",
    "isInRecycleBin": false,
    "name": "PowerApps topic",
    "orderNumber": 20,
    "parent": "d16730231c24017v0",
    "resources": [
        {
            "Value": "subTopics"
        },
        {
            "Value": "fields"
        }
    ],
    "typeCategory": "mavimElementContainer"
}

MavimiMprove.GetTopicChildren（dbid， datalanguage， topicId）

取得主題的兒童主題

回應 （範例）

[
    {
        "business": {
            "canCreateChildTopic": true,
            "canCreateTopicAfter": true,
            "canDelete": true,
            "isReadOnly": false
        },
        "dcv": "d16730231c28632v0",
        "hasChildren": false,
        "icon": "TreeIconID_YellowOpen",
        "isInRecycleBin": false,
        "name": "Subtopic 1",
        "orderNumber": 1,
        "parent": "d16730231c28607v0",
        "typeCategory": "unknown"
    },
   {
        "business": {
            "canCreateChildTopic": true,
            "canCreateTopicAfter": true,
            "canDelete": true,
            "isReadOnly": false
        },
        "dcv": "d16730231c28633v0",
        "hasChildren": false,
        "icon": "TreeIconID_YellowOpen",
        "isInRecycleBin": false,
        "name": "Subtopic 2",
        "orderNumber": 2,
        "parent": "d16730231c28607v0",
        "typeCategory": "unknown"
    }
]

其他支援的動作包括

主題

• 建立主題之後
• 建立子主題
• 更新主題
• 刪除主題

主題結構

• MoveTopicToTop （將主題移至頂部）
• 將主題移至底部
• 移動話題
• 下移主題
• 移動主題升級
• 移動主題降級
• GetPathToRoot

Fields

• GetTopic欄位
• GetFieldByDcvAndFieldsetId
• 更新欄位
• 更新布林單一欄位
• 更新文字單一欄位
• UpdateTextMulti欄位
• 更新編號單一欄位
• UpdateNumberMulti欄位
• 更新十進位單一欄位
• 更新十進式多欄位
• UpdateDateSingle欄位
• UpdateDate多欄位
• UpdateListSingle欄位
• UpdateRelationshipSingle欄位
• UpdateRelationshipMulti欄位
• UpdateRelationshipList欄位
• UpdateSingle超連結欄位
• UpdateMultiHyperlink欄位

Relations

• GetTopic關係
• SaveRelation
• 刪除關係
• GetRelationCategories

Other

• GetTopic圖表
• GetTopic類型
• GetTopicIcons
• 版本

已知問題與限制

• 更新主題描述只能透過我們的 WOPI （Office 網頁版） API 來完成。 在 My Mavim 入口網站上，您可以在 Mavim 開發者 API 下找到更多資訊。
• Mavim iMprove API 支持英語和荷蘭語數據語言。
• 目前我們只允許一個租戶訪問 Mavim 雲數據庫。 目前不支援來賓使用者。

常見錯誤和補救措施

401 未被掠奪

• 檢查使用者是否有權存取 Mavim 雲端資料庫。 前往 Mavim iMprove 的使用者管理，確保正確的使用者有權存取。
• 檢查使用者帳戶是否有有效的電子郵件廣告。

404 找不到

• 檢查該主題是否存在於 Mavim 雲端資料庫中。 您可以使用 Mavim iMprove 或 Mavim Manager 來評估（如果它仍然存在）。

FAQ

我可以在哪裡新增其他使用者？ 使用 Mavim iMprove 應用程序中的用戶管理部分添加其他用戶。 您可以在此處新增所有需要存取的使用者。 提供對 Mavim iMprove 的訪問意味著允許用戶使用 Mavim iMprove 和對 API 的訪問。

服務/API 帳戶 只有透過與具名使用者連線，才允許存取 Mavim 資料庫。 Mavim 不提供 clientid 和秘密身份驗證方法來連接到 API。

正在建立連線

連接器支援下列驗證類型：

預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

刪除主題	主題 ID 所要求的特定主題會被刪除。
取得 API 版本	擷取 API 版本號碼。
取得主題的同層級主題	取得主題 ID 所提供的主題的同層級主題。
取得主題的類型	取得主題識別碼所提供之特定主題的類型集合。
取得主題集合	取得主題的關聯性類別
取得主題類型的可用圖示	取得特定主題類型的圖示集合。
取得所提供主題識別碼至根目錄的路徑	取得根主題路徑中的所有主題。
取得根主題	取得根主題。
在分支中向上移動主題	將特定主題在分支中向上移動一個位置。
在分支中向上移動主題	將特定主題在分支中向上移動一個位置。
在分支中向下移動主題	將特定主題在分支中向下移動一個位置。
在分支中向下移動主題	將特定主題在分支中向下移動一個位置。
將主題移至分支底部	將特定主題移至分支底部。
將主題移至分支頂端	將特定主題移至分支頂端。
建立新主題	新主題會在參考主題之後建立為同層級。
建立新的子主題	新主題會建立為所參考主題的子項。
建立關聯	在兩個主題之間建立關聯性。
從主題中刪除關聯	依主題識別碼和 relationId 刪除關聯性。
從主題取得欄位	依欄位和特定主題的欄位集識別碼取得特定欄位。
從主題取得欄位	從使用主題 ID 要求的特定主題，會傳回欄位集合。
從主題更新多值小數點欄位	逐個欄位更新特定主題的特定多值十進位欄位和欄位集識別碼。
從主題更新多值數字欄位	依欄位和特定主題的欄位集識別碼更新特定布林欄位。
從主題更新多值文字欄位	逐個欄位更新特定主題的特定多值文字欄位和欄位集識別碼。
從主題更新多值日期欄位	依欄位和特定主題的欄位集識別碼更新特定的多值日期欄位。
從主題更新多值關係欄位	逐個欄位更新特定主題的特定多值關係欄位和欄位集識別碼。
從主題更新小數欄位	逐個欄位更新特定主題的特定單一值十進位欄位和欄位集識別碼。
從主題更新布林值欄位	依欄位和特定主題的欄位集識別碼更新特定布林欄位。
從主題更新數字欄位	逐個欄位更新特定主題的特定單一值數字欄位和欄位集識別碼。
從主題更新文字欄位	逐個欄位更新特定主題的特定單一值文字欄位和欄位集識別碼。
從主題更新日期欄位	逐個欄位更新特定主題的特定單一值日期欄位和欄位集識別碼。
從主題更新清單欄位	逐個欄位更新特定清單欄位和特定主題的欄位集識別碼。
從主題更新關係清單欄位	依欄位和特定主題的欄位集識別碼更新特定的單一值關係清單欄位。
從主題更新關聯性欄位	逐個欄位更新特定主題的特定單一值關係欄位和欄位集識別碼。
更新主題中的欄位	更新特定主題的多種欄位類型。
更新主題的名稱	更新特定主題的名稱。
更新單一值超連結欄位	更新特定主題的單一值超連結欄位。
更新多值超連結欄位	更新特定主題的多值超連結欄位。
獲取主題	通過 DCV 標識符獲取特定主題。
獲取主題的圖表	從使用主題 ID 要求的特定主題，會傳回圖表集合。
獲取主題的關係	取得主題 DCV ID 所提供的主題關係。
讓孩子們了解一個主題	取得主題的兒童主題

刪除主題

取得 API 版本

取得主題的同層級主題

取得主題的類型

取得主題集合

取得主題類型的可用圖示

取得所提供主題識別碼至根目錄的路徑

取得根主題

在分支中向上移動主題

在分支中向上移動主題

在分支中向下移動主題

在分支中向下移動主題

將主題移至分支底部

將主題移至分支頂端

建立新主題

建立新的子主題

建立關聯

從主題中刪除關聯

從主題取得欄位

從主題取得欄位

從主題更新多值小數點欄位

從主題更新多值數字欄位

從主題更新多值文字欄位

從主題更新多值日期欄位

從主題更新多值關係欄位

從主題更新小數欄位

從主題更新布林值欄位

從主題更新數字欄位

從主題更新文字欄位

從主題更新日期欄位

從主題更新清單欄位

從主題更新關係清單欄位

從主題更新關聯性欄位

更新主題中的欄位

更新主題的名稱

更新單一值超連結欄位

更新多值超連結欄位

獲取主題

獲取主題的圖表

獲取主題的關係

讓孩子們了解一個主題

定義

類別類型

欄位類型

艾哈特

IField

IPath項目

IRelationship

IRelationship元素

ISimpleDispatchInstruction

互聯網

ITopic商務

ITopic路徑

關係類型

主題資源

主題類型

字串

物件