Importação e exportação de dados — a exportação amigável em Excel, o fluxo de importação por migração com validação e ciclo de relatório de erros, os separadores de diretório Requerentes/Riscos/Fornecedores, e a migração de documentos através do contentor migration-staging.

Last updated: August 06, 2026 by Steve

Importação e Exportação de Dados

Definições → Importação e exportação de dados é onde o AccessPoint cumpre a sua própria promessa de não aprisionamento de dados: uma exportação legível para o negócio do seu volume de casos, disponível a qualquer momento, e um percurso guiado para trazer casos históricos de outro sistema sem necessidade de um projeto de ETL.

Importação e exportação de dados

Onde Encontrá-lo

Abra Definições na barra de ferramentas da aplicação e escolha Importação e exportação de dados no grupo Introdução.

Os Seus Dados Nunca Ficam Bloqueados

Três factos são verdadeiros independentemente de alguma vez utilizar este painel:

  1. A base de dados é sua. Todas as tabelas do AccessPoint residem na base de dados Azure SQL na sua subscrição Azure. As ferramentas padrão do Azure SQL de exportação, cópia de segurança e consulta funcionam todas diretamente sobre ela — sem necessidade de envolvimento do fornecedor.
  2. Os documentos residem no seu próprio Blob Storage. Os documentos de caso, os pacotes de resposta e as exportações de auditoria de caso são ficheiros comuns na sua própria conta de Azure Storage.
  3. A exportação está a um clique de distância. O separador Exportar, abaixo, produz uma cópia legível para o negócio sempre que quiser uma.

Exportação Amigável

O separador Exportar produz um livro Excel legível para o negócio, abrangendo os seus pedidos, avaliações, incidentes e reclamações, mais o diretório de requerentes, o registo de riscos ao nível do registo, e o registo de fornecedores. Os seus separadores espelham deliberadamente o modelo de importação descrito abaixo — pelo que uma exportação retirada de um tenant valida corretamente como importação noutro, o que a torna útil para consolidar tenants ou ensaiar uma migração contra um tenant de teste. (Os artefactos de relatórios estatutários anuais/trimestrais — as apresentações Excel/XML para as quais um pacote jurisdicional inclui um modelo — provêm da área de Relatórios, não deste painel.)

Migrar Dados Históricos

O separador Importar migra um volume de casos históricos de outro sistema, de ponta a ponta, sem necessidade de um programador ou de uma ferramenta de ETL:

  1. Descarregue o modelo de importação. É gerado para o seu tenant, pelo que o respetivo separador de referência e as listas pendentes em célula já trazem os seus códigos de tipo e valores de fase configurados.
  2. Preencha uma linha por registo, com as datas no formato YYYY-MM-DD.
  3. Carregue o ficheiro e leia o relatório de validação.
  4. Importar agora para o executar em segundo plano.

Referência Legada vs. Números Gerados

Cada linha importada necessita de um identificador, e o modelo oferece duas formas de o fornecer:

  • Coloque o identificador do sistema antigo em Referência legada — sempre, em todas as linhas.
  • Deixe Número em branco no caso normal: o AccessPoint gera um número com o prefixo IMP-, mantendo-se como autoridade única de numeração.
  • Forneça um Número apenas quando o seu registo ou um registo de divulgação publicado exigir que o número de caso antigo se mantenha como o oficial. Um número fornecido é mantido tal e qual — e, se corresponder ao formato de numeração configurado do seu tenant, avança automaticamente a sequência, para que os casos recém-criados continuem de forma limpa a partir dele. O relatório de validação informa-o sempre que ocorre um avanço de sequência.

Validação e o Ciclo do Relatório de Erros

