Eventos do UiPath Data Fabric

Configure eventos do UiPath Data Fabric no Integration Service para disparar fluxos de trabalho em alterações no nível do registro por meio de notificações de webhook.

Events

Um evento no Data Fabric representa uma alteração de estado em um registro de entidade. O Data Fabric publica eventos no Integration Service por meio de um webhook — sempre que uma alteração no nível de registro ocorre na entidade assinada (por exemplo, um registro é criado ou atualizado), o Data Fabric emite uma notificação de que o Integration Service roteia para o gatilho do fluxo de trabalho assinado. Para obter mais detalhes, consulte a documentação de Gatilhos .

O conector do UiPath Data Fabric é compatível com os seguintes eventos:

• — Record created quando um registro é criado na entidade selecionada que corresponde ao filtro configurado do gatilho.
• Record updated — Dispara quando um registro existente na entidade selecionada é atualizado e o estado pós-atualização corresponde ao filtro configurado do gatilho.

Os eventos do conector do UiPath Data Fabric são entregues por meio de um webhook.

Propriedades do evento

O envelope do evento é composto pelas seguintes propriedades, que estão presentes em todos os eventos do Data Fabric.

Propriedade	Description
UiPathEvent	Tipo de evento (por exemplo, CREATED, UPDATED)
UiPathEventObjectType	A entidade na qual o evento ocorreu (por exemplo, Customer, Invoice)
UiPathEventObjectId	O identificador exclusivo (Id) do registro afetado (por exemplo, 65747f9e-6442-f111-8ef2-000d3a350adf)
UiPathEventConnector	O conector que iniciou a automação (sempre uipath-uipath-dataservice)

Saídas de eventos

Cada evento do UiPath Data Fabric gera uma referência a um registro de entidade. A saída compreende todos os campos acessíveis na entidade selecionada, com base nas permissões do usuário da conexão do gatilho.

Evento	Tipo de saída
Registro criado	Entity Record
Registro Atualizado	Entity Record

Para obter mais informações sobre permissões de conexão de gatilho e entrega de eventos, consulte Melhoria de segurança.

Gatilhos conectados

Com um gatilho conectado, o fluxo de trabalho é iniciado com as propriedades do envelope do evento (NÃO inclui a carga do registro). No entanto, a atividade de gatilho se encarrega de produzir essa carga de registro automaticamente. Para obter mais detalhes sobre como usar os gatilhos de evento do Integration Service, consulte Usando gatilhos no Integration Service.

Comportamento

• A propriedade output da atividade Trigger é o registro de entidade afetado, digitado como o esquema da entidade. Os tipos de campo, formatos e acessibilidade são derivados dos metadados da entidade no momento do design.
• O fluxo de trabalho pode ler campos diretamente fora de output e usá-los em atividades subsequentes sem qualquer configuração adicional.
• As propriedades do envelope do evento (UiPathEvent, UiPathEventObjectId etc.) permanecem disponíveis junto com o registro resolvido.

Gatilhos desconectados

Com um gatilho desconectado, o fluxo de trabalho é iniciado APENAS com as propriedades do envelope do evento — a carga do registro afetada não é preenchida para o fluxo de trabalho. Espera-se que o autor do fluxo de trabalho recupere o próprio registro usando o identificador carregado no evento. Para obter mais detalhes sobre como usar os gatilhos de evento do Integration Service, consulte Usando gatilhos no Integration Service.

Comportamento

Para ler o registro, o fluxo de trabalho deve:

1. Aceite uma propriedade de entrada vinculada a UiPathEventObjectId (o Id do registro afetado).
   • O fluxo de trabalho também pode aceitar qualquer uma das outras propriedades do envelope de evento (por exemplo, UiPathEventObjectType, UiPathEvent, UiPathEventConnector) como entradas se precisar delas.
2. Chame a atividade Get Entity Record by Id contra a entidade à qual o gatilho está inscrito, usando o Id do registro afetado.
3. Use o registro retornado em atividades subsequentes.