Exportando Dados

Importante: este tópico é para usuários da versão mais recente do Connect. Se a sua conta ainda usar o Connect Clássico, faça download do Guia do Usuário do Connect Clássico.

Assista ao vídeo para saber mais.

Com o Connect, você pode exportar os seguintes tipos de origens de dados do Oracle Responsys:

  • Lista
  • Público-alvo
  • Lista de canais de aplicativo
  • Filtro de lista
  • Dados da tabela de extensões de perfil
  • Dados da tabela complementar

Para criar um job para Exportar Dados:

  1. Clique em Dados na barra de navegação lateral e selecione Connect.
  2. Clique em Criar Job na página Gerenciar Connect.
  3. Selecione Exportar Dados na lista suspensa e informe um nome e uma descrição para o job de exportação.

    Os nomes de job não podem ter mais de 100 caracteres e só podem incluir os seguintes caracteres: A-Z a-z 0-9 espaço ! - = @ _ [ ] { }

  4. Clique em Concluído.

    O assistente de exportação do Connect é aberto. Você pode concluir essas etapas em qualquer ordem, salvar as alterações e continuar depois.

    Uma imagem do assistente de exportação do Connect

  5. Conclua as etapas:
  6. Depois de configurar todas as etapas, clique em Ativar para ativar o job.

    Importante: antes de poder salvar ou ativar o job, você precisa definir uma data de expiração ou definir que ele nunca expire. Para definir uma data de expiração, clique em EditarUma imagem do ícone Editar ao lado de Expiração. Quando o job expira, ele é excluído e não pode ser recuperado. Saiba mais sobre gerenciamento da data de expiração.

Depois de concluir:

  • Depois de salvar seu job, você pode usar a página Gerenciar Connect para gerenciar o job. Saiba mais sobre o gerenciamento de jobs.
  • Quando você salva seu job, o Connect pode retornar erros. Clique em Mostrar Erros para analisar os erros e ir rapidamente para a página que precisa de correção. Você deve resolver todos os erros antes de ativar o job.

    Uma imagem indicando erros em um job do Connect

Etapa 1: Selecionar Objeto

Nesta etapa, selecione os objetos a serem exportados. Você pode exportar as seguintes opções:

  • Listas
  • Públicos-alvo
  • Listas de Canais de Aplicativo
  • Filtros de lista ou filtros de Lista de Canais de Aplicativo
  • Dados da tabela de extensões de perfil
  • Dados da tabela complementar

Para selecionar o objeto a ser exportado:

  1. Na etapa Selecionar Objeto, selecione o tipo de objeto que deseja exportar.
  2. Selecione os objetos da lista a serem exportados.
    • Para lista de perfis: escolha Lista se for solicitado ou se quiser usar uma lista diferente da que é mostrada.
    • Para públicos-alvo, listas de canais de aplicativo e tabelas de extensões de perfil: selecione a lista à qual a origem de dados está relacionada antes de selecionar a origem de dados.
    • Para filtros de lista, escolha a Lista e o Filtro.
    • Para filtros de listas de canais de aplicativos, primeiro selecione o objeto do filtro de Lista. Em seguida, escolha a Lista e selecione Usar Lista de Canais de Aplicativo. Depois escolha o Filtro.
  3. Opcionalmente, para listas e tabelas, você pode restringir os registros aos modificados desde a última execução do job (com base no carimbo de data e hora da última execução do job). Para fazer isso, selecione Exportar apenas registros inseridos ou atualizados depois da hora da última execução do job.

Etapa 2: Conectividade de Destino

Nesta etapa, especifique o local para envio do arquivo de exportação. Você pode exportar para o servidor de arquivos da Responsys ou para um servidor de SSH File Transfer Protocol (SFTP). Você pode enviar o arquivo de exportação para até 3 locais

