> 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(19) 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 vous guide dans la collecte des données nécessaires à l’analyse de votre processus de gestion des contrats. Il répertorie les attributs essentiels, les activités à suivre et des conseils pratiques pour extraire ces informations de vos systèmes sources. Utilisez cette ressource pour préparer vos données et commencer votre démarche de Process Mining.

Attributs recommandés
Activités de gestion des contrats à suivre
Conseils pratiques pour l’extraction

Vous découvrez les journaux d’événements ? Découvrez comment créer un journal d’événements pour le Process Mining.

Télécharger le modèle

Attributs de gestion des contrats

Voici les champs de données essentiels à inclure dans votre journal d’événements pour analyser votre processus de gestion des contrats de façon complète.

3 Obligatoire 6 Recommandé 10 Facultatif

	Nom	Description
	Activité ActivityName	Nom de l’étape ou de l’événement précis du processus métier qui s’est produit.
Description Cet attribut décrit la tâche ou l’étape franchie à un moment donné, par exemple « Contrat rédigé » ou « Examen juridique lancé ». La succession de ces activités constitue la base de la cartographie du processus. L’analyse des activités permet de comprendre le travail effectué, la fréquence des différentes étapes et leur ordre. Elle aide à repérer les parcours habituels, les écarts et les boucles de reprise, comme les activités « Contrat révisé » répétées. Pourquoi est-ce important ? Il définit les étapes du processus, ce qui permet de visualiser son déroulement et de repérer les goulots d’étranglement et les reprises. Où trouver ces données Généralement déduit des changements de statut des tâches, des journaux d’audit ou des tables d’événements du module SAP Ariba Contracts. Exemples Examen interne commencéContrat signéModification du contrat lancéeContrat clôturé
	Horodatage de l’événement EventTime	Date et heure précises auxquelles une activité ou un événement s’est produit.
Description Cet horodatage indique le début de chaque activité du processus de gestion des contrats. Il est indispensable à toutes les analyses temporelles, notamment au calcul des temps de cycle, des durées et des temps d’attente entre les étapes. En classant les événements selon cet horodatage, les outils de Process Mining peuvent reconstituer avec précision la séquence des activités de chaque contrat. Cela permet d’analyser les performances du processus au fil du temps et de repérer les goulots d’étranglement liés aux délais, par exemple lors de l’examen juridique. Pourquoi est-ce important ? Cet attribut est indispensable au calcul de toutes les métriques temporelles, comme les temps de cycle et les temps d’attente, ainsi qu’à l’ordonnancement correct des événements du processus. Où trouver ces données Dans SAP Ariba Contracts, il figure avec les informations sur les activités dans les journaux d’événements, les pistes d’audit ou les tables d’historique des changements de statut. Exemples 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	ID de cas ContractId	Identifiant unique de chaque espace de travail de contrat, utilisé comme identifiant principal du cas.
Description Cet attribut sert d’identifiant principal du cas et relie toutes les activités et tous les événements du cycle de vie du contrat. Il permet de reconstituer le parcours complet de chaque contrat, de sa création à sa clôture. En Process Mining, chaque événement associé au même ID de contrat est considéré comme faisant partie de la même instance de processus. C’est indispensable pour analyser les variantes du processus, calculer les temps de cycle et repérer les goulots d’étranglement propres à certains contrats ou types de contrats. Pourquoi est-ce important ? Il s’agit de la clé indispensable pour suivre le parcours complet d’un contrat et réaliser des analyses au niveau du cas ou visualiser le flux du processus. Où trouver ces données Cet identifiant central de SAP Ariba Contracts figure généralement dans toutes les tables et vues liées aux contrats, sous le nom d’ID de l’espace de travail du contrat. Exemples CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	Heure de fin de l’événement EventEndTime	Horodatage indiquant le moment où une activité s’est terminée.
Description Cet attribut enregistre l’heure de fin d’une activité. Alors que StartTime indique son début, EndTime en marque la fin et permet de mesurer avec précision la durée des activités qui ne sont pas instantanées. En analyse, la différence entre EndTime et StartTime correspond à la durée de traitement d’une activité. Cette mesure est indispensable à l’analyse détaillée des goulots d’étranglement : elle permet de distinguer le temps consacré à une tâche du temps d’attente entre deux tâches. Elle permet, par exemple, de mesurer précisément la durée de l’activité « Examen juridique ». Pourquoi est-ce important ? Il permet de calculer précisément les durées de traitement des activités, afin de repérer les goulots d’étranglement et de mesurer l’efficacité des ressources. Où trouver ces données Consultez la documentation de SAP Ariba Contracts. Ces informations peuvent figurer dans les journaux d’audit ou les enregistrements de fin de tâche. Exemples 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	Juriste responsable LegalCounsel	Membre de l’équipe juridique chargé de l’examen du contrat.
Description Cet attribut identifie précisément le juriste ou le professionnel du droit chargé des tâches d’examen juridique du contrat. Ce rôle est souvent plus spécifique que celui de l’utilisateur général qui effectue d’autres activités. Cet attribut est essentiel au Dashboard « Charge de travail et efficacité de l’examen juridique ». Il permet de suivre le nombre de contrats attribués à chaque juriste, leur temps moyen d’examen et le volume global de contrats traités par le service juridique. Ces informations aident à équilibrer la charge de travail, à repérer les personnes ou les pratiques les plus performantes et à mieux répartir les ressources juridiques. Pourquoi est-ce important ? Il permet d’analyser en détail la phase d’examen juridique, de gérer la charge de travail de l’équipe juridique, de repérer les goulots d’étranglement et d’améliorer l’efficacité. Où trouver ces données Consultez la documentation de SAP Ariba Contracts. Ces informations peuvent figurer dans les détails d’attribution des tâches ou correspondre à un rôle précis dans le circuit d’approbation. Exemples s.jonesm.riverad.chen
	Service Department	Service de l’entreprise à l’origine du contrat ou qui en est responsable.
