Comando IMPORT GRCRESULTS

Cria uma tabela do Analytics importando uma tabela ou interpretação do Resultados do HighBond.

Sintaxe

IMPORT GRCRESULTS TO tabela nome_arquivo_importação <PASSWORD num> FROM Caminho_recursos_Resultados <FIELD nome AS nome_exibicao <...n>>

Parâmetros

Nome Descrição
TO tabela

O nome da tabela do Analytics na qual os dados serão importados.

Nota

Os nomes de tabela são limitados a 64 caracteres alfanuméricos. 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.

nomearquivo_importação

O nome do arquivo de dados do Analytics a ser criado.

Especifique nome_arquivo_importação como uma cadeia entre aspas com uma extensão de arquivo .FIL. Por exemplo, "Faturas.FIL".

Por padrão, o arquivo de dados (.FIL) é salvo na pasta que contém o projeto do Analytics.

Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:

  • "C:\dados\Faturas.FIL"
  • "dados\Faturas.FIL"
PASSWORD num

A definição de senha a ser usada.

PASSWORD num não é usado para solicitar ou especificar uma senha real. A definição de senha faz referência a uma senha previamente fornecida ou definida com o comando PASSWORD, o comando SET PASSWORD ou a tag de análise PASSWORD.

num é o número da definição de senha. Por exemplo, se as duas senhas foram previamente fornecidas ou definidas em um script, ou no agendamento de uma análise, PASSWORD 2 especifica o uso da senha nº 2.

Para obter mais informações sobre o fornecimento ou a definição de senhas, consulte:

Nota

Dependendo do ambiente em que o script é executado, PASSWORD pode ou não ser obrigatório:

Analytics

(ativação on-line)

PASSWORD não é obrigatório.

O token de acesso do HighBond do usuário atual é usado automaticamente.

Analytics

(ativação off-line)

PASSWORD é obrigatório.
Robôs
Analytics Exchange
Janela Aplicativo de análise

FROM Caminho_recursos_Results

O caminho até os dados que estão sendo importados.

O formato do caminho varia dependendo dos dados importados. Para obter detalhes sobre o formato do caminho, consulte Caminho do módulo Resultados.

Nota

O formato do caminho do módulo Resultados é fornecido por uma API e está sujeito à alteração. A forma mais fácil e confiável de obter a sintaxe correta e atual do caminho e executar uma importação manual dos dados de destino e copiar o caminho do log de comandos.
FIELD nome AS nome_exibicao <...n>

opcional

Campos individuais nos dados de origem a serem importados. Especifique o nome.

Se você omitir FIELD, todos os campos serão importados.

Nome

nome deve corresponder exatamente ao nome do campo físico na tabela Resultados, inclusive maiúsculas e minúsculas. Para exibir o nome físico do campo, realize uma das ações a seguir:

  • No Resultados, clique em um cabeçalho de coluna na Exibição de tabela. O nome do campo físico é exibido após Nome do campo.
  • No Analytics, quando você importa uma tabela do módulo Resultados, o nome de campo físico aparece entre parênteses após o nome de exibição na caixa de diálogo que permite selecionar campos.

Nota

O nome do campo físico do Resultados não é o nome de exibição usado para cabeçalhos de coluna na Exibição de tabela.

Consulte também Considerações sobre nomes de campos para importação e exportação de dados do Resultados.

Nome de exibição

nome_exibicao (título alternativo da coluna) é o nome do campo na exibição na nova tabela do Analytics. Você deve especificar um nome de exibição para cada FIELD nome. Especifique nome_exibicao como uma cadeia entre aspas.

Utilize um ponto e vírgula (;) entre palavras se quiser uma quebra de linha no título da coluna.

Ao contrário de alguns comandos IMPORT no Analytics, não é possível especificar nome_exibicao em branco como forma de usar o nome de FIELD como nome de exibição.

Exemplos

Importação dos campos especificados de uma tabela do Resultados

Importe os campos especificados de uma tabela do Resultados para uma tabela do Analytics chamada Exceções T e E:

