Objective Connect (préversion)

Objective Connect est la plateforme de partage de fichiers approuvée qui permet à l’organisation de partager des documents sensibles avec des parties externes. Les utilisateurs peuvent créer des espaces de travail privés et inviter des participants dans le cloud en quelques secondes. Les fonctionnalités de collaboration, de création de rapports, de sécurité et de conformité permettent aux gouvernements et aux industries réglementées de travailler en externe tout en ayant la tranquillité d’esprit.

Ce connecteur est disponible dans les produits et régions suivants :

Service	classe	Régions
Copilot Studio	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Applications logiques	Norme	Toutes les régions Logic Apps , à l’exception des suivantes :      - Régions Azure Government      - Régions Azure Chine      - Us Department of Defense (DoD)
Power Apps	Premium	Toutes les régions Power Apps , à l’exception des suivantes :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)
Power Automate	Premium	Toutes les régions Power Automate , à l’exception des éléments suivants :      - Us Government (GCC)      - Us Government (GCC High)      - China Cloud géré par 21Vianet      - Us Department of Defense (DoD)

Métadonnées du connecteur
Éditeur	Objective Corporation

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :

Par défaut	Paramètres de création de connexion.	Toutes les régions	Impossible à partager

Faire défaut

Applicable : Toutes les régions

Paramètres de création de connexion.

Ce n’est pas une connexion partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Nom	Type	Descriptif	Obligatoire
Mot de passe	securestring	Mot de passe de cette API	Vrai
Région du serveur. (Royaume-Uni - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com)	ficelle	Spécifiez le serveur Objective Connect.	Vrai
Nom d’utilisateur	securestring	Nom d’utilisateur de cette API	Vrai

Limitations

Nom	Appels	Période de renouvellement
Appels d’API par connexion	100	60 secondes

Actions

Ajouter ou mettre à jour un participant	Inviter un nouveau participant ou modifier des rôles attribués
Charger le contenu du document	Charger du contenu pour un document
Créer un document	Si la requête est application :hal+json, elle crée uniquement des métadonnées. Si la requête est multipart :form-data, elle crée un document avec du contenu dans un seul appel.
Créer un espace de travail	Créer un espace de travail
Obtenir des participants	Obtenir des participants à l’espace de travail
Obtenir la version du document	Obtenir une version de ressource
Obtenir le contenu de la version du document	Retourne le contenu d’une version de document
Obtenir le contenu du document	Retourne le contenu d’un document
Obtenir l’espace de travail	Obtenir l’espace de travail par ID
Obtenir un utilisateur	Obtenir des utilisateurs
Répertorier les documents partagés	Obtenir la liste des ressources par UUID de l’espace de travail
Répertorier les espaces de travail	Obtenir la liste des partages que l’utilisateur demandeur a le privilège de voir
Répertorier les versions de document	Obtenir la liste des versions d’éléments multimédias
Supprimer un participant	Supprime le participant de l’espace de travail

Ajouter ou mettre à jour un participant

ID d’opération :

AddParticipant

Inviter un nouveau participant ou modifier des rôles attribués

Paramètres

Nom	Clé	Obligatoire	Type	Description
e-mails	emails	True	array of string	e-mails
Message	message		string	Message d’invitation
roles	roles		array of string	roles
UUID de l’espace de travail	shareUuid	True	string	UUID (Identifiant Unique Universel)
Visibilité des participants	type		string	STANDARD : visible par d’autres participants. CCI - Le participant sera masqué par d’autres personnes

Retours

Nom	Chemin d’accès	Type	Description
		array of object
a accepté	accepted	boolean	a accepté
Messagerie électronique	email	string	Messagerie électronique
isOwner	isOwner	boolean	isOwner
model	model	string	model
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
type	type	string	type
Identifiant unique universel (UUID)	uuid	string	Identifiant unique universel (UUID)

Charger le contenu du document

ID d’opération :

UploadDocumentContent

Charger du contenu pour un document

Paramètres

Nom	Clé	Obligatoire	Type	Description
Document	assetUuid	True	string	Document UUID
Workspace	shareUuid	True	string	UUID de l’espace de travail
Contenu du fichier	file	True	file	Contenu du fichier à charger

Créer un document

ID d’opération :

CreateDocument

Si la requête est application :hal+json, elle crée uniquement des métadonnées. Si la requête est multipart :form-data, elle crée un document avec du contenu dans un seul appel.

Paramètres

Nom	Clé	Obligatoire	Type	Description
UUID de l’espace de travail	shareUuid	True	string	uuid de partage à partir du chemin d’accès
Contenu du fichier	file	True	file	Contenu du fichier à charger
Nom de fichier	name	True	string	Nom du fichier
Parent UUID	parentUuid		string	(facultatif)
Résumé	summary		string	(facultatif)

Retours

Corps

AssetReturnDocumentResponse

Créer un espace de travail

ID d’opération :

CreateWorkspace

Créer un espace de travail

Paramètres

