Tag RESULT

Especifica que os resultados gerados por um script de análise estão disponíveis em aplicativos cliente para os usuários finais.

Os resultados de saída, mesmo quando existentes, não são automaticamente disponibilizados.

Nota

Se sua organização usa um Agente do Robôs local, a especificação da tag RESULT pode causar o upload de dados do agente para o aplicativo Robôs baseado na nuvem do HighBond. Para obter mais informações, consulte Uploads para o aplicativo Robôs baseado na nuvem.

Sintaxe

//RESULT tipo nome
  <descrição>

Parâmetros

Nome Descrição
tipo

O tipo do item de resultado:

  • TABLE – uma tabela do Analytics e o arquivo de dados associado (.fil)
  • LOG – um arquivo de log de análise.
  • FILE – um arquivo não Analytics

Nota

Não use //RESULT LOG or //RESULT FILE se sua organização usa um Agente do Robôs local e desativou os uploads de arquivos para o Robôs. Para obter mais informações, consulte Uploads para o aplicativo Robôs baseado na nuvem.

Para obter mais informações sobre logs, consulte Como os arquivos de log são gerados.
nome

O nome do item de resultado.

Nota

O valor de nome deve corresponder exatamente ao nome do item de resultado no script de análise. Você não atribui um item a uma tabela com o valor de nome, mas corresponde esse valor a um nome especificado no script.

Você pode usar caracteres curinga em nome para ajudar a corresponder um nome no script.

Não é possível usar uma variável para nome.

Nome da tabela

O valor de nome especifica um nome de tabela do Analytics. Você deve especificar o nome da tabela e não o nome do arquivo de dados de origem.

Correto:

//RESULT TABLE Cheques_Faltantes

Incorreto:

//RESULT TABLE Verificacoes_Faltantes.fil

Não inclua nenhum espaço no nome.

Não use nenhum dos seguintes caracteres no nome. Eles não são permitidos:

! @ # $ % ^ & ( ) - + = { } [ ] | \ : ; ' " < > , / . ` ~

Nome do log

Opcional. O valor de nome especifica um nome de arquivo de log da análise. Se você não especificar nome, será usado o nome de log padrão: nome_análise.log.

Nota

Se você especificar um nome de log, SET LOG TO nome_log deve aparecer no script.

Não inclua nenhum espaço no nome.

Não use nenhum dos seguintes caracteres no nome. Eles não são permitidos:

< > : " \ / |

Nome do arquivo

O valor de nome especifica um nome de arquivo não Analytics.

Você deve especificar a extensão de arquivo adequada para o tipo de arquivo não Analytics sendo gerado.

Correto:

//RESULT FILE Cheques_Faltantes.xlsx

Incorreto:

//RESULT FILE Cheques_Faltantes

Não inclua nenhum espaço no nome.

Não use nenhum dos seguintes caracteres no nome. Eles não são permitidos:

< > : " \ / |

Caracteres curinga

Um ou mais caracteres curinga em nome para ajudar a corresponder uma tabela, um log ou um nome de tabela no script. Utilize um único asterisco (*) para substituir zero ou mais caracteres consecutivos.

Os padrões criados pela combinação de caracteres curinga e literais permitem corresponder todos os itens de um determinado tipo (por exemplo, *.xlsx) ou itens em que parte do nome pode mudar de acordo com uma definição de variável no script.
descrição

opcional

Texto descritivo sobre o resultado ou outras informações. A descrição pode conter diversas linhas, mas não pode pular nenhuma.

A descrição aparece somente no cabeçalho da análise e não é visível para usuários finais em aplicativos cliente.

Exemplos

Exemplos básicos

Tag RESULT para uma tabela do Analytics:

//RESULT TABLE Cheques_Faltantes

Tag RESULT para um log de análise com o nome padrão:

//RESULT LOG

Tag RESULT para um log de análise com um nome especificado:

//RESULT LOG Nome_meu_log
,
,
,
SET LOG TO Nome_meu_log

Tag RESULT para um arquivo Excel específico:

//RESULT FILE Cheques_Faltantes.xlsx

Tag RESULT para todos os arquivos Excel:

//RESULT FILE *.xlsx

Exemplos avançados

Nome da tabela com um mês variável

O nome de uma tabela de saída inclui o mês (faturas-jan, faturas-fev e assim por diante). Portanto, você especifica faturas-* para garantir que a tabela seja disponibilizada nos resultados independentemente do sufixo do mês:

//RESULT TABLE faturas-*

Nome da log com uma data variável

O nome de um arquivo de log inclui um carimbo de data (preparar_tabela_faturas_31072019 e assim por diante). Portanto, você especifica preparar_tabela_faturas_* para garantir que o arquivo de log seja disponibilizado nos resultados, independentemente do carimbo de data:

//RESULT LOG preparar_tabela_faturas_*

Nome de arquivo com um mês variável

O nome de um arquivo de saída inclui o mês (faturas-jan.xlsx, faturas-fev.xlsx e assim por diante). Portanto, você especifica faturas-*.xslx para garantir que o arquivo seja disponibilizado nos resultados independentemente do sufixo do mês:

//RESULT FILE faturas-*.xlsx

Nome de arquivo com um mês e um formato variáveis

