Compartir a través de


Panviva

Panviva es una solución de administración de conocimientos omnicanal. Nuestra prioridad es ayudar a nuestros clientes a mantener satisfechos a sus empleados, para que puedan centrarse en asegurarse de que sus clientes estén satisfechos. Transformar digitalmente las organizaciones durante los últimos 20 años, ahora estamos ayudando a nuestros clientes a ofrecer nuggets de conocimiento a sus empleados y clientes, ya sea en el hogar o en la oficina, en cualquier momento y en cualquier lugar.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Equipo de defensa de clientes de Panviva
URL https://www.panviva.com/support
Correo Electrónico support@panviva.com
Metadatos del conector
Publicador Panviva
Sitio web https://www.panviva.com
Directiva de privacidad https://www.panviva.com/privacy-policy
Categorías Gestión empresarial; Productividad

Prerrequisitos

Para usar el conector Panviva, debe tener:

  1. Acceso a una instancia de Panviva (también conocida como inquilino)
  2. Una cuenta de desarrollador en el portal para desarrolladores de Panviva (dev.panviva.com)
  3. Una suscripción activa a panviva API (también conocida como plan de API) y credenciales válidas de la API de Panviva

Si no es cliente o necesita ayuda para visitar www.panviva.com/support.

Obtención de credenciales

Siga los pasos que se indican a continuación para obtener la instancia de API y la clave de API.

Si ve un error al usar el conector, puede buscar el código de error para obtener más información. Nota: el código de estado HTTP de la documentación puede ser ligeramente diferente al que ve en Power Automate o Power Apps, use el campo Código de error con fines de búsqueda.

Para obtener la clave de API, debe:

  1. Inicie sesión en el portal para desarrolladores de Panviva en dev.panviva.com
  2. Vaya al perfil (haga clic en el nombre y, a continuación, haga clic en "Perfil" en la barra de navegación superior).
  3. Ahora debería ver la clave de API en la sección "Sus suscripciones" del perfil.

Para obtener la instancia de API, debe:

  1. Inicie sesión en el portal para desarrolladores de Panviva en dev.panviva.com
  2. Vaya a la API (haga clic en "API" en la barra de navegación superior).
  3. Ahora debería ver la instancia de API en el conjunto de API (busque "El nombre de instancia de API Suite es")

Limitaciones

Tenga en cuenta que los límites de limitación se basarán en el tipo de suscripción de API (o plan de API) al que se ha suscrito.

Para encontrar el límite de cuota o tasa, puede:

  1. Inicie sesión en el portal para desarrolladores de Panviva en dev.panviva.com
  2. Vaya al perfil (haga clic en el nombre y, a continuación, haga clic en "Perfil" en la barra de navegación superior).
  3. Vaya al plan de API en la sección "Suscripciones" del perfil.
  4. Ahora debería ver los detalles del plan (busque "... podrá ejecutar ** llamadas/minutos hasta un máximo de _** llamadas/mes...")

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de suscripción de panviva API securestring La clave de suscripción de Panviva API para la instancia. Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Archivo

Devuelve un archivo (documento externo) de Panviva

Artefacto

Devolver un artefacto mediante el identificador proporcionado

Carpeta

Devolver información sobre una carpeta Panviva y referencias a cada uno de sus elementos secundarios directos

Contenedor

Devolver un contenedor mediante el identificador de contenedor proporcionado

Contenedores de documentos

Devolver una lista de contenedores mediante el identificador de documento proporcionado

Crear categoría de artefactos

Crea una categoría para clasificar artefactos

CSH activo

Presentar una página de resultados de búsqueda de CSH de la consulta de paso en el cliente panviva al usuario especificado en el cliente de Panviva

Documento

Devolver un documento mediante el identificador de documento proporcionado

Documento activo

Presentar una página de documento al usuario especificado en el cliente panviva

Elementos secundarios de carpeta

Obtiene todos los elementos secundarios inmediatos de una carpeta Panviva, no incluidos los nietos. Los elementos secundarios pueden ser carpetas, documentos o archivos (documentos externos)

Imagen

Devuelve una imagen de Panviva. Los datos de imagen se representan como una cadena base64

Live Search

Presentar una página de resultados de búsqueda de la consulta de paso en el cliente panviva al usuario especificado en el cliente de Panviva

Objetos de búsqueda

Devolver resultados de búsqueda para una consulta determinada

Obtener categorías de artefactos

Obtiene una lista de todas las categorías de artefactos disponibles.

Raíz de carpeta

