Partilhar via


Panviva

Panviva é uma solução de gestão de conhecimento omnichannel. Nossa prioridade é ajudar nossos clientes a manter seus funcionários felizes, para que eles possam se concentrar em garantir que seus clientes estejam felizes. Transformando digitalmente as organizações nos últimos 20 anos, agora estamos ajudando nossos clientes a fornecer pepitas de conhecimento para seus funcionários e clientes, estejam eles em casa ou no escritório - a qualquer hora e em qualquer lugar.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Class Regiões
Estúdio Copiloto Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões do Azure Government
     - Regiões do Azure China
     - Departamento de Defesa dos EUA (DoD)
Aplicações Power Premium Todas as regiões do Power Apps , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Automatize o poder Premium Todas as regiões do Power Automatic , exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Contato
Nome Equipa de Defesa do Cliente Panviva
URL https://www.panviva.com/support
Email support@panviva.com
Metadados do conector
Editora Panviva
Sítio Web https://www.panviva.com
Política de privacidade https://www.panviva.com/privacy-policy
Categorias Gestão Empresarial; Produtividade

Pré-requisitos

Para usar o conector Panviva, você deve ter:

  1. Acesso a uma instância do Panviva (também conhecida como locatário)
  2. Uma conta de desenvolvedor no portal do desenvolvedor Panviva (dev.panviva.com)
  3. Uma assinatura ativa da API Panviva (também conhecida como um plano de API) e credenciais válidas da API Panviva

Se você não é um cliente ou precisa de ajuda, visite www.panviva.com/support.

Como obter credenciais

Siga as etapas abaixo para obter sua chave de API & instância de API.

Se vir um erro ao utilizar o conector, poderá procurar o código de erro para obter mais informações. Nota: o código de estado HTTP na documentação pode ser ligeiramente diferente do que vê no Power Automate ou Power Apps, utilize o campo Código de erro para fins de pesquisa.

Para obter sua chave de API, você deve:

  1. Entre no portal do desenvolvedor Panviva em dev.panviva.com
  2. Navegue até ao seu perfil (clique no seu nome e, em seguida, clique em "Perfil" na barra de navegação superior)
  3. Agora você deve ver sua chave de API na seção "Suas assinaturas" do seu perfil.

Para obter sua instância de API, você deve:

  1. Entre no portal do desenvolvedor Panviva em dev.panviva.com
  2. Navegue até sua API (clique em "APIs" na barra de navegação superior)
  3. Agora você deve ver sua instância de API em seu pacote de API (procure por "O nome da instância para o API Suite é")

Limites de limitação

Observe que seus limites de limitação serão baseados no tipo de assinatura de API (ou plano de API) ao qual você se inscreveu.

Para encontrar a sua quota ou limite de taxa, pode:

  1. Entre no portal do desenvolvedor Panviva em dev.panviva.com
  2. Navegue até ao seu perfil (clique no seu nome e, em seguida, clique em "Perfil" na barra de navegação superior)
  3. Vá para o seu plano de API na seção "Suas assinaturas" do seu perfil
  4. Agora você deve ver os detalhes do seu plano (procure por "... será capaz de executar ** chamadas/minuto até um máximo de _** chamadas/mês...")

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Nome Tipo Description Obrigatório
Chave de assinatura da API Panviva securestring A chave de assinatura da API Panviva para sua instância. Verdade

Limites de Limitação

Name Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Artefacto

Devolver um artefacto utilizando o ID fornecido

Container

Retornar um contêiner usando o ID do contêiner fornecido

Contentores de documentos

Retornar uma lista de contêineres usando a ID do documento fornecida

Criar categoria de artefato

Cria uma categoria para classificar artefatos

CSH ao vivo

Apresentar uma página de resultado de pesquisa CSH da consulta de passagem no cliente Panviva para o usuário especificado no cliente Panviva

Documento

Devolver um documento utilizando o ID do documento fornecido

Documento ao vivo

Apresentar uma página de documento ao usuário especificado no cliente Panviva

Ficheiro

Retorna um arquivo (documento externo) do Panviva

Folder

Retornar informações sobre uma pasta Panviva e referências a cada um de seus filhos diretos

Imagem

Retorna uma imagem do Panviva. Os dados de imagem são representados como uma cadeia de caracteres base64

Live search

Apresentar uma página de resultado de pesquisa da consulta de passagem no cliente Panviva para o usuário especificado no cliente Panviva

Obter Categorias de Artefactos

Obtém uma lista de todas as categorias de artefatos disponíveis

Pasta Crianças

