Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2025-10-03
Conceito: diretrizes de processo de negócios de integração

Conceito: diretrizes de processo de negócios de integração

Visão geral

Um processo de negócios de integração é um fluxo de trabalho configurável que orquestra as tarefas associadas à execução de uma integração para o intercâmbio de dados entre o Workday e os pontos de extremidade externos. Ele usa o tipo de processo de negócios
Evento de processo de integração
 , que permite um processamento mais complexo do que uma simples inicialização de integração. Consulte Conceito: processos de negócios de integração.

Subprocessos

Você pode incorporar uma integração a outro processo de negócios adicionando uma etapa de integração à definição desse processo de negócios. Quando o processo de negócios principal chega a essa etapa, ele inicia o Evento de processo de integração especificado como um subprocesso de negócios.

Iniciadores do processo

Um processo de negócios de integração pode ser iniciado de várias maneiras:
  • Manualmente
    Um usuário com as permissões apropriadas pode iniciar a integração diretamente do relatório
    View Integration System
     ou usando a tarefa
    Launch/Schedule Integration
     .
  • Programado
    Você pode programar a execução da integração para um horário específico ou de forma recorrente na tarefa
    Iniciar/Programar integração
     .
  • Como um subprocesso de negócios
    O processo de negócios Integração pode ser iniciado a partir de uma etapa dentro de outro processo de negócios do Workday (exemplo: execução de uma integração E-Verify após o processo de negócios
    Complete Form I-9
     ).

Limitações

Embora a estrutura do processo de negócios de integração seja flexível, a tecnologia de integração subjacente tem limitações específicas.
  • Web Service Launch
    : quando você inicia uma integração usando o
    Launch_Integration
     ou
    Launch_EIB
     operações de serviço Web, não é possível especificar uma versão específica da organização do processo de negócios. Será usada a definição de nível superior (valor por padrão) desse sistema de integração.
  • Limite de tamanho do arquivo para recuperação de documentos
    : os arquivos de entrada têm um limite de 1 GB para XML e de 300 MB para XLSX. Consulte Referência: integrações e limites de serviços Web.

Diretrizes e fluxos de trabalho de processos de negócios comuns

Caminho 1: fluxo de trabalho de integração por padrão
Por padrão, o
Evento de processo de integração
 consiste em duas etapas fundamentais:
A etapa
Serviço (Ativar integração)
 executa o próprio sistema de integração. Para uma integração de saída, ele gera o arquivo de saída. Para uma integração de entrada, ele carrega dados no Workday.
Caminho 2: integração de saída com aprovação
Esse fluxo de trabalho é comum quando você precisa que um usuário revise os dados antes de serem enviados pelo Workday.
Depois de aprovada, a etapa
Serviço (Ativar integração)
 é executada e extrai os dados do Workday, gerando o arquivo de saída.
A etapa
Serviço: entrega de documentos
 entrega o arquivo gerado ao ponto de extremidade externo, como um servidor SFTP.
Caminho 3: fluxo de trabalho de integração de entrada
Este é um fluxo de trabalho padrão para trazer dados para o Workday de uma fonte externa.
A etapa
Serviço: recuperação de documentos
 recupera um arquivo de uma fonte externa (como um servidor FTP) ou encaminha uma tarefa a um usuário para que carregue manualmente um arquivo.
A etapa
Serviço: ativar integração
 executa a integração, pegando o arquivo recuperado e carregando os dados no Workday.
Caminho 4: fluxo de trabalho de integração encadeada
Esse padrão é útil quando a saída de uma integração é a entrada de outra.
A primeira etapa
Integração
 aciona o primeiro sistema de integração (exemplo: um EIB ou uma integração do Studio) para ser executado e gerar um arquivo de saída.
A segunda etapa
Integração
 aciona um segundo sistema de integração, que consome o arquivo de saída da primeira integração.

Etapas do fluxo de trabalho