Description Cet attribut indique le service, par exemple les ventes, l’informatique ou les achats, responsable du contrat. Il apporte un contexte métier essentiel à l’analyse du processus. L’analyse par service permet de repérer les comportements, les goulots d’étranglement ou les problèmes de conformité propres à chacun. Elle peut, par exemple, révéler que le processus d’approbation des contrats est nettement plus lent au service commercial que dans les autres services, et inciter à examiner les pratiques concernées. Pourquoi est-ce important ? Il permet de segmenter le processus par domaine d’activité afin de repérer les goulots d’étranglement et les écarts de performance propres à chaque service. Où trouver ces données Ces informations figurent généralement dans l’en-tête du contrat ou les détails de l’espace de travail dans SAP Ariba Contracts. Elles peuvent être associées au profil utilisateur du responsable du contrat. Exemples VentesTechnologies de l’informationAchatsJuridique
	Type de contrat ContractType	Catégorie du contrat, par exemple MSA, NDA ou SOW.
Description Cet attribut classe les contrats selon leur objet juridique ou commercial. Parmi les types courants figurent le contrat-cadre de services (MSA), l’accord de confidentialité (NDA) et le cahier des charges (SOW). L’analyse du processus par type de contrat est indispensable pour comprendre ses variations. Les différents types de contrats suivent souvent des circuits d’approbation, des SLA et des niveaux de complexité distincts. Par exemple, un NDA peut suivre un processus simple et rapide, tandis qu’un MSA peut nécessiter plusieurs niveaux d’examen juridique et financier. Cet attribut est un filtre essentiel des Dashboards pour comparer les temps de cycle et les taux de conformité entre les catégories de contrats. Pourquoi est-ce important ? Il permet de segmenter l’analyse et de voir comment les différents types de contrats influent sur le déroulement, la complexité et la durée du processus. Où trouver ces données Il s’agit d’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 confidentialitéCahier des chargesContrat de vente
	Utilisateur UserName	Nom ou identifiant de l’utilisateur qui a effectué l’activité.
Description Cet attribut identifie la personne chargée d’effectuer une tâche ou une activité précise du cycle de vie du contrat. Il peut s’agir du responsable du contrat, d’un juriste chargé de l’examen ou d’un approbateur. L’analyse par utilisateur permet de comprendre la répartition de la charge de travail et les performances individuelles, et de repérer les besoins de formation ciblée. Par exemple, dans un Dashboard sur la charge de travail des juristes, cet attribut indique le nombre de contrats traités par chaque juriste et leur temps moyen d’examen. Pourquoi est-ce important ? Il donne une visibilité sur la répartition de la charge de travail et les performances des utilisateurs, ce qui facilite la gestion des ressources et l’analyse de l’efficacité. Où trouver ces données Dans SAP Ariba Contracts, ces informations figurent dans les tables de pistes d’audit ou de journaux d’événements, souvent dans un champ « Modifié par » ou « ID utilisateur ». Exemples john.doejane.smithlegal_team_member_1
	Valeur du contrat ContractAmount	Valeur financière totale du contrat.
Description Cet attribut représente la valeur financière du contrat. Il s’agit d’une métrique importante pour comprendre les retombées commerciales et les risques associés à chaque contrat. L’analyse de la valeur des contrats permet de donner la priorité au suivi des contrats les plus importants ou de repérer les tendances du volume d’activité. Le Dashboard « Évolution de la valeur des contrats signés » utilise cet attribut pour agréger la valeur des contrats signés au fil du temps et suivre les performances de l’entreprise. Il est également utile à l’analyse des causes profondes, pour vérifier si les contrats de grande valeur suivent un processus différent, éventuellement plus long. Pourquoi est-ce important ? Il quantifie les retombées financières des contrats et permet d’analyser leur valeur, de définir les priorités et de suivre les performances de l’entreprise. Où trouver ces données Consultez la documentation de SAP Ariba Contracts. Il s’agit d’un champ standard de l’espace de travail du contrat, souvent intitulé « Montant » ou « Valeur du contrat ». Exemples 150000.0025000.501200000.00
	Date d’expiration du contrat ContractExpirationDate	Date à laquelle le contrat doit expirer.
