共用方式為


潘維瓦

Panviva 是一個全渠道知識管理解決方案。 我們的首要任務是幫助我們的客戶讓員工滿意,以便他們能夠專注於確保客戶滿意。 在過去的 20 年裡,我們對組織進行了數字化轉型,現在正在幫助我們的客戶隨時隨地向他們的員工和客戶提供知識塊,無論他們是在家裡還是在辦公室。

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

服務 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)
連絡人​​
名稱 Panviva 客戶倡導團隊
URL https://www.panviva.com/support
Email support@panviva.com
連接器中繼資料
Publisher 潘維瓦
網站 https://www.panviva.com
隱私策略 https://www.panviva.com/privacy-policy
類別 商業管理;生產力

先決條件

若要使用 Panviva 連接器,您必須具備:

  1. 存取 Panviva 執行個體 (也稱為租用戶)
  2. Panviva 開發人員入口網站 (dev.panviva.com) 上的開發人員帳戶
  3. 有效的 Panviva API 訂閱 (也稱為 API 方案) 和有效的 Panviva API 認證

如果您不是客戶或需要幫助,請訪問 www.panviva.com/support.

如何取得認證

請依照下列步驟取得您的 API 金鑰和 API 執行個體。

如果您在使用連接器時看到錯誤,您可以查詢錯誤代碼以獲取更多信息。 附註: 文件中的 HTTP 狀態碼可能與您在 Power Automate 或 Power Apps 中看到的狀態碼略有不同,請使用 [錯誤碼] 欄位進行查閱。

若要取得 API 金鑰,您必須:

  1. 登入 Panviva 開發人員入口網站,網址為 dev.panviva.com
  2. 導航到您的個人資料(單擊您的姓名,然後單擊頂部導航欄中的“個人資料”)
  3. 您現在應該會在個人資料的「您的訂閱」部分下看到您的 API 金鑰。

若要取得 API 執行個體,您必須:

  1. 登入 Panviva 開發人員入口網站,網址為 dev.panviva.com
  2. 導覽至您的 API (按一下頂端導覽列中的「API」)
  3. 您現在應該會在 API 套件下看到您的 API 執行個體 (尋找「API 套件的執行個體名稱為」)

節流限制

請注意,您的節流限制將根據您訂閱的 API 訂閱 (或 API 方案) 類型而定。

若要尋找配額或速率限制,您可以:

  1. 登入 Panviva 開發人員入口網站,網址為 dev.panviva.com
  2. 導航到您的個人資料(單擊您的姓名,然後單擊頂部導航欄中的“個人資料”)
  3. 前往您個人資料的「您的訂閱」部分下的 API 計劃
  4. 您現在應該會看到計劃的詳細資料 (尋找「...將能夠運行**每個分鐘的**個呼叫,最多_**個呼叫/月...“)

正在建立連線

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

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

預設

適用:所有地區

建立連線的參數。

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

名稱 類型 Description 為必填項目
Panviva API 訂閱金鑰 securestring 執行個體的Panviva API訂閱金鑰。

節流限制

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

動作

即時搜尋

將 Panviva 用戶端上傳遞查詢的搜尋結果頁面呈現給 Panviva 用戶端上的指定使用者

即時文件

在 Panviva 用戶端上向指定的使用者呈現文件頁面

容器

使用提供的容器識別碼傳回容器

建立工件類別

建立用於分類成品的種類

影像

傳回來自Panviva的影像。 影像資料會以 base64 字串表示

搜尋

搜尋文件、資料夾和檔案 (外部文件) 的字詞,並傳回編頁結果

搜尋文物

傳回指定查詢的搜尋結果

文件

使用提供的文件 ID 傳回文件

文件容器

使用提供的文件識別碼傳回容器清單

文件容器關係

傳回所提供文件識別碼之每個容器之間父子關係清單

文件翻譯

傳回Panviva檔案的所有翻譯(依語言和地區設定)的清單

檔案

從 Panviva 傳回檔案 (外部文件)

獲取文物類別

取得所有可用人工製品類別的清單

直播 CSH

