Enviar para a Gestioo (versão prévia)
Deposite documentos em PDF e Word na Gestioo com grupos de acesso autorizados e classificação de registros e confirme seu arquivamento no cofre seguro.
Esse conector está disponível nos seguintes produtos e regiões:
| Serviço | Classe | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Azure Governamental regiões - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões Power Apps exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões Power Automate exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Name | Suporte à Gestioo |
| URL | https://gestioo.co/contact |
| support@gestioo.co |
| Metadados do conector | |
|---|---|
| Publicador | Gestioo |
| Website | https://gestioo.co |
| Política de privacidade | https://gestioo.co/politique-confidentialite |
| Categories | Conteúdo e arquivos; Produtividade |
Enviar para a Gestioo
A Gestioo ajuda as organizações a gerenciar, classificar e arquivar seus documentos em um cofre seguro. Esse conector deposita PDF e Word documentos com os grupos de acesso e classificação autorizados do usuário, solicita arquivamento e verifica o resultado final.
Publicador
Gestioo
Prerequisites
- Uma organização da Gestioo ativa e uma conta corporativa Microsoft autorizada por essa organização a criar documentos e acessar seu cofre.
- Uma licença Power Automate que abrange conectores Premium e permissão para usar o conector nas políticas de dados da sua organização.
- Para um servidor de arquivos de Windows local, um gateway de dados local Microsoft configurado e uma conexão do Sistema de Arquivos ou um fluxo de área de trabalho existente que fornece o conteúdo do arquivo. O gateway acessa seus arquivos locais; o conector gestioo chama Gestioo via HTTPS.
A transferência de documento não requer um banco de dados do Dataverse ou Power BI. Power BI pode relatar um registro de importação mantido por seu próprio fluxo de trabalho.
Operações com suporte
| Operation | Purpose |
|---|---|
| Obter opções de depósito | Obtenha os grupos de acesso, classificações, unidades administrativas e limite de upload disponíveis para o usuário conectado. |
| Criar depósito | Carregue um PDF ou DOCX com seus metadados e uma chave de idempotência estável. Retorna um recibo de depósito. |
| Obter o status do depósito | Verifique um recibo criado por este usuário e conector. |
| Depósito de arquivos | Solicitar arquivamento do documento depositado. Repita essa ação quando o processamento ainda estiver em andamento. |
Introdução
- Selecione Enviar para a Gestioo, crie uma conexão e entre com sua conta corporativa Microsoft autorizada. Sua organização gestioo foi resolvida com base nessa conta. Talvez um administrador precise aprovar o acesso sob a política de consentimento do locatário.
- Execute Obter opções de depósito e escolha os grupos de classificação e acesso de destino. Forneça uma data de evento quando a classificação selecionada exigir.
- Leia o conteúdo do arquivo e crie uma chave de idempotency durável para esta versão do arquivo. Armazene essa chave antes do primeiro upload e reutilize-a para novas tentativas.
- Execute Criar depósito com o nome do arquivo original, o título, os metadados e os bytes de arquivo codificados uma vez como base64. Quando o conector de origem retorna um objeto binário, use seu
$contentvalor. Armazene o retornadodepositId. - Chame o depósito de arquivo morto com esse recibo. Se o status for
receivingouprocessing, aguarderetryAfterSeconds(15 segundos por padrão) e chame o depósito de arquivo morto novamente. Acoplou o loop, por exemplo, a 240 iterações e uma hora. - Só
archivedconfirma a conclusão. Registre o carimbo de data/hora do recibo e do arquivo em seu registro de importação. Onfailed,interruptedou timeout, keep the original and investigate the existing receipt.
O arquivamento sela o documento e é irreversível. Configure o arquivamento automático somente para arquivos que sua organização aprovou para esse destino. Limite as importações iniciais para um arquivo de cada vez e proteja entradas e saídas de arquivo no histórico de execuções de fluxo.
Limitações conhecidas
- Há suporte para PDF e DOCX. A Gestioo aceita arquivos originais de até 50 MiB; Conectores upstream e gateways podem impor limites mais baixos. Verifique o limite mais estrito em todo o fluxo antes de carregar.
- Word documentos são convertidos em PDF. O DOCX original não é mantido como a origem arquivada; mantenha o arquivo original em seu sistema de origem.
- O conector transfere arquivos e metadados existentes. Ele não verifica um servidor de arquivos, diagnostica sua infraestrutura ou decide uma classificação de registros por si só.
- Um status de
processingnão significa que o documento está no cofre. Obter status de depósito observa apenas o progresso; O depósito de arquivos solicita o selo quando o processamento permite. - Reutilizando uma chave com bytes ou metadados diferentes retorna
409 idempotency_conflict. Não gere uma nova chave automaticamente após um tempo limite ou uma resposta perdida. - O acesso é verificado em todas as chamadas. A remoção dos direitos do usuário ou da associação de grupo pode interromper um fluxo conectado anteriormente.
- O ambiente e o sistema de origem do Power Platform determinam o local de dados do lado Microsoft. A certificação do conector não garante que todo o fluxo de trabalho esteja hospedado exclusivamente no Quebec.
Troubleshooting
| Resposta | Ação |
|---|---|
| 401 | Reconecte-se com uma conta corporativa Microsoft autorizada. |
| 403 | Peça ao administrador da Gestioo para verificar as permissões de conta, documento e cofre e grupos de acesso selecionados. |
| 404 | Verifique o recibo e use o mesmo usuário e conector que o criou. |
| 409 | Preserve a chave de confirmação e idempotency existentes. Investigue o conflito relatado ou o estado do documento. |
| 413 ou 415 | Verifique o tamanho do arquivo, a extensão e o conteúdo real. |
| 429 ou 503 | Aguarde e tente novamente com o mesmo recibo ou a mesma chave de idempotency e conteúdo. |
Support
Contate o suporte ou o email support@gestioo.coda Gestioo. Forneça a operação, o carimbo de data/hora e o código de erro seguro. Não envie credenciais ou conteúdo do documento em uma solicitação de suporte.
Termos de uso · Política de privacidade
Ações
| Arquivar um depósito |
Selo o PDF depositado no cofre seguro usando suas regras de retenção e classificação atuais. O arquivamento é irreversível. Repita com a mesma ID de depósito durante o processamento e interrompa com falha ou interrupção. |
| Criar um depósito |
Carregue um pdf ou Word documento com uma chave de versão de arquivo estável. Word arquivos são convertidos em PDF. Siga esta ação com Arquivar um depósito até que o status seja arquivado e mantenha o original local. |
| Obter o status do depósito |
Verifique um depósito criado pelo usuário conectado. Somente arquivado confirma a entrega para o cofre seguro. |
| Obter opções de depósito |
Obtenha os grupos de acesso, os rubricos de classificação e as unidades administrativas disponíveis para o usuário conectado. |
Arquivar um depósito
Selo o PDF depositado no cofre seguro usando suas regras de retenção e classificação atuais. O arquivamento é irreversível. Repita com a mesma ID de depósito durante o processamento e interrompa com falha ou interrupção.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do depósito
|
depositId | True | string |
A ID de depósito retornada por Criar um depósito. |
Retornos
- Body
- DepositStatus
Criar um depósito
Carregue um pdf ou Word documento com uma chave de versão de arquivo estável. Word arquivos são convertidos em PDF. Siga esta ação com Arquivar um depósito até que o status seja arquivado e mantenha o original local.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Chave de versão do arquivo
|
idempotencyKey | True | string |
Um identificador estável para esta versão do arquivo. Reutilize a mesma chave, bytes e metadados em novas tentativas. |
|
Nome do arquivo
|
fileName | True | string |
O nome do arquivo PDF ou DOCX original sem um caminho de pasta. |
|
Conteúdo do arquivo
|
contentBase64 | True | byte |
Os bytes de arquivo originais codificados em base64 exatamente uma vez. Não envie texto extraído. |
|
Título do documento
|
title | True | string |
O título exibido no cofre da Gestioo. |
|
Grupos de acesso
|
accessGroupIds | True | array of string |
Identificadores de um ou mais grupos de acesso retornados por Obter opções de depósito. |
|
Rubrica de classificação
|
classificationRubricId | True | string |
A rubrica de classificação autorizada para o documento. |
|
Tipo de cópia
|
classificationCopyType | string |
O tipo de cópia do documento. Use a entidade de segurança para o registro primário ou o secundário para uma cópia secundária. |
|
|
Unidade administrativa
|
administrativeUnitId | string |
A unidade administrativa autorizada, quando aplicável. |
|
|
Data do evento de retenção
|
triggerEventAt | date-time |
A data do evento de retenção no formato ISO 8601 com um fuso horário, quando exigido pela classificação. |
Retornos
- Body
- DepositStatus
Obter o status do depósito
Verifique um depósito criado pelo usuário conectado. Somente arquivado confirma a entrega para o cofre seguro.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do depósito
|
depositId | True | string |
A ID de depósito retornada por Criar um depósito. |
Retornos
- Body
- DepositStatus
Obter opções de depósito
Obtenha os grupos de acesso, os rubricos de classificação e as unidades administrativas disponíveis para o usuário conectado.
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Organização
|
organizationName | string |
A organização resolveu a partir da conta de entrada. |
|
Tamanho máximo de upload
|
maxUploadBytes | integer |
O tamanho máximo do arquivo original aceito pela Gestioo, em bytes. |
|
Formatos com suporte
|
supportedFormats | array of string |
As extensões de arquivo originais com suporte. |
|
Grupos de acesso autorizados
|
accessGroups | array of object |
Os grupos de acesso disponíveis para essa conta. |
|
ID do grupo de acesso
|
accessGroups.id | string |
O identificador do grupo de acesso autorizado. |
|
Nome francês
|
accessGroups.nameFr | string |
O nome do grupo de acesso em francês. |
|
Nome em inglês
|
accessGroups.nameEn | string |
O nome do grupo de acesso em inglês. |
|
Opções de classificação
|
classifications | array of object |
Os rubricos de classificação autorizados e seus requisitos de data de evento. |
|
ID da rubrica de classificação
|
classifications.id | string |
O identificador de rubrico de classificação autorizado. |
|
Rótulo de classificação
|
classifications.label | string |
O código rubrico e o título. |
|
Data do evento necessária
|
classifications.requiresEventDate | boolean |
Se a classificação requer uma data de evento de retenção. |
|
Unidades administrativas
|
administrativeUnits | array of object |
As unidades administrativas ativas na organização. |
|
ID da unidade administrativa
|
administrativeUnits.id | string |
O identificador de unidade administrativa. |
|
Nome da unidade
|
administrativeUnits.name | string |
O nome da unidade administrativa. |
|
Série de classificação
|
classificationSeries | array of object |
A hierarquia de classificação autorizada e os metadados de retenção padrão. |
|
Código de série
|
classificationSeries.seriesCode | string |
O código da série de classificação. |
|
Título da série
|
classificationSeries.seriesTitle | string |
O título da série de classificação. |
|
Listas de critérios de avalição
|
classificationSeries.rubrics | array of object |
Os rubricos autorizados nesta série de classificação. |
|
Rubric ID
|
classificationSeries.rubrics.id | string |
O identificador de rubrica de classificação. |
|
Código rubrico
|
classificationSeries.rubrics.code | string |
O código rubrico de classificação. |
|
Título rubrico
|
classificationSeries.rubrics.title | string |
O título da classificação rubrica. |
|
Código de série
|
classificationSeries.rubrics.seriesCode | string |
O código da série de classificação pai. |
|
Título da série
|
classificationSeries.rubrics.seriesTitle | string |
O título da série de classificação pai. |
|
Código de subseria
|
classificationSeries.rubrics.subSeriesCode | string |
O código de subseria de classificação, quando disponível. |
|
Título da subseria
|
classificationSeries.rubrics.subSeriesTitle | string |
O título da subseria de classificação, quando disponível. |
|
Função opcional
|
classificationSeries.rubrics.optionalFunction | string |
A função de classificação opcional, quando disponível. |
|
ID da regra de retenção padrão
|
classificationSeries.rubrics.defaultRetentionLineId | string |
O identificador de regra de retenção padrão, quando disponível. |
|
Tipo de retenção ativo
|
classificationSeries.rubrics.defaultRetentionActiveKind | string |
O tipo de período de retenção ativo, quando disponível. |
|
Tipo de evento de retenção
|
classificationSeries.rubrics.defaultRetentionTriggerType | string |
O tipo de evento de retenção sugerido, quando disponível. |
Definições
DepositStatus
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do depósito
|
depositId | string |
O identificador de recibo de depósito estável. |
|
ID do documento
|
documentId | string |
O identificador reservado para o documento depositado. |
|
Status
|
status | string |
O estado de depósito atual. Somente arquivado confirma o arquivamento bem-sucedido. |
|
Arquivado em
|
archivedAt | string |
O carimbo de data/hora do arquivo no formato ISO 8601, disponível após o arquivamento. |
|
Código do erro
|
error | string |
Um código de erro seguro quando o depósito falha. |
|
Próxima ação
|
nextAction | string |
A próxima ação necessária durante o processamento do documento. |
|
Tentar novamente após segundos
|
retryAfterSeconds | integer |
O atraso antes de verificar ou solicitar o arquivamento novamente. |