> Amélioration continue des processus > Gestion des Contrats > SAP Ariba Contracts > Modèle de données

Votre modèle de données pour la gestion des contrats

SAP Ariba Contracts

Attributs de Gestion des Contrats (20) Activités de Gestion des Contrats (14) Guides d'extraction (2)

Votre modèle de données pour la gestion des contrats

Ce modèle fournit un guide complet pour la collecte des données nécessaires à l'analyse de votre processus de gestion des contrats. Il décrit les attributs essentiels à collecter, les activités clés à suivre et des conseils pratiques pour extraire ces informations de vos systèmes sources. Utilisez cette ressource pour rationaliser votre préparation de données et démarrer votre parcours de Process Mining.

Attributs recommandés à collecter
Activités clés de gestion des contrats à suivre
Guide pratique d’extraction

Nouveau dans les journaux d'événements ? Apprenez comment créer un journal d'événements Process Mining.

Télécharger le modèle

Attributs de Gestion des Contrats

Ce sont les champs de données essentiels recommandés pour votre journal d'événements afin d'assurer une analyse complète de votre processus de gestion des contrats.

3 Obligatoire 6 Recommandé 11 Facultatif

	Nom	Description
	Activité ActivityName	Le nom de l'étape ou de l'événement de processus métier spécifique qui s'est produit.
Description Cet attribut décrit la tâche ou le jalon qui a été achevé à un moment précis, comme « Contrat rédigé » ou « Révision juridique débutée ». La séquence de ces activités constitue la base de la carte des processus. L'analyse des activités est cruciale pour comprendre le travail effectué, la fréquence des différentes étapes et leur ordre. Elle permet d'identifier les chemins de processus courants, les déviations et les boucles de retravail, comme les activités répétées de « Contrat révisé ». Pourquoi c'est important Il définit les étapes du processus, permettant la visualisation du flux de processus et l'identification des goulots d'étranglement et des retravails. Où obtenir Généralement dérivé des changements de statut des tâches, des journaux d'audit ou des tables d'événements au sein du module SAP Ariba Contracts. Exemples Revue Interne InitiéeContrat ExécutéModification InitiéeContrat Clôturé
	ID de contrat ContractId	L'identifiant unique pour chaque espace de travail de contrat, servant d'identifiant principal de dossier.
Description Cet attribut sert d'identifiant principal de dossier, reliant toutes les activités et tous les événements tout au long du cycle de vie du contrat. Il permet la reconstitution du parcours de bout en bout pour chaque contrat individuel, de la création à la clôture. En Process Mining, chaque événement avec le même ID de contrat est considéré comme faisant partie de la même instance de processus. C'est fondamental pour analyser les variantes de processus, calculer les temps de cycle et identifier les goulots d'étranglement spécifiques aux contrats individuels ou aux types de contrats. Pourquoi c'est important C'est la clé essentielle pour suivre le parcours complet d'un contrat, permettant toutes les analyses au niveau du dossier et la visualisation des flux de processus. Où obtenir C'est un identifiant essentiel dans SAP Ariba Contracts, généralement trouvé dans toutes les tables et vues liées aux contrats comme l'ID de l'espace de travail du contrat. Exemples CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	Timestamp de l'événement EventTime	La date et l'heure précises auxquelles une activité ou un événement s'est produit.
Description Ce timestamp marque le début de chaque activité dans le processus de gestion des contrats. C'est un composant critique pour toutes les analyses basées sur le temps, y compris le calcul des temps de cycle, des durées et des temps d'attente entre les étapes. En ordonnant les événements en fonction de ce timestamp, les outils de Process Mining peuvent reconstruire avec précision la séquence des activités pour chaque contrat. Cela permet l'analyse des performances du processus au fil du temps et l'identification des goulots d'étranglement liés au temps, tels que les retards dans l'étape de révision juridique. Pourquoi c'est important Cet attribut est fondamental pour le calcul de toutes les métriques basées sur le temps, telles que les temps de cycle et les temps d'attente, et pour l'ordonnancement correct des événements de processus. Où obtenir Trouvé dans les journaux d'événements, les pistes d'audit ou les tables d'historique des changements de statut à côté des informations d'activité dans SAP Ariba Contracts. Exemples 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	Conseiller juridique LegalCounsel	Le membre de l'équipe juridique assigné, responsable de la révision du contrat.
Description Cet attribut identifie spécifiquement l'avocat ou le professionnel juridique assigné aux tâches de révision légale du contrat. C'est souvent un rôle plus spécifique que l'utilisateur général qui effectue d'autres activités. Cet attribut est essentiel pour le dashboard « Charge de travail et efficacité de la révision juridique ». Il permet de suivre le nombre de contrats assignés à chaque conseiller, leur temps de révision moyen et le débit global du service juridique. Cela aide à équilibrer les charges de travail, à identifier les individus ou les pratiques performantes et à optimiser l'allocation des ressources juridiques. Pourquoi c'est important Il permet une analyse détaillée de l'étape de revue juridique, aidant à gérer la charge de travail de l'équipe juridique, à identifier les goulots d'étranglement et à améliorer l'efficacité. Où obtenir Consultez la documentation SAP Ariba Contracts. Cela peut être capturé dans les détails d'affectation de tâche ou en tant que rôle spécifique au sein du flux d'approbation. Exemples s.jonesm.riverad.chen
	Département Department	Le service métier qui a initié ou est propriétaire du contrat.
Description Cet attribut spécifie le service organisationnel, tel que Ventes, IT ou Achats, qui est responsable du contrat. Il fournit un contexte commercial essentiel pour l'analyse du processus. Segmenter l'analyse de processus par département aide à identifier les comportements, les goulots d'étranglement ou les problèmes de conformité spécifiques au département. Par exemple, cela peut révéler si le processus d'approbation des contrats est significativement plus lent pour le service des ventes par rapport aux autres, incitant à une enquête ciblée sur leurs pratiques spécifiques. Pourquoi c'est important Il permet la segmentation des processus par domaine d'activité, aidant à identifier les goulots d'étranglement spécifiques aux départements et les variations de performance. Où obtenir Généralement trouvé dans l'en-tête du contrat ou les détails de l'espace de travail dans SAP Ariba Contracts. Il peut être lié au profil utilisateur du propriétaire du contrat. Exemples VentesTechnologies de l'InformationApprovisionnementJuridique
	Heure de fin de l'événement EventEndTime	L'horodatage indiquant quand une activité a été achevée.