Nom	Clé	Obligatoire	Type	Description
User UUID	userUuid	True	string	User UUID
Accès	access		string
Agent	agentShareToken		string	Jeton d’agent
Nom	name	True	string	Nom
Organisation	organisationUuid		string	Organisation UUID
Propriétaire	ownerUuid		string	Propriétaire UUID
Résumé	summary		string	Résumé
UUID (Identifiant Unique Universel)	uuid		string	UUID (Identifiant Unique Universel)

Retours

Corps

ShareResponse

Obtenir des participants

ID d’opération :

GetParticipants

Obtenir des participants à l’espace de travail

Paramètres

Nom	Clé	Obligatoire	Type	Description
Utilisateur	userUuid		string	User UUID

Retours

Nom	Chemin d’accès	Type	Description
		array of object
a accepté	accepted	boolean	a accepté
Messagerie électronique	email	string	Messagerie électronique
isOwner	isOwner	boolean	isOwner
JointDate	joinedDate	string	JointDate
model	model	string	model
nom	name	string	nom
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
type	type	string	type
Identifiant unique universel (UUID)	uuid	string	Identifiant unique universel (UUID)

Obtenir la version du document

ID d’opération :

GetDocumentVersion

Obtenir une version de ressource

Paramètres

Nom	Clé	Obligatoire	Type	Description
Document	assetUuid	True	string	UUID (Identifiant Unique Universel)
Workspace	shareUuid	True	string	UUID (Identifiant Unique Universel)
Version	version	True	integer	Numéro de version du document

Retours

Corps

DocumentVersion

Obtenir le contenu de la version du document

ID d’opération :

GetDocumentVersionContent

Retourne le contenu d’une version de document

Paramètres

Nom	Clé	Obligatoire	Type	Description
Document	assetUuid	True	string	UUID (Identifiant Unique Universel)
Version du contenu	contentVersion	True	integer	Numéro de version du document
Workspace	shareUuid	True	string	UUID (Identifiant Unique Universel)

Obtenir le contenu du document

ID d’opération :

GetDocumentContent

Retourne le contenu d’un document

Paramètres

Nom	Clé	Obligatoire	Type	Description
Document	assetUuid	True	string	UUID (Identifiant Unique Universel)
Workspace	shareUuid	True	string	UUID (Identifiant Unique Universel)

Obtenir l’espace de travail

ID d’opération :

GetWorkspace

Obtenir l’espace de travail par ID

Paramètres

Nom	Clé	Obligatoire	Type	Description
Workspace	shareUuid	True	string	uuid de l’espace de travail à récupérer

Retours

Corps

ShareResponse

Obtenir un utilisateur

ID d’opération :

GetUser

Obtenir des utilisateurs

Paramètres

Nom	Clé	Obligatoire	Type	Description
Messagerie électronique	emailAddress		string	Adresse e-mail à rechercher
Length	length		integer	Nombre de résultats à retourner. Utilisé uniquement si le décalage est utilisé.
Décalage	offset		integer	Retourner les résultats après cette position
Organisation	orgUuid		string	L’UUID de l’organisation à rechercher
Trier	sort		string	Le paramètre - tri doit être au format d’un mot indiquant le champ de tri une balise facultative « :d esc », s’il n’est pas présent croissant est supposé. Requêtes incorrectes ou vides par défaut avec le nom croissant. Les tris disponibles sont : firstName, lastName, email
UUID utilisateur	uuids		array	Liste des uuids utilisateur

Retours

response

array of UserResponse

Répertorier les documents partagés

ID d’opération :

ListDocuments

Obtenir la liste des ressources par UUID de l’espace de travail

Paramètres

Nom	Clé	Obligatoire	Type	Description
Workspace	shareUuid	True	string	UUID de l’espace de travail
Length	length		integer	Nombre maximal de résultats à récupérer
Décalage	offset		integer	Résultat au début des valeurs retournées (valeur par défaut : 0)
Parent UUID	parentUuid		string	UUID du partage ou de la ressource parente. Si les résultats sont fournis, ils seront limités aux enfants immédiats de la part ou de l’actif. Si elle n’est pas valide, la réponse est 200 avec une liste vide.
Query	query		string	Chaîne de requête de recherche. Si les résultats sont limités aux ressources dont le nom commence par la valeur de requête donnée, les résultats sont limités.
Trier	sort		string	Chaîne de critères d’ordre de tri. Les valeurs acceptables sont nom date de création modifiedDate la taille des critères de tri peut éventuellement être suivie de « :d esc » pour indiquer que le tri doit être dans l’ordre décroissant. Si aucun triInfo n’est fourni ou qu’il contient des valeurs non valides, la liste est triée en plaçant le nom de ressource croissant

Retours

Nom	Chemin d’accès	Type	Description
		array of object