Description Cet attribut contient la date d’expiration officielle du contrat signé. Il s’agit d’une information essentielle pour gérer le cycle de vie du contrat après sa signature. Cette date est à la base du Dashboard « Statut des obligations et des renouvellements des contrats ». Elle sert à déclencher des alertes avant les renouvellements ou les expirations, afin d’éviter que les contrats arrivent involontairement à échéance. L’analyse de ces données aide les organisations à gérer leur portefeuille de contrats de manière proactive, à réduire les risques liés aux contrats expirés et à saisir les occasions de renouvellement. Pourquoi est-ce important ? Il est essentiel à la gestion proactive du cycle de vie : il permet de renouveler les contrats à temps, d’éviter les expirations involontaires et de suivre les obligations. Où trouver ces données Il s’agit d’un champ standard de l’espace de travail du contrat, généralement situé dans l’en-tête ou la section consacrée aux conditions 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	Horodatage indiquant la dernière actualisation ou extraction des données de cet événement.
Description Cet attribut enregistre la date et l’heure de la dernière extraction des données du système source. Il ne correspond pas au moment où l’événement s’est produit, mais au chargement de l’enregistrement dans la plateforme de Process Mining. Cette information est essentielle à la gouvernance des données et permet de connaître leur fraîcheur. Elle aide les utilisateurs à savoir s’ils consultent les données les plus récentes et facilite la gestion des chargements incrémentiels. Pourquoi est-ce important ? Il permet aux utilisateurs de connaître l’ancienneté des données, un élément essentiel pour analyser et suivre les processus avec précision et en temps utile. Où trouver ces données Cet horodatage est généré et ajouté lors de l’ingestion des données dans l’outil de Process Mining. Exemples 2024-05-21T02:00:00Z2024-05-22T02:00:00Z
	Nom de la contrepartie CounterpartyName	Nom de la partie externe au contrat, par exemple un fournisseur ou un client.
Description Cet attribut identifie l’autre partie au contrat, qu’il s’agisse d’un fournisseur, d’un client ou d’un partenaire. Il apporte un contexte commercial important au processus de gestion des contrats. L’analyse par contrepartie peut révéler des tendances propres à certains partenaires. Par exemple, des négociations avec certaines contreparties peuvent durer systématiquement plus longtemps, ce qui peut indiquer qu’il faut standardiser les modèles ou convenir de conditions à l’avance. Cet attribut permet également d’évaluer la qualité des relations et les performances des fournisseurs dans l’ensemble du portefeuille de contrats. Pourquoi est-ce important ? Il permet d’analyser les performances du processus en fonction de la partie externe, afin de repérer les difficultés de négociation et de gérer les relations avec les fournisseurs. Où trouver ces données Ces informations figurent généralement dans la section consacrée aux fournisseurs ou aux clients de l’espace de travail du contrat dans SAP Ariba Contracts. Exemples Acme CorporationGlobal Tech Inc.Innovate Solutions LLC
	Région Region	Région géographique associée au contrat ou à la contrepartie.
Description Cet attribut définit la zone géographique concernée par le contrat, par exemple l’Amérique du Nord, l’EMEA ou l’APAC. Elle est souvent déterminée par l’emplacement de la contrepartie ou de l’unité opérationnelle responsable du contrat. La segmentation du processus par région permet de repérer les écarts régionaux en matière de performance, de conformité et de déroulement du processus. L’analyse peut, par exemple, montrer que les temps de cycle des contrats sont plus longs dans la région APAC en raison de certaines étapes d’examen réglementaire. Ces résultats aident à adapter les améliorations du processus et la répartition des ressources aux besoins régionaux. Pourquoi est-ce important ? Il permet d’analyser les écarts régionaux de performance, de temps de cycle et de conformité. Où trouver ces données Consultez la documentation de SAP Ariba Contracts. Il peut s’agir d’un champ de l’espace de travail du contrat ou d’une valeur déduite de l’adresse de la contrepartie. Exemples Amérique du NordEMEAAPACAmérique latine
	Reprise IsRework	Indique si une activité correspond à la reprise ou à la répétition d’une étape précédente.
Description Cet attribut booléen prend la valeur « vrai » lorsqu’une activité, comme « Contrat révisé », se produit plusieurs fois dans le même cas de contrat. Il permet de repérer et de quantifier explicitement les boucles de reprise dans le processus. Cet indicateur est essentiel au calcul du KPI « Taux de reprise des contrats » et à la visualisation des reprises dans la cartographie du processus. En filtrant les données selon cet attribut, les analystes peuvent rapidement repérer les contrats qui ont nécessité d’importantes révisions, en rechercher les causes profondes et mesurer l’incidence des reprises sur les temps de cycle globaux. Il met en évidence les inefficacités des phases de rédaction et de négociation. Pourquoi est-ce important ? Il quantifie les reprises et facilite la mesure des inefficacités du processus, l’analyse de leurs causes profondes et le suivi des améliorations au fil du temps. Où trouver ces données Cet attribut est calculé lors de la transformation des données, en repérant les activités répétées dans un même cas. Exemples truefalse
	SLA d’examen SlaForReview	Durée cible ou délai prévu pour terminer une activité d’examen.
Description Cet attribut définit l’accord de niveau de service (SLA) convenu pour certaines tâches d’examen, comme l’« Examen interne » ou l’« Examen juridique ». Il indique le délai prévu pour terminer l’examen. Cet attribut est essentiel au Dashboard et au KPI « Respect des SLA pour les examens internes et juridiques ». En comparant le temps réel consacré à l’examen à la durée cible, les organisations peuvent mesurer le respect des niveaux de service internes. Cette analyse aide à repérer les retards récurrents, à responsabiliser les équipes et à éviter que l’examen ne devienne un goulot d’étranglement majeur. Pourquoi est-ce important ? Il définit l’objectif de performance des activités d’examen, ce qui permet de mesurer le respect des SLA et de repérer les retards. Où trouver ces données Consultez la documentation de SAP Ariba Contracts. Ce paramètre peut être défini dans les règles ou les modèles du flux de travail d’approbation. Exemples P3DP5DP10D
	Statut de respect du SLA SlaAdherenceStatus	Indique si une activité d’examen a été terminée dans le délai prévu par son SLA.