Início
Ordem
A (primeira etapa)
Atualizado por
O usuário ou o sistema que inicia a integração. Pode ser um Usuário de sistema de integração (ISU) para eventos programados ou acionados pelo sistema, ou um usuário interativo para inicializações manuais.
Domínio de segurança por função
O administrador do ISU ou da Integração que inicia a integração: acesso
a Modificar/Inserir
 em
Build de integração
,
Configurar integração
,
Depuração de integração
,
Evento de integração
.
Prática recomendada
A etapa
Início
 é a primeira etapa obrigatória para todos os processos de negócios. Ela não pode ser removida. Ele serve como ponto de entrada e registro de auditoria para o início do processo.
Exemplo
Um administrador de RH navega até a tarefa
Iniciar/Programar integração
 e clica em "
OK
" para executar uma exportação de nova admissão para um fornecedor de benefícios externo. Essa ação conclui a etapa
Início
 e inicia o fluxo de trabalho do processo de negócios.
Tipos de etapa
Aqui estão os tipos de etapa comuns que você pode adicionar a um processo de negócios de integração.
Aprovação
Ordem
Pode ser colocado em qualquer lugar após a etapa
Início
 . Por exemplo, você pode colocá-lo após uma etapa
de ativação de integração
 , mas antes de uma etapa
de entrega de documentos
 .
Atualizado por
Um grupo de segurança especificado (por exemplo, parceiro de RH, administrador de remuneração, gestor).
Domínios de segurança
ISU, administrador de integrações ou administrador de processos de negócios: acesso
Modificar/Estabelecer
 no
evento de integração
.
Especificar
Você deve especificar os grupos de segurança responsáveis pela aprovação.
Regra de condição
  • Caso de uso: exigir que um gestor revise e aprove um arquivo contendo dados de bonificações do colaborador antes de ser entregue ao fornecedor de folha de pagamento.
  • Prática recomendada: use regras de condição para acionar aprovações somente quando necessário. Por exemplo, você pode criar uma regra que ignore a etapa de aprovação se o valor total da bonificação estiver abaixo de um determinado limite.
  • Exemplo: uma regra de condição é configurada na etapa de aprovação para verificar se o campo Valor total da bonificação na saída da integração é maior que 50.000 USD. Em caso afirmativo, a etapa é encaminhada para o grupo de segurança
    do administrador de remuneração
     para aprovação. Caso contrário, a etapa é ignorada.
Casos de uso, práticas recomendadas e exemplo do tipo de etapa:
  • Caso de uso: garanta a precisão dos dados para integrações de saída confidenciais, como folha de pagamento ou concessões de ações.
  • Prática recomendada: atribua aprovações a um grupo de segurança com base em funções, em vez de a um usuário designado específico, para evitar atrasos no processo devido à ausência do colaborador.
  • Exemplo: antes de enviar um arquivo de alterações de remuneração de executivos a um sistema externo, uma etapa
    de Aprovação
     é encaminhada para o grupo de segurança
    Administração de remuneração de executivos
     para validar os dados.
Serviço
Ordem
Pode ser colocado em qualquer lugar após
o Início
. A ordem é crítica. Para uma integração de entrada,
a recuperação de documentos
 deve vir antes de
ativar a integração
. Para uma saída,
a ativação da integração
 deve vir antes
da entrega de documentos
.
Atualizado por
Usuário de sistema de integração (ISU)
Domínios de segurança por função
ISU: acesso
Modificar/Inserir
 na
criação de integração
,
configuração da integração
.
Especificar
Você deve especificar o serviço a ser executado:
recuperação de documentos
,
entrega de documentos
ou
ativação de integração
.
Regra de condição
  • Caso de uso: para uma integração executada diariamente, você só precisa recuperar um arquivo no primeiro dia da semana.
  • Prática recomendada: use regras de condição nas etapas
    de Entrega de documentos
     para evitar o envio de arquivos vazios. Você pode criar uma regra que verifique se o total de registros do evento de integração é maior que zero.
  • Exemplo: uma regra de condição em uma etapa
    Entrega de documentos
     verifica um campo calculado que conta o número de registros processados pela etapa
    Executar integração
     . A etapa de entrega é executada somente se o total for maior que 0, evitando que o sistema envie um arquivo em branco ao fornecedor.
