Freigeben über

Objective Connect (Vorschau)

Objective Connect ist die vertrauenswürdige Dateifreigabeplattform, mit der Organisation vertrauliche Dokumente für externe Parteien freigeben kann. Benutzer können private Arbeitsbereiche erstellen und Teilnehmer in der Cloud innerhalb von Sekunden einladen. Die Zusammenarbeits-, Berichterstellungs-, Sicherheits- und Compliance-Features ermöglichen Regierungen und regulierten Branchen die Fähigkeit, extern zu arbeiten, während sie ruhen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Connectormetadaten
Herausgeber Objective Corporation

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:
Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Kennwort securestring Das Kennwort für diese API Richtig
Serverregion. (Uk - secure.objectiveconnect.co.uk, ANZ - secure.objectiveconnect.com) Schnur Geben Sie objective Connect-Server an. Richtig
Nutzername securestring Der Benutzername für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen von Dokumentinhalten

Gibt den Inhalt eines Dokuments zurück.
Abrufen von Dokumentversionsinhalten

Gibt den Inhalt einer Dokumentversion zurück.
Arbeitsbereich abrufen

Arbeitsbereich nach ID abrufen
Arbeitsbereich erstellen

Arbeitsbereich erstellen
Arbeitsbereiche auflisten

Abrufen einer Liste der Freigaben, die der anfordernde Benutzer über Berechtigungen zum Anzeigen verfügt
Auflisten freigegebener Dokumente

Abrufen einer Liste von Ressourcen nach Workspace UUID
Auflisten von Dokumentversionen

Abrufen einer Liste von Objektversionen
Benutzer abrufen

Abrufen von Benutzern
Dokument erstellen

Wenn "Request" "application:hal+json" lautet, werden nur Metadaten erstellt. Wenn "Request" mehrteilig:form-data ist, wird ein Dokument mit Inhalt in einem einzigen Aufruf erstellt.
Dokumentversion abrufen

Abrufen einer Objektversion
Hochladen von Dokumentinhalten

Hochladen von Inhalten für ein Dokument
Teilnehmer abrufen

Abrufen von Arbeitsbereichsteilnehmern
Teilnehmer hinzufügen oder aktualisieren

Neuen Teilnehmer einladen oder zugewiesene Rollen bearbeiten
Teilnehmer löschen

Entfernt Teilnehmer aus dem Arbeitsbereich.

Abrufen von Dokumentinhalten

Vorgangs-ID:
GetDocumentContent

Gibt den Inhalt eines Dokuments zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dokument
 assetUuid True string

UUID
Arbeitsbereich
 shareUuid True string

UUID

Abrufen von Dokumentversionsinhalten

Vorgangs-ID:
GetDocumentVersionContent

Gibt den Inhalt einer Dokumentversion zurück.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dokument
 assetUuid True string

UUID
Inhaltsversion
 contentVersion True integer

Die Versionsnummer des Dokuments
Arbeitsbereich
 shareUuid True string

UUID

Arbeitsbereich abrufen

Vorgangs-ID:
GetWorkspace

Arbeitsbereich nach ID abrufen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsbereich
 shareUuid True string

Die uuid des abzurufenden Arbeitsbereichs

Gibt zurück

Body
ShareResponse

Arbeitsbereich erstellen

Vorgangs-ID:
CreateWorkspace

Arbeitsbereich erstellen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer-UUID
 userUuid True string

Benutzer-UUID
Zugang
 access string
Vertreter
 agentShareToken string

Agenttoken
Name
 name True string

Name
Organization
 organisationUuid string

Organisation UUID
Besitzer
 ownerUuid string

Besitzer UUID
Zusammenfassung
 summary string

Zusammenfassung
UUID
 uuid string

UUID

Gibt zurück

Body
ShareResponse

Arbeitsbereiche auflisten

Vorgangs-ID:
ListWorkspaces

Abrufen einer Liste der Freigaben, die der anfordernde Benutzer über Berechtigungen zum Anzeigen verfügt

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Length
 length integer

Maximale Anzahl der abzurufenden Ergebnisse
Offset
 offset integer

Ergebnis, bei dem zurückgegebene Werte beginnen (Standardwert 0)
Besitzer
 ownerUuid string

Benutzer-UUID des Besitzers. Wenn die Ergebnisse bereitgestellt werden, werden auf Freigaben beschränkt, die im Besitz dieses Benutzers sind
Teilnehmer
 participantUuid string

Benutzer-UUID des Teilnehmers. Wenn die Ergebnisse bereitgestellt werden, werden auf Freigaben beschränkt, bei denen dieser Benutzer ein Teilnehmer ist
Query
 query string

Suchabfragezeichenfolge. Wenn die Ergebnisse auf Freigaben mit dem Namen beschränkt werden, der den angegebenen Abfragewert enthält
Sortieren
 sort string

Sortierreihenfolgekriterienzeichenfolge. Zulässige Werte sind

  • name
  • Erstellungsdatum
  • modifiedDate
  • angegliedert
  • shareOrder
  • organisation Die Sortierkriterien können optional von ":d esc" gefolgt werden, um anzugeben, dass die Sortierung in absteigender Reihenfolge erfolgen soll. Wenn keine SortInfo bereitgestellt wird oder ungültige Werte enthalten sind, wird die Liste nach aufsteigender Freigabename sortiert.
