Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2026-04-03
Diretrizes do processo de negócios de integração

Diretrizes do 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 a troca 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 o início de uma integração simples. ConsultarConceito: processos de negócios de integração .
Estas são as seções neste tópico:
  • Subprocessos
  • Pré-requisitos
  • Iniciadores do processo
  • Limitações
  • Fluxos de trabalho de processo de negócios comuns
  • Etapas do fluxo de trabalho
  • Integração
  • Notificações
  • Problemas e soluções

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 atinge essa etapa, ele inicia o Evento de processo de integração especificado como um subprocesso de processo 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
    Iniciar/Programar integração
     .
  • Programado
    Você pode programar a integração para ser executada em um horário específico ou de forma recorrente na tarefa
    Iniciar/Programar integração
     .
  • Como um subprocesso de processo de negócios
    O processo de negócios de integração pode ser iniciado a partir de uma etapa em outro processo de negócios do Workday (exemplo: executar 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.
  • Organização para um sistema de integração a partir do início de um serviço Web
    Ao iniciar uma integração por meio de
    Launch_Integration
     ou
    Launch_EIB
     operações de serviço Web, você não pode especificar uma versão específica da organização do processo de negócios. Será usada a definição de nível superior (por padrão) desse sistema de integração . Consulte
    Organizações e processos de negócios de integração
     emConceito: processos de negócios 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. ConsultarReferência: integrações e limites de serviço Web .

Fluxos de trabalho de processo 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: Início
>
 B: Serviço (Integração para ativar)
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
Este fluxo de trabalho é comum quando você precisa que um usuário revise os dados antes de serem enviados do Workday.
A: Início
>
 B: aprovação
>
 C: Serviço (Integração para ativar)
>
 D: Serviço: entrega de documentos
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 de fluxo de trabalho padrão para trazer dados ao Workday provenientes de uma fonte externa.
A: Início
>
 B: Serviço: Recuperação de documentos
>
 C: Serviço (Integração para ativar)
A etapa
Serviço: recuperação de documentos
 recupera um arquivo de uma fonte externa (como um servidor FTP) ou encaminha uma tarefa para um usuário para upload um arquivo manualmente.
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 em cadeia
Esse padrão é útil quando a saída de uma integração é a entrada para outra.
A: Início
>
 B: Integração
>
 C: Integração
A primeira etapa
de integração
 aciona o primeiro sistema de integração (exemplo: um EIB (Enterprise Interface Builder) ou uma integração do Studio ) para executar e gerar um arquivo de saída.
A segunda etapa
de 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
Administrador de integração (ISU) ou de integração que inicia a integração: Acesso
para Modificar/Colocar
 em
Build de integração
 ,
Configurar de 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. e não pode ser removido. Funciona 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 nova admissão para um fornecedor de benefícios externo. Esta 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 inserido 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ção ou administrador de processos de negócios: acesso
para Modificar/Colocar
 no
evento de integração
 .
Especificar
Você deve especificar os grupo de segurança responsáveis pela aprovação.
Regra de condição
  • Caso de uso: exija que um gestor revise e aprove um arquivo contendo dados de bonificação do colaborador antes de ser entregue ao fornecedor de folha de pagamento.
  • Prática recomendada: use regras de condição para acionador 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 regras 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 ao grupo de segurança
    Administrador de remuneração
     para aprovação. Caso contrário, a etapa é ignorada.
Casos de uso do tipo de etapa, práticas recomendadas e exemplo:
  • 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ção .
  • Prática recomendada: atribua aprovações a um grupo de segurança com base em funções em vez de um usuário nomeado específico para evitar atrasos no processo devido à ausência do colaborador .
  • Exemplo: antes de entregar um arquivo de alterações de remuneração de executivos a um sistema externo, uma etapa
    de aprovação
     é encaminhada ao grupo de segurança
    Administrador de remuneração executiva
     para validar os dados.
Serviço
Ordem
Pode ser inserida em qualquer lugar após
o início de
 . A ordem é crítica. Para uma integração de entrada ,
a recuperação de documentos
 deve ocorrer antes
da ativação da integração
 . Para uma saída,
a integração de ativação
 deve ocorrer 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
de Modificação/Colocação
 para o
Build de integração de
 ,
Configure de integração de
 .
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 que é executada diariamente, pode ser que você só precise recuperar um arquivo no primeiro dia da semana.
  • Prática recomendada: use regras de condição em etapas
    de entrega de documentos
     para evitar o envio de arquivos vazio . Você pode criar uma regra que verifique se o total de registros do evento de integração é maior que zero.
  • Exemplo: uma regras 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 só é executada se o total for maior que 0, impedindo que o sistema envie um arquivo em branco ao fornecedor.
Considerações para o tipo de etapa
  • Recuperação de documentos: usada em integrações de entrada para extrair 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 para um destino externo (como um servidor SFTP ou um ponto de extremidade de serviços Web).
Tarefa a fazer
Ordem
Pode ser inserida em qualquer lugar do processo em que uma ação ou instrução manual é necessária.
Executado por
Um grupo de segurança ou usuário especificado.
Domínios de segurança
ISU, administrador de integração ou administrador de processos de negócios: acesso
para Modificar/Colocar
 no
evento de integração
 .
Regra de condição
Útil para acionar uma 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 que um administrador revise os avisos.
Casos de uso de tipos de etapa, práticas recomendadas e exemplos
  • 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: torne as instruções na etapa
    Tarefas a fazer
     claras e acionáveis. Inclua links para relatórios ou tarefas relevantes, se possível.
  • Exemplo: um EIB (Enterprise Interface Builder) de entrada carrega novos trabalhadores terceirizados. Uma etapa Tarefas
    a fazer
     está configurada para acionador após a etapa
    Serviço - Executar integração
     . Ele é atribuído ao grupo
    Analista de HRIS
     com a instrução: "Trabalhadores terceirizados foram carregados. Execute o relatório Auditoria de novas admissões para verificar os dados e preencher as localizações que estão faltando."

Integração

Este tipo de etapa permite iniciar outro sistema de integração separado de dentro do processo de negócios atual . É assim que você encadeia integrações.
Ordem
Pode ser inserido 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: após a execução de uma integração de saída principal, você deseja 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 tiver sido bem-sucedida.
Use uma regras 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
 está configurada para iniciar uma integração de arquivo. Uma regras de condição nessa etapa verifica o status da etapa anterior
Executar integração
 . A integração de arquivo é executada apenas 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 um arquivo.
Use uma regras de condição que sempre é avaliada como falsa. Exemplo: "1=2" na etapa que deve ser ignorada.
Casos de uso de 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 processos): depois que um EIB (Enterprise Interface Builder) de entrada carrega novas admissões, uma etapa
    de Integração
     pode acionador uma integração de saída para provisionar contas para as novas admissões em um sistema de TI externo.
  • Caso de uso (falhas no redirecionamento): quando uma etapa de integração falhar, encaminhe essa integração para usuários específicos em vez de encerrar automaticamente o processo de negócios.
    1. Configure grupos de segurança para ter permissões
      de redirecionamento
       na política de segurança de processo 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,
