Imprimir      Abrir a versão em PDF da Ajuda on-line


Tópico anterior

Próximo tópico

Criando ações de workflow: criar evento de integração

Uma ação Criar evento de integração em uma regra de fluxo de trabalho envia automaticamente um evento de integração para uma ou mais filas quando as condições da regra de fluxo de trabalho são atendidas e uma alteração é detectada em pelo menos um dos campos controlados pela ação Criar evento de integração.

Sobre ações Criar evento de integração e Aguardar

Se quiser usar uma ação Criar evento de integração para criar um evento de integração que capture as alterações feitas em um registro pelo evento que aciona uma regra de fluxo de trabalho, você deverá seguir a ação Criar evento de integração antes da Ação de espera na sequência de ações na regra de fluxo de trabalho. Se uma Ação de espera anteceder uma ação Criar evento de integração em uma regra de fluxo de trabalho, a Ação de espera impedirá a ação Criar evento de integração de detectar alterações feitas no registro. Quando o período de espera na Ação de espera terminar, o registro será lido novamente antes das ações restantes na regra serem realizadas, e os valores dos campos no registro antes do evento que acionaram a regra de fluxo de trabalho não serão preservados. Por isso, os valores anterior e atual de um campo são considerados iguais, e a ação Criar evento de integração não cria um evento de integração porque não detecta nenhuma alteração nos campos controlados.

Sobre formatos de valor da lista de opções em eventos de integração

Dependendo de como você configura as filas de eventos de integração, os valores nos campos da lista de opções nos eventos de integração são registrados no idioma do usuário, cuja ação faz com que o evento de integração seja criado, ou como valores de código independente de linguagem (LIC). Para obter informações sobre como especificar o formato de valor da lista de opções para uma fila de eventos de integração, consulte Criando filas de eventos de integração e Gerenciando as configurações do evento de integração.

Sobre os sinalizadores de faturamento, entrega e principal em registros de conta e endereço de contato

Em eventos de integração para o tipo de registro Endereço de conta, você pode incluir os indicadores de Faturamento e Entrega que indicam se um endereço é o endereço de faturamento ou o endereço de entrega designados para a conta. Da mesma forma, em eventos de integração para o tipo de registro Endereço de contato, você pode incluir o indicador Principal que indica se um endereço é o endereço principal do contato. Entretanto, você não pode rastrear as alterações nos indicadores Faturamento, Entrega e Principal. Isso significa que as alterações a esses indicadores não podem ser usadas para provocar a criação de eventos de integração, mesmo que você selecione a caixa de seleção Sempre incluir para o indicador. Se você incluir um desses indicadores em um evento de integração, e se esse indicador for alterado ao mesmo tempo que um campo para o qual as alterações foram rastreadas, o evento de integração que é criado como resultado da alteração no campo rastreado não mostra o novo valor do indicador. Em vez disso, o evento de integração mostra o valor do indicador antes que a alteração tenha sido feita. Porém, a próxima vez que um evento de integração for criado como resultado de uma alteração a um campo rastreado, o evento de integração incluirá o valor do campo de indicador depois que a atualização anterior tiver sido feita.

Por exemplo, suponha que você tenha dois endereços, Endereço A e Endereço B, vinculados a um contato chamado Jane Smith. O Endereço A é o endereço principal de Jane Smith. Você possui uma ação Criar evento de integração do workflow para o tipo de registro Endereço de contato que está configurada da seguinte forma:

  • A caixa de seleção Rastrear alterações é selecionada somente para o campo Tipo de endereço.
  • A caixa de seleção Sempre incluir é selecionada para o campo Principal.

Se um usuário atualizar o campo Tipo de Endereço no Endereço A a partir do registro de endereço de contato de Jane Smith e também desmarcar a caixa de seleção Principal do Endereço A, o evento de integração que a ação do workflow cria como resultado da alteração do campo Tipo de Endereço mostra o novo tipo de endereço, mas o valor do indicador Principal no evento de integração ainda indica que o Endereço A é o endereço principal de Jane Smith. Porém, a próxima vez que o campo Tipo de Endereço no Endereço A a partir do registro de endereço de contato for alterado e um evento de integração for criado como resultado da alteração, o indicador Principal no evento de integração mostrará que o Endereço A não é o endereço principal de Jane Smith.

OBSERVAÇÃO: é possível criar várias ações para uma regra de workflow; até 25 ações para cada regra.

O procedimento a seguir descreve como criar uma ação Criar evento de integração.

Antes de começar. Para executar o procedimento descrito aqui, você deve possuir o privilégio Gerenciar regras de dados - Gerenciar regras de fluxo de trabalho em sua função do usuário. Para obter informações sobre como adicionar privilégios às funções, consulte Adicionando funções.

