Definir exportadores

Os exportadores fornecem instruções para a apresentação dos dados do evento.

A funcionalidade de transformação fornece três tipos de exportadores para exportar arquivos .vsl, arquivos de log, arquivos XML e dados ODBC como arquivos .vsl, arquivos de texto ou arquivos de texto delimitados que podem ser usados por rotinas de carregamento de DataWarehouse, agências de auditoria ou outros alvos.

OBSERVAÇÃO

Para que um exportador funcione corretamente, a fonte de log deve atender aos requisitos apropriados discutidos na seção Fontes de Log do Arquivo de Configuração de Processamento de Log.

Definição de exportador

  1. Abra Transform.cfg no Data Workbench. Consulte Para editar o arquivo Insight Transform.cfg.

  2. Clique com o botão direito do mouse em Exporters e depois clique em Add New.

  3. Selecione uma das seguintes opções:

    • ExportTextFile
    • ExportDelimitedTextFile
    • ExportVSLFile
    OBSERVAÇÃO

    Para a opção ExportVSLFile, todos os campos estendidos no arquivo de entrada e todos os campos definidos pelo usuário do formulário cs(header) são sempre gravados no arquivo de saída VSL. Se você substituir um campo estendido existente, o novo valor será gravado no arquivo de saída, mesmo se o campo estiver em branco.

  4. Edite os parâmetros Exportadores no arquivo de configuração usando a tabela a seguir como guia:

    Parâmetro Descrição
    Formato dos dados

    Apenas para ExportTextFile. O formato de cada linha de saída, que consiste em escape de nome de campo (expresso como %fieldname%) e qualquer outro texto fixo desejado. O formato deve incluir um separador de linha, normalmente [CR] [LF].

    Um sinal de porcentagem literal (%) pode ser incorporado na string de formato, escapando do caractere, como mostrado aqui: %%

    Um exemplo de entrada para o parâmetro Formato de Dados é %x-timestring% %x-trackingid%[CR][LF].

    Campos Apenas para ExportDelimitedTextFile. Nomes dos campos a serem enviados.
    Delimitador

    Opcional. Apenas para ExportDelimitedTextFile. Caractere usado para separar os campos no arquivo de saída.

    O software não pode escapar delimitadores incluídos nos valores dos dados. Como resultado, o Adobe não recomenda usar vírgulas como delimitadores.

    Se você pressionar a tecla Ctrl e clicar com o botão direito do mouse no parâmetro Delimitador, um menu Inserir é exibido. Esse menu contém uma lista de caracteres especiais que geralmente são usados como delimitadores.

    Separador de linha Opcional. Apenas para ExportDelimitedTextFile. Os caracteres usados para separar linhas nos arquivos de saída. O valor padrão é [CR] [LF].
    Nome

    Opcional. Identificador do exportador. Esse nome aparece na interface Status Detalhado.

    Para obter informações sobre a interface Status Detalhado, consulte o Guia do Usuário do Data Workbench.

    Comentários Opcional. Notas sobre o exportador.
    Caminho de saída

    Caminho onde os arquivos de saída devem ser armazenados. O caminho é relativo à pasta de instalação do servidor do Data Workbench.

    Observação: O servidor do Data Workbench que armazena dados de saída é o servidor de processamento #0 no arquivo profile.cfg.

    Período de rotação do arquivo

    Opcional. A frequência na qual os dados são exportados para o arquivo de saída. Cada arquivo de saída contém dados relacionados a um período de tempo específico chamado período de rotação. Todos os cálculos de tempo estão em GMT: Um dia começa à meia-noite GMT e termina no dia seguinte à meia-noite GMT, mesmo que os dados gravados no arquivo incluam um campo que foi transformado para hora local.

    Os valores disponíveis são os seguintes:

    • ANO. Cada arquivo contém dados de um ano civil.
    • MÊS. Cada arquivo contém dados de um mês. Os meses são numerados de 1 (janeiro) a 12 (dezembro).
    • SEMANA. Cada arquivo contém dados de uma semana. Uma semana começa na segunda-feira. A semana que começa em um dos primeiros sete dias do ano é a semana 1 e a semana anterior (parcial), se houver, é a semana 0.
    • DIA. Cada arquivo contém dados de um dia de calendário.
    • HORA. Cada arquivo contém dados por uma hora.
    • NONE. Nenhuma rotação é executada. Todos os dados são gravados no mesmo arquivo (ou em um conjunto de arquivos, conforme determinado por outras configurações de parâmetro). Consulte o parâmetro File Name Format nesta tabela.

    O período padrão de rotação do arquivo é DIA.

    • Defina a rotação do arquivo como NONE somente quando estiver trabalhando em Modo offline. Consulte a descrição do parâmetro Modo offline.
    Formato do nome do arquivo

    Opcional. O formato do nome do arquivo de saída.

    Cada entrada de log pode ser armazenada em um arquivo cujo nome é derivado da hora de início do período de rotação e, opcionalmente, de valores de campos nas linhas que contém. Os campos a serem usados no nome do arquivo são incorporados como escape do nome do campo (expresso como %fieldname%).

    Os componentes de nome de arquivo relacionados ao período de rotação são incorporados na string de formato usando as seguintes sequências de escape:

    • %yyyy% (ano de quatro dígitos)
    • %yy% (ano com dois dígitos)
    • %mm% (mês com dois dígitos, 01 - 12)
    • %ww% (semana de dois dígitos, 01 - 52)
    • %dd% (dia com dois dígitos, 01 - 31)
    • %HH% (hora de dois dígitos, 00 - 23)

    O formato de nome de arquivo padrão é %yyyy%%mm%%dd%-%x-mask%.txt

    • As sequências de escape fazem distinção entre maiúsculas e minúsculas.
    • Quando o Período de Rotação de Arquivo é definido como NONE, uma string vazia é substituída por cada uma das sequências de escape, se houver.
    • Um erro é gerado se Formato de Nome de Arquivo não resultar em um nome de arquivo exclusivo para cada período de rotação (consulte o parâmetro Período de Rotação de Arquivo nesta tabela). Por exemplo, ao usar o período de rotação DIA, as sequências de escape %dd%, %mm% e %yy% ou %yyyy% devem estar presentes no padrão para evitar perda de dados.
    • Se você estiver usando sequências de escape de nome de campo dentro do padrão e o campo fornecido tiver muitos valores distintos, muitos arquivos de saída serão gravados para cada período de rotação. Observe que esse cenário pode resultar em desempenho inadequado, portanto, você deve usar esse recurso com cautela.
    • Os cálculos são sempre em GMT.
    Executar na rolagem

    Opcional. Quando cada arquivo é finalizado, um comando externo (Windows) pode ser executado. A linha de comando é derivada do nome final do arquivo, substituindo as seguintes sequências de escape neste parâmetro:

    • %dir%. A parte do diretório do nome do arquivo final, incluindo a barra invertida à direita.
    • %file%. O nome do arquivo (excluindo o diretório e a extensão) do arquivo final.
    • %ext%. A extensão (incluindo o "." à esquerda) do nome do arquivo final.
    • %caminho%. O nome completo do caminho do ficheiro, equivalente a %dir%%file%%ext%.

    Por padrão, esse parâmetro fica vazio (nenhum comando é executado).

    Limite de memória

    Opcional. A quantidade de memória em bytes usada para buffering da saída do exportador. O valor padrão é 10.000.000 bytes.

    Observação: Se você tiver muitos arquivos de saída abertos ao mesmo tempo, talvez queira aumentar esse valor, mas pode diminuir a quantidade de memória disponível para uso por outros componentes do sistema. No entanto, a diminuição desse valor pode retardar o processo de exportação. Para obter ajuda, entre em contato com o Adobe.

    Limite de arquivos abertos

    Opcional. O número máximo de processos que podem ser abertos ao mesmo tempo para saída do exportador. Se esse número for excedido, um erro será registrado no log de eventos e o servidor do Data Workbench interromperá a execução. O valor padrão é 1000.

  5. Depois de definir seu exportador (e fazer alterações em outros parâmetros) no arquivo Transform.cfg, salve o arquivo localmente e salve-o no perfil apropriado na máquina do servidor do Data Workbench.

Nesta página