Küldés a Gestioo-ba (előzetes verzió)
Helyezzen el PDF-dokumentumokat és Word dokumentumokat a Gestioo-ba engedélyezett hozzáférési csoportokkal és rekordbesorolással, majd erősítse meg az archiválásukat a biztonságos tárolóban.
Ez az összekötő a következő termékekben és régiókban érhető el:
| Szolgáltatás | Class | Regions |
|---|---|---|
| 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 Apps | 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) |
| Kapcsolat | |
|---|---|
| Name | Gestioo-támogatás |
| URL | https://gestioo.co/contact |
| support@gestioo.co |
| Összekötő metaadatai | |
|---|---|
| Publisher | Gestioo |
| Webhely | https://gestioo.co |
| Adatvédelmi irányelvek | https://gestioo.co/politique-confidentialite |
| Categories | Tartalom és fájlok; Termelékenység |
Küldés a Gestioo-ba
A Gestioo segítségével a szervezetek biztonságos tárolóban kezelhetik, osztályozhatják és archiválhatják dokumentumaikat. Ez az összekötő pdf-dokumentumokat és Word dokumentumokat a felhasználó engedélyezett besorolási és hozzáférési csoportjaival, archiválási kéréseket küld, és ellenőrzi a végeredményt.
Publisher
Gestioo
Prerequisites
- Egy aktív Gestioo-szervezet és egy Microsoft munkahelyi fiók, amely jogosult a szervezet számára dokumentumok létrehozására és a tároló elérésére.
- A prémium szintű összekötőket lefedő Power Automate licenc, valamint a szervezet adatszabályzatai szerinti összekötő használatára vonatkozó engedély.
- Helyi Windows fájlkiszolgáló esetén egy konfigurált Microsoft helyszíni adatátjáró és fájlrendszer-kapcsolat, vagy egy meglévő asztali folyamat, amely biztosítja a fájltartalmat. Az átjáró hozzáfér a helyi fájlokhoz; A Gestioo-összekötő HTTPS-en keresztül hívja meg a Gestioo-t.
A dokumentumátvitelhez nincs szükség Dataverse-adatbázisra vagy Power BI. Power BI jelentést készíthet a saját munkafolyamata által kezelt importálási nyilvántartásról.
Támogatott műveletek
| Operation | Cél |
|---|---|
| Betéti lehetőségek lekérése | Szerezze be a bejelentkezett felhasználó számára elérhető hozzáférési csoportokat, besorolásokat, felügyeleti egységeket és feltöltési korlátot. |
| Betét létrehozása | Töltsön fel egy PDF-fájlt vagy DOCX-et a metaadataival és egy stabil idempotencia-kulccsal. Egy letéti nyugtát ad vissza. |
| Betéti állapot lekérése | Ellenőrizze a felhasználó és az összekötő által létrehozott visszaigazolást. |
| Archív letét | Kérje a letétbe helyezett dokumentum archiválását. Ismételje meg ezt a műveletet, ha a feldolgozás még folyamatban van. |
Kezdő lépések
- Válassza a Küldés a Gestioo-ba lehetőséget, hozzon létre egy kapcsolatot, és jelentkezzen be a jogosult Microsoft munkahelyi fiókjával. A Gestioo-szervezetet a rendszer ebből a fiókból oldja fel. Előfordulhat, hogy a rendszergazdának jóvá kell hagynia a hozzáférést a bérlő hozzájárulási szabályzata alapján.
- Futtassa a Befizetési lehetőségek lekérése parancsot , és válassza ki a célbesorolási és hozzáférési csoportokat. Adjon meg egy eseménydátumot, amikor a kiválasztott besorolás megköveteli.
- Olvassa el a fájl tartalmát, és hozzon létre egy tartós idempotencia-kulcsot ehhez a fájlverzióhoz. A kulcsot az első feltöltés előtt tárolja, és újrapróbálkozáshoz használja újra.
- Futtassa a Create deposit parancsot az eredeti fájlnévvel, címmel, metaadatokkal és egyszer base64-ként kódolt fájlbájtokkal. Amikor a forrás-összekötő bináris objektumot ad vissza, használja annak
$contentértékét. Tárolja a visszaadottdepositId. - Hívja meg az archív letétet ezzel a nyugtával. Ha az állapot vagy
receivingprocessing, várjon (alapértelmezés szerint 15 másodpercigretryAfterSeconds), és hívja meg újra az Archívum befizetését . A hurkot például 240 iterációra és egy órára kötötte. - Csak
archiveda befejezést erősíti meg. Rögzítse a nyugtát és az archiválási időbélyeget az importálási nyilvántartásban. Afailedbe-interruptedvagy időtúllépéskor tartsa meg az eredetit, és vizsgálja meg a meglévő nyugtát.
Az archiválás lezárja a dokumentumot, és visszafordíthatatlan. Csak a szervezet által jóváhagyott fájlok automatikus archiválását konfigurálja. A kezdeti importálást egyszerre egy fájlra korlátozhatja, és megvédheti a fájlbemeneteket és kimeneteket a folyamatfuttatási előzményekben.
Ismert korlátozások
- A PDF és a DOCX támogatott. A Gestioo legfeljebb 50 MiB-ig fogadja el az eredeti fájlokat; A felsőbb rétegbeli összekötők és átjárók alacsonyabb korlátokat szabhatnak. Feltöltés előtt ellenőrizze a teljes folyamat legszigorúbb korlátját.
- Word dokumentumok PDF-fájllá alakulnak. Az eredeti DOCX nem marad meg archivált forrásként; tárolja az eredeti fájlt a forrásrendszerben.
- Az összekötő átviszi a meglévő fájlokat és metaadatokat. Nem ellenőrzi a fájlkiszolgálót, nem diagnosztizálja az infrastruktúráját, és nem dönt önállóan egy rekordbesorolásról.
- Az állapot
processingnem jelenti azt, hogy a dokumentum a tárolóban van. A befizetési állapot lekérése csak az előrehaladást figyeli meg; Az archív letét kéri a pecsétet, ha a feldolgozás lehetővé teszi. - Kulcs újrafelhasználása különböző bájtokkal vagy metaadatokkal
409 idempotency_conflict. Ne hozzon létre automatikusan új kulcsot időtúllépés vagy elveszett válasz után. - A hozzáférés minden híváskor be van jelölve. A felhasználó jogosultságainak vagy csoporttagságának eltávolítása leállítja a korábban csatlakoztatott folyamatot.
- A Power Platform környezete és a forrásrendszer határozza meg a Microsoft oldali adathelyet. Az összekötőtanúsítvány nem garantálja, hogy a teljes munkafolyamat kizárólag Québecben üzemel.
Troubleshooting
| Válasz | Tevékenység |
|---|---|
| 401 | Csatlakozzon újra egy engedélyezett Microsoft munkahelyi fiókkal. |
| 403 | Kérje meg a Gestioo-rendszergazdát, hogy ellenőrizze a fiók- és dokumentum- és tárolóengedélyeket, valamint a kiválasztott hozzáférési csoportokat. |
| 404 | Ellenőrizze a visszaigazolást, és használja ugyanazt a felhasználót és összekötőt, aki létrehozta. |
| 409 | Őrizze meg a meglévő nyugtát és idempotenciakulcsot. Vizsgálja meg a jelentett ütközést vagy dokumentumállapotot. |
| 413 vagy 415 | Ellenőrizze a fájlméretet, a bővítményt és a tényleges tartalmat. |
| 429 vagy 503 | Várjon, és próbálkozzon újra ugyanazzal a nyugtával vagy ugyanazzal az idempotencia-kulccsal és hasznos adatokkal. |
Support
Lépjen kapcsolatba a Gestioo ügyfélszolgálatával vagy e-mailben support@gestioo.co. Adja meg a műveletet, az időbélyeget és a biztonságos hibakódot. Ne küldjön hitelesítő adatokat vagy dokumentumtartalmakat támogatási kérelemben.
Használati feltételek · Adatvédelmi szabályzat
Műveletek
| Betét létrehozása |
Töltsön fel egy PDF-dokumentumot vagy Word dokumentumot stabil fájlverziós kulccsal. Word fájlok PDF-fájllá alakulnak. Kövesse ezt a műveletet a letét archiválása mellett az állapot archiválásáig, és tartsa meg a helyi eredetit. |
| Betéti lehetőségek lekérése |
Szerezze be a csatlakoztatott felhasználó számára elérhető hozzáférési csoportokat, besorolási rubricákat és felügyeleti egységeket. |
| Betéti állapot lekérése |
Ellenőrizze a csatlakoztatott felhasználó által létrehozott letétet. Csak az archivált adatok erősítik meg a biztonságos tárolóba való kézbesítést. |
| Letét archiválása |
Az aktuális besorolási és megőrzési szabályokkal zárja le a biztonságos tárolóban elhelyezett PDF-fájlt. Az archiválás visszafordíthatatlan. Ismételje meg ugyanazt a betétazonosítót a feldolgozás során, és állítsa le a sikertelen vagy megszakított műveletet. |
Betét létrehozása
Töltsön fel egy PDF-dokumentumot vagy Word dokumentumot stabil fájlverziós kulccsal. Word fájlok PDF-fájllá alakulnak. Kövesse ezt a műveletet a letét archiválása mellett az állapot archiválásáig, és tartsa meg a helyi eredetit.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Fájlverzió kulcsa
|
idempotencyKey | True | string |
A fájlverzió stabil azonosítója. Használja újra ugyanazt a kulcsot, bájtot és metaadatokat az újrapróbálkozásokon. |
|
Fájlnév
|
fileName | True | string |
Az eredeti PDF- vagy DOCX-fájlnév mappaelérési út nélkül. |
|
Fájl tartalma
|
contentBase64 | True | byte |
Az eredeti fájl bájtja pontosan egyszer van kódolva a base64-ben. Ne küldjön kinyert szöveget. |
|
Dokumentum címe
|
title | True | string |
A Gestioo-tárolóban megjelenő cím. |
|
Hozzáférési csoportok
|
accessGroupIds | True | array of string |
A Get deposit options (Letéti lehetőségek lekérése) által visszaadott egy vagy több hozzáférési csoport azonosítója. |
|
Besorolási rubric
|
classificationRubricId | True | string |
A dokumentum engedélyezett besorolási rubrica. |
|
Másolás típusa
|
classificationCopyType | string |
A dokumentum másolási típusa. A másodlagos példány elsődleges rekordjának vagy másodpéldányának egyszerű használata. |
|
|
Felügyeleti egység
|
administrativeUnitId | string |
Adott esetben az engedélyezett felügyeleti egység. |
|
|
Adatmegőrzési esemény dátuma
|
triggerEventAt | date-time |
A megőrzési esemény dátuma ISO 8601 formátumban, időzónával, ha a besorolás megköveteli. |
Válaszok
- Törzs
- DepositStatus
Betéti lehetőségek lekérése
Szerezze be a csatlakoztatott felhasználó számára elérhető hozzáférési csoportokat, besorolási rubricákat és felügyeleti egységeket.
Válaszok
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
Szervezet
|
organizationName | string |
A szervezet a bejelentkezett fiókból oldódott fel. |
|
Feltöltés maximális mérete
|
maxUploadBytes | integer |
A Gestioo által elfogadott maximális eredeti fájlméret bájtban. |
|
Támogatott formátumok
|
supportedFormats | array of string |
A támogatott eredeti fájlkiterjesztések. |
|
Engedélyezett hozzáférési csoportok
|
accessGroups | array of object |
A fiókhoz elérhető hozzáférési csoportok. |
|
Hozzáférési csoport azonosítója
|
accessGroups.id | string |
Az engedélyezett hozzáférési csoport azonosítója. |
|
Francia név
|
accessGroups.nameFr | string |
A hozzáférési csoport neve franciául. |
|
Angol név
|
accessGroups.nameEn | string |
A hozzáférési csoport neve angol nyelven. |
|
Besorolási lehetőségek
|
classifications | array of object |
Az engedélyezett besorolási rubricák és azok eseménydátum-követelményei. |
|
Besorolási rubrica azonosítója
|
classifications.id | string |
Az engedélyezett besorolási rubric azonosító. |
|
Besorolási címke
|
classifications.label | string |
A rubric kód és a cím. |
|
Eseménydátum szükséges
|
classifications.requiresEventDate | boolean |
Azt jelzi, hogy a besorolás megőrzési eseménydátumot igényel-e. |
|
Felügyeleti egységek
|
administrativeUnits | array of object |
A szervezet aktív felügyeleti egységei. |
|
Felügyeleti egység azonosítója
|
administrativeUnits.id | string |
A felügyeleti egység azonosítója. |
|
Egység neve
|
administrativeUnits.name | string |
A felügyeleti egység neve. |
|
Besorolási sorozat
|
classificationSeries | array of object |
Az engedélyezett besorolási hierarchia és az alapértelmezett adatmegőrzési metaadatok. |
|
Sorozatkód
|
classificationSeries.seriesCode | string |
A besorolási sorozat kódja. |
|
Sorozat címe
|
classificationSeries.seriesTitle | string |
A besorolási sorozat címe. |
|
Rubrikák
|
classificationSeries.rubrics | array of object |
A besorolási sorozatban szereplő engedélyezett rubricák. |
|
Rubric-azonosító
|
classificationSeries.rubrics.id | string |
A besorolási rubric azonosító. |
|
Rubric-kód
|
classificationSeries.rubrics.code | string |
A besorolási rubric kód. |
|
Rubric cím
|
classificationSeries.rubrics.title | string |
A besorolási rubric címe. |
|
Sorozatkód
|
classificationSeries.rubrics.seriesCode | string |
A szülőbesorolási sorozat kódja. |
|
Sorozat címe
|
classificationSeries.rubrics.seriesTitle | string |
A szülőbesorolási sorozat címe. |
|
Almappák kódja
|
classificationSeries.rubrics.subSeriesCode | string |
A besorolási alkészletek kódja, ha elérhető. |
|
Almappák címe
|
classificationSeries.rubrics.subSeriesTitle | string |
A besorolási almappák címe, ha elérhető. |
|
Nem kötelező függvény
|
classificationSeries.rubrics.optionalFunction | string |
Az opcionális besorolási függvény, ha elérhető. |
|
Alapértelmezett adatmegőrzési szabály azonosítója
|
classificationSeries.rubrics.defaultRetentionLineId | string |
Az alapértelmezett adatmegőrzési szabály azonosítója, ha elérhető. |
|
Aktív adatmegőrzési típus
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
Az aktív megőrzési időszak típusa, ha elérhető. |
|
Adatmegőrzési esemény típusa
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
A javasolt adatmegőrzési eseménytípus, ha elérhető. |
Betéti állapot lekérése
Ellenőrizze a csatlakoztatott felhasználó által létrehozott letétet. Csak az archivált adatok erősítik meg a biztonságos tárolóba való kézbesítést.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Betét azonosítója
|
depositId | True | string |
A betét létrehozása által visszaadott betétazonosító. |
Válaszok
- Törzs
- DepositStatus
Letét archiválása
Az aktuális besorolási és megőrzési szabályokkal zárja le a biztonságos tárolóban elhelyezett PDF-fájlt. Az archiválás visszafordíthatatlan. Ismételje meg ugyanazt a betétazonosítót a feldolgozás során, és állítsa le a sikertelen vagy megszakított műveletet.
Paraméterek
| Név | Kulcs | Kötelező | Típus | Description |
|---|---|---|---|---|
|
Betét azonosítója
|
depositId | True | string |
A betét létrehozása által visszaadott betétazonosító. |
Válaszok
- Törzs
- DepositStatus
Definíciók
DepositStatus
| Név | Elérési út | Típus | Description |
|---|---|---|---|
|
Betét azonosítója
|
depositId | string |
A stabil betéti nyugta azonosítója. |
|
Dokumentumazonosító
|
documentId | string |
A letétbe helyezett dokumentum számára fenntartott azonosító. |
|
Status
|
status | string |
Az aktuális betéti állapot. Csak az archiváltak erősítik meg a sikeres archiválásokat. |
|
Archiválva:
|
archivedAt | string |
Az archív időbélyeg ISO 8601 formátumban, archiválás után érhető el. |
|
Hibakód
|
error | string |
Biztonságos hibakód, ha a befizetés meghiúsult. |
|
Következő művelet
|
nextAction | string |
A következő művelet szükséges a dokumentum feldolgozása során. |
|
Újrapróbálkozás másodpercek után
|
retryAfterSeconds | integer |
Az archiválás ismételt ellenőrzése vagy kérése előtti késés. |