Guia do Usuário › Design › Conversões › Scripts de conversão › Adicionar um script de conversão

Adicionar um script de conversão

Importante: ao criar um script de conversão, nunca use o objeto Ferramentas no escopo global. Use-o somente no procedimento e função do Script.

Para adicionar um script de conversão:

1. Na página Scripts de conversão, clique em Adicionar. A página Detalhes do script de conversão é exibida.
2. Na guia Geral:
   1. Em Nome, digite o nome do script de conversão.
   2. Em Descrição, digite uma descrição do script de conversão.
   3. Em Status, selecione Desativado para definir o script de conversão sem executá-lo ou Ativado para ativar o script a ser executado.
   4. Em Fuso horário, selecione o fuso horário interno para o script. Todas as datas no script usam o mesmo fuso horário e o formato de data e hora de acordo com o fuso horário definido. Esse é um campo obrigatório.
   5. Selecione Executar a cada para programar o intervalo para a execução do script de conversão.
   6. Em Horário da próxima execução, digite a hora de início do script de conversão. Essa opção é ativada se Executar a cada estiver selecionado.
   7. Em Executa o script após, selecione o script que será executado antes dessa tarefa.

   Observação: use Executa o script após apenas quando houver dois scripts a serem executados simultaneamente.

3. Na guia Conversão:
   1. Selecione Executar em entradas novas se o script de conversão for ser executado somente nas novas entradas.
   2. Selecione Executar apenas em entradas pendentes se o script de conversão for ser executado somente nas entradas pendentes.
   3. Selecione Executar em todas as tabelas se o script de conversão for ser executado em todas as tabelas de conversão, mesmo os que forem criados no futuro. (Para obter um melhor desempenho, essa opção não é recomendável.)
   4. Em Tabelas de conversão utilizadas, selecione as tabelas de conversão que são relevantes para o script de conversão na lista Tabelas de conversão disponíveis e mova-as para a lista Incluir.

   Observação: para obter o desempenho ideal, uma tabela de conversão é atribuída somente a um único script de conversão que tenha a opção Executar apenas em entradas pendentes selecionada.

   1. Selecione Filtro adicional e digite a condição para o filtro usando os campos relevantes dos campos Entrada de conversão. Para obter um melhor desempenho, essa opção não é recomendável.

   Observação: o filtro define em quais entradas o script é executado. O filtro final é uma combinação das informações selecionadas.

   Os critérios de filtro disponíveis são: FIELD_NAME_1, FIELD_NAME_2, FIELD_NAME_3, FIELD_NAME_4, FIELD_NAME_5.

   Esses campos definem a tabela de conversão na tabela T_TRANSLATION_DEFINITIONS tabela.

   Use esses campos quando estiver gravando uma instrução "where" em uma consulta SQL (sem o "where").
   Exemplo: FIELD_NAME_1 = 'val1' e FIELD_NAME_2 = 'val2'

   Observação: quando o script de conversão é executado nas novas entradas, ele usa somente as entradas da tabela de conversão utilizada. O script ignora as outras definições de filtro.

   1. Clique em Verificar filtro adicional para verificar a sintaxe do filtro adicional.

   Se não houver nenhum erro, uma sequência de caracteres de confirmação será exibida. Se houver um erro, o motivo do erro será exibido.

4. Na guia Script:
   1. Digite o código do script. Uma barra de ferramentas de script, localizada acima da área do script, permite executar funções adicionais no script, como descrito na tabela a seguir:

1. Selecione Verificar script ao salvar para verificar a sintaxe do script quando Salvar for executado.

1. Clique em Salvar para salvar o script.
2. Clique em Cancelar para descartar as alterações e retornar à página anterior.

Observação: use os recursos na caixa de diálogo para editar, excluir, executar, pesquisar e exibir os detalhes de um script de conversão.

Se tiver selecionado idiomas do Extremo Oriente, terá os seguintes ícones:

Selecione Verificar script ao salvar para verificar a sintaxe do script quando Salvar for executado.

Observação: consulte o Guia de Administração para obter instruções sobre como permitir idiomas do Extremo Oriente no BSI.