Description Cet attribut capture le temps d'achèvement d'une activité. Alors que StartTime marque le début, EndTime marque la conclusion, permettant de mesurer avec précision la durée des activités qui ne sont pas instantanées. Dans l'analyse, la différence entre EndTime et StartTime fournit le temps de traitement d'une activité. C'est essentiel pour une analyse détaillée des goulots d'étranglement, aidant à distinguer le temps passé à travailler activement sur une tâche du temps d'attente entre les tâches. Par exemple, cela permet une mesure précise de la durée de l'activité « Révision juridique ». Pourquoi c'est important Il permet le calcul précis des temps de traitement des activités, ce qui est crucial pour identifier les goulots d'étranglement et mesurer l'efficacité des ressources. Où obtenir Consultez la documentation SAP Ariba Contracts. Cela peut être disponible dans les journaux d'audit ou les enregistrements de tâches terminées. Exemples 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	Type de contrat ContractType	La classification du contrat, telle que Contrat-cadre de services (MSA), Accord de non-divulgation (NDA) ou Énoncé des travaux (SOW).
Description Cet attribut catégorise les contrats en fonction de leur objectif légal ou commercial. Les types courants incluent Contrat-cadre de services (MSA), Accord de non-divulgation (NDA) ou Énoncé des travaux (SOW). Analyser le processus par type de contrat est essentiel pour comprendre les variations de processus. Différents types de contrats ont souvent des chemins d'approbation, des SLA et des niveaux de complexité différents. Par exemple, un NDA peut avoir un processus très simple et accéléré, tandis qu'un MSA peut nécessiter plusieurs niveaux de révision juridique et financière. Cet attribut est un filtre clé pour les dashboards afin de comparer les temps de cycle et les taux de conformité entre les différentes catégories de contrats. Pourquoi c'est important Il permet la segmentation de l'analyse, révélant comment différents types de contrats impactent le flux de processus, la complexité et la durée. Où obtenir C'est un champ de classification standard disponible dans les détails de l'espace de travail du contrat dans SAP Ariba Contracts. Exemples Contrat-cadre de servicesAccord de non-divulgationÉnoncé des travauxContrat de vente
	Utilisateur UserName	Le nom ou l'`ID` de l'`utilisateur` qui a effectué l'`activité`.
Description Cet attribut identifie l'individu responsable de l'achèvement d'une tâche ou activité spécifique dans le cycle de vie du contrat. Il peut s'agir du propriétaire du contrat, d'un réviseur juridique ou d'un approbateur. L'analyse par utilisateur aide à comprendre la répartition de la charge de travail, la performance individuelle et à identifier les opportunités de formation ciblée. Par exemple, dans un dashboard de charge de travail de révision juridique, cet attribut est utilisé pour voir combien de contrats chaque conseiller juridique gère et leur temps de révision moyen. Pourquoi c'est important Il offre une visibilité sur la répartition de la charge de travail et la performance des utilisateurs, permettant la gestion des ressources et l'analyse de l'efficacité. Où obtenir Trouvé dans les pistes d'audit ou les tables de journaux d'événements dans SAP Ariba Contracts, souvent associé à un champ 'Modifié par' ou 'ID utilisateur'. Exemples john.doejane.smithlegal_team_member_1
	Valeur du Contrat ContractAmount	La valeur monétaire totale du contrat.
Description Cet attribut représente la valeur financière de l'accord contractuel. C'est une métrique clé pour comprendre l'impact commercial et le risque associés à chaque contrat. Dans l'analyse, la valeur du contrat peut être utilisée pour prioriser les contrats de grande valeur pour un suivi plus étroit ou pour identifier les tendances du volume d'affaires. Le dashboard « Tendance de la valeur des contrats exécutés » utilise cet attribut pour agréger la valeur des contrats signés au fil du temps, fournissant un insight sur la performance commerciale. Il est également précieux pour l'analyse des causes profondes afin de voir si les contrats de grande valeur suivent un processus différent, peut-être plus lent. Pourquoi c'est important Il quantifie l'impact financier des contrats, permettant une analyse basée sur la valeur, la priorisation et le suivi de la performance commerciale. Où obtenir Consultez la documentation SAP Ariba Contracts. Il s'agit d'un champ standard dans l'espace de travail du contrat, souvent libellé 'Montant' ou 'Valeur du contrat'. Exemples 150000.0025000.501200000.00
	Date d'Expiration du Contrat ContractExpirationDate	La date à laquelle le contrat doit expirer.
Description Cet attribut stocke la date d'expiration officielle du contrat exécuté. C'est une donnée essentielle pour la gestion du cycle de vie du contrat post-exécution. Cette date est la base du dashboard « Statut des obligations et renouvellements de contrats ». Elle est utilisée pour déclencher des alertes pour les renouvellements ou expirations à venir, garantissant que les contrats ne se terminent pas involontairement. L'analyse de ces données aide les organisations à gérer de manière proactive leur portefeuille de contrats, à atténuer les risques associés aux accords expirés et à capitaliser sur les opportunités de renouvellement. Pourquoi c'est important C'est essentiel pour une gestion proactive du cycle de vie, permettant des renouvellements opportuns, prévenant les ruptures involontaires et gérant les obligations. Où obtenir C'est un champ standard dans l'espace de travail du contrat, généralement trouvé dans l'en-tête ou la section des détails des termes dans SAP Ariba Contracts. Exemples 2025-12-31T23:59:59Z2024-08-15T23:59:59Z2026-06-30T23:59:59Z
	Dernière mise à jour des données LastDataUpdate	Le timestamp indiquant la dernière fois que les données de cet événement ont été rafraîchies ou extraites.
Description Cet attribut enregistre la date et l'heure du dernier extraction de données depuis le système source. Ce n'est pas l'heure à laquelle l'événement s'est produit, mais plutôt celle à laquelle l'enregistrement a été chargé dans la plateforme de Process Mining. Cette information est vitale pour la gouvernance des données et pour comprendre la fraîcheur de l'analyse. Elle aide les utilisateurs à savoir s'ils consultent les données les plus récentes et est essentielle pour gérer les chargements de données incrémentiels. Pourquoi c'est important Il assure que les utilisateurs comprennent la fraîcheur des données, ce qui est essentiel pour une analyse et une surveillance des processus précises et opportunes. Où obtenir Ce timestamp est généré et ajouté pendant le processus d'ingestion des données dans l'outil de Process Mining. Exemples 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	Durée de l'activité ActivityProcessingTime	La durée de temps passée sur une activité, calculée à partir de ses heures de début et de fin.
Description Cet attribut mesure le temps réel passé sur une activité spécifique, calculé comme la différence entre EventEndTime et EventTime. Il représente le temps de travail actif pour une tâche. C'est une métrique fondamentale pour l'analyse des performances. Il est utilisé dans les dashboards d'analyse des goulots d'étranglement pour identifier précisément quelles étapes consomment le plus de temps, comme une longue révision juridique ou une négociation. Il alimente également les KPI tels que « Temps de cycle moyen de révision juridique » et aide à différencier le temps de traitement du temps d'attente, offrant une vue plus précise de l'efficacité des processus. Pourquoi c'est important Il mesure précisément le temps que prend chaque étape du processus, ce qui est crucial pour identifier les goulots d'étranglement et analyser l'efficacité des ressources. Où obtenir Il s'agit d'un attribut calculé, dérivé en soustrayant l'EventTime de l'EventEndTime lors de la transformation des données. Exemples P1DT2H23M5SP3DT1H36MPT45M
	Est un retravail IsRework	Un indicateur signalant si une activité est une reprise ou une répétition d'une étape précédente.
