Passer au contenu principal
Documentation
Documentation
Administrator Guide
Dernière mise à jour : 2026-04-03
Recommandations du processus de gestion d'intégration

Recommandations du processus de gestion d'intégration

Aperçu

Un processus de gestion d'intégration est un workflow configurable qui orchestre les tâches associées à l'exécution d'une intégration pour l'échange de données entre Workday et des points de terminaison externes. Il utilise le type de processus de gestion
Événement du processus d'intégration
 , qui permet un traitement plus complexe qu'un simple lancement intégration . ConsulterConcept : processus de gestion d'intégration .
Voici les sections associées à ce thème:
  • Sous-processus
  • Conditions préalables
  • Initiateurs de processus
  • Limites
  • Workflows des processus de gestion communs
  • Étapes du workflow
  • Intégration
  • Notifications
  • Problèmes et solutions

Sous-processus

Vous pouvez imbriquer une intégration dans un autre processus de gestion en ajoutant une étape d'intégration à la définition de ce processus de gestion. Lorsque le processus de gestion parent atteint cette étape, il lance l'événement de processus d'intégration spécifié en tant que sous processus de gestion.

Conditions préalables

Initiateurs de processus

Un processus de gestion d'intégration peut être lancé de plusieurs façons :
  • Manuellement
    Un utilisateur disposant des autorisations appropriées peut lancer l' intégration directement à partir du rapport
    View Integration System
     ou à l'aide de la tâche
    Launch/Schedule Integration
     .
  • Planifié
    Vous pouvez planifier l'exécution de intégration à une heure précise ou de façon récurrente à partir de la tâche
    Launch/Schedule Integration
     .
  • En tant que sous processus de gestion
    Le processus de gestion d'intégration peut être lancé à partir d'une étape dans un autre processus de gestion Workday (par exemple, exécution d'une intégration E-Verify après le processus de gestion
    Remplir le formulaire I-9
     ).

Limites

Bien que la structure du processus de gestion d'intégration soit flexible, la technologie intégration sous-jacente présente des limites spécifiques.
  • Organisation d'un système d'intégration à partir d'un lancement de service web
    Lors du lancement d'une intégration via le
    Launch_Integration
     ou
    Launch_EIB
     Les opérations de service web, vous ne pouvez pas indiquer une version spécifique à une organisation du processus de gestion. La définition de premier niveau (par défaut) de ce système d'intégration sera utilisée. Voir
    Organisations et processus de gestion d'intégration
     dansConcept : processus de gestion d'intégration .
  • Taille maximale du fichier pour la récupération des documents
    Les fichiers entrants sont limités à 1 Go pour le format XML et à 300 Mo pour le format XLSX. ConsulterRéférence : intégrations et limites des services web .

Workflows des processus de gestion communs

Chemin 1 : workflow d'intégration par défaut
Par défaut, l'
événement du processus d'intégration
 se compose de deux étapes fondamentales :