Obtiene la carpeta raíz o principal de todo Panviva, que se puede explorar en profundidad mediante el punto de conexión Obtener elementos secundarios de la carpeta. Tenga en cuenta que este punto de conexión se conocía anteriormente como punto de conexión "Búsqueda de carpetas".

Relaciones de contenedor de documentos

Devuelve una lista de la relación de elementos primarios y secundarios entre cada contenedor para el identificador de documento proporcionado.

Search

Busca documentos, carpetas y archivos (documentos externos) para un término y devuelve resultados paginados.

Traducciones de carpetas

Obtiene todas las traducciones de una carpeta Panviva, junto con cada carpeta traducida correspondiente a los elementos secundarios correspondientes.

Traducciones de documentos

Devolver una lista de todas las traducciones (por idioma y configuración regional) de un documento panviva

Archivo

Devuelve un archivo (documento externo) de Panviva

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de un archivo Panviva (documento externo)

Devoluciones

Artefacto

Devolver un artefacto mediante el identificador proporcionado

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True string

Formato: uuid. Identificador (ID) de un artefacto

Devoluciones

Carpeta

Devolver información sobre una carpeta Panviva y referencias a cada uno de sus elementos secundarios directos

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de una carpeta Panviva

Devoluciones

Contenedor

Devolver un contenedor mediante el identificador de contenedor proporcionado

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True string

Identificador de un contenedor de documentos

Devoluciones

Contenedores de documentos

Devolver una lista de contenedores mediante el identificador de documento proporcionado

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de un documento de Panviva

Devoluciones

Crear categoría de artefactos

Crea una categoría para clasificar artefactos

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

nombre
name string

Devoluciones

CSH activo

Presentar una página de resultados de búsqueda de CSH de la consulta de paso en el cliente panviva al usuario especificado en el cliente de Panviva

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

nombre de usuario
username string

Usuario de Panviva al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

userId
userId string

Identificador numérico del usuario al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

query
query string

Término de CSH que se va a buscar.

showFirstResult
showFirstResult boolean

True para abrir inmediatamente el primer documento encontrado o false para mostrar la lista de resultados.

maximizeClient
maximizeClient boolean

True/False en función de si desea que el cliente de Panviva maximice en el escritorio del usuario, cuando se entregue el documento.

Devoluciones

response
object

Documento

Devolver un documento mediante el identificador de documento proporcionado

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True string

Identificador único de documento, Id. de documento. Si un documento es un documento traducido, este valor representa id. interno o IID en Panviva API v1.

Versión
version integer

Solicite a la API que devuelva una versión determinada del documento especificado.

Devoluciones

Documento activo

Presentar una página de documento al usuario especificado en el cliente panviva

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

nombre de usuario
username string

Usuario de Panviva al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

userId
userId string

Identificador numérico del usuario al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

id
id string

El id. de documento del documento panviva que desea enviar.

location
location string

El identificador de sección que desea que vea el usuario cuando se abra el documento especificado.

maximizeClient
maximizeClient boolean

True/False en función de si desea que el cliente de Panviva maximice en el escritorio del usuario, cuando se entregue el documento.

Devoluciones

response
object

Elementos secundarios de carpeta

Obtiene todos los elementos secundarios inmediatos de una carpeta Panviva, no incluidos los nietos. Los elementos secundarios pueden ser carpetas, documentos o archivos (documentos externos)

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de una carpeta Panviva

Devoluciones

Imagen

Devuelve una imagen de Panviva. Los datos de imagen se representan como una cadena base64

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

El identificador de una imagen de Panviva

Devoluciones

Presentar una página de resultados de búsqueda de la consulta de paso en el cliente panviva al usuario especificado en el cliente de Panviva

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

nombre de usuario
username string

Usuario de Panviva al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

userId
userId string

Identificador numérico del usuario al que desea enviar el resultado. (Nota: Use username OR userId, no ambos).

query
query string

Término que se va a buscar.

maximizeClient
maximizeClient boolean

True/False en función de si desea que el cliente de Panviva maximice en el escritorio del usuario, cuando se entregue el documento.

showFirstResult
showFirstResult boolean

True para abrir inmediatamente el primer documento encontrado o false para mostrar la lista de resultados.

Devoluciones

response
object

Objetos de búsqueda

Devolver resultados de búsqueda para una consulta determinada

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Consulta simple
simplequery string

Cadena de consulta de lenguaje natural. Por ejemplo: "Películas de acción". (Nota: Use simplequery OR advancedquery, no ambos).

Consulta avanzada
advancedquery string