O nome de um arquivo de saída inclui o mês e é gerado em formatos diferentes(faturas-jan.xlsx, faturas-jan.del e assim por diante). Portanto, você especifica faturas-*.* para garantir que os arquivos sejam disponibilizado nos resultados independentemente do sufixo do mês ou do tipo do arquivo:

//RESULT FILE faturas-*.*

Observações

Uploads para o aplicativo Robôs baseado na nuvem

Se sua organização usa um Agente do Robôs local, a especificação da tag RESULT em um cabeçalho de análise pode causar o upload de dados do agente para o aplicativo Robôs baseado na nuvem do HighBond. Todos os dados são criptografados em trânsito e quando armazenados no Robôs.

A configuração Carregamentos de arquivos permitidos no Robôs controla se os resultados de saída especificados pela tag RESULT são:

  • aceitos para upload para o Robôs
  • restritos para geração local no servidor em que o Agente do Robôs está instalado

Para obter mais informações sobre a configuração, consulte Configurando um Agente do Robôs.

Tag de análise Configuração "Carregamentos de arquivos permitidos":
Somente arquivos de resultados e logs Tabelas, arquivos e logs de resultados Carregamentos de arquivos não permitidos
Tabela de Resultados

Somente são carregados os layouts das tabelas de resultados do Analytics (nome do campo, tipo de dados, comprimento do campo)

Os dados da tabela de resultados permanecem no servidor na sua rede

As tabelas de resultados do Analytics (layout e dados) são carregadas

Somente são carregados os layouts das tabelas de resultados do Analytics (nome do campo, tipo de dados, comprimento do campo)

Os dados da tabela de resultados permanecem no servidor na sua rede
//RESULT LOG

Os arquivos de log do Analytics das tarefas bem-sucedidas e com falhas são carregados

Os arquivos de log do Analytics das tarefas bem-sucedidas e com falhas são carregados

Não especifique, causa falha no script de análise
//RESULT FILE

Arquivos de resultados não Analytics (como Excel) são carregados

Arquivos de resultados não Analytics (como Excel) são carregados

Não especifique, causa falha no script de análise

Como os arquivos de log são gerados

A forma como os arquivos de log de scripts de análise são gerados depende dos seguintes fatores:

  • se o script foi bem-sucedido ou falhou
  • o aplicativo onde o script é executado
  • a configuração Carregamentos de arquivos permitidos (somente para Agente do Robôs local)

    Para obter mais informações sobre a configuração, consulte Configurando um Agente do Robôs.

Script de análise bem-sucedido

Agente do Robôs local Agente do Robôs baseado na rede Servidor AX Janela Aplicativo de análise
  • RESULT LOG especificado

    arquivo de log carregado para o aplicativo Robôs baseado na nuvem, a menos que a configuração Carregamentos de arquivos permitidos esteja definida como "Carregamentos de arquivos não permitidos"

  • RESULT LOG não especificado

    sem arquivo de log
  • RESULT LOG especificado

    arquivo de log gerado para o aplicativo Robôs baseado na nuvem

  • RESULT LOG não especificado

    sem arquivo de log
  • RESULT LOG especificado

    arquivo de log gerado no Servidor AX (disponível em aplicativos cliente)

  • RESULT LOG não especificado

    sem arquivo de log
  • RESULT LOG especificado

    arquivo de log gerado na guia Resultados

  • RESULT LOG não especificado

    sem arquivo de log

Falha no script de análise

Agente do Robôs local Agente do Robôs baseado na rede Servidor AX Janela Aplicativo de análise
  • Tag RESULT LOG não considerada

    arquivo de log carregado automaticamente para o aplicativo Robôs baseado na nuvem, a menos que a configuração Carregamentos de arquivos permitidos esteja definida como "Carregamentos de arquivos não permitidos"
  • Tag RESULT LOG não considerada

    arquivo de log gerado automaticamente para o aplicativo Robôs baseado na nuvem
  • Tag RESULT LOG não considerada

    arquivo de log gerado automaticamente no Servidor AX (disponível em aplicativos cliente)
  • Tag RESULT LOG não considerada

    arquivo de log gerado automaticamente na guia Resultados

Limitação de tamanho de arquivo de resultado no Servidor AX

Para scripts de análise executados no Servidor AX, os arquivos de resultado estão limitados ao máximo de 2 GB. Se o arquivo exceder esse tamanho, os resultados não serão salvos.

Armazenamento e disponibilidade do arquivo Resultado durante a execução de script no Servidor AX

Quando você usa a tag RESULT FILE, o arquivo criado é disponibilizado para download pelo Cliente Web AX e pelo Cliente AX após a conclusão do script. O arquivo é armazenado no banco de dados do AX e não está disponível no sistema de arquivos do Servidor AX quando o script não está em execução.

Durante a execução do script, o arquivo fica temporariamente disponível no sistema de arquivos do Servidor AX e você pode trabalhar com ele usando processos externos, como os invocados usando o comando EXECUTE. Durante a execução do script, os processos externos podem acessar o arquivo na subpasta da tarefa de análise.

Nota

Por padrão, as subpastas das tarefas de análise estão localizadas dentro de ACL\Data\jobs. Após a conclusão do script, a subpasta de tarefas de análise é removida e o arquivo é armazenado no banco de dados.