Considerações sobre o tipo de etapa
  • Recuperação de documentos: usada em integrações de entrada para obter um arquivo de uma fonte externa (como um servidor SFTP).
  • Executar integração: esta é a etapa principal que executa o sistema de integração principal, seja gerando um arquivo de saída (saída) ou carregando dados no Workday (entrada).
  • Entrega de documentos: usado em integrações de saída para enviar um arquivo gerado a um destino externo (como um servidor SFTP ou ponto de extremidade de serviço Web).
Ação: Tarefas a fazer
Ordem
Pode ser colocado em qualquer lugar do processo em que uma ação manual ou instrução seja necessária.
Atualizado por
Um grupo de segurança ou usuário especificado.
Domínios de segurança
ISU, administrador de integrações ou administrador de processos de negócios: acesso
Modificar/Estabelecer
 no
evento de integração
.
Regra de condição
Útil para acionar intervenção manual somente quando necessário. Por exemplo, uma regra pode verificar se o status do evento de integração é "
Concluído com avisos
", acionando uma Tarefa
a fazer
 para um administrador revisar os avisos.
Casos de uso, práticas recomendadas e exemplos de tipo de etapa
  • Caso de uso: notificar um administrador para executar uma tarefa manual fora do Workday ou para verificar dados no Workday após uma etapa do processo.
  • Prática recomendada: deixe as instruções na etapa
    Tarefas a fazer
     claras e acionáveis. Se possível, inclua links para relatórios ou tarefas relevantes.
  • Exemplo: um EIB de entrada carrega novos trabalhadores terceirizados. Uma etapa Tarefas
    a fazer
     é configurada para ser acionada após a etapa
    Serviço - Executar integração
     . Ele é atribuído ao grupo
    de analistas de HRIS
     com a instrução: "Trabalhadores terceirizados foram carregados. Execute o relatório Auditoria de novas admissões para verificar os dados e concluir as localizações ausentes.

Integração

Esse tipo de etapa permite que você inicie outro sistema de integração separado do processo de negócios atual. É assim que você encadeia as integrações.
Ordem
Pode ser colocado em qualquer lugar após a etapa
Início
 .
Atualizado por
Usuário de sistema de integração (ISU)
Especificar
Você deve selecionar o Sistema de integração a ser iniciado como um subprocesso.
Regras de condição com casos de uso, práticas recomendadas e exemplo
Caso de uso: depois que uma integração de saída principal é executada, você quer executar uma segunda integração para arquivar o arquivo gerado em um local de armazenamento de longo prazo, mas apenas se a primeira integração foi bem-sucedida.
Use uma regra de condição para verificar o status de uma etapa anterior (
Executar integração
) para garantir que ela seja concluída com êxito antes de iniciar uma integração subsequente que depende de sua saída.
Exemplo: uma etapa
de integração
 é configurada para iniciar "Arquivar integração". Uma regra de condição nessa etapa verifica o status da etapa anterior
Executar integração
 . A integração de arquivo morto é executada somente se o status da etapa anterior é "
Concluído
".
Caso de uso: você quer recuperar um arquivo sem iniciar uma integração ou iniciar uma integração sem entregar o arquivo.
Use uma regra de condição que sempre avalie como falso. Exemplo: “1=2” na etapa que deve ser ignorada.
Casos de uso do tipo de etapa
  • Caso de uso (enriquecimento de dados): uma integração inicial extrai dados básicos do colaborador. A segunda etapa
    de integração
     chama uma integração diferente que usa a saída inicial, adiciona dados de outra fonte (como um relatório personalizado) e produz um arquivo final enriquecido.
  • Caso de uso (orquestração de processo): depois que um EIB de entrada carrega novas admissões, uma etapa
    de integração
     pode acionar uma integração de saída para provisionar contas para essas novas admissões em um sistema de TI externo.
  • Caso de uso (falhas de redirecionamento): quando uma etapa de integração falha, encaminhe a integração com falha para usuários específicos em vez de encerrar automaticamente o processo de negócios.
    1. Configure grupos de segurança para que tenham permissões
      de redirecionamento
       na política de segurança de processos de negócios.
    2. Use a ação relacionada
      Manter redirecionamento
       na etapa
      Integração
       da definição de processo de negócios.
    3. Selecione uma ou mais ações de redirecionamento e selecione um ou mais grupos de segurança para receber a etapa redirecionada.
