Show Menu
TÓPICOS×

Resolução de problemas e práticas recomendadas do Report Builder

Maneiras de otimizar a entrega do Report Builder e uma lista de mensagens de erro que podem ocorrer ocasionalmente.

Usuários do Report Builder 5.0 e abertura das pastas de trabalho 5.1

A Adobe alterou o separador entre as dimensões e as classificações de um caractere sublinhado (_) para ||. Essa mudança tem implicações de compatibilidade para um usuário do Report Builder 5.0 que abre uma pasta de trabalho do Report Builder v5.1 com solicitações de classificação. Sempre que uma pasta de trabalho de uma versão anterior ao v5.1 é aberta, todas as solicitações de classificações serializadas são convertidas nesse formato.
Isso causa um problema de compatibilidade futura: depois de convertido em v5.1, se uma pasta de trabalho for compartilhada com um usuário no Report Builder v5.0, esse usuário não poderá reconhecer a solicitação de classificação (procura "_", mas o v5.1 procura "||" serializado).
O problema ocorre ao abrir uma pasta de trabalho ARB v5.1 com a solicitação de classificação:
  • Ao abrir uma pasta de trabalho, você receberá o seguinte aviso: "Esta pasta de trabalho foi salva pela última vez com o Report Builder v5.1. Essa versão apresentou alguns recursos incompatíveis com a versão do Report Builder instalada no computador. É recomendado atualizar para a versão mais recente do Report Builder antes de atualizar esta pasta de trabalho".
  • Se você clicar com o botão direito em uma solicitação de ARB com classificação, os menus de contexto do Report Builder (editar solicitação, adicionar solicitação dependente...) não aparecerão.
  • Se você executar Atualizar tudo, ao clicar no terceiro botão, ou ao atualizar um conjunto de solicitações do formulário do Gerenciador de solicitação, a solicitação de classificação será executada sem erro. No entanto, os valores de classificação não serão expressos.
  • Você ainda pode editar a solicitação ao abrir o Gerenciador de solicitações, de linha em linha, até atingir a solicitação apropriada.
  • Se você editar a solicitação, não alterar os parâmetros e, em seguida, clicar em Concluir, a resposta será expressa apropriadamente. A edição da solicitação soluciona o problema à medida que os parâmetros do Layout de resposta são serializados novamente. Portanto, há uma solução, embora seja demorada.

Problemas de autenticação no Report Builder

O Report Builder exige autenticação para criar solicitações de dados dos seus conjuntos de relatórios. Às vezes, ocorrem questões ao acessar o Report Builder dependendo de suas configurações no Analytics na sua rede.
Empresa de logon inválido
Esse erro geralmente ocorre quando a empresa de logon é inserida incorretamente ou se houver problemas de atividade de rede. Faça o seguinte:
  • Verifique a ortografia da empresa de logon para garantir que não haja erro de digitação ou de espaçamento.
  • Faça logon no Analytics com a mesma empresa de logon para garantir que esteja correto. Se não conseguir fazer logon com essas credenciais, entre em contato com um dos administradores do de sua organização para obter a empresa de logon correta.
Firewall
O Report Builder usa as portas 80 e 443. Assegure que essas portas estejam permitidas no firewall de sua organização. Veja também os endereços IP internos do Adobe para outras exclusões de firewall.

Recomendações para solicitações de otimização

Os seguintes fatores podem aumentar a complexidade do pedido e resultar em um processamento mais lento:
Fatores que podem atrasar entregas
  • Muitos favoritos, painéis e pastas de trabalho do Report Builder foram agendados dentro de poucas horas.
  • Muitas pastas de trabalho do Report Builder foram agendadas ao mesmo tempo. Quando isso ocorre, a fila de relatórios do API fica lotada.
Fatores que podem atrasar o tempo de execução da pasta de trabalho
  • Aumento significativo nas classificações.
  • Aumento do intervalo de solicitação de dados ao longo do tempo.
    Exemplo : suponha que você crie uma solicitação de tendência usando a configuração Ano atual, discriminada pela granularidade Dia. No fim do ano, a solicitação irá retornar mais períodos que o primeiro criado no início do ano.
    (January 1 - January 30 versus January 1 - December 31.)
Causas que resultam na falha de entrega da pasta de trabalho
Fórmulas complexas do Excel em uma pasta de trabalho, particularmente as que envolvem data e hora.
Células que retornam 0s (sem valores)
Uma apóstrofe ou uma aspa simples no nome da planilha do Excel fará com que o Report Builder não retorne valores. (Esta é uma limitação do Microsoft Excel).
Desempenho individual de solicitação
A velocidade do processo pode ser afetada pelas seguintes configurações:
Configuração
Desempenho mais rápido
Desempenho mais devagar
Análises e a ordem da análise
Poucas
Muitas
Exemplo: se você analisar A por Z, o número de itens para A deve sempre ser menor que o número de itens para Z. Se for o contrário, o tempo de solicitação pode aumentar significativamente.
Intervalo de data
Intervalo pequeno
Intervalo grande
Filtragem
Filtragem específica
Filtragem mais popular
Granularidade
Agregado
Por hora
  • Diariamente
  • Semanalmente
  • Mensalmente
  • Trimestralmente
  • Anualmente
