Compartir a través de

Objective Connect (versión preliminar)

Objective Connect es la plataforma de uso compartido de archivos de confianza que permite a la organización compartir documentos confidenciales con terceros externos. Los usuarios pueden crear áreas de trabajo privadas e invitar a participantes en la nube en cuestión de segundos. Las características de colaboración, informes, seguridad y cumplimiento permiten a los gobiernos y a los sectores regulados trabajar externamente mientras tienen tranquilidad.

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)
Metadatos del conector
Publicador Objective Corporation

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
Contraseña securestring La contraseña de esta API Cierto
Región del servidor. (Reino Unido - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com) cuerda / cadena Especifique objective Connect server (Servidor de Objective Connect). Cierto
Nombre de usuario securestring El nombre de usuario de esta API Cierto

Limitaciones

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

Acciones

Agregar o actualizar participante

Invitar a un nuevo participante o editar roles asignados
Carga del contenido del documento

Cargar contenido para un documento
Creación de un área de trabajo

Creación de un área de trabajo
Crear documento

Si Request es application:hal+json, solo crea metadatos. Si Request es multipart:form-data, crea el documento con contenido en una sola llamada.
Eliminar participante

Quita el participante del área de trabajo.
Enumerar documentos compartidos

Obtener una lista de activos por UUID del área de trabajo
Enumerar versiones de documentos

Obtener una lista de versiones de recursos
Enumerar áreas de trabajo

Obtener una lista de recursos compartidos que el usuario solicitante tiene privilegios para ver
Obtención de la versión del documento

Obtención de una versión de recurso
Obtener contenido de la versión del documento

Devuelve el contenido de una versión del documento.
Obtener contenido del documento

Devuelve el contenido de un documento.
Obtener participantes

Obtener participantes del área de trabajo
Obtener usuario

Obtener usuarios
Obtener área de trabajo

Obtención del área de trabajo por identificador

Agregar o actualizar participante

Id. de la operación:
AddParticipant

Invitar a un nuevo participante o editar roles asignados

Parámetros

Nombre Clave Requerido Tipo Description
correos electrónicos
 emails True array of string

correos electrónicos
Message
 message string

Mensaje de invitación
roles
 roles array of string

roles
UUID del área de trabajo
 shareUuid True string

Identificador Único Universal (UUID)
Visibilidad de los participantes
 type string

ESTÁNDAR: visible para otros participantes. CCO: el participante estará oculto de otros usuarios.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
aceptado
 accepted boolean

aceptado
Correo electrónico
 email string

Correo electrónico
isOwner
 isOwner boolean

isOwner
model
 model string

model
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
Identificador Único Universal (UUID)
 uuid string

Identificador Único Universal (UUID)

Carga del contenido del documento

Id. de la operación:
UploadDocumentContent

Cargar contenido para un documento

Parámetros

Nombre Clave Requerido Tipo Description
Documento
 assetUuid True string

UUID del documento
Workspace
 shareUuid True string

UUID del área de trabajo
Contenido del archivo
 file True file

El contenido del archivo que se va a cargar

Creación de un área de trabajo

Id. de la operación:
CreateWorkspace

Creación de un área de trabajo

Parámetros

Nombre Clave Requerido Tipo Description
UUID de usuario
 userUuid True string

UUID de usuario
Acceso
 access string
Agente
 agentShareToken string

Token del agente
Nombre
 name True string

Nombre
Organización
 organisationUuid string

UUID de organización
Propietario
 ownerUuid string

UUID del propietario
Resumen
 summary string

Resumen
Identificador Único Universal (UUID)
 uuid string

Identificador Único Universal (UUID)

Devoluciones

Body
ShareResponse

Crear documento

Id. de la operación:
CreateDocument

Si Request es application:hal+json, solo crea metadatos. Si Request es multipart:form-data, crea el documento con contenido en una sola llamada.

Parámetros

Nombre Clave Requerido Tipo Description
UUID del área de trabajo
 shareUuid True string

El uuid de recurso compartido de la ruta de acceso
Contenido del archivo
 file True file

El contenido del archivo que se va a cargar
Nombre del archivo
 name True string

Nombre de archivo
UUID primario
 parentUuid string

(Opcional)
Resumen
 summary string

(Opcional)

Devoluciones

Body
AssetReturnDocumentResponse

Eliminar participante

Id. de la operación:
DeleteParticipant

Quita el participante del área de trabajo.

Parámetros

Nombre Clave Requerido Tipo Description
Usuario
 uuid True string

UUID de usuario

Enumerar documentos compartidos

Id. de la operación:
ListDocuments

Obtener una lista de activos por UUID del área de trabajo

Parámetros

Nombre Clave Requerido Tipo Description
Workspace
 shareUuid True string