Exemplo de tipo de etapa
O processo de negócios é iniciado e a primeira etapa,
Service (Fire Integration)
, executa a integração
PayData Extração
 , que gera um arquivo de dados brutos de folha de pagamento. A próxima etapa,
Integração
, é configurada para iniciar a integração
PayData Transformation
 . Essa segunda integração foi projetada para selecionar o arquivo da primeira, reformatá-lo no layout XML obrigatório do fornecedor e colocar o novo arquivo na área de retenção de saída. A etapa final,
Serviço (Entrega de documentos)
, entrega o arquivo XML transformado ao fornecedor de folha de pagamento.

Notificações

As notificações personalizadas são acionadas pelo status final do evento de processo de integração geral. Você pode configurar notificações na própria definição de processo de negócios (exemplo: na conclusão da etapa ou no erro).
Casos de uso com prática recomendada e exemplo:
  • Caso de uso (Êxito): envie um e-mail para a equipe da folha de pagamento confirmando que o arquivo de interface da folha de pagamento semanal foi gerado e entregue com êxito ao fornecedor.
  • Caso de uso (erro): se uma integração falhar, envie uma notificação de alta prioridade para a equipe de administração de integração com os detalhes do evento e as mensagens de erro para que eles possam investigar imediatamente.
  • Prática recomendada: use grupos de segurança específicos com base em funções (por exemplo,
    administradores de integração
    ) como destinatários, em vez de usuários individuais. Crie mensagens de notificação claras e acionáveis que incluam informações importantes, como o nome da integração, a hora de execução e um link para o monitor de processos para obter detalhes.
  • Exemplo: uma notificação de integração é configurada para ser acionada quando o status do processo de negócios é "
    Falha
    ". Ele envia um e-mail para o grupo de segurança
    Suporte à integração
     . O corpo do e-mail é personalizado para dizer: "Falha na integração
    CCB - Dados demográficos de saída
     . Revise o Monitor de processos para obter detalhes. ID do evento: [Event ID]".

Problemas e soluções

Expedição
Causa e solução
O ponto de extremidade externo não recebe um arquivo de integração esperado.
Use os relatórios
Monitor de processos
 e
Registro de processo completo
 para determinar o que não funcionou conforme o esperado. Consulte
Solução de problemas de eventos de processo de integração
 na. Conceito: processos de negócios de integração.
O arquivo de saída não foi entregue ao ponto de extremidade externo.
Causa: o processo de negócios pode ter falhado antes da etapa
Entrega de documentos
 ou a própria etapa de entrega falhou.
Solução: para visualizar o status e as mensagens de erro relacionadas à falha:
  1. No relatório
    Monitor de processos
     sobre o tipo de processo
    Integração
     , localize sua solicitação de integração.
  2. Na página
    Visualizar processo em segundo plano
     , clique em
    Evento principal
    , que é o evento de processo de integração.
  3. Na página
    Visualizar evento
     , a tabela
    Processos subsequentes
     exibe os eventos de integração para as etapas
    Integração
     e
    Entregar documento
     .
  4. Revise as mensagens de status e de erro para localizar a falha.
  5. Verifique as credenciais e o endereço do ponto de extremidade na configuração de entrega.
A integração de entrada não carregou nenhum dado.
Causa: a etapa
Recuperação de documentos
 pode ter falhado ao localizar o arquivo, o arquivo pode estar vazio ou a etapa