A : Lancement
 >
 B : Service (Déclencher l'intégration)
L'étape
Service (Fire Integration)
 exécute le système d'intégration lui-même. Pour une intégration sortante , elle génère le fichier de sortie. Pour une intégration entrante , elle charge les données dans Workday.
Chemin 2 : intégration sortante avec approbation
Ce workflow est courant lorsque vous avez besoin qu'un utilisateur révise des données avant qu'elles ne soient envoyées depuis Workday.
A : Lancement
 >
 B : Approbation
 >
 C : Service (Déclenchement de l'intégration)
 >
 D : Service : Envoi des documents
Une fois la demande approuvée, l'étape
Service (Fire Integration)
 s'exécute et extrait les données de Workday, générant ainsi le fichier de sortie.
L'étape
Service: Document Delivery
 envoie le fichier généré au point de terminaison externe, tel qu'un serveur SFTP.
Chemin 3 : workflow d'intégration entrante
Ce workflow est un workflow standard permettant d'importer des données dans Workday depuis une source externe.
A : Lancement
 >
 B : Service : Récupération de documents
 >
 C : Service (Déclenchement de l'intégration)
L'étape
Service: Document Retrieval
 récupère un fichier depuis une source externe (comme un serveur FTP) ou route une tâche à un utilisateur pour télécharger manuellement un fichier.
L'étape
Service: Fire Integration
 exécute l' intégration, en prenant le fichier récupéré et en chargeant les données dans Workday.
Chemin 4 : workflow d'intégration en chaîne
Ce modèle est utile lorsque la sortie d'une intégration est l'entrée d'une autre.
A : Lancement
 >
 B : Intégration
 >
 C : Intégration
La première étape
d'intégration
 déclenche l'exécution et la génération d'un fichier de sortie par le premier système d'intégration (exemple : une intégration générateur d'interfaces Entreprise (EIB) ou une intégration Studio).
La deuxième étape
d'intégration
 déclenche un deuxième système d'intégration, qui consomme le fichier de sortie de la première intégration.

Étapes du workflow

Lancement
Ordre
A (première étape)
Effectuée par
L'utilisateur ou le système qui lance l' intégration. Il peut s'agir d'un utilisateur du système d'intégration (ISU) pour les événements planifiés ou déclenchés par le système, ou d'un utilisateur interactif pour les lancements manuels.
Domaine de sécurité par rôle
ISU ou administrateur d'intégration qui lance l' intégration: accès
Modifier/Insérer
 à
Integration Build
 ,
Integration Configure
 ,
Integration Debug
 ,
Integration Event
 .
Bonne pratique
L'étape
Lancement
 est une première étape obligatoire pour tous les processus de gestion. Elle ne peut pas être retirée. Il sert de point d'entrée et d'enregistrement d'audit pour le démarrage du processus.
Exemple
Un administrateur RH accède à la tâche
Launch/Schedule Integration
 et clique sur
OK
 pour exécuter une nouvelle embauche exportation vers un fournisseur d'avantages sociaux externe. Cette action exécute l'étape
de lancement
 et démarre le workflow du processus de gestion .
Types d'étape
Voici les types d'étape courants que vous pouvez ajouter à un processus de gestion d'intégration.
Approbation
Ordre
Peut être placé n'importe où après l'étape
de lancement
 . Par exemple, vous pouvez le placer après une étape
Déclencher l'intégration
 , mais avant une étape
Envoi des documents
 .
Effectuée par
groupe de sécurité spécifié (ex. : Partenaire RH, Administrateur de la rémunération, Responsable).
Domaines de sécurité
ISU, administrateur d'intégration ou administrateur du processus de gestion : accès
Modifier/Insérer
 à
l'événement d'intégration
 .
Spécifier
Vous devez indiquer le(s) groupe de sécurité responsable(s) de l'approbation.
Règle de condition
  • Cas d'utilisation : demandez à un responsable de réviser et d'approuver un fichier contenant les données prime des salarié avant que celui-ci ne soit envoyé au fournisseur de la paie.
  • Bonne pratique : utilisez des règles de condition pour déclencheur les approbations uniquement lorsque cela est nécessaire. Par exemple, vous pouvez créer une règle qui ignore l'étape d'approbation si le montant total de la prime est inférieur à un certain seuil.
  • Exemple : une règle de condition est configurée à l'étape d'approbation pour vérifier si le champ "Montant total de la prime" dans la sortie de intégration est supérieur à 50 000 USD. Si c'est le cas, l'échelon est routé au groupe de sécurité
    Administrateur de la rémunération
     pour approbation. Sinon, l'étape est ignorée.
Cas d'utilisation des types d'étape, bonnes pratiques et exemple :
  • Cas d'utilisation : garantir l'exactitude des données pour les intégrations sortantes sensibles telles que la paie ou les octrois d'actions.
  • Bonne pratique : affectez les approbations à un groupe de sécurité par rôle plutôt qu'à un utilisateur spécifique désigné pour éviter les retards de processus dus à l' absence du salarié .
  • Exemple : avant l'envoi d'un fichier de modifications de la rémunération des cadres à un système externe, une étape
    d'approbation
     est envoyée au groupe de sécurité
    Administration de la rémunération des cadres
     pour valider les données.
Service
Ordre
Peut être placé n'importe où après
le lancement
 . L'ordre est essentiel. Pour une intégration entrante ,
la récupération de documents
 doit intervenir avant
le déclenchement
 . Pour un type sortant,
le déclenchement d'intégration
 doit intervenir avant
l'envoi de document
 .
Effectuée par
Utilisateur du système d'intégration (ISU).
Domaines de sécurité par rôle
ISU : accès
Modifier/Insérer
 à
Integration Build
 ,
Integration Configure
 .
Spécifier
Vous devez indiquer le service à exécuter :
Récupération de documents
 ,
Envoi de documents
 ou
Intégration de déclenchement
 .
Règle de condition
  • Cas d'utilisation : pour une intégration qui s'exécute tous les jours, vous n'aurez peut-être besoin que de récupérer un fichier le premier jour de la semaine.
  • Bonne pratique : utilisez des règles de condition dans les étapes
    d'envoi de documents
     pour empêcher l'envoi de fichiers vides. Vous pouvez créer une règle qui vérifie si le nombre d'enregistrements de l'événement intégration est supérieur à zéro.
  • Exemple : une règle de condition d'une étape
    Envoi des documents
     vérifie un champ calculé qui compte le nombre d'enregistrements traités par l'étape
    Déclencher l'intégration
     . L'étape d'envoi ne s'exécute que si le nombre est supérieur à 0, ce qui empêche le système d'envoyer un fichier vide au fournisseur.
Éléments à prendre en compte :
  • Récupération de documents : utilisée dans les intégrations entrantes pour extraire un fichier d'une source externe (comme un serveur SFTP).
  • Déclencher l'intégration : il s'agit de l'étape principale qui exécute le système d'intégration principal , soit en générant un fichier de sortie (sortant), soit en chargeant des données dans Workday (entrant).
  • Envoi de documents : utilisé dans les intégrations sortantes pour envoyer un fichier généré vers une destination externe (comme un serveur SFTP ou un point de terminaison du service web).
À faire
Ordre
Peuvent être placés n'importe où dans le processus lorsqu'une action manuelle ou une instruction est nécessaire.
Effectué par
Un groupe de sécurité ou un utilisateur spécifique.
Domaines de sécurité
ISU, administrateur d'intégration ou administrateur du processus de gestion : accès
Modifier/Insérer
 à
l'événement d'intégration
 .
Règle de condition
Utilisé pour déclencher une intervention manuelle uniquement lorsque cela est nécessaire. Par exemple, une règle peut vérifier si le statut de événement d'intégration est "
Terminé avec avertissements
 ", ce qui déclenche une
tâche À faire
 pour qu'un administrateur puisse consulter les avertissements.
Cas d'utilisation des types d'étape, bonnes pratiques et exemples
  • Cas d'utilisation : notification à un administrateur d'effectuer une tâche manuelle en dehors de Workday ou de vérifier des données dans Workday après une étape de processus.
  • Bonne pratique : rendez les instructions de l'étape
    À faire
     claires et exploitables. Inclure dans la mesure du possible des liens vers des tâches ou des rapports pertinents.
  • Exemple : un générateur d'interfaces Entreprise (générateur d'interfaces Entreprise (EIB) entrant pour charger de nouveaux intervenants extérieurs. Une étape
    À faire
     est configurée pour déclencheur après l'étape
    Service - Déclencher l'intégration
     . Il est affecté au groupe
    Analyste SIRH
     avec l'instruction suivante : « Les intervenants extérieurs ont été chargés ». Exécutez le rapport "Audit des nouvelles embauches" pour vérifier leurs données et finaliser les localisations manquantes

Intégration

Ce type d'étape vous permet de lancer un autre système d'intégration distinct à partir du processus de gestion actuel . C'est ainsi que vous chaînez les intégrations entre elles.
Ordre
Peut être placé n'importe où après l'étape
de lancement
 .
Effectuée par
Utilisateur du système d'intégration (ISU).
Spécifier
Vous devez sélectionner le système d'intégration à lancer en tant que sous-processus.
Règles de condition avec cas d'utilisation, bonnes pratiques et exemple
Cas d'utilisation : après l'exécution d'une intégration sortante principale, vous souhaitez exécuter une deuxième intégration pour archiver le fichier généré dans un site de stockage à long terme, mais uniquement si la première intégration a réussi.
Utilisez une règle de condition pour vérifier le statut d'une étape précédente (
Déclencher l'intégration
 ) afin de vous assurer qu'elle s'est terminée avec succès avant de lancer une intégration suivante qui dépend de sa sortie.
Exemple : une étape
d'intégration
 est configurée pour lancer une "intégration d'archivage". Une règle de condition à cette étape vérifie le statut de l'étape
Démarrer l'intégration
 précédente. L' intégration des archives s'exécute uniquement si le statut de l'étape précédente est "
Terminé
 ".
Cas d'utilisation : vous voulez récupérer un fichier sans lancer d' intégration ou lancer une intégration sans envoyer de fichier.
Utilisez une règle de condition qui évalue toujours à false. Exemple : « 1=2 » sur l'étape à ignorer.
Cas d'utilisation du type d'étape
  • Cas d'utilisation (enrichissement des données) : une intégration initiale extrait les données de base des salarié . Une deuxième étape
    d'intégration
     appelle une intégration différente qui récupère la sortie initiale, ajoute des données provenant d'une autre source (comme un rapport personnalisé) et produit un fichier final enrichi.
  • Cas d'utilisation ( orchestration du processus) : une fois qu'un générateur d'interfaces Entreprise (générateur d'interfaces Entreprise (EIB) entrant a chargé de nouvelles embauches, une étape
    d'intégration
     peut déclencheur une intégration sortante pour provisionner les comptes de ces nouvelles embauches dans un système informatique externe.
  • Cas d'utilisation (échecs de redirection) : lorsqu'une étape intégration échoue, routez l' intégration qui a échoué à des utilisateurs spécifiques au lieu de mettre fin automatiquement au processus de gestion.
    1. Configurez les groupes de sécurité afin de disposer des autorisations
      de redirection
       dans la règle de sécurité du processus de gestion.
    2. Utilisez l' action associée
      Mettre à jour la redirection
       dans l'étape
      d'intégration
       de la définition du processus de gestion.
    3. Sélectionnez une ou plusieurs actions de redirection, puis sélectionnez un ou plusieurs groupes de sécurité pour recevoir l'étape redirigée.
Exemple de type d'étape
Le processus de gestion démarre et la première étape,
Service (Intégration au déclenchement)
 , exécute l' intégration
PayData Extraction
 qui génère un fichier de données de paie brutes. L'étape suivante,
Intégration
 , est configurée pour lancer l' intégration
PayData Transformation
 . Cette seconde intégration est conçue pour prélever le fichier du premier, le formater à nouveau dans la présentation XML obligatoire par le fournisseur, et placer le nouveau fichier dans la zone de stockage de sortie. L'étape finale,
Service (Envoi des documents)
 , envoie le fichier XML transformé au fournisseur de la paie.

Notifications

Les notifications personnalisées sont déclenchées par le statut final de l' événement global du processus intégration . Vous pouvez configurer des notifications dans la définition du processus de gestion elle-même (exemple : lors de la finalisation d'une étape ou erreur).
Cas d'utilisation avec Bonnes pratiques et Exemple :
  • Cas d'utilisation (réussite) : envoyez un e-mail à l' équipe de la paie pour confirmer que le fichier de l'interface de la paie hebdomadaire a bien été généré et envoyé au fournisseur.
  • Use Case (Error) : si une intégration échoue, envoyez une notification de priorité élevée à l' équipe d'administration de l'intégration avec le détail de événement et les messages erreur afin qu'elle puisse enquêter immédiatement.
  • Bonne pratique : utilisez des groupes de sécurité par rôle spécifiques (par exemple,
    Administrateurs de l'intégration
     ) comme destinataires plutôt que des utilisateurs individuels. Créez des messages de notification clairs et interactifs incluant des informations clés, telles que le nom de l' intégration, la durée de son exécution et un associer vers la console des traitements pour plus d'informations.
  • Exemple : une notification intégration est configurée pour déclencheur lorsque le statut du processus de gestion est "
    Échec
     ". Il envoie un e-mail au groupe de sécurité
    Support d'intégration
     . Le corps de l'e-mail est personnalisé pour indiquer que : " Échec de l' intégration
    CCB - Données démographiques sortantes
     . Pour plus d'informations, consultez la console des traitements . Identifiant de l'événement : [Identifiant de l'événement]".

Problèmes et solutions

Cette section répertorie les problèmes courants ainsi que leurs causes et solutions correspondantes. Pour les problèmes non répertoriés ici, nous vous recommandons de rechercher les articles de la base de connaissances dans Community . Pour optimiser les résultats :
  1. Recherchez le nom exact du processus à l'aide de guillemets. Exemple : "Processus de gestion d'intégration".
  2. Affinez les résultats initiaux en sélectionnant les filtres de recherche suivants :
    • Groupe de contenu
       : Articles
    • Type de contenu
       : Article de la base de connaissances
  3. Utilisez le filtre
    Trier par
     pour afficher les résultats par
    Pertinence
     ou
    Plus récent
     .
Sortie
Cause et solution
Le point de terminaison externe ne recevoir pas de fichier intégration attendu.
Utilisez les rapports
console des traitements
 et
Enregistrement complet des traitements
 pour déterminer ce qui n'a pas fonctionné comme prévu. Voir
Résolution des événements de processus d'intégration
 dansConcept : processus de gestion d'intégration .
Le fichier sortant n'a pas été envoyé au point de terminaison externe.
Cause : le processus de gestion a peut-être échoué avant l'étape
Envoi des documents
 , ou si l'étape d'envoi elle-même a échoué.
solution: pour afficher le statut et les messages erreur liés à l'échec :
  1. Dans le rapport
    console des traitements
     du type de traitement
    Intégration
     , rechercher votre demande intégration .
  2. Sur la page
    Afficher le traitement en arrière-plan
     , cliquez sur l'
    événement parent
     , qui est l' événement du processus intégration .
  3. Sur la page
    Afficher un événement
     , le table
    Processus ultérieurs
     affiche les événements intégration pour les étapes
    d'intégration
     et d'
    envoi de document
     .
  4. Consultez le statut et les messages erreur des deux pour identifier l'échec.
  5. Vérifiez les identifiants et l'adresse du point de terminaison dans la configuration d'envoi .
intégration entrante n'a chargé aucune donnée.
Cause : l'étape
Récupération de documents
 a peut-être rechercher , le fichier peut être vide ou l'étape
Déclencher l'intégration
 a échoué pendant le chargement des données.
solution: vérifiez que le fichier existe à l' site externe indiqué et que le nom du fichier correspond à la configuration. Consultez le rapport
Événements d'intégration
 . Pour afficher les messages erreur de traitement liés à analyse de fichiers ou à la validation des données, sélectionnez la colonne
Création à partir d'un déclenchement
 pour l' événement d'intégration.
Une étape d'approbation n'a pas été routée ou ignorée.
Cause : la règle de condition de l'étape d'approbation peut être mal configurée ou les membres du groupe de sécurité indiqué peuvent être incorrects.
solution: utilisez le rapport
Afficher une définition de processus de gestion
 pour réviser la logique de règle de condition de l'étape. Utilisez le rapport
View Security Group
 pour vérifier l' affiliation du groupe approbateur affecté.
L'intégration a échoué avec une erreur de sécurité .
Cause : il manque des autorisations pour un domaine de sécurité obligatoire pour l'utilisateur du système d'intégration (ISU) associé à l' intégration .
solution: consultez le message erreur dans le détail
des événements d'intégration
 pour identifier les données ou l'action protégées. Accédez au rapport
Règles de sécurité des domaines par domaine fonctionnel
 pour rechercher le domaine approprié et l'ajouter aux groupes de sécurité affectés à l'utilisateur du système d'intégration.
Le lancement de toutes les intégrations échoue avec l' erreur: "Il n'existe aucune définition par défaut pour le type de processus de gestion "Événement du processus d'intégration"...
Cause : la définition du processus de gestion par défaut pour
l'événement du processus d'intégration
 a été désactivée, supprimée ou modifiée de manière incorrecte et enregistrée avec des erreurs. Toutes les intégrations utilisent cette définition comme base.
Solution :
  1. Exécutez les
    types de processus de gestion avec les définitions par défaut en cours d'utilisation
     .
  2. Filtrez le type
    Événement du processus d'intégration
     pour rechercher la définition.
  3. Vérifiez la définition et assurez-vous qu'elle est active et qu'elle contient au moins une étape
    de lancement
     et une étape
    de service (déclencher l'intégration)
     . Corrigez les erreurs éventuelles et enregistrez.
Les notifications des processus de gestion d'intégration sont configurées mais ne sont pas envoyées par e-mail.
Cause : les règles de routage des notification au niveau de l'environnement client ne sont pas configurées pour envoyer des notifications relatives à l'intégration par e-mail.
Solution :
  1. Accédez à la tâche
    Définition de l'environnement client - notifications
     .
  2. Dans les paramètres de sous-type de notification pour
    le système
     , rechercher la ligne
    Intégrations
     .
  3. Définissez la règle de routage de notification sur
    E-mail/immédiat
     ou sur une autre règle configurée par e-mail appropriée.
Une intégration en chaîne (lancé à partir d'une étape
d'intégration
 ) échoue, ce qui entraîne la fin d'emploi de l'ensemble du processus de gestion parent.
Cause : il s'agit du comportement conçu et attendu dans Workday. L'échec de n'importe quelle étape d'un processus de gestion, y compris une étape
d'intégration
 , interrompra le processus par défaut pour éviter de nouvelles erreurs.
solution: il ne s'agit pas d'une erreur à "corriger" mais d'un comportement à gérer.
  1. Assurez-vous que l' intégration enfant dispose d'un traitement robuste des erreur et de ses propres notifications.
  2. Révisez le traitement parent pour voir si l' intégration enfant est vraiment critique. Si ce n'est pas le cas, il faut peut-être le dissocier et l'exécuter en tant que traitement planifié distinct au lieu de procéder à une chaîne.
Une étape intégration Studio contenant des erreurs n'est pas redirigée, même si elle est configurée avec
Maintain Redirect
 .
Cause : actuellement, la fonction
Maintain Redirect
 fonctionne uniquement sur les intégrations Studio qui se terminent avec le statut "
Échec
 ". Si une intégration Studio se termine avec le statut "
Terminé avec erreurs
 ", cela n'est pas considéré comme un échec par la fonctionnalité
Maintain Redirect
 .
solution: il ne s'agit pas d'une erreur à "corriger" mais d'un comportement à gérer. Assurez-vous que l' intégration dispose d'un traitement robuste des erreur et de ses propres notifications. ConsulterConfigurer la redirection aux étapes du processus de gestion .