Objective Connect (előzetes verzió)

Az Objective Connect egy megbízható fájlmegosztási platform, amellyel a szervezet bizalmas dokumentumokat oszthat meg külső felekkel. A felhasználók másodpercek alatt létrehozhatnak privát munkaterületeket, és meghívhatják a felhő résztvevőit. Az együttműködési, jelentéskészítési, biztonsági és megfelelőségi funkciók lehetővé teszik a kormányok és a szabályozott iparágak számára, hogy külsőleg dolgozzanak, miközben nyugalmat biztosítanak.

Ez az összekötő a következő termékekben és régiókban érhető el:

Service	Class	Régiók
Copilot Studio	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Logikai alkalmazások	Standard	Az összes Logic Apps-régió , kivéve a következőket:      - Azure Government-régiók      - Azure China-régiók      - Amerikai Védelmi Minisztérium (DoD)
Power Alkalmazások	prémium	Az összes Power Apps-régió , kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)
Power Automate	prémium	Az összes Power Automate-régió, kivéve a következőket:      - USA kormánya (GCC)      - Amerikai kormány (GCC High)      - A 21Vianet által üzemeltetett China Cloud      - Amerikai Védelmi Minisztérium (DoD)

Összekötő metaadatai
Kiadó	Objective Corporation

Kapcsolat létrehozása

Az összekötő a következő hitelesítési típusokat támogatja:

Alapértelmezett	A kapcsolat létrehozásának paraméterei.	Minden régió	Nem osztható meg

Alapértelmezett

Alkalmazható: Minden régió

A kapcsolat létrehozásának paraméterei.

Ez nem megosztható kapcsolat. Ha a power app meg van osztva egy másik felhasználóval, a rendszer kérni fogja, hogy hozzon létre új kapcsolatot.

Név	Típus	Description	Kötelező
Jelszó	securestring	Az api jelszava	True
Kiszolgálói régió. (Egyesült Királyság – secure.objectiveconnect.co.uk, ANZ – secure.objectiveconnect.com)	karakterlánc	Adja meg az Objective Connect-kiszolgálót.	True
Felhasználónév	securestring	Az api felhasználóneve	True

Szabályozási korlátok

Name	Hívások	Megújítási időszak
API-hívások kapcsolatonként	100	60 másodperc

Műveletek

Dokumentum létrehozása	Ha a kérelem alkalmazás:hal+json, csak metaadatokat hoz létre. Ha a kérés többrészes:űrlap-adat, egyetlen hívásban hoz létre tartalmat tartalmazó dokumentumot.
Dokumentumtartalom feltöltése	Dokumentum tartalmának feltöltése
Dokumentumtartalom lekérése	Egy dokumentum tartalmát adja vissza
Dokumentumverzió lekérése	Eszközverzió lekérése
Dokumentumverzió tartalmának lekérése	Egy dokumentumverzió tartalmát adja vissza
Dokumentumverziók listázása	Eszközverziók listájának lekérése
Felhasználó lekérése	Felhasználók lekérése
Megosztott dokumentumok listázása	Eszközök listájának lekérése munkaterület UUID alapján
Munkaterület lekérése	Munkaterület lekérése azonosító alapján
Munkaterület létrehozása	Munkaterület létrehozása
Munkaterületek listázása	Azon megosztások listájának lekérése, amelyeket a kérelmező felhasználónak meg kell tekintenie
Résztvevő hozzáadása vagy frissítése	Új résztvevő meghívása vagy hozzárendelt szerepkörök szerkesztése
Résztvevő törlése	Résztvevő eltávolítása a munkaterületről
Résztvevők lekérése	Munkaterület résztvevőinek lekérése

Dokumentum létrehozása

Műveletazonosító:

CreateDocument

Ha a kérelem alkalmazás:hal+json, csak metaadatokat hoz létre. Ha a kérés többrészes:űrlap-adat, egyetlen hívásban hoz létre tartalmat tartalmazó dokumentumot.

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Munkaterület UUID azonosítója	shareUuid	True	string	A megosztás uuid azonosítója az elérési útról
Fájltartalom	file	True	file	A feltöltendő fájltartalom
Fájlnév	name	True	string	A fájl neve
Szülő UUID azonosítója	parentUuid		string	(Választható)
Összefoglalás	summary		string	(Választható)

