Exportação de exceções para o aplicativo Resultados no Diligent One

Se você usar o Diligent One, poderá exportar dados de exceção em uma tabela do Analytics para uma tabela no Resultados. Para exportar exceções, você utiliza o procedimento padrão para exportar dados do Analytics, com algumas pequenas diferenças.

O Resultados é um aplicativo de remediação e automação de fluxo de trabalho que gerencia dados de exceção, adiciona contexto humano por meio de questionários e torna seu monitoramento contínuo com gatilhos e métricas. Para obter mais informações, consulte Trabalhando com dados no Resultados.

Requisitos de segurança

A capacidade de exportar dados de exceção para um teste de controle no Resultados exige uma atribuição de função específica do Diligent One ou privilégios administrativos:

• Usuários com a função Usuário Profissional ou Gerente Profissional para uma coleção do Resultados podem exportar os resultados para qualquer teste de controle na coleção.

  Nota

  Somente os usuários com a função Gerente Profissional podem sobrescrever dados existentes em um teste de controle.

• Os administradores da conta do Diligent One e os administradores do Resultados recebem automaticamente a função Gerente Profissional em todas as coleções das instâncias do Diligent One que administram.

Para obter mais informações, consulte Permissões do aplicativo Resultados.

Limites de exportação

Os limites a seguir se aplicam à exportação para um teste de controle no Resultados.

Dentro desses limites, você pode exportar várias vezes para o mesmo teste de controle. Se já existirem dados no teste de controle, você pode sobrescrevê-los ou acrescentar os novos dados.

Item	Máximo
Registros por exportação	100.000
Registros por teste de controle	100.000
Campos por registro	500
Caracteres por campo	256

Manutenção do alinhamento de campos entre o Analytics e o 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 ( _ )

Opção Sobrescrever e chave primária do Resultados

Quando você exporta dados de exceção do Analytics para uma tabela existente do Resultados, tem a opção de anexar os dados exportados à tabela ou substituí-la completamente.

Se a tabela Resultados tem um campo especificado como chave primária e os dados que você está exportando contêm um campo correspondente, o comportamento da exportação é um pouco diferente. (Para obter mais informações sobre a especificação de uma chave primária no Resultados, consulte Especificar uma chave principal.)

As diferentes possibilidades são resumidas a seguir.

	Sem chave primária no Resultados	Chave primária no Resultados
Opção Sobrescrever não selecionada	os dados exportados são anexados à tabela do Resultados existente	valor correspondente se existe um valor correspondente no campo de chave primária no Resultados e no campo correspondente exportado do Analytics, o registro no Resultados é atualizado com os valores presentes no registro exportado sem valor correspondente se não existe um valor correspondente no campo de chave primária no Resultados e no campo correspondente exportado do Analytics, o registro no Resultados não é atualizado e o registro exportado é anexado à tabela
Opção Sobrescrever selecionada	dados exportados substituem (sobrescrevem) a tabela Resultados existente	dados exportados substituem (sobrescrevem) a tabela Resultados existente

Exportar exceções para o Resultados

Especificar os campos a exportar

1. Abra a tabela com os dados de exceção que deseja exportar.
2. Selecione Dados > Exportar.
3. Na guia Principal, selecione uma das seguintes ações:
   • Campos especificar os campos que deseja exportar

     Quando você seleciona essa opção, os campos são exportados usando os nomes de campos físicos no layout da tabela.

     Para obter mais informações sobre como renomear campos, consulte Para renomear um campo em um layout da tabela.

   • Exibição exportar todos os campos na exibição atual

     Quando você seleciona essa opção, os campos serão exportados usando os nomes de exibição das colunas. Os campos são exportados na mesma ordem em que aparecem na exibição.

     Para obter mais informações sobre como renomear colunas, consulte Renomear colunas em uma exibição.

4. Se escolher Campos, execute um dos itens a seguir:
   • Selecione os campos a serem exportados da lista Exportar campos.

     Dica

     Você pode usar Ctrl+clique para selecionar vários campos não adjacentes e Shift+clique para selecionar vários campos adjacentes.

   • Clique em Exportar campos para selecionar os campos ou para criar uma expressão.

Selecione as opções de saída

1. Na lista suspensa Exportar como, selecione Diligent One.
2. Execute uma das seguintes ações:
   • Anexar à tabela do Resultados

     Se você quiser anexar os dados exportados à tabela existente no Resultados, desmarque Sobrescrever.

     Nota

     Os campos do Analytics só podem ser anexados a campos existentes do Resultados se tiverem nomes de campos físicos correspondentes, independentemente do nome de exibição nesses aplicativos. No Analytics, o nome do campo físico é o nome no layout da tabela.

     A ordem dos campos nos dois aplicativos não afeta a correspondência dos nomes dos campos.

     Os campos exportados com nomes físicos que não correspondem ao nome físico de um campo na tabela do Resultados criarão novas colunas na tabela.

   • Substituir (sobrescrever) a tabela do Resultados

     Se você quiser substituir a tabela existente no Resultados, marque Sobrescrever.

   Para obter mais informações, consulte Opção Sobrescrever e chave primária do Resultados.