Cadena de consulta escrita en la sintaxis de consulta de Lucene. Por ejemplo: "películas Y "una historia". (Nota: Use simplequery OR advancedquery, no ambos).

Filter
filter string

Acepta una cadena de filtro con formato Lucene. Ejemplos: 'category eq "Mortgages"", 'panvivaDocumentVersion gt "8"'. (Los campos filtrables incluyen dateCreated, dateModified, dateDeleted, categoryJson, queryVariationsJson, title, category, primaryQuery, isDeleted, timestamp, panvivaDocumentId, panvivaDocumentVersion, id)

Channel
channel string

Devolver respuesta para un canal específico, en lugar del valor predeterminado

Desplazamiento de página
pageOffset integer

Desplazamiento de paginación para indicar el número de resultados de búsqueda iniciales que se van a omitir. Por ejemplo, pageOffset de 100 y pageLimit de 10 devolverían los registros 101-110.

Límite de página
pageLimit integer

Número de registros que se van a devolver. Debe ser un entero comprendido entre 0 y 1000.

Faceta
facet string

Acepta una cadena de faceta con formato Lucene. Ejemplos: 'facet=Category,count:10&facet=Rating'. (Los campos facetables incluyen metaData/values)

Devoluciones

Obtener categorías de artefactos

Obtiene una lista de todas las categorías de artefactos disponibles.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Devoluciones

Raíz de carpeta

Obtiene la carpeta raíz o principal de todo Panviva, que se puede explorar en profundidad mediante el punto de conexión Obtener elementos secundarios de la carpeta. Tenga en cuenta que este punto de conexión se conocía anteriormente como punto de conexión "Búsqueda de carpetas".

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Devoluciones

Relaciones de contenedor de documentos

Devuelve una lista de la relación de elementos primarios y secundarios entre cada contenedor para el identificador de documento proporcionado.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de un documento de Panviva

Devoluciones

Busca documentos, carpetas y archivos (documentos externos) para un término y devuelve resultados paginados.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Término
term True string

Palabra o frase que se va a buscar

Desplazamiento de página
pageOffset integer

Desplazamiento de paginación para indicar el número de resultados de búsqueda iniciales que se van a omitir. Por ejemplo, pageOffset de 100 y pageLimit de 10 devolverían los registros 101-110.

Límite de página
pageLimit integer

Número de registros que se van a devolver. Debe ser un entero comprendido entre 0 y 1000.

Devoluciones

Traducciones de carpetas

Obtiene todas las traducciones de una carpeta Panviva, junto con cada carpeta traducida correspondiente a los elementos secundarios correspondientes.

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de una carpeta Panviva

Devoluciones

Traducciones de documentos

Devolver una lista de todas las traducciones (por idioma y configuración regional) de un documento panviva

Parámetros

Nombre Clave Requerido Tipo Description
Instancia
instance True string

Nombre de instancia tal como se muestra en el Portal para desarrolladores de Panviva.

Id
id True integer

Identificador interno (IID) de un documento panviva.

Devoluciones

Definiciones

Nombre Ruta de acceso Tipo Description
href
href string
rel
rel string
type
type string

ResourceSearchResult

Nombre Ruta de acceso Tipo Description
type
type string
id
id string
nombre
name string
descripción
description string
matchedFields
matchedFields array of string
fragmento
snippet string
lenguaje
language string
Enlaces
links array of Link

GetSearchResponse

Nombre Ruta de acceso Tipo Description
results
results array of ResourceSearchResult
total
total integer
Enlaces
links array of Link

StringInt64NullableKeyValuePair

Nombre Ruta de acceso Tipo Description
key
key string
value
value integer

Faceta

Nombre Ruta de acceso Tipo Description
campo
field string
groups
groups array of StringInt64NullableKeyValuePair

ResponseSection

Nombre Ruta de acceso Tipo Description
mediaType
mediaType string
texto
text string
href
href string
resourceLocation
resourceLocation string

Categoría

Nombre Ruta de acceso Tipo Description
nombre
name string
id
id integer
dateCreated
dateCreated date-time
dateModified
dateModified date-time

QueryVariation

Nombre Ruta de acceso Tipo Description
id
id integer
query
query string

SearchResult

Nombre Ruta de acceso Tipo Description
id
id uuid
contenido
content array of ResponseSection
categoría
category Category
metadatos
metaData object
searchScore
searchScore number
Enlaces
links array of Link
queryVariations
queryVariations array of QueryVariation
primaryQuery
primaryQuery string
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
title
title string

GetSearchArtefactResponse