Arbeitsgruppe
 workgroupUuid string

Arbeitsgruppe UUID. Wenn die Ergebnisse auf Freigaben beschränkt werden, die zur Arbeitsgruppe gehören

Gibt zurück

response
array of ShareResponse

Auflisten freigegebener Dokumente

Vorgangs-ID:
ListDocuments

Abrufen einer Liste von Ressourcen nach Workspace UUID

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsbereich
 shareUuid True string

Arbeitsbereich UUID
Length
 length integer

Maximale Anzahl der abzurufenden Ergebnisse
Offset
 offset integer

Ergebnis, bei dem zurückgegebene Werte beginnen (Standardwert 0)
Übergeordnete UUID
 parentUuid string

Die UUID der Aktie oder des übergeordneten Vermögens. Wenn die Ergebnisse bereitgestellt werden, werden auf die unmittelbaren untergeordneten Elemente der Aktie oder des Vermögenswerts beschränkt. Wenn ungültig, lautet die Antwort 200 mit einer leeren Liste.
Query
 query string

Die Suchabfragezeichenfolge. Wenn die Ergebnisse bereitgestellt werden, werden sie auf Ressourcen mit dem Namen beschränkt, der mit dem angegebenen Abfragewert beginnt.
Sortieren
 sort string

Sortierreihenfolgekriterienzeichenfolge. Zulässige Werte sind

  • name
  • Erstellungsdatum
  • modifiedDate
  • die Sortierkriterien können optional von ":d esc" gefolgt werden, um anzugeben, dass die Sortierung in absteigender Reihenfolge erfolgen soll. Wenn keine SortInfo bereitgestellt wird oder ungültige Werte enthalten sind, wird die Liste nach aufsteigender Objektname sortiert.

Gibt zurück

Name Pfad Typ Beschreibung
array of object
annotationsCount
 annotationsCount integer

annotationsCount
commentCount
 commentCount integer

commentCount
Inhaltsversion
 contentVersion integer

Inhaltsversion
Erstellungsdatum
 createdDate string

Erstellungsdatum
Erweiterung
 extension string

Erweiterung
Dateigröße
 fileSize integer

Dateigröße
locked
 locked boolean

locked
Modell
 model string

Modell
modifiedByUuid
 modifiedByUuid string

modifiedByUuid
modifiedDate
 modifiedDate string

modifiedDate
name
 name string

name
pdfPreviewstatus
 pdfPreviewstatus string

pdfPreviewstatus
previewPageCount
 previewPageCount integer

previewPageCount
Vorschaustatus
 previewstatus string

Vorschaustatus
status
 status string

status
type
 type string

type
Universelle eindeutige Kennung (UUID)
 uuid string

Universelle eindeutige Kennung (UUID)
wopiRestricted
 wopiRestricted boolean

wopiRestricted

Auflisten von Dokumentversionen

Vorgangs-ID:
ListDocumentVersions

Abrufen einer Liste von Objektversionen

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dokument
 assetUuid True string

Dokument-UUID
Arbeitsbereich
 shareUuid True string

Arbeitsbereich UUID
Length
 length integer

Die maximale Anzahl der abzurufenden Ergebnisse
Offset
 offset integer

Das Ergebnis, bei dem begonnen werden soll (Standardwert ist 0).

Gibt zurück

response
array of DocumentVersion

Benutzer abrufen

Vorgangs-ID:
GetUser

Abrufen von Benutzern

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Email
 emailAddress string

Die E-Mail-Adresse, nach der gesucht werden soll
Length
 length integer

Die Anzahl der zurückzugebenden Ergebnisse. Wird nur verwendet, wenn Offset verwendet wird.
Offset
 offset integer

Zurückgeben der Ergebnisse nach dieser Position
Organisation
 orgUuid string

Die UUID der Organisation, nach der gesucht werden soll
Sortieren
 sort string

Der Param - Sortierung sollte das Format eines Worts sein, das das Sortierfeld angibt, ein optionales ":d esc"-Tag, wenn keine aufsteigende Darstellung angenommen wird. Ungültige oder leere Anforderungen standardmäßig aufsteigenden Namen. Verfügbare Sortierungen sind : Vorname, Nachname, E-Mail
Benutzer-UUIDs
 uuids array

Die Liste der Benutzer-Uuids

Gibt zurück

response
array of UserResponse

Dokument erstellen

Vorgangs-ID:
CreateDocument

Wenn "Request" "application:hal+json" lautet, werden nur Metadaten erstellt. Wenn "Request" mehrteilig:form-data ist, wird ein Dokument mit Inhalt in einem einzigen Aufruf erstellt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Arbeitsbereich UUID
 shareUuid True string

Der Freigabe-uuid vom Pfad
Dateiinhalt
 file True file

Der hochzuladende Dateiinhalt
Dateiname
 name True string

Der Dateiname
Übergeordnete UUID
 parentUuid string

(Optional)
Zusammenfassung
 summary string