Description Cet attribut booléen est défini sur vrai si une activité, telle que « Contrat révisé », se produit plus d'une fois dans le même dossier de contrat. Il aide à identifier et à quantifier explicitement les boucles de retravail dans le processus. Ce drapeau est crucial pour le calcul du KPI « Taux de retravail des contrats » et pour la visualisation du retravail dans la carte des processus. En filtrant sur cet attribut, les analystes peuvent rapidement isoler les contrats ayant nécessité une révision significative, enquêter sur les causes profondes et mesurer l'impact du retravail sur les temps de cycle globaux. Il met en évidence les inefficacités dans les phases de rédaction et de négociation du processus. Pourquoi c'est important Il quantifie le retravail, facilitant la mesure des inefficacités de processus, l'analyse de leurs causes profondes et le suivi des améliorations au fil du temps. Où obtenir C'est un attribut dérivé, calculé lors de la transformation des données en détectant les activités répétées au sein du même dossier. Exemples truefaux
	Nom de la Contrepartie CounterpartyName	Le nom de la partie externe, telle qu'un fournisseur ou un client, au contrat.
Description Cet attribut identifie l'autre partie impliquée dans le contrat. Il peut s'agir d'un fournisseur, d'un client ou d'un partenaire. Cette information ajoute un contexte commercial crucial au processus de gestion des contrats. L'analyse par contrepartie peut aider à identifier des modèles liés à des partenaires spécifiques. Par exemple, les négociations avec certaines contreparties peuvent prendre systématiquement plus de temps, indiquant un besoin de modèles standardisés ou de termes pré-négociés. Il peut également être utilisé pour évaluer la santé des relations et la performance des fournisseurs à travers le portefeuille de contrats. Pourquoi c'est important Il permet l'analyse des performances des processus en fonction de la partie externe, aidant à identifier les difficultés de négociation et à gérer les relations avec les fournisseurs. Où obtenir Cette information est généralement stockée dans la section des informations fournisseur ou client de l'espace de travail du contrat dans SAP Ariba Contracts. Exemples Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	Région Region	La région géographique associée au contrat ou à la contrepartie.
Description Cet attribut définit la zone géographique, telle que l'Amérique du Nord, l'EMEA ou l'APAC, à laquelle le contrat s'applique. Cela est souvent déterminé par l'emplacement de la contrepartie ou l'unité commerciale propriétaire du contrat. Segmenter le processus par région permet d'identifier les différences régionales en matière de performance, de conformité et de comportement des processus. Par exemple, l'analyse pourrait montrer que les temps de cycle des contrats dans la région APAC sont plus longs en raison d'étapes de révision réglementaires spécifiques. Cet insight aide à adapter les améliorations de processus et l'allocation des ressources aux besoins régionaux. Pourquoi c'est important Il permet une analyse géographique pour identifier les variations régionales en termes de performance des processus, de temps de cycle et de conformité. Où obtenir Consultez la documentation SAP Ariba Contracts. Il peut s'agir d'un champ de l'espace de travail du contrat ou dérivé de l'adresse de la contrepartie. Exemples Amérique du NordEMEAAPACLATAM
	SLA pour la révision SlaForReview	La durée cible ou la date limite pour l'achèvement d'une activité de révision.
Description Cet attribut définit l'accord de niveau de service (SLA) convenu pour des tâches de révision spécifiques, telles que « Révision interne » ou « Révision juridique ». Il représente le temps cible dans lequel la révision doit être achevée. Cet attribut est essentiel pour le dashboard et le KPI « Respect des SLA de révision interne et juridique ». En comparant le temps réel passé en révision à cette cible, les organisations peuvent mesurer la conformité avec les niveaux de service internes. Cela aide à identifier les retards systémiques, à responsabiliser les équipes et à garantir que le processus de révision ne devienne pas un goulot d'étranglement majeur. Pourquoi c'est important Il fixe l'objectif de performance pour les activités de révision, permettant la mesure de la conformité aux SLA et l'identification des retards. Où obtenir Consultez la documentation SAP Ariba Contracts. Cela pourrait être configuré dans les règles ou les modèles de workflow d'approbation. Exemples P3DP5DP10D
	Statut de `conformité` aux `SLA` SlaAdherenceStatus	Indique si une activité de revue a été complétée dans le respect de son SLA défini.
Description Cet attribut catégorise les activités de révision comme « Atteint », « Violé » ou « N/A » en fonction de leur temps d'achèvement par rapport au « SLA pour la révision ». Il est calculé en comparant l'« ActivityProcessingTime » à la durée cible du SLA. Cela fournit une évaluation claire et immédiate de la performance par rapport aux accords de niveau de service. C'est la métrique principale pour le KPI et le dashboard « Respect des SLA de révision interne et juridique ». En visualisant ce statut, les managers peuvent rapidement voir le pourcentage de révisions conformes et approfondir les violations pour en comprendre les causes. Pourquoi c'est important Il mesure directement les performances par rapport aux objectifs de service, permettant une surveillance claire de la conformité aux SLA et une identification rapide des infractions. Où obtenir C'est un attribut dérivé, calculé lors de la transformation des données en comparant ActivityProcessingTime avec SlaForReview. Exemples AtteintDépasséN/D
	Statut du Contrat ContractStatus	Le statut global actuel du contrat dans son cycle de vie.
Description Cet attribut indique l'état général du contrat, tel que « Brouillon », « En révision », « Exécuté », « Expiré » ou « Résilié ». Il diffère de l'activité, qui est un événement unique, tandis que le statut représente l'état sur une période de temps. Cet attribut est crucial pour les dashboards comme « Statut des obligations et renouvellements de contrats », offrant un aperçu du portefeuille de contrats actuel. Il aide à identifier les contrats bloqués et à gérer les événements du cycle de vie comme les renouvellements et les expirations. L'analyse des transitions entre les statuts peut également révéler des goulots d'étranglement ou des inefficacités dans le processus. Pourquoi c'est important Il offre une vue d'ensemble de l'état actuel d'un contrat, ce qui est essentiel pour la gestion de portefeuille, le suivi de statut et l'analyse du cycle de vie. Où obtenir Ceci est un champ de statut principal sur l'en-tête de l'espace de travail du contrat dans SAP Ariba Contracts. Exemples BrouillonEn cours d'approbationExécutéExpiré
	Système source SourceSystem	Le système d'enregistrement d'où proviennent les données.
Description Cet attribut identifie le système source où les données d'événement ont été générées. Pour ce processus, ce sera constamment « SAP Ariba Contracts ». L'inclusion de cet attribut est une bonne pratique pour la gouvernance des données et la traçabilité. Elle devient particulièrement importante lors de la fusion de données provenant de plusieurs systèmes, garantissant la clarté sur la provenance des données et aidant à résoudre les problèmes de qualité des données. Pourquoi c'est important Il fournit un contexte crucial sur l'origine des données, assurant la traçabilité et permettant une analyse multi-systèmes. Où obtenir Il s'agit généralement d'une valeur statique ajoutée pendant le processus d'extraction et de transformation des données pour étiqueter l'origine du jeu de données. Exemples SAP Ariba Contracts
	Temps de cycle total du contrat TotalContractCycleTime	Le temps total écoulé entre la création de l'espace de travail du contrat et son exécution finale.