Description Cet attribut classe les activités d’examen selon les valeurs « Respecté », « Dépassé » ou « Sans objet », en fonction de leur durée par rapport au « SLA d’examen ». Il est calculé en comparant ActivityProcessingTime à la durée cible du SLA. Il fournit une évaluation claire et immédiate des performances au regard des accords de niveau de service. Il constitue la métrique centrale du KPI et du Dashboard « Respect des SLA pour les examens internes et juridiques ». Sa visualisation permet aux responsables de voir rapidement la proportion d’examens conformes et d’examiner les dépassements pour en comprendre les causes. Pourquoi est-ce important ? Il mesure directement les performances par rapport aux objectifs de service, ce qui facilite le suivi du respect des SLA et le repérage rapide des dépassements. Où trouver ces données Cet attribut est calculé lors de la transformation des données, en comparant ActivityProcessingTime à SlaForReview. Exemples RespectéEn retardS. O.
	Statut du contrat ContractStatus	Statut général actuel du contrat au cours de son cycle de vie.
Description Cet attribut indique l’état général actuel du contrat, par exemple « Brouillon », « En cours d’examen », « Signé », « Expiré » ou « Résilié ». Contrairement à l’activité, qui correspond à un événement ponctuel, le statut décrit un état qui perdure dans le temps. Cet attribut est essentiel aux Dashboards comme « Statut des obligations et des renouvellements des contrats », qui donnent un aperçu du portefeuille de contrats à un moment donné. Il aide à repérer les contrats bloqués et à gérer les événements du cycle de vie, comme les renouvellements et les expirations. L’analyse des changements de statut peut également révéler des goulots d’étranglement ou des inefficacités dans le processus. Pourquoi est-ce important ? Il donne une vue d’ensemble de l’état actuel d’un contrat, indispensable à la gestion du portefeuille, au suivi des statuts et à l’analyse du cycle de vie. Où trouver ces données Il s’agit du champ de statut principal dans l’en-tête de l’espace de travail du contrat dans SAP Ariba Contracts. Exemples BrouillonEn cours d’approbationSignéExpiré
	Système source SourceSystem	Système de référence d’où proviennent les données.
Description Cet attribut identifie le système source dans lequel les données d’événement ont été générées. Pour ce processus, sa valeur sera toujours « SAP Ariba Contracts ». L’inclusion de cet attribut est une bonne pratique en matière de gouvernance et de traçabilité des données. Elle est particulièrement importante lorsque des données provenant de plusieurs systèmes sont regroupées : elle clarifie leur provenance et facilite la résolution des problèmes de qualité des données. Pourquoi est-ce important ? Il précise l’origine des données, garantit leur traçabilité et permet les analyses portant sur plusieurs systèmes. Où trouver ces données Il s’agit généralement d’une valeur fixe ajoutée lors de l’extraction et de la transformation des données pour indiquer l’origine du jeu de données. Exemples SAP Ariba Contracts
	Temps de cycle total des contrats TotalContractCycleTime	Durée totale entre la création de l’espace de travail du contrat et sa signature définitive.
Description Cet attribut calculé mesure la durée complète d’un contrat, de bout en bout. Il correspond généralement à l’écart entre la première et la dernière activité, souvent « Espace de travail du contrat créé » et « Contrat signé ». Il s’agit d’un indicateur clé de performance, le « temps de cycle des contrats de bout en bout ». Il donne une mesure globale de l’efficacité du processus de gestion des contrats. Les Dashboards permettent de suivre son évolution et de comparer les temps de cycle selon le type de contrat, le service ou la région, afin de repérer les principaux axes d’amélioration. Pourquoi est-ce important ? Cet indicateur mesure la rapidité et l’efficacité du processus en résumant, en une seule métrique, la performance de l’ensemble du cycle de vie du contrat. Où trouver ces données Cette métrique calculée est établie au niveau du dossier dans l’outil de Process Mining ou lors de la transformation des données. Exemples P35DP12DT5HP90D

Obligatoire Recommandé Facultatif

Activités de gestion des contrats

Voici les principales étapes du processus et les jalons à consigner dans votre journal d’événements pour découvrir avec précision le déroulement de la gestion des contrats.

6 Recommandé 8 Facultatif

	Activité	Description
	Approbation interne terminée	Cette activité marque la fin réussie de toutes les tâches d’approbation interne requises pour le contrat. Le contrat est alors prêt à être signé, sous réserve de l’accord de la contrepartie.
