Relatório de integração

Sobre o relatório de integração

Todos os dias, o otimizador de viagem do cliente revisa seus sistemas conectados para garantir que os dados estão sendo chamados corretamente e compila seus resultados em um relatório. Este relatório exibe uma síntese dos dados que foram importados para cada fonte de entrada, incluindo se ocorreram falhas ou se não foram importados dados nesse dia.

Assinar o relatório de integração

Para receber o relatório de integração, você deve entrar em contato com seu representante de implementações Qualtrics e pedir que ele configure o relatório para ser enviado a você. Ao entrar em contato com seu representante, forneça suas preferências sobre a frequência com que deseja receber o relatório e quem deve recebê-lo.

• Frequência: Por padrão, o relatório é enviado uma vez por dia à meia-noite PST. Você pode personalizar a frequência de envio do relatório em uma hora diferente do dia ou várias vezes por dia.
• Público-alvo: forneça o endereço de e-mail da pessoa que deve receber o relatório. Neste momento, o relatório só suporta o envio para um endereço de e-mail.
  Qdica: Se você quiser enviar o e-mail para várias pessoas em sua organização, recomendamos que trabalhe com sua equipe de TI para configurar uma lista de distribuição que receberá o relatório. Qualquer pessoa inscrita na lista receberá o relatório.
  Qdica: o relatório também será enviado ao seu representante de implementações Qualtrics.

Dados incluídos no relatório

Cada relatório contém 2 tabelas que fornecem uma síntese dos dados que foram importados para o otimizador de viagem do cliente nesse dia. A parte superior do seu relatório conterá avisos sobre possíveis problemas que podem exigir sua atenção.

Avisos

Os avisos serão exibidos na parte superior do relatório em amarelo. Você deve prestar muita atenção aos avisos para garantir que todos os problemas relatados neles sejam resolvidos.

Um aviso comum que é exibido é “0 novas linhas de dados foram importadas nas últimas 24 horas” para uma determinada integração. Se você esperar novos dados para esta integração, mas não tiverem sido importados novos registros, provavelmente existe um problema com o modo como a conexão está configurada. Verifique se a conexão está configurada corretamente e se você tem as entidades corretas em sua síntese de dados.

Tabela 1

A primeira tabela em seu relatório fornece uma visão geral de cada fonte conectada. As colunas na tabela incluem:

• Integração: o nome da conexão (por exemplo, “webhook” ou “SFTP”).
• Nome da entidade: o nome da entidade importada da conexão. Algumas conexões podem ter várias entidades.
• Registros válidos: o número de registros válidos que foram importados.
• Registros com falha: o número de registros que falharam na importação.

Tabela 2

A segunda tabela em seu relatório fornece mais detalhes sobre os jobs de chamada individuais para cada fonte conectada. As colunas na tabela incluem:

• Integração: o nome da conexão (por exemplo, “webhook” ou “SFTP”).
• Nome da entidade: o nome da entidade importada da conexão. Algumas conexões podem ter várias entidades.
• ID da execução: o ID interno do Qualtrics desta execução de busca de dados específica.
• Data: a data e hora em que a busca de dados foi iniciada.
• Status: o status da execução. Os valores incluem:
  • Concluído_NR: o job foi concluído sem problemas.
  • Falha _NR: falha ao concluir a tarefa. Consulte a coluna Mensagens de falha para obter mais informações sobre a falha.
• Mensagens de falha: se a importação dos registros falhou, o motivo da falha. Consulte Resolvendo mensagens de falha para obter mais informações.

Resolvendo mensagens de falha

Esta seção abrange mensagens de falha comuns e como resolvê-las.

A chave primária configurada da entidade ‘<field name> ‘ está ausente no registro

Essa mensagem de erro significa que a chave primária está ausente no registro que foi tentado importar para a Qualtrics. Ao importar registros, eles devem ter a chave primária como definido no esquema de dados dessa entidade.

Não foi possível processar ‘<date value> ‘ em ‘<field name> ‘ porque tem um formato de data inválido

Esse erro significa que houve uma tentativa de importar um campo de data para o Qualtrics, mas falhou porque ele tem um formato de data inválido. Verifique seu campo para garantir que a data esteja no formato ISO-8601.

‘<Data Type> ‘ é um tipo de dados não suportado e precisa ser substituído por um tipo de dados válido

Este erro aparece quando você tenta importar um tipo de dados que não é suportado pelo otimizador de viagem do cliente (por exemplo, matrizes). Atualize o campo para que ele seja um tipo de dados suportado, conforme definido no esquema de dados da sua entidade.

Falha ao ler o mapeamento do esquema (Webhook)

Este erro aparece ao tentar importar registros de um webhook. Para resolver esse problema, consulte a seção “schemaFields” do payload do webhook e certifique-se de que os nomes dos campos do esquema correspondam aos campos do cliente no nome e no caso. Além disso, certifique-se de que os campos não contêm caracteres inválidos.