Description Cet attribut calculé mesure la durée complète de bout en bout pour un seul contrat. Il est généralement calculé comme la différence de temps entre la première et la dernière activité, souvent « Espace de travail de contrat créé » et « Contrat exécuté ». C'est un indicateur clé de performance principal, « Temps de cycle de contrat de bout en bout ». Il fournit une mesure de haut niveau de l'efficacité globale du processus de gestion des contrats. Il est utilisé dans les dashboards pour suivre les performances au fil du temps et pour comparer les temps de cycle entre différents types de contrats, départements ou régions, aidant à identifier les principaux domaines d'amélioration. Pourquoi c'est important Il offre la mesure ultime de la vitesse et de l'efficacité des processus, résumant la performance de l'ensemble du cycle de vie d'un contrat en une seule métrique. Où obtenir Ceci est une métrique calculée au niveau du dossier au sein de l'outil de Process Mining ou lors de la transformation des données. Exemples P35DP12DT5HP90D

Obligatoire Recommandé Facultatif

Activités de Gestion des Contrats

Ce sont les étapes de processus fondamentales et les jalons critiques à capturer dans votre journal d'événements pour une découverte précise du processus de gestion des contrats.

6 Recommandé 8 Facultatif

	Activité	Description
	Approbation Interne Terminée	Marque l'achèvement réussi de toutes les tâches d'approbation interne requises pour le contrat. Cela signifie que le contrat est prêt pour la signature finale, sous réserve de l'accord de la contrepartie.
Pourquoi c'est important C'est un jalon critique avant l'exécution. Le temps entre cet événement et l'exécution finale met en évidence tout retard dans l'obtention des signatures externes ou la finalisation du document. Où obtenir Capturé à partir de l'horodatage de finalisation de la dernière tâche d'approbation dans le workflow Ariba. Le système enregistre le moment où l'ensemble du flux d'approbation est conclu avec succès. Capture Utilisez le timestamp d'achèvement du groupe de tâches de flux d'approbation global. Type d'événement explicit
	Contrat Activé	Représente le moment où un contrat exécuté devient actif et ses obligations prennent effet. Ceci est souvent déclenché par un changement de statut après l'exécution, parfois à une date d'effet spécifiée.
Pourquoi c'est important Signale le début de la phase de gestion post-exécution. C'est le déclencheur du suivi des obligations et c'est crucial pour le KPI « Taux de respect des obligations ». Où obtenir Cela est généralement déduit du changement du champ « Statut » de l'espace de travail du contrat à « Actif ». Cela peut se produire automatiquement après l'exécution ou être une étape manuelle. Capture Suivre le timestamp lorsque le champ « Statut » du contrat passe à « Actif ». Type d'événement inferred
	Contrat Clôturé	C'est une activité terminale où le contrat est formellement clôturé dans le système. Cela peut se produire après expiration, résiliation ou achèvement réussi de toutes les obligations.
Pourquoi c'est important Marque la fin finale du cycle de vie du contrat. C'est un événement de fin critique pour mesurer la durée complète du cycle de vie et garantir le respect des procédures de clôture. Où obtenir Cela est déduit du changement du champ « Statut » de l'espace de travail du contrat à « Fermé », « Résilié » ou « Expiré ». Il peut s'agir d'un changement de statut automatique ou manuel. Capture Suivre le timestamp lorsque le champ « Statut » du contrat passe à un état terminal. Type d'événement inferred
	Contrat Exécuté	L'exécution formelle du contrat, lorsque toutes les signatures requises ont été obtenues. Cela fait passer le contrat d'un document en cours à un accord juridiquement contraignant.
Pourquoi c'est important C'est le point d'arrivée de succès principal pour le processus de pré-signature. C'est fondamental pour le calcul du « Temps de cycle de contrat de bout en bout » et du « Temps de cycle moyen d'approbation des contrats ». Où obtenir Cet événement est capturé à partir du statut d'achèvement final de la tâche de signature dans le workflow Ariba, en particulier lorsqu'il est intégré à un outil de signature électronique. Le statut de l'espace de travail du contrat passe également à « Exécuté ». Capture Utilisez le timestamp d'achèvement de la tâche de signature finale ou le changement de statut à « Exécuté ». Type d'événement explicit
	Espace de Travail de Contrat Créé	Cette activité marque l'initiation du processus de gestion des contrats. Un espace de travail de contrat est créé dans SAP Ariba, servant de référentiel central pour tous les documents, tâches et communications liés à un contrat spécifique.
Pourquoi c'est important C'est l'événement de début principal pour le processus de bout en bout. L'analyse du temps entre cette activité et l'exécution est cruciale pour mesurer la durée globale du cycle de vie du contrat. Où obtenir Cet événement est capturé à partir de la date de création de l'objet projet Espace de travail de contrat. C'est un timestamp fondamental disponible dans l'en-tête du contrat ou les données du projet. Capture Utilisez le timestamp de création de l'objet Espace de travail de contrat. Type d'événement explicit
	Révision juridique débutée	Indique que le contrat a été formellement soumis au service juridique pour revue. Il s'agit souvent d'une tâche distincte et obligatoire au sein du workflow d'approbation général.
Pourquoi c'est important La révision juridique est fréquemment un goulot d'étranglement majeur. Mesurer sa durée est essentiel pour le KPI « Temps de cycle moyen de révision juridique » et pour optimiser l'allocation des ressources légales. Où obtenir C'est capturé à partir du début d'une tâche spécifique de « Révision juridique » dans le workflow Ariba. Le système enregistre le timestamp lorsque la tâche est assignée ou démarrée. Capture Identifier l'horodatage de début pour les tâches spécifiquement attribuées à l'équipe ou au rôle juridique. Type d'événement explicit
	Approbation de la Contrepartie Reçue	Indique que la partie externe a formellement accepté les termes du contrat. Cela est généralement capturé via une solution de signature électronique intégrée ou une mise à jour manuelle à la réception d'un document signé.
Pourquoi c'est important Cette activité confirme l'accord mutuel et est la dernière étape avant que le contrat ne soit considéré comme légalement exécuté. C'est un jalon clé pour finaliser l'accord. Où obtenir Il peut s'agir d'un événement explicite d'un outil de signature électronique comme DocuSign, qui enregistre un statut « Terminé ». Il peut également être déduit d'un changement de statut manuel à « Signé par la contrepartie ». Capture Capturer l'événement de finalisation depuis les journaux du fournisseur de signature électronique intégré. Type d'événement explicit
	Contrat Rédigé	Représente la création initiale ou le téléchargement du document de contrat principal dans l'espace de travail. Il s'agit souvent de la première action majeure liée au contenu après la configuration de l'espace de travail.
Pourquoi c'est important Le suivi de cette activité aide à comprendre le temps nécessaire à la préparation de l'ébauche initiale. Des retards à ce stade peuvent avoir un impact significatif sur le temps de cycle global. Où obtenir Cela peut être déduit du timestamp de création de la première version du document d'accord principal dans le dossier de documents de l'espace de travail du contrat. Capture Identifier l'horodatage de la première version de document téléchargée dans l'espace de travail. Type d'événement inferred
	Contrat Renouvelé	Indique qu'un contrat actif a été renouvelé avec succès. Ce processus aboutit souvent à la création d'un nouvel espace de travail de contrat qui succède à l'original.
