Wyślij do Gestioo (wersja zapoznawcza)
Zdeponuj pliki PDF i Word dokumenty do gestioo z autoryzowanymi grupami dostępu i klasyfikacją rekordów, a następnie potwierdź ich archiwizację w bezpiecznym magazynie.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate - narzędzie do automatyzacji procesów | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt biznesowy | |
|---|---|
| Name | Obsługa gestioo |
| adres URL | https://gestioo.co/contact |
| support@gestioo.co |
| Metadane łącznika | |
|---|---|
| Publisher | Gestioo |
| Witryna internetowa | https://gestioo.co |
| Zasady ochrony prywatności | https://gestioo.co/politique-confidentialite |
| Kategorie | Zawartość i pliki; Produktywność |
Wyślij do Gestioo
Gestioo pomaga organizacjom zarządzać, klasyfikować i archiwizować swoje dokumenty w bezpiecznym magazynie. Ten łącznik zapisuje pliki PDF i Word dokumenty z autoryzowaną klasyfikacją i grupami dostępu użytkownika, żąda archiwizacji i sprawdza końcowy wynik.
Publisher
Gestioo
Prerequisites
- Aktywna organizacja Gestioo i konto służbowe Microsoft autoryzowane przez organizację do tworzenia dokumentów i uzyskiwania dostępu do magazynu.
- Licencja Power Automate obejmująca łączniki Premium i uprawnienia do korzystania z łącznika w ramach zasad danych organizacji.
- W przypadku lokalnego serwera plików Windows skonfigurowany Microsoft lokalnej bramy danych i połączenia systemu plików lub istniejącego przepływu pulpitu dostarczającego zawartość pliku. Brama uzyskuje dostęp do plików lokalnych; Łącznik Gestioo wywołuje gestioo za pośrednictwem protokołu HTTPS.
Transfer dokumentów nie wymaga bazy danych Dataverse ani Power BI. Power BI może zgłaszać rejestr importu obsługiwany przez własny przepływ pracy.
Obsługiwane operacje
| Operation | Purpose |
|---|---|
| Pobieranie opcji depozytu | Pobierz grupy dostępu, klasyfikacje, jednostki administracyjne i limit przekazywania dostępny dla zalogowanych użytkowników. |
| Tworzenie depozytu | Przekaż plik PDF lub DOCX z jego metadanymi i stabilnym kluczem idempotentności. Zwraca potwierdzenie depozytowe. |
| Uzyskiwanie stanu depozytu | Sprawdź potwierdzenie utworzone przez tego użytkownika i łącznika. |
| Zarchiwizowane depozyty | Zażądaj archiwizacji zdeponowanego dokumentu. Powtórz tę akcję, gdy przetwarzanie jest nadal w toku. |
Rozpoczęcie pracy
- Wybierz pozycję Wyślij do gestioo, utwórz połączenie i zaloguj się przy użyciu autoryzowanego konta służbowego Microsoft. Twoja organizacja Gestioo jest rozpoznawana z tego konta. Administrator może wymagać zatwierdzenia dostępu w ramach zasad zgody dzierżawy.
- Uruchom polecenie Pobierz opcje depozytu i wybierz docelową klasyfikację i grupy dostępu. Podaj datę zdarzenia, gdy wymagana jest wybrana klasyfikacja.
- Przeczytaj zawartość pliku i utwórz trwały klucz idempotentności dla tej wersji pliku. Zapisz ten klucz przed pierwszym przekazaniem i użyj go ponownie do ponownych prób.
- Uruchom polecenie Utwórz depozyt z oryginalną nazwą pliku, tytułem, metadanymi i bajtami pliku zakodowanymi raz jako base64. Gdy łącznik źródłowy zwraca obiekt binarny, użyj jego
$contentwartości. Zapisz zwróconydepositIdelement . - Zadzwoń do depozytu Archiwum z tym potwierdzeniem. Jeśli stan to
receivinglubprocessing, poczekajretryAfterSeconds(domyślnie 15 sekund) i ponownie wywołaj depozyt Archiwum . Powiązana pętla, na przykład do 240 iteracji i jednej godziny. - Potwierdza tylko
archivedukończenie. Zarejestruj znacznik czasu paragonu i archiwum w rejestrze importu. W przypadkufailedwartości ,interruptedlub limitu czasu zachowaj oryginał i zbadaj istniejące potwierdzenie.
Archiwalne uszczelnia dokument i jest nieodwracalne. Skonfiguruj automatyczne archiwizowanie tylko dla plików zatwierdzonych przez organizację dla tego miejsca docelowego. Ogranicz początkowe importowanie do jednego pliku jednocześnie i chroń dane wejściowe i wyjściowe pliku w historii uruchamiania przepływu.
Znane ograniczenia
- Obsługiwane są pliki PDF i DOCX. Gestioo akceptuje oryginalne pliki do 50 MiB; łączniki nadrzędne i bramy mogą nakładać niższe limity. Przed przekazaniem sprawdź najbardziej rygorystyczny limit w całym przepływie.
- Word dokumenty są konwertowane na format PDF. Oryginalny dokument DOCX nie jest zachowywany jako zarchiwizowane źródło; zachowaj oryginalny plik w systemie źródłowym.
- Łącznik przesyła istniejące pliki i metadane. Nie skanuje serwera plików, diagnozuje infrastrukturę ani nie decyduje o klasyfikacji rekordów samodzielnie.
- Stan
processingnie oznacza, że dokument znajduje się w magazynie. Pobieranie stanu depozytu obserwuje tylko postęp; Archiwizacja depozytów żąda pieczęć po jego przetworzeniu. - Ponowne użycie klucza z różnymi bajtami lub metadanymi zwraca wartość
409 idempotency_conflict. Nie generuj nowego klucza automatycznie po przekroczeniu limitu czasu lub utraconej odpowiedzi. - Dostęp jest sprawdzany przy każdym wywołaniu. Usunięcie praw użytkownika lub członkostwa w grupie może zatrzymać wcześniej połączony przepływ.
- Środowisko platformy Power Platform i system źródłowy określają lokalizację danych po stronie Microsoft. Certyfikacja łącznika nie gwarantuje, że cały przepływ pracy jest hostowany wyłącznie w Quebecu.
Troubleshooting
| Odpowiedź | Akcja |
|---|---|
| 401 | Ponownie nawiązuj połączenie z autoryzowanym kontem służbowym Microsoft. |
| 403 | Poproś administratora Gestioo o zweryfikowanie uprawnień konta, dokumentu i magazynu oraz wybranych grup dostępu. |
| 404 | Sprawdź potwierdzenie i użyj tego samego użytkownika i łącznika, który go utworzył. |
| 409 | Zachowaj istniejące potwierdzenie i klucz idempotentności. Zbadaj zgłoszony konflikt lub stan dokumentu. |
| 413 lub 415 | Sprawdź rozmiar pliku, rozszerzenie i rzeczywistą zawartość. |
| 429 lub 503 | Poczekaj i ponów próbę przy użyciu tego samego potwierdzenia lub tego samego klucza idempotentności i ładunku. |
Support
Skontaktuj się z pomocą techniczną gestioo lub wyślij wiadomość e-mail na adres . support@gestioo.co Podaj operację, sygnaturę czasową i bezpieczny kod błędu. Nie wysyłaj poświadczeń ani zawartości dokumentu w żądaniu pomocy technicznej.
Warunki użytkowania · Zasady ochrony prywatności
Akcje
| Archiwizowanie depozytu |
Przypieczętuj zdeponowany plik PDF w bezpiecznym magazynie przy użyciu bieżących reguł klasyfikacji i przechowywania. Archiwizacja jest nieodwracalna. Powtórz ten sam identyfikator depozytu podczas przetwarzania i zatrzymaj się po awarii lub przerwaniu. |
| Pobieranie opcji depozytu |
Pobierz grupy dostępu, rubryk klasyfikacji i jednostki administracyjne dostępne dla połączonego użytkownika. |
| Tworzenie depozytu |
Przekaż dokument PDF lub Word ze stabilnym kluczem wersji pliku. Word pliki są konwertowane na format PDF. Postępuj zgodnie z tą akcją, aby zarchiwizować depozyt, dopóki stan nie zostanie zarchiwizowany i zachowaj lokalny oryginał. |
| Uzyskiwanie stanu depozytu |
Sprawdź depozyt utworzony przez połączonego użytkownika. Tylko zarchiwizowane potwierdza dostarczanie do bezpiecznego magazynu. |
Archiwizowanie depozytu
Przypieczętuj zdeponowany plik PDF w bezpiecznym magazynie przy użyciu bieżących reguł klasyfikacji i przechowywania. Archiwizacja jest nieodwracalna. Powtórz ten sam identyfikator depozytu podczas przetwarzania i zatrzymaj się po awarii lub przerwaniu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator depozytu
|
depositId | True | string |
Identyfikator depozytu zwrócony przez utworzenie depozytu. |
Zwraca
- Body
- DepositStatus
Pobieranie opcji depozytu
Pobierz grupy dostępu, rubryk klasyfikacji i jednostki administracyjne dostępne dla połączonego użytkownika.
Zwraca
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Organizacja
|
organizationName | string |
Organizacja została rozwiązana z zalogowanego konta. |
|
Maksymalny rozmiar przekazywania
|
maxUploadBytes | integer |
Maksymalny rozmiar oryginalnego pliku zaakceptowany przez gestioo w bajtach. |
|
Obsługiwane formaty
|
supportedFormats | array of string |
Obsługiwane oryginalne rozszerzenia plików. |
|
Autoryzowane grupy dostępu
|
accessGroups | array of object |
Grupy dostępu dostępne dla tego konta. |
|
Identyfikator grupy dostępu
|
accessGroups.id | string |
Identyfikator autoryzowanej grupy dostępu. |
|
Nazwa francuska
|
accessGroups.nameFr | string |
Nazwa grupy dostępu w języku francuskim. |
|
Nazwa angielska
|
accessGroups.nameEn | string |
Nazwa grupy dostępu w języku angielskim. |
|
Opcje klasyfikacji
|
classifications | array of object |
Autoryzowane rubryki klasyfikacji i ich wymagania dotyczące daty zdarzenia. |
|
Identyfikator rubryk klasyfikacji
|
classifications.id | string |
Autoryzowany identyfikator rubryk klasyfikacji. |
|
Etykieta klasyfikacji
|
classifications.label | string |
Kod i tytuł rubryki. |
|
Wymagana data zdarzenia
|
classifications.requiresEventDate | boolean |
Czy klasyfikacja wymaga daty zdarzenia przechowywania. |
|
Jednostki administracyjne
|
administrativeUnits | array of object |
Aktywne jednostki administracyjne w organizacji. |
|
Identyfikator jednostki administracyjnej
|
administrativeUnits.id | string |
Identyfikator jednostki administracyjnej. |
|
Nazwa jednostki
|
administrativeUnits.name | string |
Nazwa jednostki administracyjnej. |
|
Seria klasyfikacji
|
classificationSeries | array of object |
Autoryzowana hierarchia klasyfikacji i domyślne metadane przechowywania. |
|
Kod serii
|
classificationSeries.seriesCode | string |
Kod serii klasyfikacji. |
|
Tytuł serii
|
classificationSeries.seriesTitle | string |
Tytuł serii klasyfikacji. |
|
Rubryki
|
classificationSeries.rubrics | array of object |
Autoryzowane rubryki w tej serii klasyfikacji. |
|
Identyfikator rubryk
|
classificationSeries.rubrics.id | string |
Identyfikator rubryk klasyfikacji. |
|
Kod rubryk
|
classificationSeries.rubrics.code | string |
Kod rubryk klasyfikacji. |
|
Tytuł rubryki
|
classificationSeries.rubrics.title | string |
Tytuł rubryk klasyfikacji. |
|
Kod serii
|
classificationSeries.rubrics.seriesCode | string |
Kod serii klasyfikacji nadrzędnej. |
|
Tytuł serii
|
classificationSeries.rubrics.seriesTitle | string |
Tytuł nadrzędnej serii klasyfikacji. |
|
Kod podserów
|
classificationSeries.rubrics.subSeriesCode | string |
Kod podserów klasyfikacji, jeśli jest dostępny. |
|
Tytuł podserów
|
classificationSeries.rubrics.subSeriesTitle | string |
Tytuł podserień klasyfikacji, jeśli jest dostępny. |
|
Opcjonalna funkcja
|
classificationSeries.rubrics.optionalFunction | string |
Opcjonalna funkcja klasyfikacji, jeśli jest dostępna. |
|
Domyślny identyfikator reguły przechowywania
|
classificationSeries.rubrics.defaultRetentionLineId | string |
Domyślny identyfikator reguły przechowywania, jeśli jest dostępny. |
|
Typ aktywnego przechowywania
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
Typ aktywnego okresu przechowywania, jeśli jest dostępny. |
|
Typ zdarzenia przechowywania
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
Sugerowany typ zdarzenia przechowywania, jeśli jest dostępny. |
Tworzenie depozytu
Przekaż dokument PDF lub Word ze stabilnym kluczem wersji pliku. Word pliki są konwertowane na format PDF. Postępuj zgodnie z tą akcją, aby zarchiwizować depozyt, dopóki stan nie zostanie zarchiwizowany i zachowaj lokalny oryginał.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz wersji pliku
|
idempotencyKey | True | string |
Stabilny identyfikator dla tej wersji pliku. Ponownie użyj tego samego klucza, bajtów i metadanych w ponownych próbach. |
|
Nazwa pliku
|
fileName | True | string |
Oryginalna nazwa pliku PDF lub DOCX bez ścieżki folderu. |
|
Zawartość pliku
|
contentBase64 | True | byte |
Oryginalne bajty pliku zakodowane w base64 dokładnie raz. Nie wysyłaj wyodrębnionego tekstu. |
|
Tytuł dokumentu
|
title | True | string |
Tytuł wyświetlany w magazynie Gestioo. |
|
Grupy dostępu
|
accessGroupIds | True | array of string |
Identyfikatory co najmniej jednej grupy dostępu zwracanej przez opcje pobierania depozytu. |
|
Rubryk klasyfikacji
|
classificationRubricId | True | string |
Autoryzowane rubryki klasyfikacji dla dokumentu. |
|
Typ kopii
|
classificationCopyType | string |
Typ kopiowania dokumentu. Użyj podmiotu zabezpieczeń dla rekordu podstawowego lub drugiego serwera dla kopii pomocniczej. |
|
|
Jednostka administracyjna
|
administrativeUnitId | string |
Autoryzowana jednostka administracyjna, jeśli ma to zastosowanie. |
|
|
Data zdarzenia przechowywania
|
triggerEventAt | date-time |
Data zdarzenia przechowywania w formacie ISO 8601 ze strefą czasową, jeśli jest wymagana przez klasyfikację. |
Zwraca
- Body
- DepositStatus
Uzyskiwanie stanu depozytu
Sprawdź depozyt utworzony przez połączonego użytkownika. Tylko zarchiwizowane potwierdza dostarczanie do bezpiecznego magazynu.
Parametry
| Nazwisko | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator depozytu
|
depositId | True | string |
Identyfikator depozytu zwrócony przez utworzenie depozytu. |
Zwraca
- Body
- DepositStatus
Definicje
DepositStatus
| Nazwisko | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator depozytu
|
depositId | string |
Stabilny identyfikator paragonu depozytowego. |
|
Identyfikator dokumentu
|
documentId | string |
Identyfikator zarezerwowany dla zdeponowanego dokumentu. |
|
Status
|
status | string |
Bieżący stan depozytu. Tylko zarchiwizowane potwierdza pomyślne archiwizowanie. |
|
Zarchiwizowane pod adresem
|
archivedAt | string |
Sygnatura czasowa archiwum w formacie ISO 8601 dostępna po archiwizacji. |
|
Kod błędu
|
error | string |
Bezpieczny kod błędu, gdy depozyt zakończył się niepowodzeniem. |
|
Następna akcja
|
nextAction | string |
Następna akcja wymagana podczas przetwarzania dokumentu. |
|
Ponów próbę po sekundach
|
retryAfterSeconds | integer |
Opóźnienie przed ponownym sprawdzeniem lub żądaniem archiwizacji. |