Carregar o ficheiro não importa nada por si só — produz um relatório de validação, por separador, mostrando o que seria criado, o que seria ignorado, e quaisquer erros ao nível da linha. As importações são estritamente apenas de criação: uma linha que corresponda a um número de caso já existente é ignorada sem tocar nos dados desse registo, o que torna sempre seguro voltar a executar um ficheiro corrigido. Descarregar relatório de erros devolve-lhe o seu próprio livro com uma coluna de Erros acrescentada, para que o ciclo de corrigir e recarregar se mantenha dentro do mesmo ficheiro.

Histórico por Construção

Depois de Importar agora ser executado (em segundo plano — pode fechar o painel), os registos importados chegam deliberadamente inertes: não são enviadas notificações, não são geradas revisões, e não são recalculados prazos. As datas fornecidas são armazenadas exatamente como indicadas, e cada registo importado transporta uma entrada de trilha de auditoria Imported, para que a proveniência esteja sempre visível mais tarde. Os requerentes são associados a contactos existentes por email (ou criados, caso não haja correspondência); um email de responsável de acesso sem correspondência recai sobre o administrador que efetuou a importação.

Os Separadores de Diretório

Três outros separadores migram os registos que rodeiam os seus casos, utilizando a mesma semântica de ignorar-se-já-existir, apenas de criação:

Separador Chave de Ignorar Notas
Requerentes Email (senão nome) Importe requerentes no mesmo livro que os respetivos pedidos, e uma linha de Pedidos que partilhe o email liga-se ao contacto completo importado, em vez de um contacto criado automaticamente e vazio. As instituições são associadas por nome, ou criadas uma vez por execução.
Riscos Título Apenas riscos ao nível do registo (autónomos) — um risco que pertença a uma avaliação ou incidente viaja, em vez disso, com esse caso. Os códigos de categoria são validados face às suas categorias de risco configuradas; a probabilidade, o impacto e o nível de risco são armazenados tal como fornecidos, já que uma determinação histórica migrada é um registo, e não algo que o AccessPoint recalcule.
Fornecedores Nome O registo de fornecedores/subcontratantes — função, contacto, jurisdição, factos do DPA, fim de contrato, nível de risco e estado.

Migrar Documentos

Os ficheiros de caso legados migram através do contentor blob pré-aprovisionado migration-staging, na sua própria conta de armazenamento, listado no separador Documentos do livro — nada a aprovisionar, o contentor já vem incluído no modelo de implantação.

  1. Prepare os ficheiros em staging, uma pasta por caso (LEGACY-42/All Staff Memo.docx): o AzCopy para volume (preserva a sua árvore de pastas; adicione --put-md5 para ativar a verificação por hash), o arrastar-e-largar do portal Azure, ou o próprio botão Carregar ficheiros para staging do painel, para conjuntos mais pequenos. Os caminhos são únicos por construção, pelo que nomes de ficheiro idênticos em casos diferentes nunca colidem.
  2. Liste cada ficheiro no separador Documentos — o caso a que pertence (um Número ou Referência legada, ou um pedido existente), o seu caminho em staging, e, opcionalmente, um título, tipo de documento, data, e um hash de conteúdo MD5. Quando tanto o manifesto como o blob em staging transportam um hash, o importador verifica-os e rejeita uma incompatibilidade — uma verificação opcional de cadeia de custódia.
  3. Valide em ambas as direções. Todo o caminho listado tem de existir no contentor, e os ficheiros em staging que não estejam listados são assinalados como aviso, em vez de importados silenciosamente. Depois de acrescentar ficheiros ao livro, revalide sem voltar a carregá-lo.
  4. Importar. Cada ficheiro listado é copiado para o repositório de documentos normal e segue o mesmo pipeline de conversão/indexação de um carregamento nativo, transportando a proveniência Migration Import. Um ficheiro já registado no caso é ignorado em execuções repetidas.

Os ficheiros em staging eliminam-se automaticamente ao fim de 60 dias — são registos sensíveis que ficam fora do ciclo de vida normal dos documentos, pelo que o contentor não os retém indefinidamente por predefinição.

Páginas Relacionadas