annotationsCount	annotationsCount	integer	annotationsCount
commentCount	commentCount	integer	commentCount
contenuVersion	contentVersion	integer	contenuVersion
date de création	createdDate	string	date de création
extension	extension	string	extension
taille du fichier	fileSize	integer	taille du fichier
locked	locked	boolean	locked
model	model	string	model
modifiedByUuid	modifiedByUuid	string	modifiedByUuid
modifiedDate	modifiedDate	string	modifiedDate
nom	name	string	nom
pdfPreviewstatus	pdfPreviewstatus	string	pdfPreviewstatus
previewPageCount	previewPageCount	integer	previewPageCount
previewstatus	previewstatus	string	previewstatus
status	status	string	status
type	type	string	type
Identifiant unique universel (UUID)	uuid	string	Identifiant unique universel (UUID)
wopiRestricted	wopiRestricted	boolean	wopiRestricted

Répertorier les espaces de travail

ID d’opération :

ListWorkspaces

Obtenir la liste des partages que l’utilisateur demandeur a le privilège de voir

Paramètres

Nom	Clé	Obligatoire	Type	Description
Length	length		integer	Nombre maximal de résultats à récupérer
Décalage	offset		integer	Résultat au début des valeurs retournées (valeur par défaut : 0)
Propriétaire	ownerUuid		string	User UUID du propriétaire. Si les résultats sont fournis, ils sont limités aux partages appartenant à cet utilisateur.
Participant	participantUuid		string	Utilisateur UUID du participant. Si les résultats seront limités aux partages où cet utilisateur est un participant
Query	query		string	Chaîne de requête de recherche. Si les résultats sont fournis, ils sont limités aux partages portant le nom contenant la valeur de requête donnée.
Trier	sort		string	Chaîne de critères d’ordre de tri. Les valeurs acceptables sont nom date de création modifiedDate joint shareOrder organisation Les critères de tri peuvent éventuellement être suivis par « :d esc » pour indiquer que le tri doit être dans l’ordre décroissant. Si aucun sortInfo n’est fourni ou qu’il contient des valeurs non valides, la liste est triée par le nom de partage croissant.
Groupe de travail	workgroupUuid		string	Groupe de travail UUID. Si les résultats seront limités aux partages appartenant au groupe de travail

Retours

response

array of ShareResponse

Répertorier les versions de document

ID d’opération :

ListDocumentVersions

Obtenir la liste des versions d’éléments multimédias

Paramètres

Nom	Clé	Obligatoire	Type	Description
Document	assetUuid	True	string	Document UUID
Workspace	shareUuid	True	string	UUID de l’espace de travail
Length	length		integer	Nombre maximal de résultats à récupérer
Décalage	offset		integer	Résultat auquel démarrer (valeur par défaut : 0).

Retours

response

array of DocumentVersion

Supprimer un participant

ID d’opération :

DeleteParticipant

Supprime le participant de l’espace de travail

Paramètres

Nom	Clé	Obligatoire	Type	Description
Utilisateur	uuid	True	string	User UUID

Définitions

Accès

Accès

string

AssetReturnDocumentResponse

Nom	Chemin d’accès	Type	Description
commentCount	commentCount	integer
contenuVersion	contentVersion	integer
date de création	createdDate	string
extension	extension	string
taille du fichier	fileSize	integer
locked	locked	boolean
model	model	string
modifiedByUuid	modifiedByUuid	string
modifiedDate	modifiedDate	string
nom	name	string
parentUuid	parentUuid	string
previewPageCount	previewPageCount	integer
previewstatus	previewstatus	PreviewStatus
status	status	AssetStatus
summary	summary	string
type	type	AssetType
Identifiant unique universel (UUID)	uuid	string
wopiRestricted	wopiRestricted	boolean

AssetStatus

string

AssetType

string

DocumentVersion

Nom	Chemin d’accès	Type	Description
date de création	createdDate	string
extension	extension	string
taille du fichier	fileSize	integer
model	model	string
status	status	AssetStatus
Identifiant unique universel (UUID)	uuid	string
version	version	integer

EndOnDateOptionalValue

Nom	Chemin d’accès	Type	Description
présent	present	boolean
value	value	string

NotificationPreference

NotificationPreference

string

PreviewStatus

string

ShareResponse

Nom	Chemin d’accès	Type	Description
Accès	access	Access
connections	connections	integer
date de création	createdDate	string
EndOnDateOptionalValue	endOnDateOptionalValue	EndOnDateOptionalValue
model	model	string
modifiedDate	modifiedDate	string
nom	name	string
organisationUuid	organisationUuid	string
ownerUuid	ownerUuid	string
sûr	secure	boolean
ShareStatus	shareStatus	ShareStatus
status	status	AssetStatus
SynchStatus	synchStatus	SynchStatus
Identifiant unique universel (UUID)	uuid	string

ShareStatus

ShareStatus

string

SynchStatus

SynchStatus

string

UserResponse

Nom	Chemin d’accès	Type	Description
handicapé	disabled	boolean
Messagerie électronique	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
Identifiant unique universel (UUID)	uuid	string

UserStatus

UserStatus

string