Pourquoi est-ce important ? Il s’agit d’une étape importante avant la conclusion du contrat. Le temps écoulé entre cet événement et la conclusion définitive met en évidence les retards éventuels dans l’obtention des signatures externes ou la finalisation du document. Où trouver ces données Cet événement est enregistré à partir de l’horodatage de fin de la dernière tâche d’approbation dans le flux de travail Ariba. Le système consigne la fin de l’ensemble du processus d’approbation. Données à recueillir Utilisez l’horodatage de fin du groupe de tâches correspondant au processus d’approbation global. Type d’événement explicit
	Contrat activé	Indique le moment où un contrat signé entre en vigueur et où ses obligations deviennent applicables. Ce moment est souvent déclenché par un changement de statut après la signature, parfois à une date d’entrée en vigueur définie.
Pourquoi est-ce important ? Marque le début de la phase de gestion après la signature. Cet événement déclenche le suivi des obligations et joue un rôle essentiel dans le KPI « Taux de respect des obligations ». Où trouver ces données Cet événement est généralement déduit du passage du champ « Statut » de l’espace de travail du contrat à « Actif ». Ce changement peut être automatique après la signature ou effectué manuellement. Données à recueillir Suivez l’horodatage du changement du champ « Statut » du contrat vers « Actif ». Type d’événement inferred
	Contrat clôturé	Cette activité marque la clôture officielle du contrat dans le système. Elle peut intervenir après son expiration, sa résiliation ou l’exécution de toutes les obligations.
Pourquoi est-ce important ? Elle marque la fin du cycle de vie du contrat. Cet événement de fin est essentiel pour mesurer la durée totale du cycle et vérifier que les procédures de clôture sont correctement suivies. Où trouver ces données Cet événement est déduit du passage du champ « Statut » de l’espace de travail du contrat à « Clôturé », « Résilié » ou « Expiré ». Le changement de statut peut être automatique ou manuel. Données à recueillir Suivez l’horodatage du passage du champ « Statut » du contrat à un état final. Type d’événement inferred
	Contrat signé	La signature officielle du contrat intervient lorsque toutes les signatures requises ont été recueillies. Le document en cours de traitement devient alors un accord juridiquement contraignant.
Pourquoi est-ce important ? Il s’agit du principal résultat attendu du processus précédant la signature. Cet événement est indispensable au calcul du « temps de cycle de bout en bout des contrats » et du « temps moyen de cycle d’approbation des contrats ». Où trouver ces données Cet événement est enregistré à partir du statut final de la tâche de signature dans le flux de travail Ariba, en particulier lorsque celui-ci est intégré à un outil de signature électronique. Le statut de l’espace de travail du contrat passe également à « Signé ». Données à recueillir Utilisez l’horodatage de fin de la dernière tâche de signature ou le changement de statut vers « Signé ». Type d’événement explicit
	Espace de travail du contrat créé	Cette activité marque le début du processus de gestion des contrats. Un espace de travail est créé dans SAP Ariba pour servir de référentiel central aux documents, tâches et échanges liés à un contrat donné.
Pourquoi est-ce important ? Il s’agit de l’événement de début principal du processus de bout en bout. L’analyse du temps écoulé entre cette activité et la conclusion du contrat est essentielle pour mesurer la durée totale de son cycle de vie. Où trouver ces données Cet événement est enregistré à partir de la date de création de l’objet projet « Espace de travail du contrat ». Il s’agit d’un horodatage fondamental, disponible dans l’en-tête du contrat ou les données du projet. Données à recueillir Utilisez l’horodatage de création de l’objet « Espace de travail du contrat ». Type d’événement explicit
	Examen juridique commencé	Indique que le contrat a été officiellement transmis au service juridique pour examen. Il s’agit souvent d’une tâche distincte et obligatoire dans le flux d’approbation global.
Pourquoi est-ce important ? L’examen juridique constitue souvent un goulot d’étranglement important. Mesurer sa durée est essentiel pour suivre le KPI « Temps de cycle moyen des examens juridiques » et optimiser la répartition des ressources juridiques. Où trouver ces données Cet événement est enregistré au début d’une tâche précise d’examen juridique dans le flux de travail Ariba. Le système consigne l’horodatage lorsque la tâche est attribuée ou lancée. Données à recueillir Repérez l’horodatage de début des tâches attribuées spécifiquement à l’équipe ou au rôle juridique. Type d’événement explicit
	Approbation de la contrepartie reçue	Indique que la partie externe a officiellement accepté les conditions du contrat. Cet événement est généralement enregistré par une solution de signature électronique intégrée ou par une mise à jour manuelle à la réception du document signé.
Pourquoi est-ce important ? Cette activité confirme l’accord des deux parties et constitue la dernière étape avant que le contrat soit considéré comme juridiquement signé. Elle marque une étape importante dans la finalisation de l’accord. Où trouver ces données Il peut s’agir d’un événement explicite provenant d’un outil de signature électronique comme DocuSign, qui enregistre le statut « Terminé ». L’événement peut aussi être déduit d’un changement manuel de statut vers « Signé par la contrepartie ». Données à recueillir Enregistrez l’événement de fin à partir des journaux du fournisseur de signature électronique intégré. Type d’événement explicit
	Contrat renouvelé	Indique qu’un contrat en vigueur a été renouvelé. Ce processus aboutit souvent à la création d’un nouvel espace de travail qui prend la suite de celui du contrat d’origine.