Nombre Ruta de acceso Tipo Description
Facetas
facets array of Facet
results
results array of SearchResult
total
total integer

GetContainerResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
body
body string

Etiqueta

Nombre Ruta de acceso Tipo Description
nombre
name string
value
value string

Training

Nombre Ruta de acceso Tipo Description
failureFeedback
failureFeedback string
forcePageSequence
forcePageSequence boolean
forceQuestionSequence
forceQuestionSequence boolean
passingScore
passingScore integer
successFeedback
successFeedback string

GetDocumentResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
lanzamiento
release integer
liberado
released boolean
derechos de autor
copyright string
clasificación
classification string
estado
status string
porcentaje
percentage integer
releaseDate
releaseDate date-time
diseño
layout string
adiestramiento
training Training
palabras clave
keywords array of string
cshKeywords
cshKeywords array of string
updatedDate
updatedDate date-time
fecha de creación
createdDate date-time
reutilizableContent
reusableContent boolean
changeNote
changeNote string
Enlaces
links array of Link

Channel

Nombre Ruta de acceso Tipo Description
nombre
name string

ResponseVariation

Nombre Ruta de acceso Tipo Description
contenido
content array of ResponseSection
canales nueva
channels array of Channel
id
id integer
dateCreated
dateCreated date-time
dateModified
dateModified date-time

GetResponseResponse

Nombre Ruta de acceso Tipo Description
Enlaces
links array of Link
title
title string
contenido
content array of ResponseSection
Variaciones
variations array of ResponseVariation
categoría
category Category
primaryQuery
primaryQuery string
queryVariations
queryVariations array of QueryVariation
panvivaDocumentId
panvivaDocumentId integer
panvivaDocumentVersion
panvivaDocumentVersion integer
metadatos
metaData object
id
id uuid
dateCreated
dateCreated date-time
dateModified
dateModified date-time

Contenedor

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
body
body string

GetDocumentContainersResponse

Nombre Ruta de acceso Tipo Description
containers
containers array of Container

ContainerRelationship

Nombre Ruta de acceso Tipo Description
id
id string
parent
parent string
secundario
children array of string
taskFlow
taskFlow string

GetDocumentContainerRelationshipsResponse

Nombre Ruta de acceso Tipo Description
Relaciones
relationships array of ContainerRelationship

Documento

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
lanzamiento
release integer
liberado
released boolean
derechos de autor
copyright string
clasificación
classification string
estado
status string
porcentaje
percentage integer
releaseDate
releaseDate date-time
diseño
layout string
adiestramiento
training Training
palabras clave
keywords array of string
cshKeywords
cshKeywords array of string
updatedDate
updatedDate date-time
fecha de creación
createdDate date-time
reutilizableContent
reusableContent boolean
changeNote
changeNote string
Enlaces
links array of Link

GetDocumentTranslationsResponse

Nombre Ruta de acceso Tipo Description
traducciones
translations array of Document
origin
origin string

GetFileResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
contenido
content string
fileName
fileName string
lanzamiento
release integer
liberado
released boolean
derechos de autor
copyright string
clasificación
classification string
estado
status string
porcentaje
percentage integer
releaseDate
releaseDate date-time
palabras clave
keywords array of string
cshKeywords
cshKeywords array of string
changeNote
changeNote string
updatedDate
updatedDate date-time
fecha de creación
createdDate date-time

GetFolderResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
Enlaces
links array of Link

Resource

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string

GetFolderChildrenResponse

Nombre Ruta de acceso Tipo Description
secundario
children array of Resource

Carpeta

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
Enlaces
links array of Link

GetFolderTranslationsResponse

Nombre Ruta de acceso Tipo Description
traducciones
translations array of Folder

GetFolderRootResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
descripción
description string
version
version integer
lenguaje
language string
tags
tags array of Tag
hidden
hidden boolean
source
source string
type
type string
Enlaces
links array of Link

GetImageResponse

Nombre Ruta de acceso Tipo Description
id
id string
nombre
name string
Ancho
width integer
altura
height integer
size
size integer
tipo de contenido
contentType string
contenido
content string

ArtefactCategory

Nombre Ruta de acceso Tipo Description
id
id integer
categoryName
categoryName string

GetArtefactCategoriesResponse

Nombre Ruta de acceso Tipo Description
categories
categories array of ArtefactCategory

PostArtefactCategoryResponse

Nombre Ruta de acceso Tipo Description
categoryId
categoryId integer
categoryName
categoryName string

objeto

Este es el tipo 'objeto'.