3. (Opcional) Se você quiser exportar nomes de exibição de colunas para o Resultados, selecione Incluir nome de exibição do campo.

   A seleção dessa opção fará com que o nome de exibição da coluna e o nome físico no Resultados sejam iguais aos nomes do Analytics.

   Se a opção Incluir nome de exibição no campo não for selecionada, o resultado dependerá de a exportação estar sendo feita por campos ou por exibição:

   	Exportando campos	Exportando exibição
   Incluir nome de exibição no campo selecionada	O nome do campo no Resultados é o nome do campo do Analytics. O nome de exibição no Resultados é o nome de exibição do Analytics.
   Incluir nome de exibição no campo não selecionada	O nome do campo e o nome de exibição no Resultados são o nome do campo do Analytics.	O nome de campo e o nome de exibição no Resultados são o nome de exibição do Analytics.

   Nota

   Não selecione Incluir nome de exibição no campo se você estiver anexando uma exibição a uma tabela do Resultados criada inicialmente pela exportação de uma exibição de uma versão do Analytics anterior à 14.1. Se fizer isso, é possível que as colunas sejam exportadas com nomes de campo diferentes dos nomes no Resultados, o que criará novas colunas no Resultados e desalinhará os dados entre os aplicativos.

Finalizar a importação

1. Se existirem registros na exibição atual que você desejar excluir do processamento, insira uma condição na caixa de texto Se ou clique em Se para criar uma instrução IF usando o Construtor de expressões.

   Nota

   A condição Se é avaliada apenas em relação aos registros restantes em uma tabela depois da aplicação das opções de escopo (Primeiros, Próximos, Enquanto).

   A instrução IF considera todos os registros na exibição e filtra aqueles que não atendem à condição especificada.

2. Execute uma das seguintes ações:

   Se você sabe qual é o número de ID da tabela para a qual está exportando:

   Insira o número na caixa de texto Para.

   • Digite o número sem aspas – por exemplo, 99
   • Insira apenas o número. Não insira um nome de arquivo.
   • Se você está exportando para um data center localizado fora da América do Norte (EUA), também deve especificar o código do data center. O número de ID do teste de controle e o código do data center devem ser separados por um símbolo de arroba (@) – por exemplo, 99@eu. O código do data center especifica para qual servidor regional do Diligent One você está exportando dados.
     • af – África (África do Sul)
     • ap – Ásia-Pacífico (Singapura)
     • au – Ásia-Pacífico (Austrália)
     • ca – América do Norte (Canadá)
     • eu – Europa (Alemanha)
     • jp – Ásia-Pacífico (Tóquio)
     • sa – América do Sul (Brasil)
     • us – América do Norte (EUA)

     Você somente pode usar os códigos de data center autorizados para a instância do Diligent One na sua organização. O data center da América do Norte (EUA) é o padrão. Portanto, a especificação de @us é opcional.

   Se você não sabe qual é o número de ID da tabela para a qual está exportando ou se quiser criar uma nova tabela:

   1. Clique em Para. Na caixa de diálogo Selecionar Teste de Destino, navegue até a pasta de análise adequada.
   2. Execute uma das seguintes ações:
      • Selecione uma tabela existente e clique em OK.
      • Insira um nome no campo Nova análise de dados e clique em Criar.

      Você voltará para a caixa de diálogo Exportar e o número do ID do teste de controle e o código do data center estarão preenchidos na caixa de texto Para.

3. Clique na guia Mais.

4. No painel Escopo, selecione a opção adequada:

   • Tudo
   • Primeiros
   • Próximo
   • Enquanto
   Mostre-me mais

   Opção de escopo	Detalhes
   Tudo	(Padrão) Especifica que todos os registros na exibição são processados.
   Primeiros	Insira um número na caixa de texto. Começa o processamento no primeiro registro da exibição e inclui apenas o número especificado de registros.
   Próximo	Insira um número na caixa de texto. Começa o processamento no registro atualmente selecionado da exibição e inclui apenas o número especificado de registros. Na coluna mais à esquerda na exibição, deve ser selecionado o número real de registros, não os dados na linha.
   Enquanto	Use uma instrução WHILE para limitar o processamento de registros na exibição com base em um critério específico ou conjunto de critérios. Insira uma condição na caixa de texto Enquanto ou clique em Enquanto para criar uma instrução WHILE usando o Construtor de Expressões. Uma instrução WHILE permite que os registros na exibição sejam processados somente enquanto a condição especificada avaliar como verdadeiro. Assim que a condição avaliar como falso, o processamento será encerrado e nenhum outro registro será considerado. A opção Enquanto pode ser usada em conjunto com as opções Todos, Primeiro e Próximos. O processamento de registros será interrompido assim que um limite for alcançado.

   Nota

   As opções Primeiro ou Próximos se referem à ordem física ou à ordem indexada de registros em uma tabela. Primeiro ou Próximos ignoram a filtragem ou a ordenação rápida aplicadas a uma exibição de tabela. Entretanto, os resultados de saída de operações analíticas respeitam qualquer filtragem.

   Se uma exibição for ordenada rapidamente, Próximos se comporta como Primeiros.

5. Clique em OK.

   Um indicador de progresso é exibido durante a exportação de dados de exceção ao Resultados. Quando a operação de exportação é concluída, uma entrada é criada no log.

Requisito de senha

Senha não obrigatória

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

Senha necessária

Você precisa especificar uma senha para exportar para o Resultados 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 exportar para os Resultados, 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.