Recebe todos os filhos imediatos de uma pasta Panviva, não incluindo netos. As crianças podem ser pastas, documentos ou ficheiros (documentos externos)

Pesquisa

Pesquisa documentos, pastas e arquivos (documentos externos) para um termo e retorna resultados paginados

Pesquisar Artefactos

Retornar resultados de pesquisa para uma determinada consulta

Raiz da pasta

Obtém a pasta raiz/home em todo o Panviva, que pode ser detalhada usando o ponto de extremidade Get Folder Children. Observe que esse ponto de extremidade era anteriormente conhecido como o ponto de extremidade 'Pesquisa de pasta'

Relações de contêiner de documentos

Retornar uma lista da relação pai-filho entre cada contêiner para a ID do documento fornecida

Traduções de Documentos

Retornar uma lista de todas as traduções (por idioma e localidade) de um documento Panviva

Traduções de Pastas

Obtém todas as traduções de uma pasta Panviva, juntamente com cada pasta traduzida respetivos filhos

Artefacto

Devolver um artefacto utilizando o ID fornecido

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True string

Formato - uuid. O id (ID) de um artefato

Devoluções

Container

Retornar um contêiner usando o ID do contêiner fornecido

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True string

A id de um contêiner de documentos

Devoluções

Contentores de documentos

Retornar uma lista de contêineres usando a ID do documento fornecida

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de um documento Panviva

Devoluções

Criar categoria de artefato

Cria uma categoria para classificar artefatos

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

nome
name string

Devoluções

CSH ao vivo

Apresentar uma página de resultado de pesquisa CSH da consulta de passagem no cliente Panviva para o usuário especificado no cliente Panviva

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

nome de utilizador
username string

O usuário Panviva para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

userId
userId string

O ID numérico do usuário para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

consulta
query string

O termo CSH a procurar.

showFirstResult
showFirstResult boolean

True para abrir imediatamente o primeiro documento encontrado, ou false para mostrar a lista de resultados.

maximizar o cliente
maximizeClient boolean

Verdadeiro/Falso dependendo se você deseja que o cliente Panviva maximize na área de trabalho do usuário, quando o documento é entregue.

Devoluções

response
object

Documento

Devolver um documento utilizando o ID do documento fornecido

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True string

Um identificador exclusivo do documento, ID do documento. Se um documento for um documento traduzido, esse valor representará a ID interna ou IID na API Panviva v1.

Versão
version integer

Solicite que a API retorne uma versão específica do documento especificado.

Devoluções

Documento ao vivo

Apresentar uma página de documento ao usuário especificado no cliente Panviva

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

nome de utilizador
username string

O usuário Panviva para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

userId
userId string

O ID numérico do usuário para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

id
id string

O ID do documento Panviva que você deseja enviar.

localização
location string

O ID da seção que você gostaria que o usuário visse, quando o documento especificado é aberto.

maximizar o cliente
maximizeClient boolean

Verdadeiro/Falso dependendo se você deseja que o cliente Panviva maximize na área de trabalho do usuário, quando o documento é entregue.

Devoluções

response
object

Ficheiro

Retorna um arquivo (documento externo) do Panviva

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de um arquivo Panviva (documento externo)

Devoluções

Folder

Retornar informações sobre uma pasta Panviva e referências a cada um de seus filhos diretos

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de uma pasta Panviva

Devoluções

Imagem

Retorna uma imagem do Panviva. Os dados de imagem são representados como uma cadeia de caracteres base64

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id de uma imagem Panviva

Devoluções

Apresentar uma página de resultado de pesquisa da consulta de passagem no cliente Panviva para o usuário especificado no cliente Panviva

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

nome de utilizador
username string

O usuário Panviva para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

userId
userId string

O ID numérico do usuário para quem você deseja enviar o resultado. (Nota: Use username OU userId, não ambos.)

consulta
query string

O termo a procurar.

maximizar o cliente
maximizeClient boolean

Verdadeiro/Falso dependendo se você deseja que o cliente Panviva maximize na área de trabalho do usuário, quando o documento é entregue.

showFirstResult
showFirstResult boolean

True para abrir imediatamente o primeiro documento encontrado, ou false para mostrar a lista de resultados.

Devoluções

response
object

Obter Categorias de Artefactos

Obtém uma lista de todas as categorias de artefatos disponíveis

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Devoluções

Pasta Crianças

Recebe todos os filhos imediatos de uma pasta Panviva, não incluindo netos. As crianças podem ser pastas, documentos ou ficheiros (documentos externos)

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de uma pasta Panviva