UUID del área de trabajo
Length
 length integer

Número máximo de resultados que se van a recuperar
Desplazar
 offset integer

Resultado en el que se inician los valores devueltos (el valor predeterminado es 0)
UUID primario
 parentUuid string

UUID del recurso compartido o primario. Si se proporcionan los resultados se restringirán a los elementos secundarios inmediatos del recurso o el recurso compartido. Si no es válido, la respuesta será 200 con una lista vacía.
Query
 query string

Cadena de consulta de búsqueda. Si se proporcionan los resultados se restringirán a los recursos con el nombre a partir del valor de consulta especificado.
Ordenar
 sort string

Cadena de criterios de criterio de ordenación. Los valores aceptables son

  • nombre
  • fecha de creación
  • modifiedDate
  • size Los criterios de ordenación pueden ir seguidos opcionalmente por ":d esc" para indicar que la ordenación debe estar en orden descendente. Si no se proporciona sortInfo o contiene valores no válidos, la lista se ordenará por nombre de recurso ascendente.

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
annotationsCount
 annotationsCount integer

annotationsCount
commentCount
 commentCount integer

commentCount
versión de contenido
 contentVersion integer

versión de contenido
fecha de creación
 createdDate string

fecha de creación
extensión
 extension string

extensión
tamaño de archivo
 fileSize integer

tamaño de archivo
locked
 locked boolean

locked
model
 model string

model
modifiedByUuid
 modifiedByUuid string

modifiedByUuid
modifiedDate
 modifiedDate string

modifiedDate
nombre
 name string

nombre
pdfPreviewstatus
 pdfPreviewstatus string

pdfPreviewstatus
previewPageCount
 previewPageCount integer

previewPageCount
previewstatus
 previewstatus string

previewstatus
estado
 status string

estado
type
 type string

type
Identificador Único Universal (UUID)
 uuid string

Identificador Único Universal (UUID)
wopiRestricted
 wopiRestricted boolean

wopiRestricted

Enumerar versiones de documentos

Id. de la operación:
ListDocumentVersions

Obtener una lista de versiones de recursos

Parámetros

Nombre Clave Requerido Tipo Description
Documento
 assetUuid True string

UUID del documento
Workspace
 shareUuid True string

UUID del área de trabajo
Length
 length integer

Número máximo de resultados que se van a recuperar
Desplazar
 offset integer

Resultado en el que se inicia (el valor predeterminado es 0).

Devoluciones

response
array of DocumentVersion

Enumerar áreas de trabajo

Id. de la operación:
ListWorkspaces

Obtener una lista de recursos compartidos que el usuario solicitante tiene privilegios para ver

Parámetros

Nombre Clave Requerido Tipo Description
Length
 length integer

Número máximo de resultados que se van a recuperar
Desplazar
 offset integer

Resultado en el que se inician los valores devueltos (el valor predeterminado es 0)
Propietario
 ownerUuid string

UUID de usuario del propietario. Si se proporcionan los resultados se restringirán a los recursos compartidos que pertenecen a este usuario.
Participante
 participantUuid string

UUID de usuario del participante. Si se proporcionan los resultados se restringirán a los recursos compartidos en los que este usuario sea participante.
Query
 query string

Cadena de consulta de búsqueda. Si se proporcionan los resultados se restringirán a los recursos compartidos con el nombre que contiene el valor de consulta especificado.
Ordenar
 sort string

Cadena de criterios de criterio de ordenación. Los valores aceptables son

  • nombre
  • fecha de creación
  • modifiedDate
  • unido
  • shareOrder
  • organización Los criterios de ordenación pueden ir seguidos opcionalmente por ":d esc" para indicar que la ordenación debe estar en orden descendente. Si no se proporciona sortInfo o contiene valores no válidos, la lista se ordenará por nombre de recurso compartido ascendente.
Grupo de trabajo
 workgroupUuid string

UUID del grupo de trabajo. Si se proporcionan los resultados se restringirán a los recursos compartidos que pertenecen al grupo de trabajo.

Devoluciones

response
array of ShareResponse

Obtención de la versión del documento

Id. de la operación:
GetDocumentVersion

Obtención de una versión de recurso

Parámetros

Nombre Clave Requerido Tipo Description
Documento
 assetUuid True string

Identificador Único Universal (UUID)
Workspace
 shareUuid True string

Identificador Único Universal (UUID)
Versión
 version True integer

Número de versión del documento

Devoluciones

Body
DocumentVersion

Obtener contenido de la versión del documento

Id. de la operación:
GetDocumentVersionContent

Devuelve el contenido de una versión del documento.

Parámetros

Nombre Clave Requerido Tipo Description
Documento
 assetUuid True string

Identificador Único Universal (UUID)
Versión de contenido
 contentVersion True integer

