Exportação de exceções para o Resultados do HighBond

Se você usar o HighBond, 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.

Requisitos de segurança

A capacidade de exportar dados de exceção para um teste de controle exige uma atribuição de função específica do HighBond 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 HighBond e os administradores do Resultados recebem automaticamente a função Gerente Profissional em todas as coleções das instâncias do HighBond que administram.

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

Será preciso especificar uma senha na exportação para o Resultados se você usou a ativação off-line para ativar sua cópia do Analytics. O valor de senha obrigatório é um token de acesso do HighBond.

Adquira um token de acesso do HighBond

1. No menu principal do Analytics, selecione Ferramentas > Token de Acesso do HighBond.

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

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

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

4. No Analytics, cole o token na solicitação de senha.
5. 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.

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

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 ( _ )

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 tabela 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 tabela 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 HighBond.
2. Execute uma das seguintes ações:
   • Anexar à tabela do Resultados

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

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

   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 HighBond 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)
     • 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 HighBond 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. Selecione a opção adequada do painel Escopo:

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

   Tudo	Esta opção é selecionada por padrão. Deixe essa opção marcada para especificar que todos os registros na exibição são processados.
   Primeiros	Selecione esta opção e insira um número na caixa de texto para começar a processar no primeiro registro na exibição e inclua somente o número especificado de registros.
   Próximo	Selecione essa opção e insira um número na caixa de texto para começar a processar no registro selecionado no momento na exibição e incluir somente o número especificado de registros. Deve ser selecionado o número do registro real na coluna mais à esquerda, não os dados na linha.
   Enquanto	Selecione esta opção para usar a 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. Você pode inserir uma condição na caixa de texto Enquanto ou clicar 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 O número de registros especificados nas opções Primeiros ou Próximos faz referência à ordem física ou indexada de registros em uma tabela e desconsidera qualquer filtro ou ordenação rápida aplicada na exibição. Entretanto, resultados de operações analíticas respeitam qualquer filtro. 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.