Sdílet prostřednictvím

Objective Connect (Preview)

Objective Connect je důvěryhodná platforma pro sdílení souborů, která organizaci umožňuje sdílet citlivé dokumenty s externími stranami. Uživatelé můžou během několika sekund vytvářet soukromé pracovní prostory a zvát účastníky v cloudu. Funkce spolupráce, vytváření sestav, zabezpečení a dodržování předpisů umožňují vládě a regulovaným odvětvím pracovat externě a zároveň mít klid.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Metadata konektoru
Vydavatel Objective Corporation

Vytvoření připojení

Konektor podporuje následující typy ověřování:
výchozí Parametry pro vytvoření připojení Všechny oblasti Nesdílitelné

Výchozí

Použitelné: Všechny oblasti

Parametry pro vytvoření připojení

Toto připojení není možné sdílet. Pokud se power app sdílí s jiným uživatelem, zobrazí se výzva k explicitní vytvoření nového připojení.

Název Typ Description Povinné
Heslo securestring Heslo pro toto rozhraní API Pravdivé
Oblast serveru. (Británie - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com) řetězec Zadejte server Objective Connect. Pravdivé
Uživatelské jméno securestring Uživatelské jméno pro toto rozhraní API Pravdivé

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Nahrání obsahu dokumentu

Nahrání obsahu pro dokument
Odstranit účastníka

Odebere účastníka z pracovního prostoru.
Přidání nebo aktualizace účastníka

Pozvat nového účastníka nebo upravit přiřazené role
Vytvoření dokumentu

Pokud je požadavek application:hal+json, vytvoří pouze metadata. Pokud je požadavek multipart:form-data, vytvoří dokument s obsahem v jednom volání.
Vytvoření pracovního prostoru

Vytvoření pracovního prostoru
Výpis pracovních prostorů

Získání seznamu sdílených složek, které má žádající uživatel oprávnění k zobrazení
Výpis sdílených dokumentů

Získání seznamu prostředků podle UUID pracovního prostoru
Výpis verzí dokumentů

Získání seznamuverzích
Získání obsahu dokumentu

Vrátí obsah dokumentu.
Získání obsahu verze dokumentu

Vrátí obsah verze dokumentu.
Získání pracovního prostoru

Získání pracovního prostoru podle ID
Získání uživatele

Získání uživatelů
Získání verze dokumentu

Získání verze prostředku
Získání účastníků

Získání účastníků pracovního prostoru

Nahrání obsahu dokumentu

ID operace:
UploadDocumentContent

Nahrání obsahu pro dokument

Parametry

Name Klíč Vyžadováno Typ Description
Dokument
 assetUuid True string

UUID dokumentu
Workspace
 shareUuid True string

UUID pracovního prostoru
Obsah souboru
 file True file

Obsah souboru, který se má nahrát

Odstranit účastníka

ID operace:
DeleteParticipant

Odebere účastníka z pracovního prostoru.

Parametry

Name Klíč Vyžadováno Typ Description
Uživatel
 uuid True string

UUID uživatele

Přidání nebo aktualizace účastníka

ID operace:
AddParticipant

Pozvat nového účastníka nebo upravit přiřazené role

Parametry

Name Klíč Vyžadováno Typ Description
e-maily
 emails True array of string

e-maily
Message
 message string

Zpráva s pozvánkou
roles
 roles array of string

roles
UUID pracovního prostoru
 shareUuid True string

Univerzálně jedinečný identifikátor (UUID)
Viditelnost účastníků
 type string

STANDARD – viditelné ostatním účastníkům. Skrytá kopie – účastník bude skrytý před ostatními.

Návraty

Name Cesta Typ Description
array of object
přijaté
 accepted boolean

přijaté
e-mail
 email string

e-mail
isOwner
 isOwner boolean

isOwner
model
 model string

model
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
typ
 type string

typ
Univerzální jednoznačný identifikátor (UUID)
 uuid string

Univerzální jednoznačný identifikátor (UUID)

Vytvoření dokumentu

ID operace:
CreateDocument

Pokud je požadavek application:hal+json, vytvoří pouze metadata. Pokud je požadavek multipart:form-data, vytvoří dokument s obsahem v jednom volání.

Parametry

Name Klíč Vyžadováno Typ Description
UUID pracovního prostoru
 shareUuid True string

Identifikátor uuid sdílené složky z cesty
Obsah souboru
 file True file

Obsah souboru, který se má nahrát
Název souboru
 name True string

Název souboru
Nadřazené UUID
 parentUuid string

(Nepovinné)
Shrnutí
 summary string

(Nepovinné)

Návraty

Body
AssetReturnDocumentResponse

Vytvoření pracovního prostoru

ID operace:
CreateWorkspace

Vytvoření pracovního prostoru

Parametry

Name Klíč Vyžadováno Typ Description
UUID uživatele
 userUuid True string

UUID uživatele
Access
 access string
Agenta
 agentShareToken string

Token agenta
Název
 name True string

Název
Organizace
 organisationUuid string

UUID organizace
Vlastník
 ownerUuid string

UUID vlastníka
Shrnutí
 summary string