Válaszok

Törzs

AssetReturnDocumentResponse

Dokumentumtartalom feltöltése

Műveletazonosító:

UploadDocumentContent

Dokumentum tartalmának feltöltése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentum	assetUuid	True	string	Dokumentum UUID azonosítója
Workspace	shareUuid	True	string	Munkaterület UUID azonosítója
Fájltartalom	file	True	file	A feltöltendő fájltartalom

Dokumentumtartalom lekérése

Műveletazonosító:

GetDocumentContent

Egy dokumentum tartalmát adja vissza

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentum	assetUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)
Workspace	shareUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)

Dokumentumverzió lekérése

Műveletazonosító:

GetDocumentVersion

Eszközverzió lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentum	assetUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)
Workspace	shareUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)
verzió	version	True	integer	A dokumentum verziószáma

Válaszok

Törzs

DocumentVersion

Dokumentumverzió tartalmának lekérése

Műveletazonosító:

GetDocumentVersionContent

Egy dokumentumverzió tartalmát adja vissza

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentum	assetUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)
Tartalomverzió	contentVersion	True	integer	A dokumentum verziószáma
Workspace	shareUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)

Dokumentumverziók listázása

Műveletazonosító:

ListDocumentVersions

Eszközverziók listájának lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Dokumentum	assetUuid	True	string	Dokumentum UUID azonosítója
Workspace	shareUuid	True	string	Munkaterület UUID azonosítója
Length	length		integer	A lekérendő eredmények maximális száma
Kiegyenlít	offset		integer	Az az eredmény, amelynél el kell indulnia (alapértelmezés szerint 0).

Válaszok

response

array of DocumentVersion

Felhasználó lekérése

Műveletazonosító:

GetUser

Felhasználók lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Email	emailAddress		string	A keresendő e-mail-cím
Length	length		integer	A visszaadandó eredmények száma. Csak eltolás használata esetén használható.
Kiegyenlít	offset		integer	Az eredmények visszaadása a pozíció után
Szervezet	orgUuid		string	A keresendő szervezet UUID azonosítója
Fajta	sort		string	A param – rendezés formátumának egy szónak kell lennie, amely a rendezési mezőt egy választható ":d esc" címkével jelzi, ha nem jelenik meg növekvő értékként. A hibás vagy üres kérések alapértelmezés szerint növekvő névre lesznek bekapcsolva. Az elérhető rendezések a következők: firstName, lastName, e-mail
Felhasználói UUID-k	uuids		array	A felhasználói uuidok listája

Válaszok

response

array of UserResponse

Megosztott dokumentumok listázása

Műveletazonosító:

ListDocuments

Eszközök listájának lekérése munkaterület UUID alapján

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Workspace	shareUuid	True	string	Munkaterület UUID azonosítója
Length	length		integer	A lekérendő eredmények maximális száma
Kiegyenlít	offset		integer	Az eredmény, amikor a visszaadott értékek elindulnak (alapértelmezés szerint 0)
Szülő UUID azonosítója	parentUuid		string	A megosztás vagy a szülőeszköz UUID azonosítója. Amennyiben az eredmények a részvény vagy eszköz közvetlen gyermekeire korlátozódnak. Ha érvénytelen, a válasz 200 lesz egy üres listával.
Query	query		string	A keresési lekérdezési sztring. Ha meg van adva, az eredmények a megadott lekérdezési értékkel kezdődő névvel rendelkező objektumokra lesznek korlátozva.
Fajta	sort		string	Rendezési feltétel sztringje. Az elfogadható értékek a következők: név létrehozás dátuma modifiedDate méret A rendezési feltételt igény szerint a ":d esc" is követheti annak jelzésére, hogy a rendezésnek csökkenő sorrendben kell lennie. Ha nincs megadva sortInfo, vagy érvénytelen értékeket tartalmaz, a lista növekvő eszköznév szerint lesz rendezve