Para criar uma ação Criar evento de integração

  1. Navegue até a regra na qual você deseja criar a ação:
    1. No canto superior direito de qualquer página, clique no link global Administração.
    2. Na seção Gerenciamento de processo de negócios, clique em Configuração do workflow.
    3. Na página da Lista de regras de workflow, localize a regra na qual deseja criar a ação.

      Para obter informações sobre a pesquisa de regras de workflow na página da lista, consulte Filtrando listas.

  2. Clique no link Nome do workflow da regra.
  3. Na barra de título Ações na página de Detalhes de regra de workflow, clique em Menu e selecione Criar evento de integração.

    OBSERVAÇÃO: o evento de acionamento na regra de workflow determina que tipos de ações podem ser criados na regra.

    DICA: é possível criar uma cópia de uma ação existente da regra de workflow clicando no link Copiar da ação.

  4. Na página de Edição de ação do workflow, digite um nome para a ação.
  5. Se desejar ativar a ação, marque a caixa de seleção Ativa.
  6. Selecione as filas de integração para as quais os eventos de integração serão gravados.
  7. No campo Versão do esquema, se o tipo de registro da regra de workflow suportar o esquema para Web Services v1.0 e Web Services v2.0, selecione a versão do serviço Web que será usada nos eventos de integração.

    Se o tipo de registro da regra de workflow suportar o esquema para Web Services v1.0 e Web Services v2.0, o Web Services v2.0 será selecionado por padrão no campo Versão do esquema, mas é possível alterar a seleção antes de salvar a ação do workflow.

    OBSERVAÇÃO: Depois que você criar e salvar a ação do workflow, não poderá alterar o valor no campo Versão do esquema.

    Se o tipo de registro da regra de workflow suportar somente um esquema, essa versão do serviço Web será selecionada por padrão. Para obter mais informações sobre os serviços Web, consulte Oracle Web Services On Demand Guide.

  8. Salve a ação do workflow.
  9. No menu no nível do registro na lista de ações, selecione Configurar para a ação do evento de integração que você deseja configurar.

    OBSERVAÇÃO: A opção Configurar não está disponível para ações nas quais o evento de acionamento seja Quando registros são mesclados.

  10. Na página Configurar rastreamento do evento de integração, marque as caixas de seleção para os campos conforme necessário:
    • Marque a caixa de seleção Sempre incluir caso você queira que o campo seja incluído no evento de integração, mesmo que o valor do campo não tenha sido alterado.
    • Marque a caixa de seleção Rastrear alterações caso você queira que um evento de integração seja gerado sempre que o campo for atualizado.
  11. Salve as alterações.

A tabela a seguir descreve os campos na página Configurar rastreamento do evento de integração.

Campo

Descrição

Nome de exibição

O nome do campo conforme exibido na interface do usuário.

Etiqueta de integração

A etiqueta de integração usada quando o campo está incluído no evento de integração.

Os IDs de integração são exibidos na coluna Serviços Web v2.0 do ID de integração na página Campos tipo de registro.

Obrigatório

A caixa de seleção somente leitura indica se o campo foi configurado como um campo obrigatório.

Sempre incluir

Marque a caixa de seleção caso você queira que o campo seja incluído no evento de integração, mesmo que o valor do campo não tenha sido alterado.

OBSERVAÇÃO: A caixa de seleção Sempre incluir é marcada por padrão e não pode ser desmarcada para determinados campos usados por Oracle CRM On Demand.

Rastrear alterações

Marque a caixa de seleção caso você queira que um evento de integração seja gerado sempre que o campo for atualizado. Para obter mais informações sobre a caixa de seleção Rastrear alterações, consulte Sobre a caixa de seleção Rastrear alterações neste tópico.

Sobre a caixa de seleção Rastrear alterações

A caixa de seleção Rastrear alterações não estará disponível se o evento de acionamento da regra de workflow for Antes do registro ser excluído, Após associação ao pai ou Após dissociação do pai. Se também o evento de acionamento da regra de workflow for Após associação com pai ou Após dissociação do pai, o conjunto de campos exibido na página será o conjunto de campos no nível do registro filho. Você não pode configurar o conjunto de campos incluído no evento de integração no nível de registro pai.

Para ações de workflow em que a caixa de seleção Rastrear alterações estiver disponível, a ação de workflow criará um evento de integração somente se a caixa de seleção Rastrear alterações for selecionada para pelo menos um campo, e se uma alteração for detectada em pelo menos um dos campos para os quais a caixa de seleção Rastrear alterações for selecionada. Quando o evento de integração for criado, todos os campos que possuem a caixa de seleção Sempre incluir selecionada na ação do workflow serão incluídas no evento de integração.

Exceções de Campos do Sistema

Se o evento de acionamento da regra do workflow for algo diferente de Quando o Novo Reg. Salvo, o Oracle CRM On Demand não gerará eventos de integração nos casos que a caixa de seleção Rastrear Alterações não esteja marcada para qualquer outro campo:

  • ModifiedDate
  • ModifiedById
  • CreatedDate
  • CreatedById
  • ID

Para obter mais informações sobre eventos de integração, consulte Sobre eventos de integração.

Para obter os procedimentos passo-a-passo para criar outros tipos de ações de workflow, consulte os tópicos a seguir:

Tópicos relacionados

Consulte os seguintes tópicos para obter informações relacionadas a workflows:


Publicado em Setembro de 2017 Copyright © 2005, 2017, Oracle. Todos os direitos reservados. Legal Notices.