Número de versión del documento
Workspace
 shareUuid True string

Identificador Único Universal (UUID)

Obtener contenido del documento

Id. de la operación:
GetDocumentContent

Devuelve el contenido de un documento.

Parámetros

Nombre Clave Requerido Tipo Description
Documento
 assetUuid True string

Identificador Único Universal (UUID)
Workspace
 shareUuid True string

Identificador Único Universal (UUID)

Obtener participantes

Id. de la operación:
GetParticipants

Obtener participantes del área de trabajo

Parámetros

Nombre Clave Requerido Tipo Description
Usuario
 userUuid string

UUID de usuario

Devoluciones

Nombre Ruta de acceso Tipo Description
array of object
aceptado
 accepted boolean

aceptado
Correo electrónico
 email string

Correo electrónico
isOwner
 isOwner boolean

isOwner
joinedDate
 joinedDate string

joinedDate
model
 model string

model
nombre
 name string

nombre
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
Identificador Único Universal (UUID)
 uuid string

Identificador Único Universal (UUID)

Obtener usuario

Id. de la operación:
GetUser

Obtener usuarios

Parámetros

Nombre Clave Requerido Tipo Description
Correo Electrónico
 emailAddress string

Dirección de correo electrónico que se va a buscar
Length
 length integer

Número de resultados que se van a devolver. Solo se usa si se usa offset.
Desplazar
 offset integer

Devolver los resultados después de esta posición
Organización
 orgUuid string

UUID de la organización que se va a buscar
Ordenar
 sort string

El parámetro - sort debe ser del formato de una palabra que indica el campo de ordenación una etiqueta opcional ":d esc", si no está presente ascendente. Las solicitudes incorrectas o vacías se asignan de forma predeterminada al nombre ascendente. Las ordenación disponibles son: firstName, lastName, email
UUID de usuario
 uuids array

Lista de uuids de usuario

Devoluciones

response
array of UserResponse

Obtener área de trabajo

Id. de la operación:
GetWorkspace

Obtención del área de trabajo por identificador

Parámetros

Nombre Clave Requerido Tipo Description
Workspace
 shareUuid True string

Uuid del área de trabajo que se va a recuperar

Devoluciones

Body
ShareResponse

Definiciones

Acceso

Acceso
string

AssetReturnDocumentResponse

Nombre Ruta de acceso Tipo Description
commentCount
 commentCount integer
versión de contenido
 contentVersion integer
fecha de creación
 createdDate string
extensión
 extension string
tamaño de archivo
 fileSize integer
locked
 locked boolean
model
 model string
modifiedByUuid
 modifiedByUuid string
modifiedDate
 modifiedDate string
nombre
 name string
parentUuid
 parentUuid string
previewPageCount
 previewPageCount integer
previewstatus
 previewstatus PreviewStatus
estado
 status AssetStatus
summary
 summary string
type
 type AssetType
Identificador Único Universal (UUID)
 uuid string
wopiRestricted
 wopiRestricted boolean

AssetStatus

string

AssetType

string

DocumentVersion

Nombre Ruta de acceso Tipo Description
fecha de creación
 createdDate string
extensión
 extension string
tamaño de archivo
 fileSize integer
model
 model string
estado
 status AssetStatus
Identificador Único Universal (UUID)
 uuid string
version
 version integer

EndOnDateOptionalValue

Nombre Ruta de acceso Tipo Description
presente
 present boolean
value
 value string

NotificationPreference

NotificationPreference
string

PreviewStatus

string

ShareResponse

Nombre Ruta de acceso Tipo Description
Acceso
 access Access
connections
 connections integer
fecha de creación
 createdDate string
EndOnDateOptionalValue
 endOnDateOptionalValue EndOnDateOptionalValue
model
 model string
modifiedDate
 modifiedDate string
nombre
 name string
organisationUuid
 organisationUuid string
ownerUuid
 ownerUuid string
seguro
 secure boolean
ShareStatus
 shareStatus ShareStatus
estado
 status AssetStatus
SynchStatus
 synchStatus SynchStatus
Identificador Único Universal (UUID)
 uuid string

ShareStatus

ShareStatus
string

SynchStatus

SynchStatus
string

UserResponse

Nombre Ruta de acceso Tipo Description
disabled
 disabled boolean
Correo electrónico
 email string
firstName
 firstName string
hideEmailAddress
 hideEmailAddress boolean
lastName
 lastName string
model
 model string
notificationPreferences
 notificationPreferences array of NotificationPreference
organisationUuid
 organisationUuid string
roles
 roles array of string
UserStatus
 status UserStatus
timezone
 timezone string
Identificador Único Universal (UUID)
 uuid string

UserStatus

UserStatus
string