Executar integração
 falhou durante o carregamento de dados.
Solução: verifique se o arquivo existe no local externo especificado e se o nome do arquivo corresponde à configuração. Verifique o relatório
Eventos de integração
 . Para visualizar as mensagens de erro do processo relacionadas à análise de arquivo ou à validação de dados, selecione a coluna
Criado a partir do acionador
 para o evento de integração.
Uma etapa de aprovação foi encaminhada incorretamente ou ignorada.
Explicação: a regra de condição na etapa de aprovação pode ter sido configurada incorretamente ou os membros do grupo de segurança especificado podem estar incorretos.
Solução: use o relatório
Visualizar definição de processo de negócios
 para revisar a lógica da regra de condição da etapa. Use o relatório
Visualizar grupo de segurança
 para verificar a associação do grupo de aprovadores atribuído.
A integração falha com um erro de segurança.
Causa: o usuário de sistema de integração (ISU) associado à integração não tem permissões para um domínio de segurança obrigatório.
Solução: revise a mensagem de erro nos detalhes
de Eventos de integração
 para identificar os dados ou a ação protegidos. Acesse o relatório
Políticas de segurança de domínio para área funcional
 para localizar o domínio relevante e adicioná-lo aos grupos de segurança atribuídos ao ISU.
Falha ao iniciar todas as integrações com o erro: "Não há definição por padrão para o tipo de processo de negócios Evento de processo de integração...".
Causa: a definição de processo de negócios por padrão para
o Evento de processo de integração
 foi desativada, excluída ou editada incorretamente e salva com erros. Todas as integrações dependem dessa definição como base.
Solução:
  1. Execute o relatório
    Tipos de processo de negócios com Definições por padrão em uso
    .
  2. Filtre o tipo
    de Evento de processo de integração
     para localizar a definição.
  3. Revise a definição e verifique se ela está ativa e contém, no mínimo, uma etapa
    de Início
     e uma etapa
    de Serviço (Ativar integração)
     . Corrija os erros e salve.
As notificações do processo de negócios de integração estão configuradas, mas não estão sendo entregues por e-mail.
Explicação: as regras de roteamento de notificação no nível do locatário não estão definidas para enviar notificações relacionadas à integração por e-mail.
Solução:
  1. Acesse a tarefa
    Definição de locatário - Notificações
     .
  2. Nas configurações de Subtipo de notificação para
    o Sistema
    , localize a linha
    Integrações
     .
  3. Defina a Regra de roteamento de notificação como
    E-mail/Imediatamente
     ou outra regra apropriada habilitada para e-mail.
Uma integração encadeada (iniciada a partir de uma etapa
de integração
 ) falha, fazendo com que todo o processo de negócios principal seja encerrado.
Causa: este é o comportamento projetado e esperado do Workday. A falha em qualquer etapa de um processo de negócios, incluindo uma etapa
de integração
 , interromperá o processo por padrão para evitar mais erros.
Solução: este não é um erro a ser "corrigido", mas um comportamento a ser gerenciado.
  1. Verifique se a integração filho tem um tratamento robusto de erros e notificações específicas próprias.
  2. Revise o processo principal para ver se a integração secundária é realmente crítica. Caso contrário, talvez precise ser dissociado e executado como um processo programado e separado, em vez de ser encadeado.
Uma etapa de integração do Studio com erros não é redirecionada, mesmo que tenha sido configurada com
Manter redirecionamento
.
Explicação: atualmente, a funcionalidade
Manter redirecionamento
 funciona somente em integrações do Studio concluídas com o status "
Falha
". Se uma integração do Studio é concluída com o status "
Concluído com erros
", isso não será considerado uma falha pela funcionalidade
de manutenção de redirecionamento
 .
Solução: este não é um erro a ser "corrigido", mas um comportamento a ser gerenciado. Verifique se a integração tem um tratamento robusto de erros e notificações específicas próprias. Consulte Configurar redirecionamento em etapas do processo de negócios.