Importar dados do Resultados do HighBond

Informações do conceito

Comando IMPORT GRCRESULTS

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

Nota

No Resultados, um teste de controle é denominado "análise de dados".

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 HighBond.

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

Se você está executando um processo de ida e volta de dados entre o Resultados e o Analytics, precisa garantir que todos os nomes de campos da tabela do Resultados cumpram os requisitos mais rigorosos de nomenclatura de campos do Analytics. Caso contrário, os dados do Analytics e do Resultados poderão ficar desalinhados.

Por exemplo, todos os caracteres especiais dos nomes de campos do Resultados são convertidos automaticamente em sublinhados quando importados para o Analytics, o que significa que os nomes de campos deixam de corresponder aos nomes originais do Resultados. Se em seguida você exportar os dados do Analytics de volta para a tabela original no Resultados, os campos não corresponderão corretamente.

Para evitar esse problema em processos de ida e volta de dados, antes de carregar dados de arquivos CSV ou Excel para o Resultados, verifique se os requisitos de nomenclatura de campos do Analytics a seguir são cumpridos:

  • sem caracteres especiais ou espaços
  • não começa com um número
  • contém apenas caracteres alfanuméricos ou o caractere sublinhado ( _ )

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

Nota

Pode ser necessário especificar uma senha quando você se conecta ao HighBond. Para obter mais informações, consulte Requisito de senha.

  1. Selecione Importar > HighBond > 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 HighBond da sua empresa ou com o administrador de 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 tabela)

    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 HighBond se você usou a ativação on-line para ativar sua cópia do Analytics. A senha é criada e enviada automaticamente ao HighBond com base nas informações de ativação armazenadas no computador.

Senha necessária

Você precisa especificar uma senha para importar do HighBond 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 HighBond e executou o script no Robôs

O valor de senha obrigatório é um token de acesso do HighBond.

Adquira um token de acesso do HighBond

Cuidado

Proteja seu token de acesso como qualquer senha de conta. Ele contém informações exclusivas da sua conta do HighBond. Você não deve compartilhar os tokens de acesso.

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 do HighBond.

    • No Editor de script, clique com o botão direito e selecione Inserir > Token do HighBond.

    A página Gerenciar Tokens da API abre no navegador. Pode ser necessário primeiro fazer o login no HighBond.

    O acesso à página Gerenciar Tokens da API por meio do Analytics é um recurso de conveniência. Você também pode fazer login no HighBond 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 HighBond 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 HighBond 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 Insira a senha da sua conta do HighBond.
      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 HighBond 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 do HighBond.