Serviço (ativar integração)
 , executa a integração
PayData Extração
 , que gera um arquivo de dados de folha de pagamento . A próxima etapa,
Integração
 , está configurada para iniciar a integração
de transformação de dados de pagamento
 . Essa segunda integração foi desenvolvida para retirada o arquivo da primeira integração, reformatá-lo no layout XML necessário do fornecedor e colocar o novo arquivo na área de retenção de saída. A etapa final,
Serviço (Entrega de documento)
 , entrega o arquivo XML convertido 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 do Payroll confirmando que o arquivo de interface de folha de pagamento semanal foi gerado com êxito e entregue 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 em que ela foi executada e um vínculo (noun) vincular (verb) para o monitor de processos para obter detalhes.
  • Exemplo: uma notificação de integração está configurada para acionador quando o status do processo de negócios é "
    Falha
     ". Ele envia um e-mail ao grupo de segurança
    Suporte a integrações
     . O corpo do e-mail é personalizado com a mensagem: "Falha na integração
    CCB - Dados demográficos de saída
     . Consulte o monitor de processos para obter detalhes. ID do evento: [ID do evento]".

Problemas e soluções

Essa seção lista os problemas comuns junto com suas causas e soluções correspondentes. Para problemas não listados aqui, recomendamos pesquisar artigos de conhecimento no Community . Para obter melhores resultados:
  1. Pesquise o nome exato do processo usando aspas duplas. Exemplo: "Processo de negócios de integração".
  2. Refine os resultados iniciais selecionando estes filtros de pesquisa:
    • Grupo de conteúdo
       : artigos
    • Tipo de conteúdo
       : artigo de conhecimento
  3. Use o filtro
    Classificar por
     para visualizar os resultados por
    Relevância
     ou
    Mais recente
     .
Expedição
Causa e solução
O ponto de extremidade externo não receber o arquivo de integração esperado.
Use os relatórios
monitor de processos
 e
Registro de processo completo
 para determinar o que não funcionou como esperado. Consulte
Solução de problemas de eventos do processo de integração
 emConceito: 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 pode ter falhado.
solução: para visualizar o status e as mensagens de erro relacionadas à falha:
  1. No relatório
    monitor de processos
     no tipo de processo
    Integração
     , localizar a 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 de ambos para identificar 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 dados.
Causa: a etapa
de recuperação de documentos
 pode ter falhado ao localizar o arquivo, o arquivo pode estar vazio ou a etapa
de ativação de integração
 pode ter falhado 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 arquivos 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.
Causa: a regras de condição na etapa de aprovação pode estar 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 regras de condição da etapa. Use o relatório
View Security Group
 para verificar a associação do grupo de aprovador 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 necessário , .
solução: revise a mensagem de erro nos detalhes
dos Eventos de integração
 para identificar os dados protegidos ou a ação. 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 contam com esta 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 certifique-se de que ela esteja ativa e contenha, no mínimo, uma etapa
    Início
     e uma etapa
    Serviço (ativar integração)
     . Corrija todos os erros e salve.
As notificações do processo de negócios de integração foram configuradas, mas não estão sendo entregues por e-mail.
Causa: as regras de roteamento de notificação no nível de 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
     , localizar 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 em cadeia (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 no 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 erros adicionais.
solução: este não é um erro a ser "corrigido", mas um comportamento a ser gerenciado.
  1. Certifique-se de que a integração secundária tenha um tratamento de erro robusto e suas próprias notificações específicas.
  2. Revise o processo principal para ver se a integração secundária é realmente crítica. Caso contrário, pode precisar ser desanexado e executado como um processo programado separado, em vez de ser encadeado.
Uma etapa de integração do Studio com erros não é redirecionada, mesmo que esteja configurada com
Manter redirecionamento
 .
Causa: atualmente, a funcionalidade
Manter redirecionamento
 funciona apenas em integrações do Studio concluídas com um status de "
Falhou
 ". Se uma integração do Studio é concluída com o status "
Concluído com erros
 ", isso não será considerado uma falha pela funcionalidade
Manter redirecionamento
 .
solução: este não é um erro a ser "corrigido", mas um comportamento a ser gerenciado. Certifique-se de que a integração oferece um tratamento de erro robusto e suas próprias notificações específicas. ConsultarConfigurar redirecionamento em etapas do processo de negócios .