Shrnutí
Univerzálně jedinečný identifikátor (UUID)
 uuid string

Univerzálně jedinečný identifikátor (UUID)

Návraty

Body
ShareResponse

Výpis pracovních prostorů

ID operace:
ListWorkspaces

Získání seznamu sdílených složek, které má žádající uživatel oprávnění k zobrazení

Parametry

Name Klíč Vyžadováno Typ Description
Délka
 length integer

Maximální počet výsledků k načtení
Posun
 offset integer

Výsledek, při kterém vrácené hodnoty začínají (výchozí hodnota je 0)
Vlastník
 ownerUuid string

UUID uživatele vlastníka. Pokud zadáte výsledky, budou omezeny na sdílené složky, které vlastní tento uživatel.
Účastník
 participantUuid string

UUID uživatele účastníka. Pokud zadáte výsledky, budou omezeny na sdílené složky, kde je tento uživatel účastníkem.
Query
 query string

Řetězec vyhledávacího dotazu. Pokud zadáte výsledky, omezí se na sdílené složky s názvem obsahujícím danou hodnotu dotazu.
Seřadit
 sort string

Seřaďte řetězec kritérií pořadí. Přijatelné hodnoty jsou

  • název
  • datum vytvoření
  • modifiedDate
  • spojený
  • shareOrder
  • pokud chcete označit, že řazení by mělo být v sestupném pořadí, může být za kritériem řazení volitelně následovat ":d esc". Pokud není zadané žádné informace o řazení nebo obsahuje neplatné hodnoty, seznam se seřadí vzestupně podle názvu sdílené složky.
Pracovní skupina
 workgroupUuid string

UUID pracovní skupiny. Pokud zadáte výsledky, budou omezeny na sdílené složky, které patří do pracovní skupiny.

Návraty

response
array of ShareResponse

Výpis sdílených dokumentů

ID operace:
ListDocuments

Získání seznamu prostředků podle UUID pracovního prostoru

Parametry

Name Klíč Vyžadováno Typ Description
Workspace
 shareUuid True string

UUID pracovního prostoru
Délka
 length integer

Maximální počet výsledků k načtení
Posun
 offset integer

Výsledek, při kterém vrácené hodnoty začínají (výchozí hodnota je 0)
Nadřazené UUID
 parentUuid string

UUID sdílené složky nebo nadřazeného prostředku. Pokud byly výsledky poskytnuty, budou omezeny na okamžité podřízené položky nebo aktiva. Pokud je neplatná, bude odpověď 200 s prázdným seznamem.
Query
 query string

Řetězec vyhledávacího dotazu. Pokud zadáte výsledky, omezí se na prostředky s názvem začínajícím danou hodnotou dotazu.
Seřadit
 sort string

Seřaďte řetězec kritérií pořadí. Přijatelné hodnoty jsou

  • název
  • datum vytvoření
  • modifiedDate
  • velikost Kritérium řazení může volitelně následovat za ":d esc", aby bylo možné označit, že řazení by mělo být v sestupném pořadí. Pokud není zadané žádné informace o řazení nebo obsahuje neplatné hodnoty, seznam se seřadí vzestupně podle názvu assetu.

Návraty

Name Cesta Typ Description
array of object
annotationsCount
 annotationsCount integer

annotationsCount
commentCount
 commentCount integer

commentCount
verze obsahu
 contentVersion integer

verze obsahu
datum vytvoření
 createdDate string

datum vytvoření
přípona
 extension string

přípona
velikost souboru
 fileSize integer

velikost souboru
zamčený
 locked boolean

zamčený
model
 model string

model
modifiedByUuid
 modifiedByUuid string

modifiedByUuid
modifiedDate
 modifiedDate string

modifiedDate
název
 name string

název
pdfPreviewstatus
 pdfPreviewstatus string

pdfPreviewstatus
previewPageCount
 previewPageCount integer

previewPageCount
Previewstatus
 previewstatus string

Previewstatus
stav
 status string

stav
typ
 type string

typ
Univerzální jednoznačný identifikátor (UUID)
 uuid string

Univerzální jednoznačný identifikátor (UUID)
wopiRestricted
 wopiRestricted boolean

wopiRestricted

Výpis verzí dokumentů

ID operace:
ListDocumentVersions

Získání seznamuverzích

Parametry

Name Klíč Vyžadováno Typ Description
Dokument
 assetUuid True string

UUID dokumentu
Workspace
 shareUuid True string

UUID pracovního prostoru
Délka
 length integer

Maximální počet výsledků, které se mají načíst
Posun
 offset integer

Výsledek, od kterého se má spustit (výchozí hodnota je 0).

Návraty

response
array of DocumentVersion

Získání obsahu dokumentu

ID operace:
GetDocumentContent

Vrátí obsah dokumentu.

Parametry

Name Klíč Vyžadováno Typ Description
Dokument
 assetUuid True string

Univerzálně jedinečný identifikátor (UUID)
Workspace
 shareUuid True string

Univerzálně jedinečný identifikátor (UUID)

Získání obsahu verze dokumentu