(Optional)

Gibt zurück

Body
AssetReturnDocumentResponse

Dokumentversion abrufen

Vorgangs-ID:
GetDocumentVersion

Abrufen einer Objektversion

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dokument
 assetUuid True string

UUID
Arbeitsbereich
 shareUuid True string

UUID
Version
 version True integer

Die Versionsnummer des Dokuments

Gibt zurück

Body
DocumentVersion

Hochladen von Dokumentinhalten

Vorgangs-ID:
UploadDocumentContent

Hochladen von Inhalten für ein Dokument

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Dokument
 assetUuid True string

Dokument-UUID
Arbeitsbereich
 shareUuid True string

Arbeitsbereich UUID
Dateiinhalt
 file True file

Der hochzuladende Dateiinhalt

Teilnehmer abrufen

Vorgangs-ID:
GetParticipants

Abrufen von Arbeitsbereichsteilnehmern

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer
 userUuid string

Benutzer-UUID

Gibt zurück

Name Pfad Typ Beschreibung
array of object
akzeptiert
 accepted boolean

akzeptiert
E-Mail
 email string

E-Mail
isOwner
 isOwner boolean

isOwner
joinDate
 joinedDate string

joinDate
Modell
 model string

Modell
name
 name string

name
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
Universelle eindeutige Kennung (UUID)
 uuid string

Universelle eindeutige Kennung (UUID)

Teilnehmer hinzufügen oder aktualisieren

Vorgangs-ID:
AddParticipant

Neuen Teilnehmer einladen oder zugewiesene Rollen bearbeiten

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
E-Mails
 emails True array of string

E-Mails
Nachricht
 message string

Einladungsnachricht
roles
 roles array of string

roles
Arbeitsbereich UUID
 shareUuid True string

UUID
Sichtbarkeit des Teilnehmers
 type string

STANDARD – für andere Teilnehmer sichtbar. BCC - Teilnehmer werden von anderen ausgeblendet

Gibt zurück

Name Pfad Typ Beschreibung
array of object
akzeptiert
 accepted boolean

akzeptiert
E-Mail
 email string

E-Mail
isOwner
 isOwner boolean

isOwner
Modell
 model string

Modell
roles
 roles array of string

roles
shareUuid
 shareUuid string

shareUuid
type
 type string

type
Universelle eindeutige Kennung (UUID)
 uuid string

Universelle eindeutige Kennung (UUID)

Teilnehmer löschen

Vorgangs-ID:
DeleteParticipant

Entfernt Teilnehmer aus dem Arbeitsbereich.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Benutzer
 uuid True string

Benutzer-UUID

Definitionen

Zugang

Zugang
string

AssetReturnDocumentResponse

Name Pfad Typ Beschreibung
commentCount
 commentCount integer
Inhaltsversion
 contentVersion integer
Erstellungsdatum
 createdDate string
Erweiterung
 extension string
Dateigröße
 fileSize integer
locked
 locked boolean
Modell
 model string
modifiedByUuid
 modifiedByUuid string
modifiedDate
 modifiedDate string
name
 name string
parentUuid
 parentUuid string
previewPageCount
 previewPageCount integer
Vorschaustatus
 previewstatus PreviewStatus
status
 status AssetStatus
summary
 summary string
type
 type AssetType
Universelle eindeutige Kennung (UUID)
 uuid string
wopiRestricted
 wopiRestricted boolean

AssetStatus

string

AssetType

string

DocumentVersion

Name Pfad Typ Beschreibung
Erstellungsdatum
 createdDate string
Erweiterung
 extension string
Dateigröße
 fileSize integer
Modell
 model string
status
 status AssetStatus
Universelle eindeutige Kennung (UUID)
 uuid string
Ausgabe
 version integer

EndOnDateOptionalValue

Name Pfad Typ Beschreibung
Gegenwart
 present boolean
value
 value string

NotificationPreference

NotificationPreference
string

PreviewStatus

string

ShareResponse

Name Pfad Typ Beschreibung
Zugang
 access Access
Verbindungen
 connections integer
Erstellungsdatum
 createdDate string
EndOnDateOptionalValue
 endOnDateOptionalValue EndOnDateOptionalValue
Modell
 model string
modifiedDate
 modifiedDate string
name
 name string
organisationUuid
 organisationUuid string
ownerUuid
 ownerUuid string
sicher
 secure boolean
ShareStatus
 shareStatus ShareStatus
status
 status AssetStatus
SynchStatus
 synchStatus SynchStatus
Universelle eindeutige Kennung (UUID)
 uuid string

ShareStatus

ShareStatus
string

SynchStatus

SynchStatus
string

UserResponse

Name Pfad Typ Beschreibung
disabled
 disabled boolean
E-Mail
 email string
Vorname
 firstName string
hideEmailAddress
 hideEmailAddress boolean
lastName
 lastName string
Modell
 model string
notificationPreferences
 notificationPreferences array of NotificationPreference
organisationUuid
 organisationUuid string
roles
 roles array of string
UserStatus
 status UserStatus
timezone
 timezone string
Universelle eindeutige Kennung (UUID)
 uuid string

UserStatus

UserStatus
string