Directives sur les processus de gestion d'intégration
Aperçu
Un processus de gestion d'intégration est un flux des travaux des travaux configurable qui orchestre les tâches associées à l'exécution d'une intégration pour l'échange de données entre Workday et les points de terminaison externes. Il utilise le type de processus de gestion
Événement lié au processus d’intégration
, qui permet un traitement plus complexe qu’un simple lancement intégration . Voir Concept : processus de gestion d’intégrationleVoici les sections de cette sujet:
- Sous-processus
- Conditions préalables
- Initiateurs de processus
- Limites
- Flux des travaux de processus de gestion communs
- Étapes du flux des travaux
- Intégration
- Notifications
- Problèmes et solutions
Sous-processus
Vous pouvez incorporer 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 lié au processus d’intégration 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 rapportView Integration Systemou à l’aide de la tâcheLaunch/Schedule Integration.
- PlanifiéVous pouvez planifier l’exécution de intégration à un moment précis ou de manière récurrente à partir de la tâcheDémarrer/planifier l’intégration.
- En tant que sous processus de gestionLe processus de gestion d’intégration peut être lancé à partir d’une étape d’un autre processus de gestion de Workday (exemple : exécution d’une intégration de E-Verify après le processus de gestionComplete Form I-9).
Limites
Bien que le cadre de processus de gestion d’intégration soit flexible, la technologie intégration sous-jacente comporte des limites précises.
- Organisation associée à un système d'intégration depuis un lancement de service WebLors du lancement d'une intégration au moyen duLaunch_IntegrationouLaunch_EIBdes opérations de service Web, vous ne pouvez pas préciser une version propre à l'organisation du processus de gestion. La définition de plus haut niveau (par défaut) pour ce système d'intégration sera utilisée. VoirOrganisations et processus de gestion d'intégrationdansConcept : processus de gestion d’intégration le
- Limite de taille de fichier pour l'extraction de documentsLes fichiers entrants ont une limite de 1 Go pour les fichiers XML et de 300 Mo pour XLSX. Voir Référence : intégrations et limites des services Weble
Flux des travaux de processus de gestion communs
- Chemin 1 : Flux des travaux d’intégration par défaut
- Par défaut, l’événement lié au processus d’intégrationcomprend deux étapes fondamentales :A: Lancement>B: Service (Fire Integration)L’étapede service (Fire Integration)exécute le système d'intégration lui-même. Pour une intégration sortante, il génère le fichier de sortie. Pour une intégration entrante , il charge les données dans Workday.
- Chemin 2 : Intégration sortante avec approbation
- Ce flux des travaux est courant lorsque vous avez besoin qu'un utilisateur révise les données avant que les données ne soient envoyées à partir de Workday.A : Lancement>B : Approbation>C : Service (Fire Integration)>D : Service : Livraison des documentsUne fois approuvées, l'étapede service (Fire Integration)s'exécute et extrait les données de Workday, ce qui génère le fichier de sortie.L’étapeService : livraison de documentsfournit le fichier généré au point d’extrémité externe, tel qu’un serveur SFTP.
- Chemin 3 : flux des travaux d'intégration entrante
- Ce flux des travaux est un flux des travaux standard pour importer dans Workday des données à partir d’une source externe.A: Lancement>B: Service: Document Retrieval>C: Service (Fire Integration)L’étapeService : récupération de documentsrécupère un fichier d’une source externe (comme un serveur FTP) ou achemine une tâche vers un utilisateur pour téléverser un fichier manuellement.L'étapeService : Fire Integrationexécute l' intégration, en utilisant le fichier récupéré et en chargeant les données dans Workday.
- Chemin 4 : flux des travaux d’intégration en chaîne
- Ce modèle est utile lorsqu'une sortie d'intégration est l'entrée pour une autre.A : Lancement>B : Intégration>C : IntégrationLa première étaped'intégrationdéclenche l'exécution et la production d'un fichier de sortie dans le premier système d'intégration (exemple : un Créateur d'interfaces Entreprise (EIB) ou une intégration Studio).La deuxième étaped'intégrationdéclenche un deuxième système d'intégration, qui utilise le fichier de sortie de la première intégration.
Étapes du flux des travaux
- Lancement
- Ordre
- A (première étape)
- Effectué par
- L'utilisateur ou le système qui lance l' intégration. Ce rôle peut être un utilisateur système pour intégrations (utilisateur système pour intégrations) pour les événements planifiés ou déclenchés par le système, ou un utilisateur interactif pour les lancements manuels.
- Domaine de sécurité par rôle
- utilisateur système pour intégrations intégrations ou administrateur des intégrations qui lance l’ intégration: Accèspour modifier et chargeràla version d’intégration,Configurer l’intégration,Débogage de l’intégration,Événement d’intégration.
- Pratique exemplaire
- L’étapede lancementest la première étape obligatoire de tous les processus de gestion. Il ne peut pas être retiré. 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âcheDémarrer/planifier l’intégrationet clique sur «OK» pour exécuter une exportation de nouvelle embauche vers un fournisseur d’avantages sociaux externe. Cette action termine l'étapede lancementet lance le flux des travaux du processus de gestion .
types d'étapes
Voici les types d’étapes communes que vous pouvez ajouter à un processus de gestion d’intégration.
- Approbation
- Ordre
- Peut être placée n’importe où après l’étapede lancement. Par exemple, vous pourriez le placer après une étaped'intégration de déclenchement, mais avant une étapede livraison de document.
- Effectué par
- Un groupe de sécurité précis (par exemple, partenaire RH, administrateur de la rémunération, gestionnaire).
- Domaines de sécurité
- Utilisateur utilisateur système pour intégrations, administrateur de l'intégration ou administrateur de processus de gestion : Accèspour modifier ou chargeràl'événement d'intégration.
- Préciser
- Vous devez préciser le ou les groupe de sécurité responsables de l’approbation.
- Règle de conditions
- Cas d’utilisation : exigez d’un gestionnaire qu’il révise et approuve un fichier contenant des données de prime employé avant de le transmettre au fournisseur de la paie.
- Recommandation : 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 omet l’étape d’approbation si le montant total de la prime est inférieur à un certain seuil.
- Exemple : une règle de conditions 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 $. Le cas échéant, l’étape est acheminée vers le groupe de sécuritéAdministrateur de la rémunérationpour approbation. Sinon, l’étape est omise.
- Cas d’utilisation, meilleures pratiques et exemples des types d’étapes :
- Cas d’utilisation : garantir l’exactitude des données des intégrations sortantes sensibles telles que la paie ou les octrois actions .
- Recommandation : affectez les approbations à un groupe de sécurité fondé sur des rôles plutôt qu’à un utilisateur précis nommé pour éviter les retards de processus dus aux absences employé .
- Exemple : avant de livrer un fichier de changements de la rémunération de la direction à un système externe, une étaped’approbationest acheminée au groupe de sécuritéde l’administrateur de la rémunération pour la directionpour valider les données.
- Service
- Ordre
- Peut être placé n'importe où aprèsle lancement du. L’ordre est critique. Pour une intégration entrante ,l'extraction de documentsdoit précéderl'intégration de validation. Pour un événement sortant,l'intégration de sécuritédoit être antérieure àla livraison du document.
- Effectué par
- Utilisateur système pour intégrations (utilisateur système pour intégrations).
- Domaines de sécurité par rôle
- utilisateur système pour intégrations: Accèspour modifier / chargeràla version d'intégration,Configuration de l'intégration.
- Préciser
- Vous devez préciser le service à exécuter :Extraction de documents,Livraison de documentsouDéclencher l'intégration.
- Règle de conditions
- Cas d’utilisation : pour une intégration qui s’exécute quotidiennement, vous n’avez peut-être besoin de récupérer un fichier que le premier jour de la semaine.
- Recommandation : utilisez des règles de condition aux étapesde livraison de documentspour éviter d’envoyer des fichiers vide . 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 conditions d’une étapede livraison de documentsvérifie un champ calculé qui compte le nombre d’enregistrements traités par l’étapeDéclencher l’intégration. L’étape de livraison s’exécute uniquement si le nombre est supérieur à 0, ce qui empêche le système d’envoyer un fichier en blanc au fournisseur.
- Éléments à prendre en compte pour les types d'étapes
- Extraction 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 de générer un fichier de sortie (sortant) ou de charger des données dans Workday (entrant).
- Livraison de documents : utilisée 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 de service Web).
- À faire
- Ordre
- Peuvent être placées n’importe où dans le processus, là où une action manuelle ou des instructions sont nécessaires.
- Effectué par
- Un groupe de sécurité ou un utilisateur précis.
- Domaines de sécurité
- Utilisateur utilisateur système pour intégrations, administrateur de l'intégration ou administrateur de processus de gestion : Accèspour modifier ou chargeràl'événement d'intégration.
- Règle de conditions
- Utile pour déclencher une intervention manuelle uniquement en cas de besoin. Par exemple, une règle pourrait vérifier si le statut de l’événement d’intégration est «Terminé avec avertissements», ce qui déclenche unetâche À fairepour que l’administrateur puisse examiner les avertissements.
- Cas d’utilisation, meilleures pratiques et exemples des types d’étapes
- Cas d’utilisation : notifie un administrateur de l’exécution d’une tâche manuelle en dehors de Workday ou de la vérification de données dans Workday après une étape de processus.
- Recommandation : rendez les instructions de l’étapeÀ faireclaires et exploitables. Incluez des liens vers des rapports ou des tâches pertinents, si possible.
- Exemple : un Créateur d'interfaces Entreprise (EIB) Entreprise entrant charge de nouveaux travailleurs auxiliaires. Une étapeÀ faireest configurée pour déclencheur après l’étapeService - Déclencher l’intégration. Il est affecté au grouped’analystes des SIRHavec l’instruction suivante : « Les travailleurs auxiliaires ont été chargés ». Exécutez le rapport Audit des nouvelles embauches pour vérifier leurs données et effectuer les localisations manquantes. »
Intégration
Ce type d'étape vous permet de lancer un autre système d'intégration distinct du processus de gestion en cours . Voici comment vous chaînez les intégrations.
- Ordre
- Peut être placée n’importe où après l’étapede lancement.
- Effectué par
- Utilisateur système pour intégrations (utilisateur système pour intégrations).
- Préciser
- Vous devez sélectionner le système d'intégration à démarrer en tant que sous-processus.
- Règles de conditions avec cas d’utilisation, meilleures pratiques et exemples
- 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 emplacement de stockage à long terme, mais uniquement si la première intégration a réussi.Utilisez une règle de conditions 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 subséquente qui dépend de sa sortie.Exemple : une étaped'intégrationest configurée pour lancer une « intégration d'archives ». Une règle de conditions de cette étape vérifie le statut de l’étape précédenteDéclencher l’intégration. L' intégration des archives s'exécute uniquement si le statut de l'étape précédente est «Terminé».
- Cas d’utilisation : vous souhaitez extraire un fichier sans lancer d’ intégration ou lancer une intégration sans livrer de fichier.Utilisez une règle de conditions qui est toujours évaluée à faux. Exemple : « 1 = 2 » à l'étape qui doit être omise.
- Cas d’utilisation de types d’étapes
- Cas d’utilisation (enrichissement de données) : une intégration initiale extrait les données de base des employé . Une deuxième étaped’intégrationappelle une intégration différente qui utilise 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 de processus) : après qu’un Créateur d'interfaces Entreprise (EIB) entrant charge les nouvelles embauches, une étaped’intégrationpeut déclencheur une intégration sortante pour attribuer des comptes à ces nouvelles embauches dans un système informatique externe.
- Cas d’utilisation (échec de redirection) : lorsqu’une étape intégration échoue, acheminez l’ intégration qui a échoué à des utilisateurs précis plutôt que de mettre fin automatiquement au processus de gestion.
- Configurez les groupes de sécurité pour obtenir les autorisationsde redirectiondans la politique de sécurité de processus de gestion.
- Utilisez l' action connexeMettre à jour une redirectionà l'étaped'intégrationde la définition de processus de gestion.
- Sélectionnez une ou plusieurs actions de redirection et sélectionnez un ou plusieurs groupes de sécurité en vue de réceptionner l’étape redirigée.
- Exemple de type d'étape
- Le processus de gestion démarre et la première étape,Service (Fire Integration), exécute l’ intégrationde l’extraction des données sur la paie, qui génère un fichier de données de la paie . L'étape suivante,Intégration, est configurée pour lancer l' intégrationde la transformation de données de la paie. Cette deuxième intégration est conçue pour prélever le fichier dans la première page, le reformuler dans la disposition XML obligatoire du fournisseur et placer le nouveau fichier dans la zone de stockage sortante. L’étape finale,Service (livraison de documents), fournit le fichier XML converti au fournisseur de paie.
Notifications
Les notifications personnalisées sont déclenchées par le statut final de l’ événement lié au processus intégration global . Vous pouvez configurer des notifications dans la définition de processus de gestion elle-même (exemple : à l’achèvement ou à erreur de l’étape ).
Cas d’utilisation avec meilleures pratiques et exemples :
- Cas d’utilisation (success) : envoyez un courriel à l’ équipe de la paie pour confirmer que le fichier hebdomadaire de l’interface de la paie a bien été généré et envoyé au fournisseur.
- Cas d’utilisation (erreur) : si une intégration échoue, envoyez une notification à priorité élevée à l’équipe d’administration de l’intégration avec les détails de l’événement et les messages d’erreur afin qu’elle puisse en examiner immédiatement les données.
- Recommandation : utilisez des groupes de sécurité précis fondés sur des rôles (par exemple,Administrateurs d’intégration) comme destinataires plutôt que des utilisateurs individuels. Créez des messages de notification clairs et exploitables qui comportent des renseignements clés, comme le nom de l’ intégration, la durée de son exécution, et un associer vers la console des traitements pour plus de détails.
- Exemple : une notification intégration est configurée pour déclencheur lorsque le statut du processus de gestion est «Échec». Le système envoie un courriel au groupe de sécuritéde soutien de l’intégration. Le corps du courriel est personnalisé de façon à signifier : « L' intégrationCCB - Données démographiques sortantes »a échoué. Veuillez consulter la console des traitements pour obtenir plus de détails. 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 des articles de la base de connaissances dans Community . Pour de meilleurs résultats :
- Recherchez le nom exact du processus à l’aide de guillemets doubles (“ ”). Exemple : "processus de gestion d’intégration"
- 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
- Utilisez le filtreTrier parpour afficher les résultats parpertinenceoupar plus récent.
Sortie | Cause et solution |
|---|---|
Le point de terminaison externe ne réceptionner pas de fichier intégration prévu. | Utilisez les rapports console des traitements et Enregistrements de processus complets pour déterminer ce qui n’a pas fonctionné comme prévu. Voir Résolution des problèmes liés au processus d’intégration dansConcept : processus de gestion d’intégration le |
Le fichier sortant n'a pas été livré au point de terminaison externe. | Cause : le processus de gestion a peut-être échoué avant l'étape de livraison de documents , ou l'étape de livraison elle-même a échoué.
solution: Pour afficher les messages de statut et erreur liés à l'échec :
|
intégration entrante n’a chargé aucune donnée. | Cause : l'étape d'extraction de documents n'a peut-être pas rechercher le fichier, le fichier pourrait ê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' emplacement externe précisé et que le nom du fichier correspond à la configuration. Vérifiez le rapport Événements d’intégration . Pour afficher les messages erreur de processus liés à analyse de fichiers ou à la validation de données, sélectionnez la colonne Créé à partir du déclencheur pour l' événement d'intégration. |
Une étape d'approbation a été mal acheminée ou a été omise. | Cause : la règle de conditions à l’étape d’approbation est peut-être configurée mal, ou les membres du groupe de sécurité précisé peuvent être incorrects.
solution: utilisez le rapport Afficher une définition de processus de gestion pour réviser la logique de la règle de conditions de l’étape. Utilisez le rapport View Security Group pour vérifier l’ adhésion du groupe approbateur affecté. |
L'intégration échoue avec une erreur de sécurité . | Cause : l'utilisateur système pour intégrations (utilisateur système pour intégrations) associé à l' intégration n'a pas d'autorisations pour un domaine de sécurité obligatoire.
solution: Passez en revue le message erreur dans les détails des événements d'intégration pour déterminer les données ou actions protégées. Accédez au rapport Politiques de sécurité de domaine pour un domaine fonctionnel pour rechercher le domaine pertinent et l'ajouter aux groupes de sécurité affectés à l' utilisateur système pour intégrations. |
Toutes les intégrations échouent avec l' erreur: « Il n'y a pas de définition par défaut pour le type de processus de gestion Événement lié au processus d'intégration »... | Cause : la définition de processus de gestion par défaut pour l’événement lié au 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 reposent sur cette définition comme base.
Solution :
|
Les notifications de processus de gestion d'intégration sont configurées, mais ne sont pas livrées par courriel. | Cause : les règles de routage de notification au niveau du locataire ne sont pas définies pour envoyer des notifications liées à l’intégration par courriel.
Solution :
|
Une intégration en chaîne (démarrée à partir d’une étape d’intégration ) échoue, ce qui entraîne la fin du processus de gestion parent. | Cause : il s’agit du comportement conçu et attendu dans Workday. L'échec d'une processus de gestion, y compris à une étape d'intégration , interrompra le processus par défaut afin d'éviter d'autres erreurs.
solution: Ce n'est pas une erreur à « corriger », mais un comportement à gérer.
|
Une étape intégration Studio qui comporte des erreurs n'est pas redirigée, même si elle est configurée avec l'option Mettre à jour une redirection d' . | Cause : actuellement, la fonction Mettre à jour la redirection ne fonctionne que sur les intégrations Studio dont le statut est Échec . Si une intégration Studio se termine avec le statut Terminé avec erreurs , cette dernière ne sera pas considérée comme un échec par la fonctionnalité de mise à jour de la redirection .
solution: Ce n'est pas une erreur à « corriger », mais un comportement à gérer. Assurez-vous que l’ intégration dispose d’un traitement des erreur et de ses propres notifications spécifiques. Voir Configurer la redirection d'étapes de processus de gestionle |