Válaszok

Name	Elérési út	Típus	Description
		array of object
annotationsCount	annotationsCount	integer	annotationsCount
commentCount	commentCount	integer	commentCount
tartalomverzió	contentVersion	integer	tartalomverzió
létrehozás dátuma	createdDate	string	létrehozás dátuma
bővítmény	extension	string	bővítmény
Fájlméret	fileSize	integer	Fájlméret
zárolt	locked	boolean	zárolt
modell	model	string	modell
modifiedByUuid	modifiedByUuid	string	modifiedByUuid
modifiedDate	modifiedDate	string	modifiedDate
név	name	string	név
pdfPreviewstatus	pdfPreviewstatus	string	pdfPreviewstatus
previewPageCount	previewPageCount	integer	previewPageCount
previewstatus	previewstatus	string	previewstatus
állapot	status	string	állapot
típus	type	string	típus
univerzálisan egyedi azonosító (UUID)	uuid	string	univerzálisan egyedi azonosító (UUID)
wopiRestricted	wopiRestricted	boolean	wopiRestricted

Munkaterület lekérése

Műveletazonosító:

GetWorkspace

Munkaterület lekérése azonosító alapján

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Workspace	shareUuid	True	string	A lekérendő munkaterület uuid azonosítója

Válaszok

Törzs

ShareResponse

Munkaterület létrehozása

Műveletazonosító:

CreateWorkspace

Munkaterület létrehozása

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Felhasználói UUID	userUuid	True	string	Felhasználói UUID
Access	access		string
Ügynök	agentShareToken		string	Ügynök jogkivonata
Név	name	True	string	Név
Szervezet	organisationUuid		string	Szervezeti UUID
Tulajdonos	ownerUuid		string	Tulajdonos UUID azonosítója
Összefoglalás	summary		string	Összefoglalás
UUID (Univerzálisan Egyedi Azonosító)	uuid		string	UUID (Univerzálisan Egyedi Azonosító)

Válaszok

Törzs

ShareResponse

Munkaterületek listázása

Műveletazonosító:

ListWorkspaces

Azon megosztások listájának lekérése, amelyeket a kérelmező felhasználónak meg kell tekintenie

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
Length	length		integer	A lekérendő eredmények maximális száma
Kiegyenlít	offset		integer	Az eredmény, amikor a visszaadott értékek elindulnak (alapértelmezés szerint 0)
Tulajdonos	ownerUuid		string	A tulajdonos felhasználói UUID azonosítója. Ha az eredmények a felhasználó tulajdonában lévő megosztásokra lesznek korlátozva
Résztvevő	participantUuid		string	A résztvevő felhasználói UUID azonosítója. Ha az eredmények olyan megosztásokra lesznek korlátozva, ahol ez a felhasználó résztvevő
Query	query		string	Keresési lekérdezési sztring. Ha az eredmények a megadott lekérdezési értéket tartalmazó névvel rendelkező megosztásokra lesznek korlátozva
Fajta	sort		string	Rendezési feltétel sztringje. Az elfogadható értékek a következők: név létrehozás dátuma modifiedDate Csatlakozott shareOrder szervezet A rendezési kritériumokat igény szerint a ":d esc" is követheti annak jelzésére, hogy a rendezésnek csökkenő sorrendben kell lennie. Ha nincs megadva sortInfo, vagy érvénytelen értékeket tartalmaz, a lista növekvő megosztási név szerint lesz rendezve.
Munkacsoport	workgroupUuid		string	Munkacsoport UUID azonosítója. Ha az eredmények a munkacsoporthoz tartozó megosztásokra lesznek korlátozva

Válaszok

response

array of ShareResponse

Résztvevő hozzáadása vagy frissítése

Műveletazonosító:

AddParticipant

Új résztvevő meghívása vagy hozzárendelt szerepkörök szerkesztése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
e-mailek	emails	True	array of string	e-mailek
Message	message		string	Meghívóüzenet
roles	roles		array of string	roles
Munkaterület UUID azonosítója	shareUuid	True	string	UUID (Univerzálisan Egyedi Azonosító)
Résztvevők láthatósága	type		string	STANDARD – látható a többi résztvevő számára. Titkos másolat – a résztvevő el lesz rejtve mások elől