Devoluções

Pesquisa

Pesquisa documentos, pastas e arquivos (documentos externos) para um termo e retorna resultados paginados

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Term
term True string

A palavra ou frase a ser pesquisada

Deslocamento de página
pageOffset integer

O deslocamento de paginação para indicar o número de resultados iniciais da pesquisa a serem ignorados. Por exemplo, pageOffset de 100 e pageLimit de 10 retornariam registros 101-110.

Limite de páginas
pageLimit integer

O número de registos a devolver. Deve ser um número inteiro entre 0 e 1000.

Devoluções

Pesquisar Artefactos

Retornar resultados de pesquisa para uma determinada consulta

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Consulta simples
simplequery string

Cadeia de caracteres de consulta em linguagem natural. Por exemplo: 'Filmes de ação'. (Nota: Use simplequery OU advancedquery, não ambos.)

Consulta avançada
advancedquery string

Seqüência de caracteres de consulta escrita na sintaxe de consulta Lucene. Por exemplo: 'filmes E 'uma história''. (Nota: Use simplequery OU advancedquery, não ambos.)

Filter
filter string

Aceita uma cadeia de caracteres de filtro formatada em Lucene. Exemplos: 'category eq "Mortgages"', 'panvivaDocumentVersion gt "8"'. (Os campos filtráveis incluem dateCreated, dateModified, dateDeleted, categoryJson, queryVariationsJson, title, category, primaryQuery, isDeleted, timestamp, panvivaDocumentId, panvivaDocumentVersion, id)

Channel
channel string

Retornar resposta para um canal específico, em vez do padrão

Deslocamento de página
pageOffset integer

O deslocamento de paginação para indicar o número de resultados iniciais da pesquisa a serem ignorados. Por exemplo, pageOffset de 100 e pageLimit de 10 retornariam registros 101-110.

Limite de páginas
pageLimit integer

O número de registos a devolver. Deve ser um número inteiro entre 0 e 1000.

Faceta
facet string

Aceita uma cadeia de caracteres de faceta formatada em Lucene. Exemplos: 'facet=Category,count:10&facet=Rating'. (Os campos da tabela facial incluem metadados/valores)

Devoluções

Raiz da pasta

Obtém a pasta raiz/home em todo o Panviva, que pode ser detalhada usando o ponto de extremidade Get Folder Children. Observe que esse ponto de extremidade era anteriormente conhecido como o ponto de extremidade 'Pesquisa de pasta'

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Devoluções

Relações de contêiner de documentos

Retornar uma lista da relação pai-filho entre cada contêiner para a ID do documento fornecida

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de um documento Panviva

Devoluções

Traduções de Documentos

Retornar uma lista de todas as traduções (por idioma e localidade) de um documento Panviva

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de um documento Panviva.

Devoluções

Traduções de Pastas

Obtém todas as traduções de uma pasta Panviva, juntamente com cada pasta traduzida respetivos filhos

Parâmetros

Name Chave Necessário Tipo Description
Instância
instance True string

O nome da instância conforme mostrado no Panviva Developer Portal.

Id
id True integer

O id interno (IID) de uma pasta Panviva

Devoluções

Definições

Name Caminho Tipo Description
HREF
href string
rel
rel string
tipo
type string

ResourceSearchResult

Name Caminho Tipo Description
tipo
type string
id
id string
nome
name string
descrição
description string
matchedFields
matchedFields array of string
fragmento
snippet string
linguagem
language string
links
links array of Link

GetSearchResponse

Name Caminho Tipo Description
results
results array of ResourceSearchResult
total
total integer
links
links array of Link

StringInt64NullableKeyValuePair

Name Caminho Tipo Description
chave
key string
valor
value integer

Faceta

Name Caminho Tipo Description
campo
field string
groups
groups array of StringInt64NullableKeyValuePair

RespostaSecção

Name Caminho Tipo Description
mediaType
mediaType string
enviar SMS
text string
HREF
href string
resourceLocation
resourceLocation string

Categoria

Name Caminho Tipo Description
nome
name string
id
id integer
dateCriado
dateCreated date-time
dateModificado
dateModified date-time

QueryVariation

Name Caminho Tipo Description
id
id integer
consulta
query string

Resultado da pesquisa

Name Caminho Tipo Description
id
id uuid
conteúdo
content array of ResponseSection
categoria
category Category
metadados
metaData object
pesquisaPontuação
searchScore number
links
links array of Link
queryVariações
queryVariations array of QueryVariation
primaryQuery
primaryQuery string
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
title
title string

