Importar dados do Resultados do Diligent One

Você pode criar uma tabela do Analytics importando dados das coleções com as quais tem permissão de trabalhar no Resultados do Diligent One. Você pode importar tabelas de dados e interpretações de testes de controle individuais.

Como as informações podem ser úteis

A capacidade de importar dados do Resultados para o Analytics permite executar análises ou exceções secundárias ou de acompanhamento. Após executar a análise, você poderá exportar os dados de volta ao Resultados, em um processo de ida e volta. Para obter mais informações, consulte Exportação de exceções para o aplicativo Resultados no Diligent One.

Considerações sobre nomes de campos em processos de ida e volta de dados do Resultados

If you are round-tripping data between Resultados and Analytics, you need to ensure that all field names in the Resultados table meet the more stringent Analytics field name requirements. If you do not, you risk misaligning your Analytics and Resultados data.

For example, any special characters in Resultados field names are automatically converted to underscores when they are imported into Analytics, which means the field names no longer match the original names in Resultados. If you then export the Analytics data back to the original table in Resultados, fields are no longer correctly matched.

To avoid this problem with data that you intend to round-trip, make sure that before you upload the data to Resultados from CSV or Excel files it meets these Analytics field name requirements:

• no special characters or spaces
• does not start with a number
• contains only alphanumeric characters, or the underscore character ( _ )

Restrição de comprimento de registro

O comprimento máximo de registro que pode ser importado no Analytics é 32.767 caracteres ou 16.383 caracteres Unicode.

Se você tentar importar dados dos Resultados que excedam o limite máximo, será exibida uma mensagem de erro e a importação falhará. Tente remover campos narrativos grandes da importação para reduzir o comprimento do registro.

Outra abordagem é executar a importação usando o comando IMPORT GRCRESULTS na linha de comando do Analytics. Quando você usa o comando, é possível incluir o parâmetro CHARMAX, que permite que você especifique um número máximo de caracteres em cada campo importado. Para obter mais informações, consulte Comando IMPORT GRCRESULTS.

Etapas

1. Selecione Importar > Diligent One > Resultados.
2. Na caixa de diálogo Selecione os dados a importar, clique duas vezes na pasta da organização.
3. Navegue até o teste de controle adequado.

   Nota

   Você não tem as permissões necessárias para acessar os dados se:

   • a coleção que contém o teste de controle não aparece
   • a mensagem Erro ao recuperar lista de interpretações é exibida quando você tenta acessar o teste de controle

   Para mais informações, consulte Atribuindo funções e privilégios no Resultados.

   Para obter ajuda com permissões, entre em contato com o administrador de contas do Diligent One da sua empresa ou com o administrador do Resultados.

4. Selecione uma das tabelas a seguir para importar para o Analytics:
   • uma interpretação, se existir
   • trilha de auditoria
   • comentários
   • tabela de resultados (clique duas vezes na pasta Seleção de campos de tabel)

   Nota

   Somente é possível importar uma tabela por vez para o Analytics.

   Dica

   Você pode associar a tabela de resultados, a trilha de auditoria e os comentários no Analytics usando o ID do registro como campo-chave. Use a tabela de resultados como a tabela primária na associação.

5. Se você está importando a tabela de resultados, selecione os campos individuais que deseja importar nas seguintes categorias:
   • Metadados campos contendo informações de fluxo de trabalho geradas pelo usuário e pelo sistema
   • Extras nomes de coleções e testes de controle, e ID do registro

     Não deixe de selecionar ID do registro se pretende associar a tabela de resultados no Analytics.

   • Dados campos contendo dados importados para o Resultados ou respostas para questionários do Resultados
   • Selecionar tudo importa toda a tabela
6. Clique em OK.

   Os dados são importados do Resultados.

7. Na caixa de diálogo Salvar arquivo de dados como, modifique o nome do arquivo e local do arquivo de dados do Analytics, conforme o necessário, e clique em Salvar.
8. Insira um nome para a tabela do Analytics que será adicionada ao projeto do Analytics ou mantenha o nome padrão e clique em OK.

   Nota

   Os nomes de tabela do Analytics são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.

Requisito de senha

Senha não obrigatória

Não é preciso especificar uma senha para importar do Diligent One se você usou a ativação on-line para ativar sua cópia do Analytics. A senha é criada e enviada automaticamente ao Diligent One de acordo com as informações de ativação armazenadas no computador.

Senha necessária

Você precisa especificar uma senha para importar do Diligent One nas seguintes situações:

• se você usou uma ativação off-line para ativar sua cópia do Analytics

• se você usou um script para importar do Diligent One e executou o script no Robôs

O valor de senha obrigatório é um token de acesso da Diligent One.

Adquira um token de acesso da Diligent One

Use um token existente, a menos que você tenha um motivo para criar um novo. Se o token existente não funcionar, crie um novo. O uso de um token existente reduz o número de tokens que você precisa gerenciar.

1. Execute uma das seguintes ações:

   • No menu principal do Analytics, selecione Ferramentas > Token de Acesso da Diligent One.

   • No Editor de Script, clique com o botão direito e selecione Inserir > Token da Diligent One.

   A página Gerenciar tokens da API abre no navegador. Pode ser necessário primeiro fazer o login no Diligent One.

   O acesso à página Gerenciar Tokens da API por meio do Analytics é um recurso de conveniência. Você também pode fazer login no Diligent One e acessar a página por meio do seu perfil de usuário sem usar o Analytics.

2. Execute uma das seguintes ações:

   • Usar um token existente

     1. Na coluna Token, clique no token parcialmente mascarado que deseja usar.

     2. Digite a senha da conta do Diligent One e clique em Confirmar.

        O token não mascarado é exibido.

     3. Clique em Copiar para copiar o token.

        Dica

        Não feche a caixa de diálogo que contém o token até colar corretamente o token.

   • Criar um novo token

     1. Clique em Adicionar token > Analytics.

     2. No painel lateral Novo token do Analytics, especifique estas informações:

        Campo ou opção	Descrição
        Descrição	Insira uma descrição que forneça informações úteis, como: O propósito do token Onde o token é usado – por exemplo, o nome e a localização do script do Analytics, ou o nome e a localização da tarefa do robô
        Expiração do token	Habilitada o token expira após um número de dias especificado Desabilitada o token nunca expira Nota Sua organização pode ter uma política de segurança que exige a expiração de tokens após um determinado período. É recomendado criar tokens com expiração. O Diligent One enviará uma notificação automática por e-mail antes da data de expiração.
        Expiração em	Especifique o número de dias até a expiração do token (1 a 365).
        Senha	Digite a senha da conta do Diligent One.

     3. Clique em Gerar token.

     4. Clique em Copiar para copiar o token.

        Dica

        Não feche o painel lateral que contém o token até colar corretamente o token.

3. Dependendo do método de acesso aos dados e de definição de senha que você está usando, faça uma das seguintes ações:

   Interface de usuário do Analytics

   Cole o token copiado no prompt de senha que aparece ao acessar o Diligent One manualmente.

   Script do Analytics

   • Comando PASSWORD Cole o token copiado em um prompt de senha exibido durante a execução de scripts.

   • Comando SET PASSWORD Cole o token copiado no ponto apropriado na sintaxe do comando SET PASSWORD em um script.

4. No Launchpad, feche a caixa de diálogo ou o painel lateral que contém o token.

   Se tiver criado um novo token, uma versão parcialmente mascarada do token é adicionada ao início da lista de tokens.

   Para obter mais informações, consulte Criando e gerenciando tokens de acesso da Diligent One.