IMPORT GRCRESULTS TO Exceções_T_e_E "C:\Análise Secundária\Exceções_T_e_E.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" FIELD "metadata.status" AS "Status" FIELD "NumFunc" AS "Número Funcionário" FIELD "DATA" AS "Data" FIELD "NUMCARTAO" AS "Número do cartão" FIELD "CODIGOS" AS "Códigos MC" FIELD "VALOR" AS "Valor" FIELD "DESCRICAO" AS "Descrição"

Importação de todos os campos de uma tabela do Resultados

Importe todos os campos de uma tabela do Resultados para uma tabela do Analytics chamada Exceções T e E:

IMPORT GRCRESULTS TO Exceções_T_e_E "C:\Análise Secundária\Exceções_T_e_E.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions"

Importação de dados de uma interpretação no Resultados

Importe uma interpretação no Resultados para uma tabela do Analytics chamada Exceções T e E filtradas:

IMPORT GRCRESULTS TO Exceções_T_e_E_filtradas "C:\Análise Secundária\Exceções_T_e_E_filtradas.fil" FROM "results/api/orgs/11594/control_tests/185699/interpretations/22699/exceptions"

Observações

Nota

Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.

Preservação de ordem de classificação e filtros

Quando você importa dados do Resultados, todas as personalizações de dados, como classificação e filtragem, são preservadas ou ignoradas na tabela resultante do Analytics, dependendo da forma como os dados são importados:

  • importar uma tabela a personalização de dados é ignorada. Todos os dados da tabela são importados, exceto os campos que você preferir omitir.
  • importar uma interpretação a personalização de dados preservada

Caminho do módulo Resultados

Nota

O formato do caminho do módulo Resultados é fornecido por uma API e está sujeito à alteração. A forma mais fácil e confiável de obter a sintaxe correta e atual do caminho e executar uma importação manual dos dados de destino e copiar o caminho do log de comandos.

O caminho do módulo Resultados no parâmetro FROM tem o seguinte formato geral:

FROM "results <-código da região>/api/orgs/<ID da organização>/testes_controle/<ID do teste de controle>/exceções

Por exemplo: FROM "results/api/orgs/11594/control_tests/4356/exceptions"

O ID da organização é exibido na barra de endereço do navegador quando você faz login no Launchpad. O ID do teste de controle e o ID da interpretação são exibidos na barra de endereço quando você exibe essas tabelas no módulo Resultados.

A tabela a seguir oferece todas as variações do caminho do módulo Resultados.

Para importar: Use este formato do caminho do módulo Resultados:
Teste de controle de dados (tabela) FROM "results/api/orgs/11594/control_tests/4356/exceptions"
Teste de controle de trilha de auditoria (tabela) FROM "results/api/orgs/11594/control_tests/4356/audit_trail"
Teste de controle de comentários (tabela) FROM "results/api/orgs/11594/control_tests/4356/comments"
Interpretação FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions"
Dados de uma região do HighBond diferente da região padrão (us)
  • Ásia-Pacífico FROM "results-ap/api/orgs/11594/control_tests/4356/exceptions"
  • Austrália FROM "results-au/api/orgs/11594/control_tests/4356/exceptions"
  • Canadá FROM "results-ca/api/orgs/11594/control_tests/4356/exceptions"
  • Europa FROM "results-eu/api/orgs/11594/control_tests/4356/exceptions"

Colunas de informações geradas pelo sistema

Quando você importa dados do módulo Resultados, pode também importar uma ou mais das colunas de informações geradas pelo sistema listadas a seguir.

As colunas geradas pelo sistema se dividem em dois tipos:

  • parte das tabelas do módulo Resultados, com informações de processamento relacionadas a registros individuais
  • informações adicionais: nome da coleção nome da tabela ou número do ID do registro

Você deve especificar os nomes de campo das colunas geradas pelo sistema exatamente da forma como aparecem a seguir. Os nomes de exibição padrão se aplicam na importação do módulo Resultados por meio da interface do usuário do Analytics. É possível alterar os nomes de exibição se você codificar o processo de importação em scripts.