Pourquoi est-ce important ? Cet événement permet d’analyser la fidélisation des contrats et l’efficacité des renouvellements. Il s’agit d’un résultat important du cycle de vie du contrat, qui témoigne de la poursuite de la relation commerciale. Où trouver ces données L’événement peut être enregistré lorsqu’un nouveau contrat est créé avec un lien de relation, par exemple « renouvellement de », vers le contrat arrivant à échéance. Il s’agit souvent d’une action explicite lancée par un utilisateur. Données à recueillir Repérez la création d’un nouveau contrat lié à un contrat existant en tant que renouvellement. Type d’événement explicit
	Contrat révisé	Cette activité a lieu lorsqu’une nouvelle version du document contractuel principal est créée ou importée. Elle fait généralement suite aux commentaires issus d’un examen interne ou juridique, ou aux négociations avec la contrepartie.
Pourquoi est-ce important ? La fréquence des révisions mesure directement les reprises. Le suivi de cette activité est essentiel pour calculer le « Taux de reprise des contrats » et repérer les possibilités d’uniformiser les clauses ou les processus. Où trouver ces données Cet événement est déduit des données du système de gestion documentaire de l’espace de travail du contrat. Chaque enregistrement d’une nouvelle version du document principal génère un horodatage. Données à recueillir Utilisez les horodatages de création des versions de document dont le numéro est supérieur à un. Type d’événement inferred
	Examen interne commencé	Cette activité marque le début du flux de travail d’examen et d’approbation interne du projet de contrat. Le document est transmis aux parties prenantes concernées, par exemple aux équipes financières ou opérationnelles, pour recueillir leurs commentaires.
Pourquoi est-ce important ? Cette étape peut marquer le début d’un goulot d’étranglement. L’analyse de sa durée est essentielle pour repérer les retards dans le processus d’examen interne et suivre le KPI « Respect des SLA pour les examens internes ». Où trouver ces données Cet événement est généralement enregistré lorsqu’une tâche d’examen est créée et attribuée dans le moteur de flux de travail de SAP Ariba. Le statut de la tâche passe alors à « En cours » ou à un état similaire. Données à recueillir Enregistrez l’horodatage du lancement d’une tâche d’examen dans le flux d’approbation du contrat. Type d’événement explicit
	Modification du contrat lancée	Cette activité marque le début d’une modification officielle d’un contrat en vigueur. Elle consiste généralement à créer une nouvelle version ou un sous-projet lié à l’espace de travail du contrat d’origine.
Pourquoi est-ce important ? La fréquence et le calendrier des modifications renseignent sur la stabilité des contrats et l’évolution des besoins de l’entreprise. Ces données sont essentielles au Dashboard « Tendances des modifications et résiliations ». Où trouver ces données Il s’agit d’une action explicite : un utilisateur lance le processus « Modification » pour un contrat existant, et le système enregistre l’événement. Données à recueillir Enregistrez l’événement de création d’un espace de travail ou d’une tâche de modification du contrat. Type d’événement explicit
	Négociation avec la contrepartie	Cette étape correspond à la transmission du contrat à la partie externe pour négociation et révision. Elle peut être enregistrée par un changement manuel de statut dans l’espace de travail.
Pourquoi est-ce important ? Cette activité permet de suivre les cycles de négociation externe, souvent imprévisibles. Mesurer sa durée aide à calculer le « Nombre moyen de cycles de négociation » et à repérer les négociations complexes. Où trouver ces données Cet événement est souvent déduit d’un changement manuel du statut de l’espace de travail, par exemple « Négociation » ou « Avec le fournisseur ». Il peut aussi être déduit de l’envoi d’un document à un contact externe. Données à recueillir Suivez les changements du champ de statut de l’espace de travail du contrat pour repérer les valeurs indiquant un examen externe. Type d’événement inferred
	Projet de contrat rédigé	Cette activité correspond à la création ou à l’importation dans l’espace de travail de la première version du document contractuel principal. Il s’agit souvent de la première action importante liée au contenu, une fois l’espace de travail créé.
Pourquoi est-ce important ? Le suivi de cette activité permet de connaître le temps nécessaire à la préparation de la première version. Un retard à cette étape peut allonger considérablement le temps de cycle global. Où trouver ces données Cet événement peut être déduit de l’horodatage de création de la première version du document principal dans le dossier de documents de l’espace de travail du contrat. Données à recueillir Repérez l’horodatage de la première version du document importée dans l’espace de travail. Type d’événement inferred
	Tâche de conformité terminée	Indique qu’une tâche planifiée après la signature, telle qu’un contrôle de conformité ou une vérification des obligations, est terminée. Ces tâches sont prévues pour assurer le suivi continu de la gouvernance.
Pourquoi est-ce important ? Le suivi de ces tâches est indispensable pour mesurer le « Taux de respect des obligations » et vérifier que l’organisation honore ses engagements contractuels. Où trouver ces données L’événement est enregistré à partir de l’horodatage de fin des tâches de suivi ou des tâches liées aux obligations dans l’espace de travail du contrat. Données à recueillir Utilisez l’horodatage de fin des tâches configurées dans l’espace de travail après la signature. Type d’événement explicit

Recommandé Facultatif

Guides d’extraction

Comment extraire vos données de SAP Ariba Contracts

Étapes