GetSearchArtefactResponse

Name Caminho Tipo Description
Facetas
facets array of Facet
results
results array of SearchResult
total
total integer

GetContainerResponse

Name Caminho Tipo Description
id
id string
nome
name string
body
body string

Tag

Name Caminho Tipo Description
nome
name string
valor
value string

Formação

Name Caminho Tipo Description
failureFeedback
failureFeedback string
forcePageSequence
forcePageSequence boolean
forceQuestionSequence
forceQuestionSequence boolean
passingScore
passingScore integer
sucessoFeedback
successFeedback string

GetDocumentResponse

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
disponibilizar
release integer
Lançamento
released boolean
Copyright
copyright string
classificação
classification string
estado
status string
percentagem
percentage integer
Data de lançamento
releaseDate date-time
esquema
layout string
preparação
training Training
Palavras Chave
keywords array of string
cshPalavras-chave
cshKeywords array of string
atualizadoData de atualização
updatedDate date-time
createdDate (Data de criação)
createdDate date-time
Conteúdo reutilizável
reusableContent boolean
alterarNota:
changeNote string
links
links array of Link

Channel

Name Caminho Tipo Description
nome
name string

ResponseVariation

Name Caminho Tipo Description
conteúdo
content array of ResponseSection
channels
channels array of Channel
id
id integer
dateCriado
dateCreated date-time
dateModificado
dateModified date-time

GetResponseResponse

Name Caminho Tipo Description
links
links array of Link
title
title string
conteúdo
content array of ResponseSection
Variações
variations array of ResponseVariation
categoria
category Category
primaryQuery
primaryQuery string
queryVariações
queryVariations array of QueryVariation
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
metadados
metaData object
id
id uuid
dateCriado
dateCreated date-time
dateModificado
dateModified date-time

Container

Name Caminho Tipo Description
id
id string
nome
name string
body
body string

GetDocumentContainersResponse

Name Caminho Tipo Description
containers
containers array of Container

ContainerRelationship

Name Caminho Tipo Description
id
id string
elemento principal
parent string
Crianças
children array of string
fluxo de tarefas
taskFlow string

GetDocumentContainerRelationshipsResponse

Name Caminho Tipo Description
Relacionamentos
relationships array of ContainerRelationship

Documento

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
disponibilizar
release integer
Lançamento
released boolean
Copyright
copyright string
classificação
classification string
estado
status string
percentagem
percentage integer
Data de lançamento
releaseDate date-time
esquema
layout string
preparação
training Training
Palavras Chave
keywords array of string
cshPalavras-chave
cshKeywords array of string
atualizadoData de atualização
updatedDate date-time
createdDate (Data de criação)
createdDate date-time
Conteúdo reutilizável
reusableContent boolean
alterarNota:
changeNote string
links
links array of Link

GetDocumentTranslationsResponse

Name Caminho Tipo Description
traduções
translations array of Document
origin
origin string

GetFileResponse

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
conteúdo
content string
fileName
fileName string
disponibilizar
release integer
Lançamento
released boolean
Copyright
copyright string
classificação
classification string
estado
status string
percentagem
percentage integer
Data de lançamento
releaseDate date-time
Palavras Chave
keywords array of string
cshPalavras-chave
cshKeywords array of string
alterarNota:
changeNote string
atualizadoData de atualização
updatedDate date-time
createdDate (Data de criação)
createdDate date-time

GetFolderResponse

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
links
links array of Link

Resource

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string

GetFolderChildrenResponse

Name Caminho Tipo Description
Crianças
children array of Resource

Folder

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
links
links array of Link

GetFolderTranslationsResponse

Name Caminho Tipo Description
traduções
translations array of Folder

GetFolderRootResponse

Name Caminho Tipo Description
id
id string
nome
name string
descrição
description string
versão
version integer
linguagem
language string
tags
tags array of Tag
oculto
hidden boolean
origem
source string
tipo
type string
links
links array of Link

GetImageResponse

Name Caminho Tipo Description
id
id string
nome
name string
Largura
width integer
altura
height integer
size
size integer
TipoDeConteúdo
contentType string
conteúdo
content string

ArtefatoCategoria

Name Caminho Tipo Description
id
id integer
categoryName
categoryName string

GetArtefactCategoriesResponse

Name Caminho Tipo Description
categories
categories array of ArtefactCategory

PostArtefactCategoryResponse

Name Caminho Tipo Description
categoryId
categoryId integer
categoryName
categoryName string

objecto

Este é o tipo 'objeto'.