Pourquoi c'est important Aide à analyser l'efficacité de la rétention et du renouvellement des contrats. C'est un résultat clé dans le cycle de vie des contrats, indiquant une relation commerciale continue. Où obtenir Cela peut être capturé lorsqu'un nouveau contrat est créé avec un lien de relation (par exemple, « renouvellement de ») vers le contrat expirant. Il s'agit souvent d'une action explicite initiée par l'utilisateur. Capture Identifier la création d'un nouveau contrat lié comme renouvellement à un contrat existant. Type d'événement explicit
	Contrat Révisé	Cette activité se produit lorsqu'une nouvelle version du document de contrat principal est créée ou téléchargée. Elle a généralement lieu en réponse aux commentaires de la révision interne, de la révision juridique ou des négociations avec la contrepartie.
Pourquoi c'est important La fréquence des révisions est une mesure directe du retravail. Le suivi de cette activité est essentiel pour calculer le « Taux de retravail des contrats » et identifier les opportunités de standardisation du langage ou des processus. Où obtenir Déduit du système de gestion de documents au sein de l'Espace de Travail du Contrat. Chaque fois qu'une nouvelle version du document d'accord principal est enregistrée, un horodatage est créé. Capture Utilisez les timestamps de création pour les versions de document supérieures à un. Type d'événement inferred
	Modification Initiée	Cette activité marque le début d'un amendement formel à un contrat actif. Cela implique généralement la création d'une nouvelle version ou d'un sous-projet lié à l'espace de travail du contrat original.
Pourquoi c'est important La fréquence et le calendrier des amendements fournissent des insights sur la stabilité des contrats et l'évolution des besoins commerciaux. C'est un élément clé pour le dashboard « Tendances d'amendement et de résiliation ». Où obtenir C'est une action explicite où un utilisateur initie un processus d'« Amendement » sur un contrat existant, qui est enregistré par le système. Capture Capturer l'événement de création d'un espace de travail ou d'une tâche de modification de contrat. Type d'événement explicit
	Négociation avec la contrepartie	Représente la phase où le contrat est partagé avec la partie externe pour négociation et révision. Cette activité peut être enregistrée par un changement de statut manuel au sein de l'espace de travail.
Pourquoi c'est important Fournit une visibilité sur les cycles de négociation externes, qui peuvent être imprévisibles. Mesurer cette phase aide à quantifier les « Cycles de négociation moyens » et à identifier les négociations complexes. Où obtenir Ceci est souvent déduit lorsque le statut de l'espace de travail est modifié manuellement à un état comme « Négociation » ou « Avec le fournisseur ». Alternativement, cela pourrait être déduit du moment où un document est envoyé à un contact externe. Capture Suivre les changements dans le champ de statut de l'espace de travail du contrat vers des valeurs indiquant une révision externe. Type d'événement inferred
	Revue Interne Initiée	Cette activité signifie le début du workflow de révision et d'approbation interne pour l'ébauche de contrat. Le document est acheminé vers les parties prenantes pertinentes, telles que les services financiers ou les opérations, pour leurs commentaires.
Pourquoi c'est important Marque le début d'un potentiel goulot d'étranglement. L'analyse de la durée de cette phase est essentielle pour identifier les retards dans le processus de révision interne et soutenir le KPI « Respect des SLA de révision interne ». Où obtenir Cet événement est généralement enregistré lorsqu'une tâche de révision est créée et assignée au sein du moteur de workflow SAP Ariba. Le statut de la tâche passe à « En cours » ou à un état similaire. Capture Capturer l'horodatage lorsqu'une tâche de revue est initiée dans le workflow d'approbation du contrat. Type d'événement explicit
	Tâche de Conformité Terminée	Signifie l'achèvement d'une tâche post-exécution planifiée, telle qu'une révision de conformité ou une vérification d'obligation. Ces tâches sont configurées pour assurer une gouvernance continue.
Pourquoi c'est important Le suivi de l'achèvement de ces tâches est essentiel pour mesurer le « Taux de respect des obligations » et garantir que l'organisation respecte ses engagements contractuels. Où obtenir Capturé à partir de l'horodatage de finalisation de tâches de suivi spécifiques ou de tâches liées aux obligations au sein de l'Espace de travail de contrat. Capture Utilisez le timestamp d'achèvement des tâches post-exécution configurées dans l'espace de travail. Type d'événement explicit

Recommandé Facultatif

Guides d'extraction

Comment obtenir vos données de SAP Ariba Contracts

Étapes

