Отправка в Gestioo (предварительная версия)
Депозит PDF и Word документов в Gestioo с авторизованными группами доступа и классификацией записей, а затем подтвердите их архивацию в безопасном хранилище.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Standard | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Premium | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Premium | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Name | Поддержка Gestioo |
| URL-адрес | https://gestioo.co/contact |
| support@gestioo.co |
| Метаданные соединителя | |
|---|---|
| Publisher | Gestioo |
| Веб-сайт | https://gestioo.co |
| Политика конфиденциальности | https://gestioo.co/politique-confidentialite |
| Categories | Содержимое и файлы; Продуктивность |
Отправка в Gestioo
Gestioo помогает организациям управлять, классифицировать и архивировать свои документы в безопасном хранилище. Этот соединитель помещает PDF-файлы и Word документы с авторизованной классификацией и группами доступа пользователя, запрашивает архивирование и проверяет окончательный результат.
Publisher
Gestioo
Prerequisites
- Активная организация Gestioo и Microsoft рабочей учетной записи, авторизованной этой организацией для создания документов и доступа к хранилищу.
- Лицензия Power Automate, которая охватывает соединители Premium и разрешение на использование соединителя в политиках данных вашей организации.
- Для локального Windows файлового сервера настроенный Microsoft локальный шлюз данных и подключение файловой системы или существующий рабочий поток, предоставляющий содержимое файла. Шлюз обращается к локальным файлам; Соединитель Gestioo вызывает Gestioo по протоколу HTTPS.
Для передачи документов не требуется база данных Dataverse или Power BI. Power BI может сообщать о регистре импорта, поддерживаемом собственным рабочим процессом.
Поддерживаемые операции
| Операция | Purpose |
|---|---|
| Получение параметров депозита | Получите группы доступа, классификации, административные единицы и ограничение отправки, доступное пользователю, вошедшего в систему. |
| Создание депозита | Отправьте PDF-файл или DOCX со своими метаданными и стабильным ключом идемпотентности. Возвращает квитанцию о депозите. |
| Получение состояния депозита | Проверьте квитанцию, созданную этим пользователем и соединителем. |
| Архивный депозит | Запрос архивирования документа с депозитом. Повторите это действие при выполнении обработки. |
Начало работы
- Выберите "Отправить в Gestioo", создайте подключение и войдите с помощью авторизованной учетной записи Microsoft рабочей учетной записи. Ваша организация Gestioo разрешается из этой учетной записи. Администратору может потребоваться утвердить доступ в соответствии с политикой согласия клиента.
- Запустите параметры получения депозита и выберите целевые группы классификации и доступа. Укажите дату события, когда для выбранной классификации требуется.
- Прочитайте содержимое файла и создайте устойчивый ключ идемпотентности для этой версии файла. Сохраните этот ключ перед первой отправкой и повторно используйте его для повторных попыток.
- Запустите создание депозита с исходным именем файла, заголовком, метаданными и байтами файлов, закодированными один раз как base64. Когда исходный соединитель возвращает двоичный объект, используйте его
$contentзначение. Сохраните возвращенныйdepositIdобъект. - Вызов архива депозита с этой квитанцией. Если состояние равно
receivingилиprocessing, подождитеretryAfterSeconds(15 секунд по умолчанию) и снова вызовите архивный депозит . Привязывание цикла, например к 240 итерациям и одному часу. - Подтверждает только
archivedзавершение. Запишите метку времени получения и архива в реестре импорта. Вfailed,interruptedили тайм-ауте, сохраните исходный файл и изучите существующую квитанцию.
Архивные запечатывают документ и необратимы. Настройте автоматическую архивацию только для файлов, утвержденных вашей организацией для этого назначения. Ограничьте начальные импорты до одного файла за раз и защитите входные и выходные данные в журнале выполнения потока.
Известные ограничения
- Поддерживаются PDF и DOCX. Gestioo принимает исходные файлы до 50 MiB; Соединители и шлюзы вышестоящего уровня могут налагать более низкие ограничения. Перед отправкой проверьте самое строгое ограничение во всем потоке.
- Word документы преобразуются в PDF. Исходный DOCX не сохраняется в качестве архивированного источника; сохраните исходный файл в исходной системе.
- Соединитель передает существующие файлы и метаданные. Он не сканирует файловый сервер, не диагностирует свою инфраструктуру или самостоятельно решает классификацию записей.
- Состояние
processingне означает, что документ находится в хранилище. Получение состояния депозита только наблюдает ход выполнения; Архивный депозит запрашивает печать после его обработки. - Повторное использование ключа с разными байтами или метаданными
409 idempotency_conflict. Не создавайте новый ключ автоматически после времени ожидания или потерянного ответа. - Доступ проверяется при каждом вызове. Удаление прав пользователя или членства в группах может остановить ранее подключенный поток.
- Среда Power Platform и исходная система определяют расположение данных на стороне Microsoft. Сертификация соединителей не гарантирует, что весь рабочий процесс размещается исключительно в Квебеке.
Troubleshooting
| Response | Действие |
|---|---|
| 401 | Повторно подключитесь к авторизованной Microsoft рабочей учетной записи. |
| 403 | Попросите администратора Gestioo проверить учетные записи, разрешения документа и хранилища и выбранные группы доступа. |
| 404 | Проверьте квитанцию и используйте тот же пользователь и соединитель, который создал его. |
| 409 | Сохраните существующий ключ квитанции и идемпотентности. Анализ состояния конфликта или документа. |
| 413 или 415 | Проверьте размер файла, расширение и фактическое содержимое. |
| 429 или 503 | Подождите и повторите попытку с той же квитанцией или одним идемпотентным ключом и полезными данными. |
Support
Обратитесь в службу поддержки Gestioo или по электронной почте support@gestioo.co. Укажите операцию, метку времени и безопасный код ошибки. Не отправлять учетные данные или содержимое документа в запросе на поддержку.
Условия использования · Политика конфиденциальности
Действия
| Архивирование депозита |
Запечатайте pdf-файл в защищенном хранилище с помощью текущих правил классификации и хранения. Архивация необратима. Повторите с тем же идентификатором депозита во время обработки и остановитесь на неудачном или прерванном состоянии. |
| Получение параметров депозита |
Получение групп доступа, рубрик классификации и административных единиц, доступных для подключенного пользователя. |
| Получение состояния депозита |
Проверьте депозит, созданный подключенным пользователем. Только архивный файл подтверждает доставку в безопасное хранилище. |
| Создание депозита |
Отправьте PDF-файл или Word документ с ключом стабильной версии файла. Word файлы преобразуются в PDF. Следуйте этому действию с помощью архивации депозита, пока состояние не заархивировано, и сохраните локальный исходный файл. |
Архивирование депозита
Запечатайте pdf-файл в защищенном хранилище с помощью текущих правил классификации и хранения. Архивация необратима. Повторите с тем же идентификатором депозита во время обработки и остановитесь на неудачном или прерванном состоянии.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор депозита
|
depositId | True | string |
Идентификатор депозита, возвращенный путем создания депозита. |
Возвращаемое значение
- Тело
- DepositStatus
Получение параметров депозита
Получение групп доступа, рубрик классификации и административных единиц, доступных для подключенного пользователя.
Возвращаемое значение
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Предприятие
|
organizationName | string |
Организация разрешена из учетной записи, вошедшего в систему. |
|
Максимальный размер отправки
|
maxUploadBytes | integer |
Максимальный исходный размер файла, принятый Gestioo в байтах. |
|
Поддерживаемые форматы
|
supportedFormats | array of string |
Поддерживаемые исходные расширения файлов. |
|
Авторизованные группы доступа
|
accessGroups | array of object |
Группы доступа, доступные для этой учетной записи. |
|
Идентификатор группы доступа
|
accessGroups.id | string |
Идентификатор авторизованной группы доступа. |
|
Французское имя
|
accessGroups.nameFr | string |
Имя группы доступа на французском языке. |
|
Название на английском языке
|
accessGroups.nameEn | string |
Имя группы доступа на английском языке. |
|
Выбор классификации
|
classifications | array of object |
Авторизованные разделы классификации и их требования к дате события. |
|
Идентификатор классификации
|
classifications.id | string |
Идентификатор авторизованной классификации. |
|
Метка классификации
|
classifications.label | string |
Код и заголовок. |
|
Требуется дата события
|
classifications.requiresEventDate | boolean |
Требуется ли классификация дата события хранения. |
|
Административные единицы
|
administrativeUnits | array of object |
Активные административные единицы в организации. |
|
Идентификатор административной единицы
|
administrativeUnits.id | string |
Идентификатор административной единицы. |
|
Название единицы
|
administrativeUnits.name | string |
Имя административной единицы. |
|
Ряд классификаций
|
classificationSeries | array of object |
Авторизованная иерархия классификации и метаданные хранения по умолчанию. |
|
Код серии
|
classificationSeries.seriesCode | string |
Код серии классификаций. |
|
Заголовок серии
|
classificationSeries.seriesTitle | string |
Заголовок серии классификаций. |
|
Рубрики
|
classificationSeries.rubrics | array of object |
Авторизованные рубрики в этой серии классификаций. |
|
Идентификатор rubric
|
classificationSeries.rubrics.id | string |
Идентификатор классификации. |
|
Код рубика
|
classificationSeries.rubrics.code | string |
Код классификации. |
|
Название rubric
|
classificationSeries.rubrics.title | string |
Заголовок классификации. |
|
Код серии
|
classificationSeries.rubrics.seriesCode | string |
Код родительской серии классификации. |
|
Заголовок серии
|
classificationSeries.rubrics.seriesTitle | string |
Заголовок родительской серии классификации. |
|
Код подсерий
|
classificationSeries.rubrics.subSeriesCode | string |
Код подсерии классификации при наличии. |
|
Заголовок дочерних программ
|
classificationSeries.rubrics.subSeriesTitle | string |
Название подсерий классификации при наличии. |
|
Необязательная функция
|
classificationSeries.rubrics.optionalFunction | string |
Необязательная функция классификации, если она доступна. |
|
Идентификатор правила хранения по умолчанию
|
classificationSeries.rubrics.defaultRetentionLineId | string |
Идентификатор правила хранения по умолчанию, если он доступен. |
|
Активный тип хранения
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
Тип активного периода хранения, если он доступен. |
|
Тип события хранения
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
Предлагаемый тип события хранения, если он доступен. |
Получение состояния депозита
Проверьте депозит, созданный подключенным пользователем. Только архивный файл подтверждает доставку в безопасное хранилище.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор депозита
|
depositId | True | string |
Идентификатор депозита, возвращенный путем создания депозита. |
Возвращаемое значение
- Тело
- DepositStatus
Создание депозита
Отправьте PDF-файл или Word документ с ключом стабильной версии файла. Word файлы преобразуются в PDF. Следуйте этому действию с помощью архивации депозита, пока состояние не заархивировано, и сохраните локальный исходный файл.
Параметры
| Имя. | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Ключ версии файла
|
idempotencyKey | True | string |
Стабильный идентификатор для этой версии файла. Повторно используйте один и тот же ключ, байты и метаданные при повторных попытках. |
|
Имя файла
|
fileName | True | string |
Исходное имя PDF-файла или DOCX без пути к папке. |
|
Содержимое файла
|
contentBase64 | True | byte |
Исходные байты файлов, закодированные в base64, ровно один раз. Не отправляйте извлеченный текст. |
|
Название документа
|
title | True | string |
Заголовок, отображаемый в хранилище Gestioo. |
|
Группы доступа
|
accessGroupIds | True | array of string |
Идентификаторы одной или нескольких групп доступа, возвращаемых параметрами получения депозита. |
|
Классификация рубрик
|
classificationRubricId | True | string |
Авторизованная классификация в документе. |
|
Тип копирования
|
classificationCopyType | string |
Тип копирования документа. Используйте субъект для основной записи или вторичная копия. |
|
|
Административная единица
|
administrativeUnitId | string |
Авторизованная административная единица, если применимо. |
|
|
Дата события хранения
|
triggerEventAt | date-time |
Дата события хранения в формате ISO 8601 с часовой поясом, если требуется классификация. |
Возвращаемое значение
- Тело
- DepositStatus
Определения
DepositStatus
| Имя. | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор депозита
|
depositId | string |
Стабильный идентификатор получения депозита. |
|
Код документа
|
documentId | string |
Идентификатор, зарезервированный для отложенного документа. |
|
Status
|
status | string |
Текущее состояние депозита. Архивированный файл подтверждает успешное архивирование. |
|
Архивировано в
|
archivedAt | string |
Метка времени архива в формате ISO 8601 доступна после архивации. |
|
Код ошибки
|
error | string |
Безопасный код ошибки при сбое депозита. |
|
Дальнейшие действия
|
nextAction | string |
Следующее действие, необходимое во время обработки документа. |
|
Повторите попытку через секунды
|
retryAfterSeconds | integer |
Задержка перед проверкой или запросом архивации снова. |