An Gestioo senden (Vorschau)
Legen Sie PDF- und Word Dokumente in Gestioo mit autorisierten Zugriffsgruppen und Datensatzklassifizierung ein, und bestätigen Sie dann ihre Archivierung im sicheren Tresor.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Standard | 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: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Gestioo-Support |
| URL | https://gestioo.co/contact |
| support@gestioo.co |
| Connectormetadaten | |
|---|---|
| Herausgeber | Gestioo |
| Website | https://gestioo.co |
| Datenschutzrichtlinie | https://gestioo.co/politique-confidentialite |
| Kategorien | Inhalt und Dateien; Produktivität |
An Gestioo senden
Gestioo hilft Organisationen beim Verwalten, Klassifizieren und Archivieren ihrer Dokumente in einem sicheren Tresor. Dieser Connector legt PDF- und Word Dokumente mit der autorisierten Klassifizierung und Zugriffsgruppen des Benutzers ein, fordert archivierung an und überprüft das Endergebnis.
Herausgeber
Gestioo
Voraussetzungen
- Eine aktive Gestioo-Organisation und ein Microsoft Geschäftskonto, das von dieser Organisation autorisiert wurde, um Dokumente zu erstellen und auf seinen Tresor zuzugreifen.
- Eine Power Automate-Lizenz, die Premium-Connectors abdeckt, und die Berechtigung zur Verwendung des Connectors unter den Datenrichtlinien Ihrer Organisation.
- Bei einem lokalen Windows Dateiserver, einem konfigurierten Microsoft lokalen Datengateway und einer Dateisystemverbindung oder einem vorhandenen Desktopfluss, der den Dateiinhalt bereitstellt. Das Gateway greift auf Ihre lokalen Dateien zu; der Gestioo-Connector ruft Gestioo über HTTPS auf.
Für die Dokumentübertragung ist keine Dataverse-Datenbank oder Power BI erforderlich. Power BI kann über ein Importregister berichten, das von Ihrem eigenen Workflow verwaltet wird.
Unterstützte Operationen
| Operation | Purpose |
|---|---|
| Einzahlungsoptionen erhalten | Rufen Sie die Zugriffsgruppen, Klassifizierungen, administrativen Einheiten und Uploadlimits ab, die für den angemeldeten Benutzer verfügbar sind. |
| Einzahlung erstellen | Laden Sie eine PDF- oder DOCX-Datei mit ihren Metadaten und einem stabilen Idempotenzschlüssel hoch. Gibt einen Einzahlungsbeleg zurück. |
| Einzahlungsstatus abrufen | Überprüfen Sie einen Beleg, der von diesem Benutzer und Connector erstellt wurde. |
| Archiveinlage | Archivierung des hinterlegten Dokuments anfordern. Wiederholen Sie diese Aktion, wenn die Verarbeitung noch ausgeführt wird. |
Erste Schritte
- Wählen Sie "An Gestioo senden", erstellen Sie eine Verbindung, und melden Sie sich mit Ihrem autorisierten Microsoft Geschäftskonto an. Ihre Gestioo-Organisation wird von diesem Konto aufgelöst. Möglicherweise muss ein Administrator den Zugriff unter der Zustimmungsrichtlinie Ihres Mandanten genehmigen.
- Führen Sie "Einzahlungsoptionen abrufen " aus, und wählen Sie die Zielklassifizierung und Zugriffsgruppen aus. Geben Sie ein Ereignisdatum an, an dem die ausgewählte Klassifizierung erforderlich ist.
- Lesen Sie den Dateiinhalt, und erstellen Sie einen dauerhaften idempotenten Schlüssel für diese Dateiversion. Speichern Sie diesen Schlüssel vor dem ersten Upload, und verwenden Sie ihn für Wiederholungen wieder.
- Führen Sie die Create-Einzahlung mit dem ursprünglichen Dateinamen, Titel, Metadaten und Dateibytes aus, die einmal als Base64 codiert wurden. Wenn der Quellconnector ein binäres Objekt zurückgibt, verwenden Sie dessen
$contentWert. Speichern Sie die zurückgegebenedepositId. -
Anrufarchiveinlage mit diesem Beleg. Wenn der Status lautet
receivingoderprocessing, warten SieretryAfterSeconds(standardmäßig 15 Sekunden), und rufen Sie die Archiveinzahlung erneut auf . Binden Sie die Schleife beispielsweise an 240 Iterationen und eine Stunde. - Bestätigt nur
archivedden Abschluss. Notieren Sie den Beleg- und Archivzeitstempel in Ihrem Importregister. HaltenfailedSie das Original bei ,interruptedoder timeout, und untersuchen Sie den vorhandenen Beleg.
Archivversiegelt das Dokument und ist unumkehrbar. Konfigurieren Sie die automatische Archivierung nur für Dateien, die Ihre Organisation für dieses Ziel genehmigt hat. Beschränken Sie die anfänglichen Importe auf jeweils eine Datei, und schützen Sie Dateieingaben und Ausgaben im Ablaufablaufverlauf.
Bekannte Einschränkungen
- PDF und DOCX werden unterstützt. Gestioo akzeptiert originale Dateien bis zu 50 MiB; Upstreamconnectors und Gateways können niedrigere Grenzwerte auferlegen. Überprüfen Sie den strengsten Grenzwert im gesamten Fluss vor dem Hochladen.
- Word Dokumente werden in PDF konvertiert. Das ursprüngliche DOCX wird nicht als archivierte Quelle aufbewahrt. behalten Sie die ursprüngliche Datei im Quellsystem bei.
- Der Connector überträgt vorhandene Dateien und Metadaten. Ein Dateiserver wird nicht gescannt, seine Infrastruktur diagnostizieren oder eine Datensatzklassifizierung selbst entscheiden.
- Ein Status von
processingbedeutet nicht, dass sich das Dokument im Tresor befindet. Der Einzahlungsstatus beobachtet nur den Fortschritt; Archiveinlagen fordert das Siegel nach der Verarbeitung an. - Beim Erneuten Verwenden eines Schlüssels mit unterschiedlichen Bytes oder Metadaten wird ein Wert zurückgegeben
409 idempotency_conflict. Generieren Sie nach einem Timeout oder einer verlorenen Antwort keinen neuen Schlüssel automatisch. - Der Zugriff wird für jeden Anruf überprüft. Durch das Entfernen der Rechte oder der Gruppenmitgliedschaft des Benutzers kann ein zuvor verbundener Fluss beendet werden.
- Die Power Platform-Umgebung und das Quellsystem bestimmen den Microsoft-seitigen Datenspeicherort. Die Connectorzertifizierung garantiert nicht, dass der gesamte Workflow ausschließlich in Quebec gehostet wird.
Troubleshooting
| Antwort | Action |
|---|---|
| 401 | Stellen Sie eine erneute Verbindung mit einem autorisierten Microsoft Geschäftskonto her. |
| 403 | Bitten Sie Ihren Gestioo-Administrator, das Konto, die Dokument- und Tresorberechtigungen und die ausgewählten Zugriffsgruppen zu überprüfen. |
| 404 | Überprüfen Sie den Beleg, und verwenden Sie denselben Benutzer und Connector, der ihn erstellt hat. |
| 409 | Beibehalten des vorhandenen Belegs und des Idempotenzschlüssels. Untersuchen Sie den gemeldeten Konflikt- oder Dokumentstatus. |
| 413 oder 415 | Überprüfen Sie die Dateigröße, Die Erweiterung und den tatsächlichen Inhalt. |
| 429 oder 503 | Warten Sie, und wiederholen Sie den Vorgang mit demselben Beleg oder demselben Idempotenzschlüssel und derselben Nutzlast. |
Support
Kontaktieren Sie den Gestioo-Support oder die E-Mail support@gestioo.co. Geben Sie den Vorgang, den Zeitstempel und den sicheren Fehlercode an. Senden Sie keine Anmeldeinformationen oder Dokumentinhalte in einer Supportanfrage.
Nutzungsbedingungen · Datenschutzrichtlinie
Aktionen
| Archiv einer Einzahlung |
Versiegeln Sie die hinterlegte PDF im sicheren Tresor mit ihren aktuellen Klassifizierungs- und Aufbewahrungsregeln. Die Archivierung ist unumkehrbar. Wiederholen Sie den Vorgang mit derselben Einzahlungs-ID während der Verarbeitung, und beenden Sie den Vorgang fehlgeschlagen oder unterbrochen. |
| Einzahlungsoptionen erhalten |
Rufen Sie die Zugriffsgruppen, Klassifizierungsrubrik und administrativen Einheiten ab, die für den verbundenen Benutzer verfügbar sind. |
| Einzahlungsstatus abrufen |
Überprüfen Sie eine vom verbundenen Benutzer erstellte Einzahlung. Nur archiviert bestätigt die Übermittlung an den sicheren Tresor. |
| Erstellen einer Einzahlung |
Laden Sie ein PDF- oder Word-Dokument mit einem stabilen Dateiversionsschlüssel hoch. Word Dateien werden in PDF konvertiert. Folgen Sie dieser Aktion mit "Archivieren einer Einzahlung", bis der Status archiviert ist, und behalten Sie das lokale Original bei. |
Archiv einer Einzahlung
Versiegeln Sie die hinterlegte PDF im sicheren Tresor mit ihren aktuellen Klassifizierungs- und Aufbewahrungsregeln. Die Archivierung ist unumkehrbar. Wiederholen Sie den Vorgang mit derselben Einzahlungs-ID während der Verarbeitung, und beenden Sie den Vorgang fehlgeschlagen oder unterbrochen.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Einzahlungs-ID
|
depositId | True | string |
Die von Create a Deposit zurückgegebene Einzahlungs-ID. |
Gibt zurück
- Body
- DepositStatus
Einzahlungsoptionen erhalten
Rufen Sie die Zugriffsgruppen, Klassifizierungsrubrik und administrativen Einheiten ab, die für den verbundenen Benutzer verfügbar sind.
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Organisation
|
organizationName | string |
Die Organisation wurde aus dem angemeldeten Konto aufgelöst. |
|
Maximale Uploadgröße
|
maxUploadBytes | integer |
Die maximale originale Dateigröße, die von Gestioo in Byte akzeptiert wird. |
|
Unterstützte Formate
|
supportedFormats | array of string |
Die unterstützten ursprünglichen Dateierweiterungen. |
|
Autorisierte Zugriffsgruppen
|
accessGroups | array of object |
Die Zugriffsgruppen, die für dieses Konto verfügbar sind. |
|
Zugriffsgruppen-ID
|
accessGroups.id | string |
Der Bezeichner der autorisierten Zugriffsgruppe. |
|
Französischer Name
|
accessGroups.nameFr | string |
Der Name der Zugriffsgruppe in Französisch. |
|
Englischer Name
|
accessGroups.nameEn | string |
Der Name der Zugriffsgruppe in Englisch. |
|
Klassifizierungsoptionen
|
classifications | array of object |
Die autorisierten Klassifizierungsrubrik und deren Ereignisdatumsanforderungen. |
|
Klassifikations-Rubriken-ID
|
classifications.id | string |
Der autorisierte Klassifizierungs-Rubrikenbezeichner. |
|
Klassifizierungsbezeichnung
|
classifications.label | string |
Der Rubrikencode und Titel. |
|
Ereignisdatum erforderlich
|
classifications.requiresEventDate | boolean |
Gibt an, ob für die Klassifizierung ein Aufbewahrungsereignisdatum erforderlich ist. |
|
Administrative Einheiten
|
administrativeUnits | array of object |
Die aktiven administrativen Einheiten in der Organisation. |
|
Id der administrativen Einheit
|
administrativeUnits.id | string |
Der Bezeichner der administrativen Einheit. |
|
Einheitenname
|
administrativeUnits.name | string |
Der Name der administrativen Einheit. |
|
Klassifizierungsreihen
|
classificationSeries | array of object |
Die autorisierte Klassifizierungshierarchie und Standardaufbewahrungsmetadaten. |
|
Reihencode
|
classificationSeries.seriesCode | string |
Der Code der Klassifizierungsreihen. |
|
Titel der Reihe
|
classificationSeries.seriesTitle | string |
Der Titel der Klassifizierungsreihe. |
|
Rubriken
|
classificationSeries.rubrics | array of object |
Die autorisierten Rubriken in dieser Klassifizierungsreihe. |
|
Rubrik-ID
|
classificationSeries.rubrics.id | string |
Der Klassifizierungsrubrikbezeichner. |
|
Rubrikencode
|
classificationSeries.rubrics.code | string |
Der Klassifikationsrubrikcode. |
|
Rubrikentitel
|
classificationSeries.rubrics.title | string |
Der Titel der Rubrik "Klassifikation". |
|
Reihencode
|
classificationSeries.rubrics.seriesCode | string |
Der code der übergeordneten Klassifizierungsreihen. |
|
Titel der Reihe
|
classificationSeries.rubrics.seriesTitle | string |
Der Titel der übergeordneten Klassifizierungsreihe. |
|
Unterseriencode
|
classificationSeries.rubrics.subSeriesCode | string |
Der Klassifizierungs-Unterseriencode, sofern verfügbar. |
|
Titel der Unterserien
|
classificationSeries.rubrics.subSeriesTitle | string |
Der Titel der Unterserienklassifizierung, sofern verfügbar. |
|
Optionale Funktion
|
classificationSeries.rubrics.optionalFunction | string |
Die optionale Klassifizierungsfunktion, sofern verfügbar. |
|
Standardaufbewahrungsregel-ID
|
classificationSeries.rubrics.defaultRetentionLineId | string |
Der Standardmäßige Aufbewahrungsregelbezeichner, sofern verfügbar. |
|
Aktiver Aufbewahrungstyp
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
Der Typ des aktiven Aufbewahrungszeitraums, sofern verfügbar. |
|
Aufbewahrungsereignistyp
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
Der vorgeschlagene Aufbewahrungsereignistyp, sofern verfügbar. |
Einzahlungsstatus abrufen
Überprüfen Sie eine vom verbundenen Benutzer erstellte Einzahlung. Nur archiviert bestätigt die Übermittlung an den sicheren Tresor.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Einzahlungs-ID
|
depositId | True | string |
Die von Create a Deposit zurückgegebene Einzahlungs-ID. |
Gibt zurück
- Body
- DepositStatus
Erstellen einer Einzahlung
Laden Sie ein PDF- oder Word-Dokument mit einem stabilen Dateiversionsschlüssel hoch. Word Dateien werden in PDF konvertiert. Folgen Sie dieser Aktion mit "Archivieren einer Einzahlung", bis der Status archiviert ist, und behalten Sie das lokale Original bei.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
Dateiversionsschlüssel
|
idempotencyKey | True | string |
Ein stabiler Bezeichner für diese Dateiversion. Verwenden Sie denselben Schlüssel, Bytes und Metadaten für Wiederholungen wieder. |
|
Dateiname
|
fileName | True | string |
Der ursprüngliche PDF- oder DOCX-Dateiname ohne Ordnerpfad. |
|
Dateiinhalt
|
contentBase64 | True | byte |
Die ursprünglichen Dateibytes, die in Base64 codiert wurden, genau einmal. Senden Sie extrahierten Text nicht. |
|
Dokumenttitel
|
title | True | string |
Der im Gestioo-Tresor angezeigte Titel. |
|
Access-Gruppen
|
accessGroupIds | True | array of string |
Bezeichner einer oder mehrerer Zugriffsgruppen, die von den Optionen zum Abrufen von Einzahlungen zurückgegeben werden. |
|
Klassifikationsrubrik
|
classificationRubricId | True | string |
Die autorisierte Klassifikationsrubrik für das Dokument. |
|
Kopiertyp
|
classificationCopyType | string |
Der Dokumentkopietyp. Verwenden Sie den Prinzipal für den primären Datensatz oder secondaire für eine sekundäre Kopie. |
|
|
Verwaltungseinheit
|
administrativeUnitId | string |
Die autorisierte Verwaltungseinheit, falls zutreffend. |
|
|
Aufbewahrungsereignisdatum
|
triggerEventAt | date-time |
Das Aufbewahrungsereignisdatum im ISO 8601-Format mit einer Zeitzone, wenn dies für die Klassifizierung erforderlich ist. |
Gibt zurück
- Body
- DepositStatus
Definitionen
DepositStatus
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Einzahlungs-ID
|
depositId | string |
Die Stabile Einzahlungsbestätigungs-ID. |
|
Dokument-ID
|
documentId | string |
Der Bezeichner, der für das hinterlegte Dokument reserviert ist. |
|
Status
|
status | string |
Der aktuelle Einzahlungsstatus. Nur archiviert bestätigt die erfolgreiche Archivierung. |
|
Archiviert unter
|
archivedAt | string |
Der Archivzeitstempel im ISO 8601-Format, verfügbar nach der Archivierung. |
|
Fehlercode
|
error | string |
Ein fehlersicherer Fehlercode, wenn die Einzahlung fehlgeschlagen ist. |
|
Nächste Aktion
|
nextAction | string |
Die nächste Aktion, die während der Verarbeitung des Dokuments erforderlich ist. |
|
Wiederholen nach Sekunden
|
retryAfterSeconds | integer |
Die Verzögerung vor dem Erneuten Überprüfen oder Anfordern der Archivierung. |