Comando IMPORT GRCPROJECT
Cria uma tabela do Analytics importando uma tabela do Projetos do HighBond.
Sintaxe
IMPORT GRCPROJECT TO tabela nome_arquivo_importação PASSWORD num FROM id_org/id_tipo <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:
|
|||||||
| 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: O valor de senha obrigatório é um token de acesso do HighBond. Para obter mais informações, consulte Criação de uma definição de senha e especificação do valor da senha. Nota Dependendo do ambiente em que o script é executado, PASSWORD pode ou não ser obrigatório:
|
|||||||
|
FROM id_org/id_tipo |
A organização e o tipo de informações que definem os dados sendo importados:
Os valores de id_org e de id_tipo devem ser separados por uma barra, sem espaços entre eles: FROM "125@eu/auditorias". Toda a cadeia deve estar entre aspas. ID da Organizaçãoid_org deve incluir o número de ID da organização e, se você estiver importando de um data center localizado fora da América do Norte, o código do data center. O número de ID da organização e o código do data center devem ser separados por um símbolo de arroba (@): FROM "125@eu". O código do data center especifica de qual servidor regional do HighBond você está importando dados:
Você somente pode usar os códigos de data center autorizados para a instância do HighBond na sua organização. O data center da América do Norte é o padrão. Portanto, a especificação de "@us" é opcional. Se você não sabe qual é o número de ID da organização, use a interface do usuário do Analytics para importar uma tabela do módulo Projetos. O número de ID da organização está contido no comando no log. Para obter mais informações, consulte Importar dados do HighBond Projetos. ID do tipoid_tipo especifica o tipo de informações importadas. As informações do módulo Projetos estão contidas em uma série de tabelas relacionadas. Para id_tipo, você pode usar um dos seguintes valores. Insira o valor exatamente como aparece, incluindo sublinhados, se aplicável:
Dica Para obter informações sobre como as tabelas do módulo Projetos estão relacionadas, e sobre os campos-chave que você pode usar para associar as tabelas após tê-las importado para o Analytics, consulte Importar dados do Projetos do HighBond. |
|||||||
| 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.
Dica Para obter os nomes dos campos físicos, use a interface do usuário do Analytics para importar a tabela apropriada do módulo Projetos. Os nomes dos campos físicos estão contidos no comando do log. As importações subsequentes podem ser incluídas em um script. |
Exemplos
Importação de todos os campos da tabela do Projetos
Importe todos os campos da tabela do Projetos de todos os projetos ativos que pertencem à organização 286 para uma tabela do Analytics chamada Todos_Projetos. Inclua uma definição de senha numerada para autenticar a conexão:
IMPORT GRCPROJECT TO Todos_Projetos "C:\HighBond Projects Data\Todos_Projetos.fil" PASSWORD 1 FROM "286@us/auditorias"
Importação e campos especificados na tabela do Projetos
Importe campos especificados da tabela do Projetos de todos os projetos ativos que pertencem à organização 286 para uma tabela do Analytics chamada Todos_Projetos:
IMPORT GRCPROJECT TO Todos_Projetos"C:\HighBond Projects Data\Todos_Projetos.fil" FROM "286@us/auditorias" FIELD "id" AS "Id" FIELD "descrição" AS "Descrição" FIELD "nome" AS "Nome" FIELD "data_inicial" AS "Data inicial" FIELD "status" AS "Status" FIELD "criado_em" AS "Criado em"
Importação de todos os campos da tabela do Problemas
Importe todos os campos da tabela do Problemas de todos os projetos ativos que pertencem à organização 286 para uma tabela do Analytics chamada Todos_Problemas:
IMPORT GRCPROJECT TO Todos_Problemas "C:\HighBond Projects Data\Todos_Problemas.fil" FROM "286@us/findings"
Observações
Nota
Para obter mais informações sobre o funcionamento desse comando, consulte a Ajuda do Analytics.
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.
Adquira um 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, que os usuários podem gerar no Launchpad.
Cuidado
O token de acesso gerado corresponde à conta usada para fazer login no Launchpad. Como um autor de scripts, pode não ser apropriado especificar seu próprio token de acesso em um script se ele for usado por outras pessoas.
- 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 fazer antes o login no Launchpad.
- Execute uma das seguintes ações:
- Use um token existente Na coluna Token, clique no token parcialmente mascarado que você deseja usar e insira a senha da conta do HighBond. O token não mascarado é exibido.
Dica
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.
- Crie um novo token Clique em Criar token > Analytics e insira a senha da sua conta do HighBond.
Um novo token do Analytics é criado.
Nota
Se você é um Administrador de Sistema do Launchpad, também pode criar um token de API. Você deve usar tokens de API apenas para os fins a que se destinam: acesso programático à plataforma do HighBond.
- Use um token existente Na coluna Token, clique no token parcialmente mascarado que você deseja usar e insira a senha da conta do HighBond. O token não mascarado é exibido.
- Clique em Copiar para copiar o token.
Dica
Não feche a caixa de diálogo que contém o token até que colar corretamente o token.
- No Analytics, execute uma das seguintes ações:
- cole o token na solicitação de senha
- cole o token no ponto apropriado na sintaxe do comando SET PASSWORD em um script
- No Launchpad, feche a caixa de diálogo 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.
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.