Accédez aux rapports analytiques : Connectez-vous à votre système SAP Ariba. Ouvrez la section des rapports depuis le menu principal, puis sélectionnez Analytical Reports ou suivez un chemin similaire, par exemple Manage > Analytical Reports.
Créez un rapport : Cliquez sur le bouton Créer, puis sélectionnez New Report. Choisissez de créer un rapport avec plusieurs faits.
Sélectionnez le fait principal : Dans le générateur de rapports, sélectionnez Contract Workspace (Projects) comme fait principal. Ce fait contient les informations essentielles sur chaque dossier de contrat.
Associez des faits supplémentaires : Pour recueillir toutes les activités et tous les attributs nécessaires, associez les faits suivants à Contract Workspace (Projects). Utilisez le champ commun Project Id ou Contract Id comme condition d’association :
- Approval History : pour obtenir les détails des tâches d’approbation, notamment les soumissions, les approbations et les refus.
- Task : pour obtenir des informations sur les tâches du flux de travail, leurs dates de début et de fin, ainsi que les personnes affectées.
- Documenter : pour suivre les versions des documents, ce qui est essentiel pour repérer les activités Contract Drafted et Contract Revised.
Définissez les champs du rapport (logique de pivot) : L’objectif est de créer une ligne distincte pour chaque activité métier. Comme l’interface Ariba crée généralement une ligne par contrat, vous devez définir manuellement des champs calculés ou exporter un tableau à colonnes multiples pour le transformer ensuite. Il est recommandé d’ajouter une colonne pour chaque horodatage d’événement potentiel, par exemple :
- Workspace Creation Date depuis le fait Contract Workspace (Projects).
- Main Document Create Date depuis le fait Document (filtré sur l’accord principal et la première version).
- Legal Review Start Date depuis le fait Task (filtré sur la tâche de révision juridique concernée).
- Execution Date depuis le fait Contract Workspace (Projects).
- Continuez en ajoutant une colonne dédiée à l’horodatage de chacune des 14 activités requises.
Sélectionnez les champs d’attributs : Ajoutez au rapport tous les attributs requis et recommandés, par exemple Contract Id, Project Owner (pour UserName), Service, Montant (pour ContractAmount) et Contract Type.
Appliquez des filtres : Ouvrez l’onglet Filters. Définissez un filtre Time Created pour le fait Contract Workspace (Projects) afin de limiter l’extraction à une période raisonnable, par exemple les 6 à 12 derniers mois. Ajoutez tout autre filtre pertinent, comme Project Type, pour ne retenir que les espaces de travail des contrats.
Exécutez le rapport et exportez les données : Exécutez le rapport. Le résultat sera un tableau à colonnes multiples, avec une ligne par contrat et plusieurs colonnes correspondant aux différentes dates d’événement. Exportez ce rapport au format CSV ou Microsoft Excel.
Transformez les données : Le fichier exporté n’est pas un journal d’événements. Vous devez le transformer. Utilisez un outil comme Power Query dans Microsoft Excel, Python ou un outil ETL dédié pour dépivoter les données. Pour chaque ligne du fichier exporté, créez plusieurs lignes dans le nouveau fichier, une pour chaque colonne de date ajoutée à l’étape 5. Vous obtiendrez ainsi le format long du journal d’événements requis par ProcessMind.
Formatez le journal d’événements : Dans le fichier transformé, nommez les colonnes exactement comme indiqué : ContractId, ActivityName, EventTime, EventEndTime, UserName, etc. Utilisez un format uniforme pour les horodatages, par exemple YYYY-MM-DD HH:MI:SS. Enregistrez le fichier final au format CSV.
Importez les données dans ProcessMind : Le fichier CSV obtenu est prêt à être importé dans votre outil de Process Mining.

Configuration

Faits à inclure : Le rapport doit associer plusieurs faits de données. Commencez par Contract Workspace (Projects), puis associez les faits Approval History, Task et Documenter pour obtenir un historique complet.
Période : Pour l’analyse initiale, filtrez le champ Time Created du fait Contract Workspace (Projects) afin de couvrir les 6 à 12 derniers mois. Si les volumes sont importants, envisagez d’exporter les données par lots trimestriels ou mensuels.
Filtres clés : Filtrez impérativement par Project Type pour extraire uniquement les espaces de travail de contrats, et non d’autres types de projets, comme les projets d’approvisionnement. Vous pouvez également filtrer par Service ou Commodity pour cibler l’analyse.
Granularité des données : Sélectionnez des champs qui fournissent l’horodatage d’événements précis, comme les dates d’activation des tâches, d’approbation et de création des documents. Ne vous limitez pas à la date de dernière modification, car elle ne précise pas le contexte de l’événement.
Prérequis : Votre compte utilisateur SAP Ariba doit disposer des autorisations nécessaires pour créer et exécuter des rapports analytiques. Ces autorisations sont souvent attribuées à des rôles comme Analysis User ou Reporting Administrator.
Performances : L’association de plusieurs faits et l’exportation de nombreux champs sur une longue période peuvent ralentir considérablement l’exécution du rapport, voire provoquer un dépassement du délai d’attente. Prévoyez suffisamment de temps et envisagez d’exécuter le rapport en dehors des heures de pointe ou par lots plus petits.

Exemple de requête sql