ID operace:
GetDocumentVersionContent

Vrátí obsah verze dokumentu.

Parametry

Name Klíč Vyžadováno Typ Description
Dokument
 assetUuid True string

Univerzálně jedinečný identifikátor (UUID)
Verze obsahu
 contentVersion True integer

Číslo verze dokumentu
Workspace
 shareUuid True string

Univerzálně jedinečný identifikátor (UUID)

Získání pracovního prostoru

ID operace:
GetWorkspace

Získání pracovního prostoru podle ID

Parametry

Name Klíč Vyžadováno Typ Description
Workspace
 shareUuid True string

Identifikátor uuid pracovního prostoru, který se má načíst

Návraty

Body
ShareResponse

Získání uživatele

ID operace:
GetUser

Získání uživatelů

Parametry

Name Klíč Vyžadováno Typ Description
Email
 emailAddress string

E-mailová adresa, kterou chcete vyhledat
Délka
 length integer

Počet výsledků, které se mají vrátit. Používá se pouze v případě, že je použit posun.
Posun
 offset integer

Vrátí výsledky za touto pozicí.
Organizace
 orgUuid string

UUID organizace, která má hledat
Seřadit
 sort string

Parametr – řazení by mělo být ve formátu slova označujícího pole řazení volitelnou značku ":d esc", pokud není k dispozici vzestupně. Chybné nebo prázdné požadavky mají výchozí vzestupný název. Dostupné řazení jsou – firstName, lastName, email
Identifikátory UUID uživatele
 uuids array

Seznam uživatelských identifikátorů uuid

Návraty

response
array of UserResponse

Získání verze dokumentu

ID operace:
GetDocumentVersion

Získání verze prostředku

Parametry

Name Klíč Vyžadováno Typ Description
Dokument
 assetUuid True string

Univerzálně jedinečný identifikátor (UUID)
Workspace
 shareUuid True string

Univerzálně jedinečný identifikátor (UUID)
Version
 version True integer

Číslo verze dokumentu

Návraty

Body
DocumentVersion

Získání účastníků

ID operace:
GetParticipants

Získání účastníků pracovního prostoru

Parametry

Name Klíč Vyžadováno Typ Description
Uživatel
 userUuid string

UUID uživatele

Návraty

Name Cesta Typ Description
array of object
přijaté
 accepted boolean

přijaté
e-mail
 email string

e-mail
isOwner
 isOwner boolean

isOwner
joinDate
 joinedDate string

joinDate
model
 model string

model
název
 name string

název
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
typ
 type string

typ
Univerzální jednoznačný identifikátor (UUID)
 uuid string

Univerzální jednoznačný identifikátor (UUID)

Definice

Access

Access
string

AssetReturnDocumentResponse

Name Cesta Typ Description
commentCount
 commentCount integer
verze obsahu
 contentVersion integer
datum vytvoření
 createdDate string
přípona
 extension string
velikost souboru
 fileSize integer
zamčený
 locked boolean
model
 model string
modifiedByUuid
 modifiedByUuid string
modifiedDate
 modifiedDate string
název
 name string
parentUuid
 parentUuid string
previewPageCount
 previewPageCount integer
Previewstatus
 previewstatus PreviewStatus
stav
 status AssetStatus
souhrn
 summary string
typ
 type AssetType
Univerzální jednoznačný identifikátor (UUID)
 uuid string
wopiRestricted
 wopiRestricted boolean

AssetStatus

string

AssetType

string

DocumentVersion

Name Cesta Typ Description
datum vytvoření
 createdDate string
přípona
 extension string
velikost souboru
 fileSize integer
model
 model string
stav
 status AssetStatus
Univerzální jednoznačný identifikátor (UUID)
 uuid string
verze
 version integer

EndOnDateOptionalValue

Name Cesta Typ Description
přítomný
 present boolean
value
 value string

NotificationPreference

NotificationPreference
string

PreviewStatus

string

ShareResponse

Name Cesta Typ Description
Access
 access Access
connections
 connections integer
datum vytvoření
 createdDate string
EndOnDateOptionalValue
 endOnDateOptionalValue EndOnDateOptionalValue
model
 model string
modifiedDate
 modifiedDate string
název
 name string
organizaceUuid
 organisationUuid string
ownerUuid
 ownerUuid string
zajistit
 secure boolean
ShareStatus
 shareStatus ShareStatus
stav
 status AssetStatus
SynchStatus
 synchStatus SynchStatus
Univerzální jednoznačný identifikátor (UUID)
 uuid string

ShareStatus

ShareStatus
string

SynchStatus

SynchStatus
string

UserResponse

Name Cesta Typ Description
neaktivní
 disabled boolean
e-mail
 email string
křestní jméno
 firstName string
hideEmailAddress
 hideEmailAddress boolean
lastName
 lastName string
model
 model string
notificationPreferences
 notificationPreferences array of NotificationPreference
organizaceUuid
 organisationUuid string
roles
 roles array of string
UserStatus
 status UserStatus
timezone
 timezone string
Univerzální jednoznačný identifikátor (UUID)
 uuid string

UserStatus

UserStatus
string