Skicka till Gestioo (förhandsversion)
Sätt in PDF och Word dokument i Gestioo med auktoriserad åtkomstgrupper och postklassificering och bekräfta sedan deras arkivering i det säkra valvet.
Den här anslutningsappen är tillgänglig i följande produkter och regioner:
| Tjänst | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Logiska appar | Standard | Alla Logic Apps-regioner utom följande: - Azure Government regioner - Azure kinaregioner - US Department of Defense (DoD) |
| Power Apps | Premium | Alla Power Apps regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alla Power Automate regioner förutom följande: - Amerikanska myndigheter (GCC) - Amerikanska myndigheter (GCC High) – China Cloud drivs av 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | Gestioo-support |
| URL | https://gestioo.co/contact |
| support@gestioo.co |
| Metadata för anslutningsprogram | |
|---|---|
| Publisher | Gestioo |
| Webbplats | https://gestioo.co |
| Sekretesspolicy | https://gestioo.co/politique-confidentialite |
| Kategorier | Innehåll och filer; Produktivitet |
Skicka till Gestioo
Gestioo hjälper organisationer att hantera, klassificera och arkivera sina dokument i ett säkert valv. Den här anslutningsappen sätter in PDF- och Word-dokument med användarens auktoriserade klassificerings- och åtkomstgrupper, begär arkivering och kontrollerar slutresultatet.
Publisher
Gestioo
Prerequisites
- En aktiv Gestioo-organisation och ett Microsoft arbetskonto som godkänts av organisationen för att skapa dokument och få åtkomst till dess valv.
- En Power Automate licens som omfattar Premium-anslutningsappar och behörighet att använda anslutningsappen under organisationens dataprinciper.
- För en lokal Windows filserver, en konfigurerad Microsoft lokal datagateway och filsystemanslutning eller ett befintligt skrivbordsflöde som tillhandahåller filinnehållet. Gatewayen kommer åt dina lokala filer. Gestioo-anslutningsappen anropar Gestioo via HTTPS.
Dokumentöverföringen kräver inte någon Dataverse-databas eller Power BI. Power BI kan rapportera om ett importregister som underhålls av ditt eget arbetsflöde.
Åtgärder som stöds
| Operation | Syfte |
|---|---|
| Hämta insättningsalternativ | Hämta åtkomstgrupper, klassificeringar, administrativa enheter och uppladdningsgränsen som är tillgänglig för den inloggade användaren. |
| Skapa insättning | Ladda upp en PDF eller DOCX med dess metadata och en stabil idempotensnyckel. Returnerar ett depositionskvitto. |
| Hämta insättningsstatus | Kontrollera ett kvitto som skapats av den här användaren och anslutningsappen. |
| Arkivinsättning | Begär arkivering av det deponerade dokumentet. Upprepa den här åtgärden när bearbetningen fortfarande pågår. |
Komma igång
- Välj Skicka till Gestioo, skapa en anslutning och logga in med ditt auktoriserade Microsoft arbetskonto. Din Gestioo-organisation löses från det kontot. En administratör kan behöva godkänna åtkomst enligt klientorganisationens medgivandeprincip.
- Kör Hämta insättningsalternativ och välj målklassificering och åtkomstgrupper. Ange ett händelsedatum när den valda klassificeringen kräver det.
- Läs filinnehållet och skapa en varaktig idempotensnyckel för den här filversionen. Lagra nyckeln före den första uppladdningen och återanvänd den för återförsök.
- Kör Skapa insättning med det ursprungliga filnamnet, rubriken, metadata och filbyte som kodas en gång som base64. När källanslutningsappen returnerar ett binärt objekt använder du dess
$contentvärde. Lagra den returneradedepositId. - Ring arkivdepositionen med kvittot. Om statusen är
receivingellerprocessingväntar duretryAfterSeconds(15 sekunder som standard) och anropar Arkivinsättning igen. Bind loopen, till exempel till 240 iterationer och en timme. - Bekräftar bara
archivedslutförandet. Registrera tidsstämpeln för kvittot och arkivet i importregistret. Vidfailed,interruptedeller timeout behåller du originalet och undersöker det befintliga kvittot.
Arkivering förseglar dokumentet och kan inte ångras. Konfigurera endast automatisk arkivering för filer som din organisation har godkänt för målet. Begränsa inledande importer till en fil i taget och skydda filindata och utdata i flödeskörningshistoriken.
Kända begränsningar
- PDF och DOCX stöds. Gestioo accepterar ursprungliga filer upp till 50 MiB; överordnad anslutningsapp och gateway kan införa lägre gränser. Kontrollera den striktaste gränsen i hela flödet innan du laddar upp.
- Word dokument konverteras till PDF. Den ursprungliga DOCX-filen behålls inte som den arkiverade källan. behålla den ursprungliga filen i källsystemet.
- Anslutningsappen överför befintliga filer och metadata. Den söker inte igenom en filserver, diagnostiserar dess infrastruktur eller bestämmer en postklassificering på egen hand.
- Statusen
processingbetyder inte att dokumentet finns i valvet. Få insättningsstatus observerar bara förloppet; Arkivdeposition begär förseglingen när bearbetningen tillåter det. - Återanvändning av en nyckel med olika byte eller metadata returnerar
409 idempotency_conflict. Generera inte en ny nyckel automatiskt efter en timeout eller ett förlorat svar. - Åtkomst kontrolleras vid varje samtal. Om användarens rättigheter eller gruppmedlemskap tas bort kan ett tidigare anslutet flöde stoppas.
- Power Platform-miljön och källsystemet avgör den Microsoft dataplatsen. Anslutningscertifiering garanterar inte att hela arbetsflödet finns exklusivt i Quebec.
Troubleshooting
| Svar | Action |
|---|---|
| 401 | Återansluta med ett auktoriserat Microsoft arbetskonto. |
| 403 | Be Gestioo-administratören att verifiera behörigheterna för konto, dokument och valv och valda åtkomstgrupper. |
| 404 | Kontrollera kvittot och använd samma användare och anslutningsapp som skapade det. |
| 409 | Bevara den befintliga kvitto- och idempotensnyckeln. Undersök den rapporterade konflikten eller dokumenttillståndet. |
| 413 eller 415 | Kontrollera filstorlek, filnamnstillägg och faktiskt innehåll. |
| 429 eller 503 | Vänta och försök igen med samma kvitto eller samma idempotensnyckel och nyttolast. |
Support
Kontakta Gestioo-supporten eller e-post support@gestioo.co. Ange åtgärd, tidsstämpel och säker felkod. Skicka inte autentiseringsuppgifter eller dokumentinnehåll i en supportbegäran.
Användningsvillkor · Sekretesspolicy
Åtgärder
| Arkivera en insättning |
Försegla den deponerade PDF-filen i det säkra valvet med hjälp av dess aktuella klassificerings- och kvarhållningsregler. Arkivering går inte att ångra. Upprepa med samma insättnings-ID under bearbetningen och stoppa vid misslyckade eller avbrutna. |
| Hämta insättningsalternativ |
Hämta åtkomstgrupper, klassificerings rubrics och administrativa enheter som är tillgängliga för den anslutna användaren. |
| Hämta insättningsstatus |
Kontrollera en insättning som skapats av den anslutna användaren. Endast arkiverad bekräftar leveransen till det säkra valvet. |
| Skapa en insättning |
Ladda upp ett PDF- eller Word dokument med en stabil filversionsnyckel. Word filer konverteras till PDF. Följ den här åtgärden med Arkivera en insättning tills statusen har arkiverats och behåll det lokala originalet. |
Arkivera en insättning
Försegla den deponerade PDF-filen i det säkra valvet med hjälp av dess aktuella klassificerings- och kvarhållningsregler. Arkivering går inte att ångra. Upprepa med samma insättnings-ID under bearbetningen och stoppa vid misslyckade eller avbrutna.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Insättnings-ID
|
depositId | True | string |
Det insättnings-ID som returneras av Skapa en insättning. |
Returer
- Body
- DepositStatus
Hämta insättningsalternativ
Hämta åtkomstgrupper, klassificerings rubrics och administrativa enheter som är tillgängliga för den anslutna användaren.
Returer
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Organization
|
organizationName | string |
Organisationen löstes från det inloggade kontot. |
|
Maximal uppladdningsstorlek
|
maxUploadBytes | integer |
Den maximala ursprungliga filstorleken som godkänts av Gestioo, i byte. |
|
Format som stöds
|
supportedFormats | array of string |
Originalfilnamnstilläggen som stöds. |
|
Auktoriserade åtkomstgrupper
|
accessGroups | array of object |
De åtkomstgrupper som är tillgängliga för det här kontot. |
|
Åtkomstgrupps-ID
|
accessGroups.id | string |
Identifieraren för den auktoriserade åtkomstgruppen. |
|
Franskt namn
|
accessGroups.nameFr | string |
Namnet på åtkomstgruppen på franska. |
|
Engelskt namn
|
accessGroups.nameEn | string |
Namnet på åtkomstgruppen på engelska. |
|
Klassificeringsalternativ
|
classifications | array of object |
De auktoriserade klassificeringskriteriet och deras krav på händelsedatum. |
|
Klassificerings-ID
|
classifications.id | string |
Den auktoriserade klassificerings-ID:en. |
|
Klassificeringsetikett
|
classifications.label | string |
Kod och rubrik för kriteriet. |
|
Händelsedatum krävs
|
classifications.requiresEventDate | boolean |
Om klassificeringen kräver ett kvarhållningshändelsedatum. |
|
Administrativa enheter
|
administrativeUnits | array of object |
De aktiva administrativa enheterna i organisationen. |
|
Administrativt enhets-ID
|
administrativeUnits.id | string |
Identifieraren för den administrativa enheten. |
|
Enhetsnamn
|
administrativeUnits.name | string |
Namnet på den administrativa enheten. |
|
Klassificeringsserier
|
classificationSeries | array of object |
Den auktoriserade klassificeringshierarkin och standardmetadata för kvarhållning. |
|
Seriekod
|
classificationSeries.seriesCode | string |
Klassificeringsseriekoden. |
|
Serietitel
|
classificationSeries.seriesTitle | string |
Klassificeringsserierubriken. |
|
Bedömningsmatriser
|
classificationSeries.rubrics | array of object |
De auktoriserade kriterierna i den här klassificeringsserien. |
|
Rubric ID
|
classificationSeries.rubrics.id | string |
Klassificeringskriteriets ID. |
|
Kod för kriterier
|
classificationSeries.rubrics.code | string |
Klassificeringskriteriets kod. |
|
Rubrik för rubric
|
classificationSeries.rubrics.title | string |
Klassificeringskriteriets rubrik. |
|
Seriekod
|
classificationSeries.rubrics.seriesCode | string |
Den överordnade klassificeringsseriekoden. |
|
Serietitel
|
classificationSeries.rubrics.seriesTitle | string |
Rubrik för den överordnade klassificeringsserien. |
|
Underseriekod
|
classificationSeries.rubrics.subSeriesCode | string |
Klassificeringens underseriekod, när den är tillgänglig. |
|
Underserierubrik
|
classificationSeries.rubrics.subSeriesTitle | string |
Klassificeringsunderseriens rubrik, när den är tillgänglig. |
|
Valfri funktion
|
classificationSeries.rubrics.optionalFunction | string |
Den valfria klassificeringsfunktionen när den är tillgänglig. |
|
Standardregel-ID för kvarhållning
|
classificationSeries.rubrics.defaultRetentionLineId | string |
Standardidentifierare för kvarhållningsregel när det är tillgängligt. |
|
Aktiv kvarhållningstyp
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
Typen av aktiv kvarhållningsperiod, när den är tillgänglig. |
|
Typ av kvarhållningshändelse
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
Den föreslagna kvarhållningshändelsetypen när den är tillgänglig. |
Hämta insättningsstatus
Kontrollera en insättning som skapats av den anslutna användaren. Endast arkiverad bekräftar leveransen till det säkra valvet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Insättnings-ID
|
depositId | True | string |
Det insättnings-ID som returneras av Skapa en insättning. |
Returer
- Body
- DepositStatus
Skapa en insättning
Ladda upp ett PDF- eller Word dokument med en stabil filversionsnyckel. Word filer konverteras till PDF. Följ den här åtgärden med Arkivera en insättning tills statusen har arkiverats och behåll det lokala originalet.
Parametrar
| Name | Nyckel | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
Filversionsnyckel
|
idempotencyKey | True | string |
En stabil identifierare för den här filversionen. Återanvänd samma nyckel, byte och metadata vid återförsök. |
|
Filnamn
|
fileName | True | string |
Det ursprungliga PDF- eller DOCX-filnamnet utan mappsökväg. |
|
Filinnehåll
|
contentBase64 | True | byte |
De ursprungliga filbyte som kodas i base64 exakt en gång. Skicka inte extraherad text. |
|
Dokumentrubrik
|
title | True | string |
Rubriken som visas i Gestioo-valvet. |
|
Åtkomstgrupper
|
accessGroupIds | True | array of string |
Identifierare för en eller flera åtkomstgrupper som returneras av Hämta insättningsalternativ. |
|
Klassificerings rubric
|
classificationRubricId | True | string |
Det auktoriserade klassificeringskriteriet för dokumentet. |
|
Kopieringstyp
|
classificationCopyType | string |
Dokumentkopieringstypen. Använd huvudnamn för den primära posten eller secondaire för en sekundär kopia. |
|
|
Administrativ enhet
|
administrativeUnitId | string |
Den auktoriserade administrativa enheten, i förekommande fall. |
|
|
Datum för kvarhållningshändelse
|
triggerEventAt | date-time |
Datum för kvarhållningshändelse i ISO 8601-format med en tidszon, när det krävs av klassificeringen. |
Returer
- Body
- DepositStatus
Definitioner
DepositStatus
| Name | Sökväg | Typ | Description |
|---|---|---|---|
|
Insättnings-ID
|
depositId | string |
Den stabila identifieraren för inbetalningskvittot. |
|
Dokument-ID
|
documentId | string |
Identifieraren som är reserverad för det deponerade dokumentet. |
|
Status
|
status | string |
Det aktuella insättningstillståndet. Endast arkiverad bekräftar lyckad arkivering. |
|
Arkiverad på
|
archivedAt | string |
Tidsstämpeln för arkivet i ISO 8601-format, tillgänglig efter arkivering. |
|
Felkod
|
error | string |
En säker felkod när insättningen har misslyckats. |
|
Nästa åtgärd
|
nextAction | string |
Nästa åtgärd krävs när dokumentet bearbetas. |
|
Försök igen efter sekunder
|
retryAfterSeconds | integer |
Fördröjningen innan du kontrollerar eller begär arkivering igen. |