-- 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 : enregistrez une application dans le portail SAP Ariba Developer Portal. Avant d’extraire des données, vous devez enregistrer une nouvelle application dans SAP Ariba Developer Portal. Vous obtiendrez ainsi une clé d’application, un OAuth Client ID et un OAuth Client Secret. Vérifiez que l’application dispose des autorisations nécessaires pour accéder à l’API Contract Workspaces.
Configurez votre environnement Python. Installez Python 3 sur votre ordinateur, puis les bibliothèques nécessaires aux requêtes API et au traitement des données. Ouvrez un terminal ou une invite de commandes et exécutez : pip install requests pandas.
Configurez le script Python. Copiez le script Python fourni dans un fichier, par exemple ariba_extraction.py. Ouvrez le fichier et remplacez les valeurs fictives de la section de configuration au début. Vous devrez indiquer votre domaine Ariba, votre clé API, votre OAuth Client ID et votre Client Secret. Définissez également la période d’extraction souhaitée.
Comprenez le mécanisme d’authentification. Le script commence par appeler le point de terminaison d’authentification de l’API SAP Ariba avec vos identifiants afin d’obtenir un jeton d’accès temporaire. Ce jeton est nécessaire pour toutes les requêtes de données suivantes et le script l’ajoute automatiquement aux en-têtes des appels API.
Exécutez le script pour récupérer les espaces de travail des contrats. Lancez le script depuis votre terminal : python ariba_extraction.py. Il récupère d’abord la liste des espaces de travail des contrats mis à jour pendant la période indiquée. La pagination est gérée automatiquement pour récupérer tous les enregistrements pertinents.
Récupérez les données détaillées des espaces de travail. Pour chaque espace de travail repéré à l’étape précédente, le script effectue un nouvel appel détaillé à l’API. Il récupère les objets associés, tels que les tâches, les documents, les membres de l’équipe et l’historique des changements de statut de l’espace de travail, nécessaires à la création du journal d’événements.
Transformez les réponses de l’API en événements. Le script parcourt les réponses JSON détaillées de chaque contrat. Il associe les différents éléments de données, comme la date de création de l’espace de travail, les changements de statut des tâches, l’importation des versions de documents et les champs de statut du contrat (contractStatus), aux noms d’activité requis dans le journal d’événements.
Structurez et enrichissez le journal d’événements. À mesure que les événements sont repérés, ils sont ajoutés à un DataFrame pandas. Le script renseigne les colonnes requises (ContractId, ActivityName, EventTime) et les colonnes recommandées (UserName, ContractAmount, ContractType, etc.) à partir des valeurs pertinentes des données de l’API.
Exportez le journal d’événements final. Une fois le traitement de tous les espaces de travail des contrats terminé, le script enregistre le journal d’événements complet dans un fichier CSV nommé ariba_contract_management_event_log.csv, dans le même répertoire. Ce fichier est formaté et prêt à être importé dans ProcessMind.

Configuration

Identifiants API : Vous devez obtenir les éléments suivants dans SAP Ariba Developer Portal :
- API_KEY : la clé d’application générée pour l’application enregistrée.
- CLIENT_ID : l’identifiant client OAuth, sous forme de chaîne encodée en base64.
- CLIENT_SECRET : le secret client OAuth.
Domaine : le nom du domaine SAP Ariba propre à votre entreprise (par exemple, « mycompany-T »). Il permet d’acheminer les appels API vers le bon centre de données.
Filtres de période : Il est essentiel de définir les paramètres UPDATED_DATE_FROM et UPDATED_DATE_TO pour limiter le périmètre de l’extraction. Pour commencer, il est recommandé de sélectionner les 3 à 6 derniers mois afin de conserver un volume de données et une durée d’exécution raisonnables.
Filtres sur les espaces de travail : Vous pouvez modifier l’appel API de la fonction fetch_workspaces pour ajouter des filtres. Vous pouvez notamment filtrer des champs comme contractStatus (par exemple, « Active » ou « Executed ») ou projectType pour cibler certains types de contrats.
Prérequis : L’accès nécessite un abonnement SAP Ariba Contracts actif avec la fonctionnalité API activée. Vous devez également disposer d’un compte utilisateur autorisé à enregistrer des applications sur le portail développeur et à consulter les données des espaces de travail des contrats.

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()

Prêt à commencer ?

Utilisez ce modèle pour préparer vos données en toute confiance et commencer à repérer les possibilités d’amélioration de votre processus de gestion des contrats. Simplifiez la collecte des données et accélérez l’optimisation de vos processus.

Retour au guide d’amélioration

Télécharger le modèle

Améliorez l’efficacité de la gestion des contrats, démarrez votre essai dès maintenant

Réduisez de 30 % le temps de cycle des contrats et optimisez vos processus SAP Ariba.

Démarrez l’essai gratuit

Aucune carte bancaire requise. Configuration rapide.

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

Export de données depuis l’interface de rapports analytiques SAP Ariba

Étapes

Configuration

Exemple de requête sql

Script Python utilisant l’API Ariba Contract Management

Étapes

Configuration

Exemple de requête python

Prêt à commencer ?

Améliorez l’efficacité de la gestion des contrats, démarrez votre essai dès 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

Export de données depuis l’interface de rapports analytiques SAP Ariba

Étapes

Configuration

Exemple de requête sql

Script Python utilisant l’API Ariba Contract Management

Étapes

Configuration

Exemple de requête python

Prêt à commencer ?

Améliorez l’efficacité de la gestion des contrats, démarrez votre essai dès maintenant

Prêt à commencer ?