Válaszok

Name	Elérési út	Típus	Description
		array of object
elfogadva	accepted	boolean	elfogadva
e-mail	email	string	e-mail
isOwner	isOwner	boolean	isOwner
modell	model	string	modell
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
típus	type	string	típus
univerzálisan egyedi azonosító (UUID)	uuid	string	univerzálisan egyedi azonosító (UUID)

Résztvevő törlése

Műveletazonosító:

DeleteParticipant

Résztvevő eltávolítása a munkaterületről

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
User	uuid	True	string	Felhasználói UUID

Résztvevők lekérése

Műveletazonosító:

GetParticipants

Munkaterület résztvevőinek lekérése

Paraméterek

Name	Kulcs	Kötelező	Típus	Description
User	userUuid		string	Felhasználói UUID

Válaszok

Name	Elérési út	Típus	Description
		array of object
elfogadva	accepted	boolean	elfogadva
e-mail	email	string	e-mail
isOwner	isOwner	boolean	isOwner
joinedDate	joinedDate	string	joinedDate
modell	model	string	modell
név	name	string	név
roles	roles	array of string	roles
shareUuid	shareUuid	string	shareUuid
típus	type	string	típus
univerzálisan egyedi azonosító (UUID)	uuid	string	univerzálisan egyedi azonosító (UUID)

Definíciók

Access

Access

string

AssetReturnDocumentResponse

Name	Elérési út	Típus	Description
commentCount	commentCount	integer
tartalomverzió	contentVersion	integer
létrehozás dátuma	createdDate	string
bővítmény	extension	string
Fájlméret	fileSize	integer
zárolt	locked	boolean
modell	model	string
modifiedByUuid	modifiedByUuid	string
modifiedDate	modifiedDate	string
név	name	string
parentUuid	parentUuid	string
previewPageCount	previewPageCount	integer
previewstatus	previewstatus	PreviewStatus
állapot	status	AssetStatus
összegzés	summary	string
típus	type	AssetType
univerzálisan egyedi azonosító (UUID)	uuid	string
wopiRestricted	wopiRestricted	boolean

AssetStatus

string

AssetType

string

DocumentVersion

Name	Elérési út	Típus	Description
létrehozás dátuma	createdDate	string
bővítmény	extension	string
Fájlméret	fileSize	integer
modell	model	string
állapot	status	AssetStatus
univerzálisan egyedi azonosító (UUID)	uuid	string
verzió	version	integer

EndOnDateOptionalValue

Name	Elérési út	Típus	Description
jelen	present	boolean
value	value	string

NotificationPreference

NotificationPreference

string

PreviewStatus

string

ShareResponse

Name	Elérési út	Típus	Description
Access	access	Access
connections	connections	integer
létrehozás dátuma	createdDate	string
EndOnDateOptionalValue	endOnDateOptionalValue	EndOnDateOptionalValue
modell	model	string
modifiedDate	modifiedDate	string
név	name	string
organizationUuid	organisationUuid	string
ownerUuid	ownerUuid	string
biztonságos	secure	boolean
ShareStatus	shareStatus	ShareStatus
állapot	status	AssetStatus
SynchStatus	synchStatus	SynchStatus
univerzálisan egyedi azonosító (UUID)	uuid	string

ShareStatus

ShareStatus

string

SynchStatus

SynchStatus

string

UserResponse

Name	Elérési út	Típus	Description
halványított	disabled	boolean
e-mail	email	string
keresztnév	firstName	string
hideEmailAddress	hideEmailAddress	boolean
lastName	lastName	string
modell	model	string
notificationPreferences	notificationPreferences	array of NotificationPreference
organizationUuid	organisationUuid	string
roles	roles	array of string
UserStatus	status	UserStatus
timezone	timezone	string
univerzálisan egyedi azonosító (UUID)	uuid	string

UserStatus

UserStatus

string