Comando IMPORT GRCPROJECT

Cria uma tabela do Analytics importando uma tabela do Projetos do Diligent One.

Sintaxe

IMPORT GRCPROJECT TO tabela nome_arquivo_importação PASSWORD número FROM id_org/id_tipo <FIELD nome AS nome_exibição <...n>><CHARMAX tamanho_máximo_campo>

Parâmetros

Exemplos

IMPORT GRCPROJECT TO Todos_Projetos"C:\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"

IMPORT GRCPROJECT TO Todos_Projetos "C:\Projects Data\Todos_Projetos.fil" PASSWORD 1 FROM "286@us/audits"

IMPORT GRCPROJECT TO Todos_Projetos "C:\Projects Data\Todos_Projetos.fil" PASSWORD 1 FROM "286@us/audits" CHARMAX 200

IMPORT GRCPROJECT TO Todos_Problemas "C:\Projects Data\Todos_Problemas.fil" FROM "11594@-eu/findings"

Observações

Para obter mais informações sobre o funcionamento desse comando, consulte Importar dados do Projetos do Diligent One.

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

Quando você executa um script no Robôs que importa uma tabela do Projetos do Diligent One, é preciso incluir uma definição de senha com o comando IMPORT GRCPROJECT. A mesma exigência se aplica a scripts executados no Analytics se você usou a ativação off-line.

Independentemente do método usado para criar a definição de senha, o valor de senha obrigatório é um token de acesso da Diligent One, que você pode gerar no Launchpad. Para obter mais informações, consulte Adquira um token de acesso da Diligent One.

Métodos para definição de senha

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 definição de senha que você está usando, faça uma das seguintes opções:

   • Tag de análise PASSWORD No Designer de Tarefa em um robô ACL, cole o token copiado em um campo de parâmetro de senha.

   • Comando PASSWORD No Analytics, cole o token copiado em um prompt de senha exibido durante a execução de scripts.

   • Comando SET PASSWORD No Analytics, cole o token 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.

Recurso para depuração de importações

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

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 Diligent One falhar, mas o arquivo JSON estiver presente no computador, você saberá que o problema está no Analytics e não no Diligent One.
• Arquivo JSON ausente Se a importação do Diligent One falhar, mas o arquivo JSON não estiver presente no computador, você saberá que o problema está no Diligent One.

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 no Diligent One, o arquivo JSON intermediário será retido com o nome results.json. O arquivo será sobrescrito a cada importação subsequente do Diligent One.