O IBM Campaign permite que você defina os acionadores de entrada e de saída que podem ser usados em todos os fluxogramas em uma partição.
Nota: Para obter as vantagens de desempenho, utilize o IBM EMM Scheduler para enviar acionadores
para o Campaign. Para saber mais sobre o Planejador, consulte o IBM Marketing Platform Guia do
Administrador.
O que é um acionador de entrada?
Um acionador de entrada é uma mensagem que é transmitida para uma ou mais campanhas. É possível configurar um fluxograma para "receber" para que um acionador específico inicie a execução de um ou mais processos.
Os sistemas de terceiros normalmente enviam o acionador com base na ocorrência de algum evento externo.
Por que usar um acionador de entrada?
É possível usar um acionador de entrada com uma variedade de eventos para iniciar um processo no Campaign.
Alguns exemplos são:
v Uma atualização de banco de dados aciona o recálculo de todos os segmentos estratégicos (por exemplo, classificações de valor baixo, alto e médio com base na atividade de compra mais recente). v Um modelo preditivo atualizando sua pontuação no banco de dados aciona uma execução de uma
campanha de aquisição que está aguardando as pontuações mais recentes.
v Uma ferramenta de planejamento de terceiros é usada para planejar e acionar a execução dos fluxogramas.
v A conclusão da execução da sessão de Otimização aciona a execução das campanhas participantes para recuperar e processar seus resultados otimizados.
Acionadores de entrada e o processo de Planejamento
Quando configurado para isso, o processo de Planejamento recebe para os acionadores de entrada e executa quando um é transmitido.
O que é transmissão?
Transmissão é o processo de notificar todos os fluxogramas no Campaign, campanhas específicas ou fluxogramas específicos que tenham sido executados por um acionador de entrada. Processos de Planejamento configurados para receber esse acionador de entrada e, em seguida, executá-lo. Para enviar um acionador de entrada para uma campanha ou fluxograma, deve-se transmitir os acionadores para o Campaign usando o utilitário do acionador, CAMPAIGN_HOME/bin/ unica_actrg.exe.
O que é um acionador de saída?
Um acionador de saída é a execução de um comando, arquivo em lote ou script que acontece após um fluxograma ou processo que é executado. É possível definir os acionadores para executar virtualmente qualquer ação, como abrir um aplicativo, enviar um email ou executar um programa.
O Campaign pode executar um acionador de saída quando um processo de Lista de Correspondências, Lista de Chamada ou Planejamento for executado. Por exemplo, quando um processo de Lista de Chamada é concluído, um acionador de saída pode enviar um email automático informando a um gerenciador que uma lista de contatos está pronta.
Nota: Os acionadores são executados na conclusão das execuções de teste, bem como das execuções de
produção.
O Campaign também pode executar automaticamente um acionador de saída quando um fluxograma é executado. É possível configurar diferentes acionadores para quando o fluxograma for concluído com êxito ou quando falhar.
Um acionador de saída pode ser síncrono ou assíncrono.
Acionadores de saída síncronos
Quando o Campaign executar um acionador de saída de maneira síncrona, o processo que o chamou aguardo pelo comando executado para concluir e retornar com um status de sucesso ou falha.
Em outras palavras, o fluxograma não continua a ser executado até que os resultados do acionador sejam retornados. Se o acionador falhar, conforme indicado por um valor de retorno diferente de zero, a caixa do processo não continua o processamento e indica um erro (com um X vermelho) e uma mensagem de erro apropriada.
A execução síncrona é útil quando o fluxograma estiver esperando um processo externo para concluir seu trabalho antes de continuar. Por exemplo, um acionador de saída síncrono pode executar pontuações de modelo preditivo de terceiros em tempo real e um fluxo grama aguardaria até que isso fosse concluído antes de selecionar nas pontuações de modelo atualizado.
Para tornar um acionador de saída síncrono, insira um ponto de interrogação (?) após o nome do acionador ao especificar o acionador na configuração do processo. Por exemplo:
EmailUpdate ?
Acionadores de saída assíncronos
Quando um acionador de saída assíncrono é executado, o processamento do fluxograma continua imediatamente; o processo que chamou o acionador não espera para que ele seja executado com êxito ou falhe.
Para tornar um acionador de saída assíncrono, não é necessário incluir um caractere de rescisão. No entanto, para assegurar que seja explicitamente entendido que o acionador é assíncrono, é possível colocar um e comercial (&) após o nome do acionador ao especificar o acionador na configuração de processo. Por exemplo:
EmailUpdate &
Por que usar um acionador de saída?
Os acionadores de saída podem ser úteis em diversos casos em que você deseja executar uma ação relacionada, mas não externa a uma campanha.
Alguns exemplos típicos dos acionadores de saída úteis incluem:
v Enviar uma notificação por email após a conclusão de um fluxograma da campanha; v Enviar uma notificação por email ou executar alguma outra tarefa se um fluxograma falhar;
v Executar uma ferramenta de modelagem de terceiros, como um SAS, para gerar resultados sequenciais em tempo real com a lógica do fluxograma;
v Executar um Unix shell script para enviar um arquivo de saída pelo FTP, após o arquivo ser criado; v Ativar uma atualização do banco de dados de clientes;
v Ativar ou acionar outros fluxogramas.
Valores de retorno para acionadores de saída
Os programas executados por um acionador de saída deve retornar 0 com sucesso e um valor diferente de zero com falha.
Como os acionadores são definidos?
Você define os acionadores ao editar um fluxograma. Um acionador definido por você em um fluxograma estará disponível para todos os fluxogramas na mesma partição.
O arquivo executável para um acionador deve ser armazenado no diretório CAMPAIGN_HOME/ partitions/partition_name. É possível criar um subdiretório, acionadores, neste local ou usar outras
subpastas, conforme desejado.
Criando e gerenciando acionadores
É possível criar acionadores de entrada e de saída, além de organizá-los em pastas.
Criando acionadores
É possível definir acionadores de entrada e de saída que podem ser usados em todos os fluxogramas em uma partição.
Antes de Iniciar
Deve-se ter permissões para criar acionadores.
Procedimento
1. Ao editar um fluxograma, abra o ícone Opções e selecione Acionadores armazenados. A janela Definições de Acionadores Armazenados é aberta.
2. Clique em Novo Item.
Os campos de dados para o novo acionador aparecem à direita da janela.
3. Opcionalmente, selecione uma pasta para salvar o acionador na lista Salvar em.
Nota: A localização da pasta controla quais usuários podem acessar o acionador, com base na política de segurança da pasta.
4. Insira um nome para o acionador no campo Nome.
v Não é possível usar espaços na sequência, mas é possível usar sublinhados (_). v Esse nome deve ser exclusivo dentro da pasta na qual você o salvou.
5. Se você estiver criando um acionador na pasta de nível superior, selecione uma política de segurança ou mantenha o padrão.
6. Opcionalmente, insira uma descrição do acionador no campo Nota.
É possível fornecer uma descrição de texto de formato livre do acionador para fins de documentação. Você também pode desejar manter um histórico de modificação sobre quem modificou o acionador, quando e quais alterações foram feitas.
7. No campo Comando, insira o caminho relativo à raiz de partição atual e o nome do arquivo do arquivo executável no servidor IBM Campaign. É possível clicar em Procurar para selecionar um arquivo executável de dentro da partição atual.
Se você estiver criando um acionador de saída, para torná-lo síncrono, finalize o comando com um ponto de interrogação (?).
Para tornar o acionador assíncrono, não finalize o comando com um caractere especial ou use um e comercial (&).
8. Clique em Salvar e em Fechar
Editando ou movendo acionadores
É possível alterar o nome e a nota descritiva para um acionador ou movê-lo para outra pasta. Se você alterar o nome de um acionador, quaisquer processos referentes a esse acionador se tornarão
desconfigurados e não poderão ser executados. Deve-se editar para processo para se referir ao novo nome do acionador.
Antes de Iniciar
Deve-se ter permissões para editar ou mover acionadores.
Procedimento
1. Ao editar um fluxograma, abra o menu Opções e selecione Acionadores armazenados.
A janela Definições de Acionadores Armazenados aparece, exibindo todos os acionadores definidos na partição atual do IBM Campaign.
2. Localize e selecione o acionador a ser editado na Lista de Itens.
3. Clique em Editar/Mover.
Os campos de dados para o acionador aparecem à direita da janela.
4. Opcionalmente, selecione uma pasta diferente na lista Salvar em.
Nota: A localização da pasta controla quais usuários podem acessar o acionador, com base na política de segurança da pasta.
5. Opcionalmente, altere o nome do acionador no campo Nome.
v Não é possível usar espaços na sequência, mas é possível usar sublinhados (_). v Esse nome deve ser exclusivo dentro da pasta na qual você o salvou.
6. Se você estiver modificando um acionador na pasta de nível superior ou movendo um acionador para a pasta de alta nível, selecione uma política de segurança ou mantenha a padrão.
7. Opcionalmente, modifique a descrição do acionador no campo Nota.
8. Opcionalmente, no campo Comando, modifique o caminho relativo à raiz de partição atual e o nome do arquivo do arquivo executável no servidor Campaign. É possível clicar em Procurar para
selecionar um arquivo executável de dentro da partição atual.
Se você estiver criando um acionador de saída, para torná-lo síncrono, finalize o comando com um ponto de interrogação (?).
Para tornar o acionador assíncrono, não finalize o comando com um caractere especial ou use um e comercial (&).
9. Clique em Salvar e Fechar.
O que Fazer Depois
Se você tiver renomeado um acionador, edite cada processo para se referir ao novo nome do acionador.
Excluindo acionadores
Se você excluir um acionador, qualquer processo que se refira a esse acionador se tornará desconfigurado e não poderá ser executado. Deve-se editar cada processo para remover a referência ao acionador
Antes de Iniciar
Nota: Deve-se ter permissões para excluir os acionadores.
Procedimento
1. Ao editar um fluxograma, abra o menu Opções e selecione Acionadores armazenados.
2. Localize e selecione um acionador na Lista de Itens. A lista mostra todos os acionadores que são definidos na partição atual.
3. Clique em Remover.
4. Clique em OK para confirmar a exclusão.
5. Clique em Fechar.
O que Fazer Depois
Edite cada processo para remover a referência ao acionador excluído.
Organizando acionadores nas pastas
É possível usar as pastas para organizar os acionadores.
Antes de Iniciar
Deve-se ter permissões para criar pastas para os acionadores.
Procedimento
1. Abra o fluxograma para edição.
2. Abra o menu Options e selecione Acionadores armazenados.
3. Clique em Nova Pasta.
4. Nome da pasta e insira uma nota descritiva.
5. Na lista Criar em, selecione a pasta na qual deseja criar a nova pasta ou selecione Nenhum para criar uma pasta de nível superior.
6. Se você estiver criando uma pasta de nível superior, selecione uma política de segurança. Uma subpasta automaticamente herda sua política de segurança de sua pasta-pai.
7. Clique em Salvar.
Movendo pastas do acionador
É possível mover pastas do acionador. Deve-se ter permissões para mover as pastas do acionador.
Procedimento
1. Ao editar um fluxograma, abra o ícone Opções e selecione Acionadores armazenados.
2. Selecione uma pasta no painel à esquerda.
3. Clique em Editar/Mover.
4. Na lista Criar em, selecione a pasta para a qual deseja mover a pasta selecionada ou selecione
Nenhumpara tornar a pasta uma pasta de nível superior.
5. Se você estiver movendo a pasta para o nível superior, selecione uma política de segurança. Uma subpasta automaticamente herda sua política de segurança de sua pasta-pai.
Editando pastas do acionador
É possível alterar o nome e a observação descritiva para uma pasta do acionador. Deve-se ter permissões para editar as pastas do acionador.
Procedimento
1. Ao editar um fluxograma, abra o menu Opções e selecione Acionadores Armazenados.
2. Selecione uma pasta no painel à esquerda.
3. Clique em Editar/Mover.
4. Altere o Nome e a Nota para a pasta.
5. Clique em Salvar.
Excluindo pastas do acionador
É possível excluir pastas dos acionadores.
Antes de Iniciar
Deve-se ter permissões para excluir as pastas do acionador.
Procedimento
1. Ao editar um fluxograma, abra o ícone Opções e selecione Acionadores armazenados.
2. Selecione uma pasta no painel à esquerda.
3. Clique em Remover.
Você será solicitado a confirmar a exclusão.
4. Clique em OK.
Configurando os acionadores de saída
Deve-se ter permissões para usar os acionadores em um fluxograma.
Configurando um processo para executar um acionador de saída
Três processos podem executar acionadores de saída que forem executados. Esses processos são:
v Agendar v Telemarketing v Mala direta
No processo de Planejamento, você especifica os acionadores a serem executados da guia Planejamento. Na lista de Chamadas e nos processos da Lista de Correspondência, você especifica os acionadores a serem executados na guia Cumprimento.
Para obter informações sobre como configurar esses processos, consulte o Campaign Guia do Usuário.
Configurando um fluxograma para executar um acionador de saída
com sucesso
É possível configurar um fluxograma para executar os acionadores selecionados quando o fluxograma é executado com êxito, nas execuções de teste e de produção.
Procedimento
1. Ao editar um fluxograma, clique no ícone Administrador e selecione Configurações avançadas. A janela Configurações Avançadas é aberta.
2. Selecione o acionador a ser executado em Enviar Acionadores no Êxito do Fluxograma.
Para usar diversos acionadores, insira o nome de cada acionador, separados por uma vírgula e um espaço.
3. Clique em OK.
Configurando um fluxograma para executar um acionador de saída
com falha
É possível configurar um fluxograma para executar os acionadores selecionados quando o fluxograma encontrar um erro ao ser executado, nas execuções de teste e de produção.
Procedimento
1. Ao editar um fluxograma, clique no ícone Administrador e selecione Configurações avançadas. A janela Configurações Avançadas é aberta.
2. Selecione o acionador a ser executado em Enviar Acionadores no Erro de Execução de Fluxograma. Para usar diversos acionadores, insira o nome de cada acionador, separados por uma vírgula e um espaço.
3. Clique em OK.
Configurando os acionadores de entrada
Você deve ter permissões para usar os acionadores em um fluxograma.
Para configurar acionadores de entrada
Use esse procedimento para configurar acionadores de entrada.
Procedimento
1. Crie os acionadores dentro de um fluxograma, conforme descrito em “Criando acionadores” na página 121.
2. Configure o processo de Planejamento em qualquer um dos fluxogramas que deseja executar ao receber o acionador de entrada, conforme descrito em “Configurando o processo de Planejamento para execução com um acionador de entrada”.
3. Use o Campaign Utilitário do Acionador unica_actrg (na pasta Campaign_home/bin) para transmitir acionadores, conforme descrito em:
v “Transmitindo um acionador para todos os fluxogramas em uma campanha” na página 126 v “Transmitindo um acionador para fluxogramas específicos” na página 126
v “Transmitindo um acionador para todas as campanhas” na página 126
Configurando o processo de Planejamento para execução com um
acionador de entrada
Para usar um acionador de entrada para executar um fluxograma, esse fluxograma deve começar com um processo de Planejamento que é configurado conforme descrito aqui.
v Na lista Planejar para Executar, selecione Customizar Execução. v Verifique Executar nos Acionadores.
v No campo Executar nos Acionadores, insira os nomes dos acionadores que, quando transmitidos, executarão o fluxograma. Separe diversos acionadores com uma vírgula e um espaço.
O processo de Planejamento também pode ser configurado para executar com base em outras condições. Configurar a condição acionadora irá executar adicionalmente os processos subsequentes quando os acionadores especificados forem recebidos.
Importante: Para que um fluxograma execute após a recepção de um acionador de entrada, ele deve ter
um processo de Planejamento configurado conforme descrito acima e deve estar sendo executado. Executar o fluxograma coloca o fluxograma em um estado "aguardando" ou "recebendo", para que o fluxograma esteja pronto para executar quando o acionador for recebido. Um fluxograma que não esteja em execução quando o acionador é transmitido, não será executado.
Para obter mais informações sobre como configurar o processo de Planejamento, consulte o Campaign
Guia do Usuário.
Transmitindo um acionador para todos os fluxogramas em uma
campanha
É possível enviar um acionador de entrada para todos os fluxogramas em uma campanha.
Sobre Esta Tarefa
Execute o Utilitário do Acionador do Campaign com a seguinte sintaxe: unica_actrg campaign_code trigger_name
Por exemplo:
unica_actrg C003 web_hit
Se um fluxograma na campanha especificada for iniciado com um processo de Planejamento configurado para ser executado ao receber uma transmissão com base no acionador de entrada do web_hit, esse fluxograma é executado quando o acionador de fluxograma é recebido.
Transmitindo um acionador para fluxogramas específicos
É possível enviar um acionador de entrada para todos os fluxogramas em execução com o nome especificado.
Sobre Esta Tarefa
Execute o Utilitário do Acionador do Campaign com a seguinte sintaxe: unica_actrg -n flowchart_name trigger_name
Por exemplo:
unica_actrg -n account_inquiry_flowchart web_hit
Se o fluxograma do nome especificado for iniciado com um processo de Planejamento configurado para ser executado ao receber uma transmissão com base no acionador de entrada do web_hit, esse
fluxograma é executado quando o acionador de transmissão é recebido.
Transmitindo um acionador para todas as campanhas
Sobre Esta Tarefa
Execute o Utilitário do Acionador do Campaign com a seguinte sintaxe: unica_actrg * trigger_name
Por exemplo:
unica_actrg * web_hit
O acionador é transmitido para todos os fluxogramas em todas as campanhas. Se algum fluxograma for iniciado com um processo de Planejamento configurado para ser executado ao receber uma transmissão com base no acionador de entrada do web_hit, esse fluxograma é executado quando o acionador de transmissão é recebido.
Nota: Nos servidores UNIX, o asterisco deve ser de escape (\*) ou estar entre aspas duplas ("*").
Configurando o utilitário do acionador em uma máquina Windows
remota
É possível configurar uma máquina Windows para enviar acionadores para uma instalação do Campaign no UNIX. Siga estas etapas para configurar o utilitário unica_actrg e os arquivos necessários em uma máquina Windows remota.
Procedimento
1. Obter os arquivos necessários: <CAMPAIGN_HOME>\bin iconv.dll intl.dll libeay32.dll ssleay32.dll tls4d.dll unica_actrg.exe xerces-c_1_4.dll <CAMPAIGN_HOME>\conf config.xml
Para obter os arquivos, é possível copiá-los de outra instalação do Campaign no Windows ou executar o instalador do IBM Campaign. Se você obter os arquivos executando o instalador e desejar remover os arquivos desnecessários, copie os arquivos necessários para o utilitário do acionador para outro local, em seguida, desinstale o Campaign. Para obter mais informações, consulte o IBM Campaign Guia
de Instalação.
2. Abra um prompt de comandos na máquina Windows remota.
3. Se ainda não estiver configurada, configure a variável de ambiente CAMPAIGN_HOME na máquina Windows remota. Por exemplo:
O que Fazer Depois
Ao executar o unica_actrg remotamente, especifique o nome do servidor e da porta da máquina em que o listener do IBM Campaign está instalado. Se você tiver uma configuração do listener armazenado em cluster, a melhor prática é especificar o servidor e a porta do listener principal.
Tokens suportados por acionadores
Os tokens podem ser usados na linha de comandos de um acionador de saída para passar informações específicas do fluxograma em execução.