Nome do campo

Nome de exibição padrão

metadata.priority

Prioridade

metadata.status

Status

metadata.publish_date

Publicado

metadata.publisher

Nome da editora

metadata.assignee

Atribuído(a) a
metadata.group Grupo
metadata.updated_at Atualizado(a)
metadata.closed_at Fechado(a)
extras.collection Coleção
extras.results_table Tabela de Resultados
extras.record_id ID do registro

Considerações sobre nomes de campos para importação e exportação de dados do Resultados

If you are round-tripping data between Results and Analytics, you need to ensure that all field names in the Results table meet the more stringent Analytics field name requirements. 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 ( _ )

Criação de uma definição de senha e especificação do valor da senha

Comando PASSWORD

Se você usar o comando PASSWORD para criar o número de definição da senha para conexão ao HighBond, nenhum valor de senha será especificado. Portanto, a senha será solicitada quando o script tentar se conectar.

Para obter mais informações, consulte Comando PASSWORD.

Comando SET PASSWORD

Se você usar o comando SET PASSWORD para criar o número de definição da senha para conexão ao HighBond, um valor de senha será especificado. Portanto, nenhuma senha será solicitada, o que é adequado para scripts projetados para execução sem intervenção manual.

Para obter mais informações, consulte Comando SET PASSWORD.

Token de acesso do HighBond

Independentemente do método usado para criar a definição de senha, o valor de senha obrigatório é um token de acesso do HighBond:

  • Método PASSWORD – os usuários podem adquirir um token de acesso selecionando Ferramentas > Token de acesso do HighBond e fazendo login no HighBond. Será retornado um token de acesso, que pode ser copiado e colado pelos usuários no prompt de senha.
  • Método SET PASSWORD – para inserir um token de acesso na sintaxe do comando SET PASSWORD em um script do Analytics, clique com o botão direito no Editor de script, selecione Inserir > Token HighBond e faça login no HighBond. Um token de acesso é inserido no script, na posição do cursor.

Cuidado

O token de acesso retornado corresponde à conta usada para fazer login no HighBond. Como autor de scripts, usar seu próprio token de acesso pode não ser apropriado se você estiver escrevendo um script para ser usado por outras pessoas.

Recurso para depuração de importações

Existe um recurso de depuração simples para importações do HighBond.

Os dados importados são armazenados temporariamente em um arquivo JSON intermediário na pasta que contém o projeto de destino do Analytics. Em qualquer pasta que contém um projeto do Analytics, você pode criar um arquivo de texto para que o arquivo JSON seja retido, em vez de ser excluído, após a importação dos dados para o Analytics.

  • Arquivo JSON presente Se a importação do HighBond falhar, mas o arquivo JSON estiver presente no computador, você saberá que o problema está no Analytics e não no HighBond.
  • Arquivo JSON ausente Se a importação do HighBond falhar, mas o arquivo JSON não estiver presente no computador, você saberá que o problema está no HighBond.

Essa informação pode ser útil para solucionar o problema.

Configurar retenção do arquivo JSON intermediário

Na pasta que contém o projeto do Analytics de destino, crie um arquivo de texto vazio com o nome exatamente igual a _grc_import_debug.txt

Quando você realizar uma importação do Resultados ou do Projetos do HighBond, o arquivo JSON intermediário será retido com o nome results.json. O arquivo será sobrescrito a cada importação subsequente do HighBond.

Importação de grandes tabelas

A importação de tabelas com um grande número de campos usando um único comando IMPORT GRCRESULTS pode falhar. Se você precisar trabalhar com uma única tabela que contém um grande número de campos fora do Resultados, use uma das seguintes abordagens:

  • Divida a tabela use dois ou mais comandos IMPORT GRCRESULTS para importar um subconjunto dos campos e associe as tabelas resultantes no Analytics usando o comando JOIN
  • Exporte a tabela para um arquivo use o formato de exportação para CSV e importe o arquivo resultante para o Analytics usando o comando IMPORT DELIMITED

[ Voltar ao início ]

Guia de scripting do ACL 14.1