Número de entradas
Conjunto de dados pequeno
Conjunto de dados grande
Período de agendamento
Programação ordenada durante o período de 24 horas (consulte a tabela abaixo). Favoritos, painéis e pastas de trabalho do Report Builder já existentes que foram agendados muito próximos podem causar atrasos.
Agende as solicitações maiores e mais complexas no início da manhã para permitir que o manual extraia e atualize para ocorrer durante o dia útil.
Período de agendamento
1 h - 2 h
2 h - 7 h
7 h - 18 h
18 h - Meia-noite
Uso do Report Builder
Silencioso
Muito ocupado
Uso do lado do cliente.
Maiores volumes de usuários atualizando e solicitando para "Enviar imediatamente".
Além disso, verifique se a fila da API é apagada ao programar tempo limite da pasta de trabalho.
Não ocupado
Limites de tempo
Qualquer relatório agendado atinge o tempo limite depois de quatro horas. O sistema tenta programar por mais três vezes, resultando em uma falha. (Geralmente, quanto maior o conjunto de dados, maior é o tempo para execução.) Estes podem ser vistos nos relatórios do Analytics e do Report Builder:
  • Analytics: Favorites > Scheduled Reports
  • Report Builder: clique em Management na guia Add-ins no Excel.

Descrições de mensagens de erro

Uma lista de mensagens de erro que podem ocorrer ocasionalmente durante o uso do Report Builder.
Esta é apenas uma seleção de mensagens de erro, não uma lista exaustiva. Para obter mais informações sobre como solucionar erros, contate o administrador.
Esse recurso pode ser aplicado somente a uma pasta de trabalho aberta.
Se nenhuma pasta de trabalho (documentos de planilhas) estiver aberta no Excel e você clicar em um dos ícones na barra de ferramentas do Report Builder, esta mensagem será exibida. Além disso, a barra de ferramentas fica desativada até que você abra uma planilha. No entanto, você pode clicar no ícone de Ajuda online enquanto a barra de ferramentas ainda está ativada, sem causar este erro.
É necessário sair do Request Wizard antes de ativar o Request Manager.
Embora o Request Manager e o Request Wizard estejam vinculados funcionalmente, não é possível começar a trabalhar com o Request Manager antes de concluir ou cancelar ações feitas no Request Wizard.
Não há solicitações associada a esse intervalo.
Esta mensagem de erro ocorre se você clicar no botão From Sheet no Request Manager quando uma célula da planilha não tiver solicitações.
Para identificar quais células na planilha têm solicitações, clique nas solicitações individuais listadas na tabela no Request Manager. Se uma solicitação estiver associada a células, as células aparecerão realçadas quando a solicitação for selecionada na tabela.
O intervalo selecionado não é válido. Selecione outro intervalo.
Se uma célula da planilha for selecionada e já houver uma solicitação mapeada para ela, este erro ocorrerá. Exclua a solicitação mapeada para as células ou escolha outro intervalo de células para mapear.
Quando quiser excluir células, é importante localizar as que contenham solicitações e excluir as solicitações antes de excluir as células (removendo linhas ou colunas).
Saia da célula do Excel onde está o foco antes de usar esse recurso.
Caso esteja no modo de edição em uma célula do Excel e clique em um dos ícones do Report Builder, esta mensagem de erro será exibida. O modo de edição em uma célula do Excel significa que a célula está selecionada e o cursor aparece dentro dela. Você também está no modo de edição em uma célula do Excel quando digita diretamente na barra Formula ou na Name Box na parte superior do Excel.
O intervalo selecionado faz interseção com o intervalo de outra solicitação. Altere sua seleção.
Se você já tiver mapeado um conjunto de células para a planilha, este erro será exibido.
Uma maneira de determinar quais células estão mapeadas antes de adicionar novas solicitações é fechar o Request Wizard e abrir o Request Manager. Em seguida, selecione, um por um, os itens listados na tabela de resumo de solicitações. Sempre que você selecionar uma solicitação na lista, as células correspondentes que contêm os mapeamentos da solicitação são realçadas na planilha.
Este é um motivo para você considerar a marcação de células com realce, informações de linha ou coluna ou um estilo de formatação antes de mapear várias células para várias áreas.