Accéder aux rapports analytiques : Connectez-vous à votre système SAP Ariba. Naviguez vers la section des rapports en cliquant sur le menu principal, puis en sélectionnant Rapports analytiques ou un chemin similaire comme Gérer > Rapports analytiques.
Créer un nouveau rapport : Cliquez sur le bouton Créer et sélectionnez Nouveau rapport. Choisissez de créer un rapport avec plusieurs faits.
Sélectionner le fait principal : Dans le générateur de rapports, sélectionnez Contract Workspace (Projects) comme fait de données principal. Ce fait contient les informations essentielles sur chaque dossier de contrat.
Joindre des faits supplémentaires : Pour capturer toutes les activités et tous les attributs requis, joignez les faits suivants au fait Contract Workspace (Projects). Utilisez le champ commun ID de projet ou ID de contrat pour la condition de jointure :
- Historique d'approbation : Pour obtenir des détails sur les tâches d'approbation, y compris les soumissions, les approbations et les refus.
- Tâche : Pour des informations sur toutes les tâches de workflow, leurs dates de début et de fin, et les personnes assignées.
- Document : Pour suivre les versions de documents, ce qui est crucial pour identifier les activités Contrat rédigé et Contrat révisé.
Définir les champs du rapport (logique de pivotement) : L'objectif est de créer une ligne distincte pour chaque activité commerciale. Comme l'interface utilisateur d'Ariba crée généralement une ligne par contrat, vous devez définir manuellement des champs calculés ou exporter un tableau large et le transformer ultérieurement. L'approche recommandée consiste à ajouter des colonnes pour chaque horodatage d'événement potentiel, par exemple :
- Date de création de l'espace de travail à partir du fait Contract Workspace (Projects).
- Date de création du document principal à partir du fait Document (filtré pour l'accord principal et la première version).
- Date de début de la revue juridique à partir du fait Tâche (filtré pour la tâche de revue juridique spécifique).
- Date d'exécution à partir du fait Contract Workspace (Projects).
- Continuez à ajouter une colonne dédiée pour l'horodatage de chacune des 14 activités requises.
Sélectionner les champs d'attributs : Ajoutez tous les champs d'attributs requis et recommandés au rapport, tels que Contract Id, Project Owner (pour Nom d'utilisateur), Department, Amount (pour ContractAmount), et Contract Type.
Appliquer les filtres : Allez à l'onglet Filtres. Définissez un filtre Time Created pour le fait Contract Workspace (Projects) afin de limiter l'extraction de données à une période gérable, par exemple, les 6 à 12 derniers mois. Ajoutez tout autre filtre pertinent comme Project Type pour inclure uniquement les espaces de travail de contrats.
Exécuter et exporter les données : Exécutez le rapport. Le résultat sera un tableau large avec une ligne par contrat et de nombreuses colonnes pour différents événements de date. Exportez ce rapport vers un fichier CSV ou Microsoft Excel.
Transformer les données : Le fichier exporté n'est pas un journal d'événements. Vous devez le transformer. Utilisez un outil comme Microsoft Excel Power Query, Python ou un outil ETL dédié pour déplier les données. Pour chaque ligne du fichier exporté, créez plusieurs lignes dans le nouveau fichier, une pour chaque colonne de date que vous avez créée à l'étape 5. Ce processus convertit le format large en format de journal d'événements long requis par ProcessMind.
Formater le journal d'événements : Dans le fichier transformé, assurez-vous que les colonnes sont nommées exactement comme requis : ContractId, ActivityName, EventTime, EventEndTime, UserName, etc. Formatez les colonnes d'horodatage dans un format cohérent comme AAAA-MM-JJ HH:MI:SS. Enregistrez le fichier final au format CSV.
Télécharger sur ProcessMind : Le fichier CSV résultant est maintenant prêt à être téléchargé dans votre outil de process mining.

Configuration

Faits à Inclure : Le rapport doit joindre plusieurs faits de données. Commencez par Contract Workspace (Projects) et joignez les faits Approval History, Task et Document pour collecter un historique complet.
Plage de Dates : Pour une analyse initiale, définissez un filtre sur le champ Time Created du fait Contract Workspace (Projects) pour les 6 à 12 derniers mois. Pour de grands volumes, envisagez d'exporter les données par lots plus petits, trimestriels ou mensuels.
Filtres Clés : Il est essentiel de filtrer par Project Type pour vous assurer que vous extrayez uniquement les espaces de travail de contrats et non d'autres types de projets comme les projets d'approvisionnement. Vous pouvez également filtrer par Department ou Commodity pour cibler l'analyse.
Granularité des données : Sélectionnez les champs qui fournissent des horodatages pour des événements spécifiques, tels que les dates d'activation des tâches, les dates d'approbation et les dates de création de documents. Évitez d'utiliser uniquement la date de dernière modification, car elle manque de contexte événementiel spécifique.
Prérequis : Votre compte utilisateur dans SAP Ariba doit disposer des autorisations nécessaires pour créer et exécuter des rapports analytiques. Ceci est souvent attribué à des rôles comme Analysis User ou Reporting Administrator.
Considérations de Performance : Joindre plusieurs faits et exporter de nombreux champs sur une longue période peut entraîner une exécution très lente du rapport ou des délais d'attente. Soyez patient et envisagez d'exécuter le rapport pendant les heures creuses ou par lots plus petits.

a Exemple de requête config

-- This is a logical representation of the report configuration in the SAP Ariba Analytical Reporting UI.
-- The tool does not use a direct query language; you build this logic by selecting facts, fields, and filters.
-- The final step requires transforming the wide export file into this long format.

-- FACT: Contract Workspace (Projects) as c
-- JOIN: Approval History as a ON c."Project Id" = a."Project Id"
-- JOIN: Task as t ON c."Project Id" = t."Project Id"
-- JOIN: Document as d ON c."Project Id" = d."Project Id"

-- Each of the following SELECT blocks represents a set of rows for a specific activity.

SELECT c."Contract Id" AS ContractId, 'Contract Workspace Created' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Drafted' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version = 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Internal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Legal Review Started' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Legal Review%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Revised' AS ActivityName, d."Time Created" AS EventTime, NULL AS EventEndTime, d."Created By" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Document" AS d ON c."Project Id" = d."Project Id" WHERE d."Is Main Agreement" = TRUE AND d.Version > 1
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Negotiation With Counterparty' AS ActivityName, t."Activated Date" AS EventTime, t."Completed Date" AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Negotiation%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Internal Approval Completed' AS ActivityName, a."Time Completed" AS EventTime, NULL AS EventEndTime, a."Approver" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Approval History" AS a ON c."Project Id" = a."Project Id" WHERE a."Approval Task Name" LIKE '%Internal Approval Flow%' AND a.Status = 'Approved' AND a."Is Last Approver" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Counterparty Approval Received' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Counterparty Signature%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Executed' AS ActivityName, c."Executed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Executed Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Activated' AS ActivityName, c."Activated Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Activated Date" IS NOT NULL
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Compliance Task Completed' AS ActivityName, t."Completed Date" AS EventTime, NULL AS EventEndTime, t.Assignee AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c JOIN "Task" AS t ON c."Project Id" = t."Project Id" WHERE t."Task Name" LIKE '%Compliance%'
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Amendment Initiated' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Amendment" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Renewed' AS ActivityName, c."Time Created" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c."Is Renewal" = TRUE
UNION ALL
SELECT c."Contract Id" AS ContractId, 'Contract Closed' AS ActivityName, c."Completed Date" AS EventTime, NULL AS EventEndTime, c."Project Owner" AS UserName, c.Department, c.Amount AS ContractAmount, c."Contract Type Name" AS ContractType, c."Legal Contact" AS LegalCounsel FROM "Contract Workspace (Projects)" AS c WHERE c.Status = 'Completed'

Étapes

Prérequis : Enregistrer une application dans le Portail Développeur SAP Ariba. Avant de pouvoir extraire des données, vous devez enregistrer une nouvelle application dans le Portail Développeur SAP Ariba. Ce processus vous fournira une clé d'application, un ID client OAuth et un secret client OAuth. Assurez-vous que l'application dispose des autorisations nécessaires pour accéder à l'API Contract Workspaces.
Configurer votre environnement Python. Installez Python 3 sur votre machine. Ensuite, installez les bibliothèques requises pour effectuer des requêtes API et gérer les données. Ouvrez un terminal ou une invite de commande et exécutez : pip install requests pandas.
Configurer le script Python. Copiez le script Python fourni dans un fichier, par exemple, ariba_extraction.py. Ouvrez le fichier et mettez à jour les valeurs de l'espace réservé dans la section de configuration en haut. Vous devrez fournir votre Domaine Ariba, votre clé API, votre ID client OAuth et votre secret client. Vous devez également définir la plage de dates souhaitée pour l'extraction.
Comprendre le flux d'authentification. Le script appelle d'abord le point de terminaison d'authentification de l'API SAP Ariba en utilisant vos identifiants pour obtenir un jeton d'accès temporaire. Ce jeton est requis pour toutes les requêtes de données ultérieures et est automatiquement inclus dans les en-têtes des appels API effectués par le script.
Exécuter le script pour récupérer les espaces de travail de contrats. Exécutez le script depuis votre terminal : python ariba_extraction.py. Le script commencera par récupérer une liste de tous les espaces de travail de contrats qui ont été mis à jour dans la plage de dates spécifiée. Il gère la pagination automatiquement pour récupérer tous les enregistrements pertinents.
Récupérer les données détaillées de l'espace de travail. Pour chaque espace de travail de contrat identifié à l'étape précédente, le script effectue un appel API de suivi détaillé. Cet appel récupère les objets associés comme les tâches, les documents, les membres de l'équipe et les changements de statut historiques de l'espace de travail, qui sont essentiels pour construire le journal d'événements.
Transformer les réponses API en événements. La logique centrale du script itère à travers la réponse JSON détaillée pour chaque contrat. Elle mappe intelligemment différents points de données, tels que la date de création de l'espace de travail, les changements de statut des tâches, les téléchargements de versions de documents et les champs de statut de contrat (contractStatus), aux noms d'activité spécifiques requis pour le journal d'événements.
Structurer et enrichir le journal d'événements. Au fur et à mesure que les événements sont identifiés, ils sont ajoutés à un DataFrame pandas. Le script remplit les colonnes requises (ContractId, ActivityName, EventTime) et les colonnes recommandées (UserName, ContractAmount, ContractType, etc.) en extrayant les valeurs pertinentes des données API.
Exporter le journal d'événements final. Une fois tous les espaces de travail de contrats traités, le script enregistre le journal d'événements complet sous forme de fichier CSV nommé ariba_contract_management_event_log.csv dans le même répertoire. Ce fichier est formaté et prêt à être téléchargé dans ProcessMind.

Configuration

Informations d'identification API : Vous devez obtenir les éléments suivants depuis le Portail Développeur SAP Ariba :
- API_KEY : La clé d'application générée pour votre application enregistrée.
- CLIENT_ID : L'ID client OAuth, une chaîne encodée en base64.
- CLIENT_SECRET : Le secret client OAuth.
Domaine (Realm) : Le nom de domaine spécifique de votre entreprise SAP Ariba (par exemple, 'mycompany-T'). Cela dirige les appels API vers le centre de données approprié.
Filtres de Plage de Dates : Il est essentiel de définir les paramètres UPDATED_DATE_FROM et UPDATED_DATE_TO pour limiter la portée de l'extraction. Une plage initiale recommandée est les 3 à 6 derniers mois afin d'assurer des volumes de données gérables et un temps d'exécution du script raisonnable.
Filtres d'Espaces de Travail : Le script peut être modifié pour inclure des filtres supplémentaires dans l'appel API de la fonction fetch_workspaces. Vous pouvez filtrer sur des champs comme contractStatus (par exemple, 'Actif', 'Exécuté') ou projectType pour cibler des types de contrats spécifiques.
Prérequis : L'accès nécessite un abonnement SAP Ariba Contracts actif avec la fonctionnalité API activée. Vous avez également besoin d'un compte utilisateur avec des autorisations suffisantes pour enregistrer des applications sur le portail développeur et consulter les données d'espaces de travail de contrats.

a Exemple de requête python

import requests
import pandas as pd
import base64
from datetime import datetime, timedelta

class=class="hl-string">"hl-comment"># --- CONFIGURATION --- #
class=class="hl-string">"hl-comment"># Replace with your SAP Ariba realm and API credentials
REALM = class="hl-string">'[Your Ariba Realm]'
API_KEY = class="hl-string">'[Your Application Key]'
class=class="hl-string">"hl-comment"># The OAUTH_CLIENT_ID is your Application Key and a hyphen, base64 encoded.
class=class="hl-string">"hl-comment"># Example: class="hl-string">'yourappkey:' -> class="hl-string">'eW91cmFwcGtleTo='
OAUTH_CLIENT_ID = class="hl-string">'[Your Base64 Encoded OAuth Client ID]'
OAUTH_CLIENT_SECRET = class="hl-string">'[Your OAuth Client Secret]'

class=class="hl-string">"hl-comment"># --- FILTERS --- #
class=class="hl-string">"hl-comment"># Set the date range for contracts to extract (based on last modified date)
UPDATED_DATE_TO = datetime.now().strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')
UPDATED_DATE_FROM = (datetime.now() - timedelta(days=180)).strftime(class="hl-string">'%Y-%m-%dT%H:%M:%SZ')

class=class="hl-string">"hl-comment"># API Endpoints
AUTH_URL = fclass="hl-string">'https://api.ariba.com/v2/oauth/token'
BASE_API_URL = fclass="hl-string">'https://{REALM}.api.ariba.com/api/contracts/v1/workspaces'

class=class="hl-string">"hl-comment"># --- AUTHENTICATION --- #
def get_access_token():
    class="hl-string">"""Authenticates with Ariba API to get an access token."""
    auth_header = {class="hl-string">'Authorization': fclass="hl-string">'Basic {OAUTH_CLIENT_ID}'}
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_secret': OAUTH_CLIENT_SECRET
    }
    try:
        response = requests.post(AUTH_URL, headers=auth_header, data=payload)
        response.raise_for_status()
        return response.json().get(class="hl-string">'access_token')
    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"Error getting access token: {e}")
        return None