Use o seguinte para ajudar a concluir esta etapa:

  • Servidor de Arquivos do Responsys

    Por padrão, o Connect importa dados por meio do servidor de arquivos de contas do SCP (Secure Copy Protocol) do Responsys. Essa conta inclui três diretórios: upload, download e arquivo. Você pode escolher o diretório no qual armazenar arquivos.

    IMPORTANTE: o Suporte do Oracle Responsys e sua própria equipe de TI precisarão trabalhar juntos para gerar um par de chaves pública/privada SSH-2, caso isso ainda não tenha sido estabelecido. Isso garante acesso seguro à sua conta SCP por meio de um cliente SSH/SCP. Você também pode criar seus próprios diretórios usando um cliente SSH (Secure Shell).

  • Servidor externo por SFTP

    Se você selecionar esta opção, forneça as seguintes informações:

    • Nome do Host: selecione o nome do host na lista suspensa.
    • Caminho do Diretório: informe o nome do caminho do diretório associado.
    • Nome do Usuário: informe o nome do usuário para acessar sua conexão SFTP.
    • Autenticação: dependendo da maneira como seu servidor está configurado, selecione Senha ou Chave.

      Se este for seu primeiro job usando autorização por chave, clique em Acessar ou Gerar Informações da Chave e informe o endereço de e-mail a receber a chave pública e as instruções para adicionar a chave à sua conta SFTP. Depois de instalar a chave pública, clique em Testar Conexão para verificar se a configuração da sua conexão SFTP é válida.

      DICA: para obter informações sobre autenticação com chave, consulte Selecionando, Importando ou Gerando Chaves Públicas.

Etapa 3: Especificação de Destino

Nesta etapa, especifique as definições do arquivo de destino.

  • Arquivo a ser criado: o nome completo e a extensão do arquivo a ser criado. É possível adicionar a data de criação do arquivo como prefixo e/ou sufixo. Para fazer isso, selecione um formato de data na lista Prefixo ou Sufixo.

    Quando um arquivo é criado, jobID e executionID são adicionados automaticamente como prefixo no nome do arquivo. Isso significa que você deve incluir o ID do job e o ID da execução ao fazer referência ao arquivo

  • Conjunto de caracteres: o conjunto de caracteres do arquivo.
  • Delimitador de campos: o delimitador que divide os campos (colunas) no arquivo.
  • Inclusão de campo: especifique se as colunas de texto e os valores devem ser delimitados por aspas simples ou duplas.

    Observação: o sistema substituirá delimitadores por espaços em todos os campos de texto dos dados de feeds de eventos exportados quando NONE for escolhido como o caractere de fechamento, desde que a conta esteja configurada para isso. Por exemplo, se você configurar um job de exportação de dados do feed de eventos usando uma conta do Responsys configurada para esse comportamento e depois escolher NONE como o fechamento do campo e o caractere de tabulação como delimitador do campo, o Responsys substituirá todos os caracteres de tabulação dentro dos campos de texto com espaços.

  • Inserir cabeçalho da coluna na primeira linha: marque esta caixa de seleção se a primeira linha do arquivo contiver nomes de campos.
  • Criptografia/compactação: compacte seu job como um arquivo .ZIP ou .GZ e/ou criptografe-o. Se você escolher a opção para compactar e criptografar o arquivo com a chave PGP/GPG, clique no botão Selecionar ou importar chave para selecionar uma ou mais chaves públicas na lista ou para importar uma nova chave pública.
  • Inserir cabeçalho da coluna na primeira linha: marque esta caixa de seleção se a primeira linha do arquivo exportado contiver cabeçalhos de coluna.
  • Arquivo pronto adicional na conclusão do download: um arquivo pronto é usado para validação depois que o arquivo é exportado.
    • Selecione Criar arquivo vazio para validar a conclusão de seu processo de download.
    • Selecione Criar arquivo com número de registros para comparar contagens de registros simples para verificar se todos os registros esperados foram transferidos.

    Em ambas as opções, o arquivo pronto terá o mesmo nome do job de exportação.

Etapa 4: Notificação

Nesta etapa, especifique se você enviará notificações por e-mail sobre jobs que tiveram êxito ou falharam.

Etapa 5: Agendamento

Nesta etapa, agende o envio do job. O job pode ser executado uma vez em uma data e hora especificadas ou em um agendamento recorrente. Para executar o job por demanda, use a opção Não programar.

IMPORTANTE: para garantir que anos bissextos e meses com 31 dias não causem problemas, você não pode agendar uma recorrência mensal nos dias 29, 30 nem 31 do mês. Você pode agendar o job para ser executado em um dia da semana que seja o último dia do mês. Por exemplo, na última sexta-feira do mês.

Ao definir a hora inicial de um job, selecione um dos quatro períodos dentro da hora: 0 a 14, 15 a 29, 30 a 44 e 45 a 59. Para cada tarefa agendada, o sistema escolhe um minuto aleatório (por exemplo, 12 dentro do segmento de 0-14). Isso distribui as horas iniciais das tarefas mais uniformemente.

O job começará em horários aleatórios dentro do período escolhido. Se você tentar configurar um novo job em um intervalo que coincida com a hora atual, uma mensagem de erro poderá ser emitida informando que a hora selecionada ocorre no passado. Por isso, como prática recomendada, escolha o período seguinte ao período atual.

Relacionado