將 Panviva 用戶端上傳遞查詢的 CSH 搜尋結果頁面呈現給 Panviva 用戶端上的指定使用者

神器

使用提供的識別碼傳回成品

資料夾

傳回 Panviva 資料夾的相關資訊,以及每個直接子項的參考

資料夾子項

取得 Panviva 資料夾的所有直接子系,不包括孫系。 子項可以是資料夾、文件或檔案 (外部文件)

資料夾根目錄

取得所有 Panviva 中的根/主資料夾,可以使用 [取得資料夾子項] 端點深入瞭解。 請注意,此端點先前稱為「資料夾搜尋」端點

資料夾翻譯

獲取 Panviva 文件夾的所有翻譯,以及每個翻譯文件夾各自的子項

即時搜尋

將 Panviva 用戶端上傳遞查詢的搜尋結果頁面呈現給 Panviva 用戶端上的指定使用者

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

使用者名稱
username string

您要將結果傳送給的 Panviva 使用者。 (注意:使用使用者名稱或 userId,而不是兩者。

userId
userId string

您要傳送結果之使用者的數字 ID。 (注意:使用使用者名稱或 userId,而不是兩者。

查詢
query string

要搜尋的字詞。

最大化客戶端
maximizeClient boolean

True/False,取決於您是否希望 Panviva 用戶端在傳送文件時在使用者桌面上最大化。

顯示第一個結果
showFirstResult boolean

True 表示立即開啟找到的第一個文件,或 false 表示顯示結果清單。

傳回

response
object

即時文件

在 Panviva 用戶端上向指定的使用者呈現文件頁面

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

使用者名稱
username string

您要將結果傳送給的 Panviva 使用者。 (注意:使用使用者名稱或 userId,而不是兩者。

userId
userId string

您要傳送結果之使用者的數字 ID。 (注意:使用使用者名稱或 userId,而不是兩者。

識別碼
id string

您要傳送之Panviva檔案的檔案ID。

位置
location string

您希望使用者在開啟指定文件時看到的區段 ID。

最大化客戶端
maximizeClient boolean

True/False,取決於您是否希望 Panviva 用戶端在傳送文件時在使用者桌面上最大化。

傳回

response
object

容器

使用提供的容器識別碼傳回容器

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True string

文件容器的識別碼

傳回

建立工件類別

建立用於分類成品的種類

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

名稱
name string

傳回

影像

傳回來自Panviva的影像。 影像資料會以 base64 字串表示

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva 影像的 ID

傳回

搜尋

搜尋文件、資料夾和檔案 (外部文件) 的字詞,並傳回編頁結果

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

術語
term True string

要搜尋的單字或片語

頁面偏移
pageOffset integer

分頁位移數,表示要略過的初始搜尋結果數目。 例如,pageOffset 為 100 且 pageLimit 為 10 會傳回記錄 101-110。

頁面限制
pageLimit integer

要傳回的記錄數目。 必須是介於 0 到 1000 之間的整數。

傳回

搜尋文物

傳回指定查詢的搜尋結果

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

簡單查詢
simplequery string

自然語言查詢字串。 例如:「動作片」。 (注意:使用 simplequery 或 advancedquery,而不是兩者。

進階查詢
advancedquery string

以 Lucene 查詢語法撰寫的查詢字串。 例如:「電影和「一個故事」」。 (注意:使用 simplequery 或 advancedquery,而不是兩者。

Filter
filter string

接受 Lucene 格式的篩選字串。 範例: 'category eq “Mortgages”', 'panvivaDocumentVersion gt “8”'。 (可篩選的欄位包括 dateCreated、dateModified、dateDeleted、categoryJson、queryVariationsJson、title、category、primaryQuery、isDeleted、timestamp、panvivaDocumentId、panvivaDocumentVersion、id)

Channel
channel string

傳回特定通道的回應,而不是預設的

頁面偏移
pageOffset integer

分頁位移數,表示要略過的初始搜尋結果數目。 例如,pageOffset 為 100 且 pageLimit 為 10 會傳回記錄 101-110。

頁面限制
pageLimit integer

要傳回的記錄數目。 必須是介於 0 到 1000 之間的整數。

方面
facet string

接受Lucene格式的Facet字串。 範例:「facet=Category,count:10&facet=Rating」。 (可構面欄位包括 metaData/值)

傳回

文件

使用提供的文件 ID 傳回文件

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True string

文件唯一識別碼,文件 ID。 如果文件是已翻譯的文件,則此值代表 Panviva API v1 中的內部 ID 或 IID。

版本
version integer

要求 API 傳回指定文件的特定版本。

傳回

文件容器

使用提供的文件識別碼傳回容器清單

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva 文件的內部 ID (IID)

傳回

文件容器關係

傳回所提供文件識別碼之每個容器之間父子關係清單

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva 文件的內部 ID (IID)

傳回

文件翻譯

傳回Panviva檔案的所有翻譯(依語言和地區設定)的清單

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva 文件的內部識別碼 (IID)。

傳回

檔案

從 Panviva 傳回檔案 (外部文件)

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva檔案(外部文件)的內部ID (IID)

傳回

獲取文物類別

取得所有可用人工製品類別的清單

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

傳回

直播 CSH

將 Panviva 用戶端上傳遞查詢的 CSH 搜尋結果頁面呈現給 Panviva 用戶端上的指定使用者

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

使用者名稱
username string

您要將結果傳送給的 Panviva 使用者。 (注意:使用使用者名稱或 userId,而不是兩者。

userId
userId string

您要傳送結果之使用者的數字 ID。 (注意:使用使用者名稱或 userId,而不是兩者。

查詢
query string

要搜尋的 CSH 字詞。

顯示第一個結果
showFirstResult boolean

True 表示立即開啟找到的第一個文件,或 false 表示顯示結果清單。

最大化客戶端
maximizeClient boolean

True/False,取決於您是否希望 Panviva 用戶端在傳送文件時在使用者桌面上最大化。

傳回

response
object

神器

使用提供的識別碼傳回成品

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True string

格式 - uuid。 構件的 ID (ID)

傳回

資料夾

傳回 Panviva 資料夾的相關資訊,以及每個直接子項的參考

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva資料夾的內部ID (IID)

傳回

資料夾子項

取得 Panviva 資料夾的所有直接子系,不包括孫系。 子項可以是資料夾、文件或檔案 (外部文件)

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva資料夾的內部ID (IID)

傳回

資料夾根目錄

取得所有 Panviva 中的根/主資料夾,可以使用 [取得資料夾子項] 端點深入瞭解。 請注意,此端點先前稱為「資料夾搜尋」端點

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

傳回

資料夾翻譯

獲取 Panviva 文件夾的所有翻譯,以及每個翻譯文件夾各自的子項

參數

名稱 機碼 必要 類型 Description
實例
instance True string

Panviva 開發人員入口網站上顯示的執行個體名稱。

Id
id True integer

Panviva資料夾的內部ID (IID)

傳回

定義

名稱 路徑 類型 Description
href
href string
關係
rel string
型別
type string

資源搜尋結果

名稱 路徑 類型 Description
型別
type string
識別碼
id string
名稱
name string
描述
description string
matched欄位
matchedFields array of string
片段
snippet string
語言
language string
links
links array of Link

GetSearch回應

名稱 路徑 類型 Description
results
results array of ResourceSearchResult
總計
total integer
links
links array of Link

StringInt64NullableKeyValuePair

名稱 路徑 類型 Description
Key
key string
value
value integer

方面

名稱 路徑 類型 Description
欄位
field string
groups
groups array of StringInt64NullableKeyValuePair

回應區段

名稱 路徑 類型 Description
mediaType
mediaType string
收發簡訊
text string
href
href string
resourceLocation
resourceLocation string

類別

名稱 路徑 類型 Description
名稱
name string
識別碼
id integer
創建日期
dateCreated date-time
日期修改
dateModified date-time

查詢變數

名稱 路徑 類型 Description
識別碼
id integer
查詢
query string

搜尋結果

名稱 路徑 類型 Description
識別碼
id uuid
內容
content array of ResponseSection
分類
category Category
元數據
metaData object
搜尋分數
searchScore number
links
links array of Link
查詢變化
queryVariations array of QueryVariation
primary查詢
primaryQuery string
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
title
title string

GetSearchArtefact回應

名稱 路徑 類型 Description
切面
facets array of Facet
results
results array of SearchResult
總計
total integer

GetContainer回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
body
body string

標記

名稱 路徑 類型 Description
名稱
name string
value
value string

Training

名稱 路徑 類型 Description
失敗反饋
failureFeedback string
forcePageSequence
forcePageSequence boolean
forceQuestionSequence
forceQuestionSequence boolean
passingScore(及格分數)
passingScore integer
success反饋
successFeedback string

GetDocument回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
版本
release integer
發布
released boolean
版權
copyright string
分類
classification string
狀態
status string
百分比
percentage integer
發行日期
releaseDate date-time
版面配置
layout string
訓練
training Training
關鍵字
keywords array of string
csh關鍵字
cshKeywords array of string
更新日期
updatedDate date-time
建立日期
createdDate date-time
可重複使用的內容
reusableContent boolean
變更註解
changeNote string
links
links array of Link

Channel

名稱 路徑 類型 Description
名稱
name string

回應變化

名稱 路徑 類型 Description
內容
content array of ResponseSection
通道
channels array of Channel
識別碼
id integer
創建日期
dateCreated date-time
日期修改
dateModified date-time

GetResponse回應

名稱 路徑 類型 Description
links
links array of Link
title
title string
內容
content array of ResponseSection
變化
variations array of ResponseVariation
分類
category Category
primary查詢
primaryQuery string
查詢變化
queryVariations array of QueryVariation
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
元數據
metaData object
識別碼
id uuid
創建日期
dateCreated date-time
日期修改
dateModified date-time

容器

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
body
body string

GetDocumentContainers回應

名稱 路徑 類型 Description
containers
containers array of Container

容器關係

名稱 路徑 類型 Description
識別碼
id string
父代
parent string
孩童
children array of string
任務流程
taskFlow string

GetDocumentContainerRelationships回應

名稱 路徑 類型 Description
關係
relationships array of ContainerRelationship

文件

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
版本
release integer
發布
released boolean
版權
copyright string
分類
classification string
狀態
status string
百分比
percentage integer
發行日期
releaseDate date-time
版面配置
layout string
訓練
training Training
關鍵字
keywords array of string
csh關鍵字
cshKeywords array of string
更新日期
updatedDate date-time
建立日期
createdDate date-time
可重複使用的內容
reusableContent boolean
變更註解
changeNote string
links
links array of Link

GetDocumentTranslations回應

名稱 路徑 類型 Description
翻譯
translations array of Document
原點
origin string

GetFile回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
內容
content string
fileName
fileName string
版本
release integer
發布
released boolean
版權
copyright string
分類
classification string
狀態
status string
百分比
percentage integer
發行日期
releaseDate date-time
關鍵字
keywords array of string
csh關鍵字
cshKeywords array of string
變更註解
changeNote string
更新日期
updatedDate date-time
建立日期
createdDate date-time

GetFolder回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
links
links array of Link

Resource

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string

GetFolderChildren回應

名稱 路徑 類型 Description
孩童
children array of Resource

資料夾

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
links
links array of Link

GetFolderTranslations回應

名稱 路徑 類型 Description
翻譯
translations array of Folder

GetFolderRoot回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
描述
description string
版本
version integer
語言
language string
tags
tags array of Tag
隱藏
hidden boolean
來源
source string
型別
type string
links
links array of Link

GetImage回應

名稱 路徑 類型 Description
識別碼
id string
名稱
name string
寬度
width integer
height
height integer
size
size integer
內容類型
contentType string
內容
content string

Artefact類別

名稱 路徑 類型 Description
識別碼
id integer
類別名稱
categoryName string

GetArtefactCategoriesResponse

名稱 路徑 類型 Description
categories
categories array of ArtefactCategory

PostArtefactCategory回應

名稱 路徑 類型 Description
categoryId
categoryId integer
類別名稱
categoryName string

物件

這是類型 'object'。