class=class="hl-string">"hl-comment"># --- DATA FETCHING --- #
def fetch_paginated_data(url, headers, params):
    class="hl-string">"""Fetches data from a paginated Ariba API endpoint."""
    all_records = []
    page = 0
    while True:
        params[class="hl-string">'page'] = page
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        data = response.json()
        all_records.extend(data)
        if len(data) == 0: class=class="hl-string">"hl-comment"># Assuming empty list means last page
            break
        page += 1
    return all_records

class=class="hl-string">"hl-comment"># --- EVENT DERIVATION LOGIC --- #
def derive_events_from_workspace(workspace_details):
    class="hl-string">"""Derives multiple event log rows from a single workspace's detailed data."""
    events = []
    case_id = workspace_details.get(class="hl-string">'contractId')
    if not case_id:
        return []

    class=class="hl-string">"hl-comment"># Helper function to create a standard event dictionary
    def create_event(activity, timestamp, user=class="hl-string">'System'):
        return {
            class="hl-string">'ContractId': case_id,
            class="hl-string">'ActivityName': activity,
            class="hl-string">'EventTime': timestamp,
            class="hl-string">'EventEndTime': None, class=class="hl-string">"hl-comment"># Populate if available
            class="hl-string">'UserName': user,
            class="hl-string">'Department': workspace_details.get(class="hl-string">'custom', {}).get(class="hl-string">'Department', None),
            class="hl-string">'ContractAmount': workspace_details.get(class="hl-string">'amount', {}).get(class="hl-string">'amount', None),
            class="hl-string">'ContractType': workspace_details.get(class="hl-string">'contractType', {}).get(class="hl-string">'name', None),
            class="hl-string">'LegalCounsel': next((member.get(class="hl-string">'name') for member in workspace_details.get(class="hl-string">'team', []) if member.get(class="hl-string">'role') == class="hl-string">'Legal Counsel'), None)
        }

    class=class="hl-string">"hl-comment"># 1. Contract Workspace Created
    if workspace_details.get(class="hl-string">'createDate'):
        events.append(create_event(class="hl-string">'Contract Workspace Created', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 2. Contract Drafted & 5. Contract Revised
    if workspace_details.get(class="hl-string">'documents'):
        main_doc_versions = sorted([v for doc in workspace_details[class="hl-string">'documents'] if doc.get(class="hl-string">'isMainAgreement') for v in doc.get(class="hl-string">'versions', [])], key=lambda x: x[class="hl-string">'createDate'])
        if main_doc_versions:
            events.append(create_event(class="hl-string">'Contract Drafted', main_doc_versions[0][class="hl-string">'createDate'], main_doc_versions[0].get(class="hl-string">'createdBy')))
            for version in main_doc_versions[1:]:
                events.append(create_event(class="hl-string">'Contract Revised', version[class="hl-string">'createDate'], version.get(class="hl-string">'createdBy')))

    class=class="hl-string">"hl-comment"># 3, 4, 7, 11. Task-based activities
    if workspace_details.get(class="hl-string">'tasks'):
        for task in workspace_details[class="hl-string">'tasks']:
            task_name = task.get(class="hl-string">'name', class="hl-string">'').lower()
            if class="hl-string">'internal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Internal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'legal review' in task_name and task.get(class="hl-string">'startDate'):
                events.append(create_event(class="hl-string">'Legal Review Started', task[class="hl-string">'startDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'internal approval' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Internal Approval Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))
            if class="hl-string">'compliance' in task_name and task.get(class="hl-string">'completionDate'):
                events.append(create_event(class="hl-string">'Compliance Task Completed', task[class="hl-string">'completionDate'], task.get(class="hl-string">'owner')))

    class=class="hl-string">"hl-comment"># 6, 8. Status-based manual activities
    class=class="hl-string">"hl-comment"># This requires interpreting status history, which can be complex. Simplified here.
    if workspace_details.get(class="hl-string">'statusHistory'):
        for status_change in workspace_details.get(class="hl-string">'statusHistory'):
            status = status_change.get(class="hl-string">'status', class="hl-string">'').lower()
            if class="hl-string">'negotiation' in status:
                events.append(create_event(class="hl-string">'Negotiation With Counterparty', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))
            if class="hl-string">'counterparty approval' in status:
                events.append(create_event(class="hl-string">'Counterparty Approval Received', status_change[class="hl-string">'date'], status_change.get(class="hl-string">'user')))

    class=class="hl-string">"hl-comment"># 9. Contract Executed
    if workspace_details.get(class="hl-string">'executionDate'):
        events.append(create_event(class="hl-string">'Contract Executed', workspace_details[class="hl-string">'executionDate']))

    class=class="hl-string">"hl-comment"># 10. Contract Activated
    if workspace_details.get(class="hl-string">'effectiveDate'):
        events.append(create_event(class="hl-string">'Contract Activated', workspace_details[class="hl-string">'effectiveDate']))

    class=class="hl-string">"hl-comment"># 12. Amendment Initiated
    if workspace_details.get(class="hl-string">'isAmendment'):
        events.append(create_event(class="hl-string">'Amendment Initiated', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 13. Contract Renewed
    if workspace_details.get(class="hl-string">'renewalOfWorkspaceId'):
         events.append(create_event(class="hl-string">'Contract Renewed', workspace_details[class="hl-string">'createDate']))

    class=class="hl-string">"hl-comment"># 14. Contract Closed
    if workspace_details.get(class="hl-string">'closeDate'):
        events.append(create_event(class="hl-string">'Contract Closed', workspace_details[class="hl-string">'closeDate']))

    return events

class=class="hl-string">"hl-comment"># --- MAIN EXECUTION --- #
def main():
    class="hl-string">"""Main function to orchestrate the extraction process."""
    print(class="hl-string">"Attempting to get access token...")
    access_token = get_access_token()
    if not access_token:
        print(class="hl-string">"Failed to get access token. Exiting.")
        return

    print(class="hl-string">"Successfully obtained access token.")
    headers = {
        class="hl-string">'Authorization': fclass="hl-string">'Bearer {access_token}',
        class="hl-string">'apiKey': API_KEY
    }

    print(fclass="hl-string">"Fetching contract workspaces updated from {UPDATED_DATE_FROM} to {UPDATED_DATE_TO}...")
    workspace_params = {
        class="hl-string">'filters': fclass="hl-string">'updatedDateFrom={UPDATED_DATE_FROM}&updatedDateTo={UPDATED_DATE_TO}'
    }
    try:
        workspaces = fetch_paginated_data(BASE_API_URL, headers, workspace_params)
        print(fclass="hl-string">"Found {len(workspaces)} workspaces.")

        all_events = []
        for i, ws_summary in enumerate(workspaces):
            ws_id = ws_summary.get(class="hl-string">'contractId')
            print(fclass="hl-string">"Processing workspace {i+1}/{len(workspaces)}: {ws_id}")
            detail_url = fclass="hl-string">"{BASE_API_URL}/{ws_id}"
            class=class="hl-string">"hl-comment"># Add parameters to get full details
            detail_params = {class="hl-string">'include': class="hl-string">'tasks,documents,team,statusHistory'}
            try:
                ws_details_response = requests.get(detail_url, headers=headers, params=detail_params)
                ws_details_response.raise_for_status()
                ws_details = ws_details_response.json()
                
                events = derive_events_from_workspace(ws_details)
                all_events.extend(events)
            except requests.exceptions.RequestException as e:
                print(fclass="hl-string">"Could not fetch details for workspace {ws_id}: {e}")

        if not all_events:
            print(class="hl-string">"No events were generated. Check API responses and derivation logic.")
            return

        class=class="hl-string">"hl-comment"># Convert to DataFrame and save to CSV
        event_log_df = pd.DataFrame(all_events)
        event_log_df[class="hl-string">'EventTime'] = pd.to_datetime(event_log_df[class="hl-string">'EventTime'])
        event_log_df = event_log_df.sort_values(by=[class="hl-string">'ContractId', class="hl-string">'EventTime'])
        
        output_filename = class="hl-string">'ariba_contract_management_event_log.csv'
        event_log_df.to_csv(output_filename, index=False, date_format=class="hl-string">'%Y-%m-%d %H:%M:%S')
        print(fclass="hl-string">"Successfully created event log: {output_filename}")

    except requests.exceptions.RequestException as e:
        print(fclass="hl-string">"An error occurred during API request: {e}")

if __name__ == class="hl-string">'__main__':
    main()

Votre modèle de données pour la gestion des contrats

Votre modèle de données pour la gestion des contrats

Attributs de Gestion des Contrats

Activités de Gestion des Contrats

Guides d'extraction

Exportation de données de l'interface de reporting analytique SAP Ariba

Étapes

Configuration

a Exemple de requête config

Script Python utilisant l'API Ariba Contract Management

Étapes

Configuration

a Exemple de requête python

Prêt(e) à démarrer ?

Débloquez l'efficacité de la gestion des contrats, démarrez votre essai maintenant

Votre modèle de données pour la gestion des contrats

Votre modèle de données pour la gestion des contrats

Attributs de Gestion des Contrats

Activités de Gestion des Contrats

Guides d'extraction

Exportation de données de l'interface de reporting analytique SAP Ariba

Étapes

Configuration

a Exemple de requête config

Script Python utilisant l'API Ariba Contract Management

Étapes

Configuration

a Exemple de requête python

Nous respectons votre vie privée

Prêt(e) à démarrer ?

Débloquez l'efficacité de la gestion des contrats, démarrez votre essai maintenant