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

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

SAP Ariba Contracts

Attributs de la gestion des contrats (19) Activités de gestion des contrats (14) Guides d’extraction (2)

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

Ce modèle fournit un guide complet pour recueillir les données nécessaires à l’analyse de votre processus de gestion des contrats. Il présente les attributs essentiels à collecter, les principales activités à suivre et des conseils pratiques pour extraire ces informations de vos systèmes sources. Utilisez cette ressource pour simplifier la préparation de vos données et commencer votre démarche de Process Mining.

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

Vous découvrez les journaux d’événements ? En savoir plus sur la création d’un journal d’événements pour le Process Mining.

Télécharger le modèle

Attributs de la gestion des contrats

Voici les champs de données essentiels recommandés pour votre journal d’événements afin d’analyser en détail votre processus de gestion des contrats.

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 le jalon achevé à un moment donné, par exemple « Contract Drafted » ou « Legal Review Started ». La séquence de ces activités constitue la base de la carte du processus. L’analyse des activités est essentielle pour comprendre le travail réalisé, la fréquence des différentes étapes et leur ordre d’exécution. Elle permet d’identifier les parcours courants, les écarts et les boucles de reprise, comme les activités répétées « Contract Revised ». Pourquoi c’est important Il définit les étapes du processus, ce qui permet de visualiser le flux du processus et d’identifier les goulots d’étranglement ainsi que les reprises. Où les obtenir Généralement dérivé des changements de statut des tâches, des journaux d’audit ou des tables d’événements du module SAP Ariba Contracts. Exemples Revue interne commencéeContrat exécutéModification initié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 marque le début de chaque activité du processus de gestion des contrats. Il est essentiel pour toutes les analyses temporelles, notamment le 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 pour chaque contrat. Cela permet d’analyser la performance du processus dans le temps et d’identifier les goulots d’étranglement liés aux délais, comme les retards au stade de la revue juridique. Pourquoi c’est important Cet attribut est fondamental pour calculer toutes les métriques temporelles, notamment les temps de cycle et les temps d’attente, ainsi que pour ordonner correctement les événements du processus. Où les obtenir Présent dans les journaux d’événements, les pistes d’audit ou les tables d’historique des changements de statut, avec les informations sur les activités dans SAP Ariba Contracts. Exemples 2023-04-15T10:22:05Z2023-05-01T14:00:12Z2023-05-20T09:30:00Z
	Identifiant du contrat ContractId	Identifiant unique de chaque espace de travail de contrat, utilisé comme identifiant principal du dossier.
Description Cet attribut sert d’identifiant principal du dossier et relie toutes les activités et tous les événements sur l’ensemble du cycle de vie du contrat. Il permet de reconstituer le parcours de bout en bout de chaque contrat, de sa création à sa clôture. Dans le Process Mining, chaque événement associé au même identifiant de contrat est considéré comme faisant partie de la même instance de processus. Cette notion est fondamentale pour analyser les variantes de processus, calculer les temps de cycle et identifier les goulots d’étranglement propres à certains contrats ou types de contrats. Pourquoi c’est important Il constitue la clé essentielle pour suivre le parcours complet d’un contrat, réaliser toutes les analyses au niveau du dossier et visualiser le flux du processus. Où les obtenir Il s’agit d’un identifiant central dans SAP Ariba Contracts, généralement présent dans toutes les tables et vues liées aux contrats sous la forme Contract Workspace ID. Exemples CW2023-00123CW-MSA-45892CW2024-FIN-001CW19876
	Heure de fin de l’événement EventEndTime	Horodatage indiquant le moment où une activité a été terminée.
Description Cet attribut enregistre l’heure d’achèvement d’une activité. Alors que StartTime marque le début, EndTime marque la fin, ce qui permet de mesurer précisément la durée des activités qui ne sont pas instantanées. Dans l’analyse, la différence entre EndTime et StartTime correspond au temps de traitement d’une activité. Cette information est essentielle pour analyser les goulots d’étranglement en détail et distinguer le temps consacré à l’exécution d’une tâche du temps d’attente entre les tâches. Elle permet, par exemple, de mesurer précisément la durée de l’activité « Legal Review ». Pourquoi c’est important Il permet de calculer précisément les temps de traitement des activités, ce qui est essentiel pour identifier les goulots d’étranglement et mesurer l’efficacité des ressources. Où les obtenir Consulter la documentation SAP Ariba Contracts. Ces informations peuvent figurer dans les journaux d’audit ou les enregistrements d’achèvement des tâches. Exemples 2023-04-16T11:45:10Z2023-05-03T17:21:09Z2023-05-20T10:05:00Z
	Juriste responsable LegalCounsel	Membre de l’équipe juridique chargé de la revue du contrat.
Description Cet attribut identifie précisément le juriste ou le professionnel du droit chargé des tâches de revue juridique du contrat. Il s’agit souvent d’un rôle plus spécifique que celui de 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 revue juridique ». Il permet de suivre le nombre de contrats attribués à chaque juriste, son temps moyen de revue et le débit global du service juridique. Ces informations facilitent l’équilibrage des charges, l’identification des personnes ou des pratiques les plus performantes et l’optimisation de l’allocation des ressources juridiques. Pourquoi c’est important Il permet d’analyser en détail l’étape de revue juridique, de gérer la charge de travail de l’équipe juridique, d’identifier les goulots d’étranglement et d’améliorer l’efficacité. Où les obtenir Consulter la documentation SAP Ariba Contracts. Ces informations peuvent être enregistrées dans les détails d’attribution des tâches ou sous la forme d’un rôle spécifique dans le circuit d’approbation. Exemples s.jonesm.riverad.chen
	Service Department	Service métier à l’origine du contrat ou qui en est responsable.
Description Cet attribut précise le service de l’organisation, comme les ventes, l’informatique ou les achats, responsable du contrat. Il fournit un contexte métier essentiel pour analyser le processus. La segmentation de l’analyse par service permet d’identifier les comportements, les goulots d’étranglement ou les problèmes de conformité propres à chaque service. Elle peut, par exemple, révéler que le processus d’approbation des contrats est nettement plus lent pour le service commercial que pour les autres services, ce qui justifie une étude ciblée de ses pratiques. Pourquoi c’est important Il permet de segmenter le processus par domaine métier et d’identifier les goulots d’étranglement ainsi que les écarts de performance propres à chaque service. Où les obtenir Généralement présent dans l’en-tête du contrat ou les détails de l’espace de travail dans SAP Ariba Contracts. Il peut être associé au profil utilisateur du responsable du contrat. Exemples VentesTechnologies de l'informationAchatsJuridique
	Type de contrat ContractType	Classification du contrat, par exemple MSA, NDA ou SOW.
Description Cet attribut catégorise les contrats selon leur finalité juridique ou métier. Les types courants comprennent le Master Service Agreement (MSA), le Non-Disclosure Agreement (NDA) et le Statement of Work (SOW). L’analyse du processus par type de contrat est essentielle pour comprendre les variations du processus. 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 très simple et accéléré, tandis qu’un MSA peut nécessiter plusieurs niveaux de revue juridique et financière. Cet attribut constitue un filtre essentiel des Dashboards pour comparer les temps de cycle et les taux de conformité entre les catégories de contrats. Pourquoi c’est important Il permet de segmenter l’analyse et de montrer comment les différents types de contrats influencent le flux, la complexité et la durée du processus. Où les obtenir 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éÉnoncé des travauxContrat de vente
	Utilisateur UserName	Nom ou identifiant de l’utilisateur ayant effectué l’activité.
Description Cet attribut identifie la personne responsable de l’achèvement d’une tâche ou d’une activité donnée dans le cycle de vie du contrat. Il peut s’agir du responsable du contrat, d’un réviseur juridique ou d’un approbateur. L’analyse par utilisateur permet de comprendre la répartition de la charge de travail, la performance individuelle et les besoins de formation ciblée. Par exemple, dans un Dashboard consacré à la charge de travail de la revue juridique, cet attribut permet de connaître le nombre de contrats traités par chaque juriste ainsi que son temps moyen de revue. Pourquoi c’est important Il donne de la visibilité sur la répartition de la charge de travail et la performance des utilisateurs, ce qui facilite la gestion des ressources et l’analyse de l’efficacité. Où les obtenir Présent dans les tables de pistes d’audit ou de journaux d’événements de SAP Ariba Contracts, souvent associé à un champ « Changed By » ou « User ID ». Exemples john.doejane.smithlegal_team_member_1
	Valeur du contrat ContractAmount	Valeur monétaire totale du contrat.
Description Cet attribut représente la valeur financière de l’accord contractuel. Il s’agit d’une métrique importante pour comprendre l’impact métier et le risque associés à chaque contrat. Dans l’analyse, la valeur du contrat peut servir à prioriser les contrats de montant élevé afin d’en assurer un suivi renforcé ou à identifier les tendances du volume d’activité. Le Dashboard « Tendance de la valeur des contrats signés » utilise cet attribut pour agréger la valeur des contrats signés au fil du temps et fournir une vision de la performance de l’entreprise. Il est également utile pour l’analyse des causes racines, afin de déterminer si les contrats de montant élevé suivent un processus différent, éventuellement plus long. Pourquoi c’est important Il quantifie l’impact financier des contrats et permet une analyse fondée sur la valeur, une priorisation ainsi qu’un suivi de la performance de l’entreprise. Où les obtenir Consulter la documentation SAP Ariba Contracts. Il s’agit d’un champ standard de l’espace de travail du contrat, souvent intitulé « Amount » ou « Contract Value ». 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 constitue la base du Dashboard « Statut des obligations et des renouvellements contractuels ». Elle sert à déclencher des alertes concernant les renouvellements ou les expirations à venir et à éviter que les contrats n’arrivent involontairement à échéance. Son analyse aide les organisations à gérer leur portefeuille de contrats de manière proactive, à réduire les risques liés aux accords expirés et à saisir les possibilités de renouvellement. Pourquoi c’est important Elle est essentielle à une gestion proactive du cycle de vie, car elle permet de renouveler les contrats à temps, d’éviter les échéances involontaires et de gérer les obligations. Où les obtenir Il s’agit d’un champ standard de l’espace de travail du contrat, généralement présent 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 associées à cet événement.
Description Cet attribut enregistre la date et l’heure de la dernière extraction des données depuis le système source. Il ne correspond pas au moment où l’événement s’est produit, mais au moment où l’enregistrement a été chargé dans la plateforme de Process Mining. Cette information est essentielle pour la gouvernance des données et pour évaluer la fraîcheur de l’analyse. Elle permet de vérifier que les données consultées sont les plus récentes et joue un rôle important dans la gestion des chargements incrémentiels. Pourquoi c’est important Il permet aux utilisateurs de connaître l’ancienneté des données, un élément essentiel pour réaliser une analyse et un suivi précis et à jour des processus. Où les obtenir 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
	Est une reprise IsRework	Indicateur précisant si une activité correspond à une reprise ou à la répétition d’une étape précédente.
Description Cet attribut booléen prend la valeur true lorsqu’une activité, comme « Contract Revised », se produit plusieurs fois dans le même dossier de contrat. Il permet d’identifier et de quantifier explicitement les boucles de reprise du processus. Cet indicateur est essentiel pour calculer le KPI « Taux de reprise des contrats » et visualiser les reprises sur la carte du processus. En filtrant sur cet attribut, les analystes peuvent rapidement isoler les contrats ayant nécessité de nombreuses révisions, en rechercher les causes racines et mesurer l’impact 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 c’est important Il quantifie les reprises et facilite la mesure des inefficacités du processus, l’analyse de leurs causes racines et le suivi des améliorations dans le temps. Où les obtenir Il s’agit d’un attribut dérivé, calculé lors de la transformation des données en détectant les activités répétées au sein d’un même dossier. Exemples truefalse
	Nom de la contrepartie CounterpartyName	Nom de la partie externe au contrat, comme un fournisseur ou un client.
Description Cet attribut identifie l’autre partie au contrat. Il peut s’agir d’un fournisseur, d’un client ou d’un partenaire. Cette information apporte un contexte commercial important au processus de gestion des contrats. L’analyse par contrepartie peut aider à identifier des tendances liées à certains partenaires. Par exemple, les négociations avec certaines contreparties peuvent systématiquement durer plus longtemps, ce qui indique la nécessité de modèles standardisés ou de conditions négociées à l’avance. Elle peut également servir à évaluer la qualité de la relation et les performances des fournisseurs dans l’ensemble du portefeuille de contrats. Pourquoi c’est important Il permet d’analyser la performance du processus selon la partie externe, d’identifier les difficultés de négociation et de gérer les relations avec les fournisseurs. Où les obtenir Ces informations sont généralement stockées dans la section consacrée aux informations sur le fournisseur ou le client 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, comme l’Amérique du Nord, la région EMEA ou la région APAC, à laquelle le contrat s’applique. Elle est souvent déterminée par la localisation de la contrepartie ou de l’unité opérationnelle responsable du contrat. La segmentation du processus par région permet d’identifier les différences régionales en matière de performance, de conformité et de fonctionnement 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 de revue réglementaire. Cette analyse aide à adapter l’amélioration des processus et l’allocation des ressources aux besoins régionaux. Pourquoi c’est important Il permet une analyse géographique afin d’identifier les variations régionales de la performance des processus, des temps de cycle et de la conformité. Où les obtenir Consulter la documentation SAP Ariba Contracts. Il peut s’agir d’un champ de l’espace de travail du contrat ou d’une valeur dérivée de l’adresse de la contrepartie. Exemples Amérique du NordEMEAAPACAmérique latine
	SLA de revue SlaForReview	Durée cible ou délai à respecter pour terminer une activité de revue.
Description Cet attribut définit le SLA convenu pour certaines tâches de revue, comme la « Internal Review » ou la « Legal Review ». Il représente le délai cible dans lequel la revue doit être terminée. Cet attribut est essentiel pour le Dashboard et le KPI « Respect des SLA des revues internes et juridiques ». En comparant le temps réel consacré à la revue avec cette cible, les organisations peuvent mesurer le respect des niveaux de service internes. Cela permet d’identifier les retards récurrents, de responsabiliser les équipes et d’éviter que la revue ne devienne un goulot d’étranglement majeur. Pourquoi c’est important Il définit la cible de performance des activités de revue, permettant de mesurer le respect des SLA et d’identifier les retards. Où les obtenir 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é de revue a été terminée dans le délai défini par son SLA.
Description Cet attribut classe les activités de revue comme « Met », « Breached » ou « N/A » selon que leur délai d’achèvement respecte le « SLA for Review ». Il est calculé en comparant « ActivityProcessingTime » à la durée cible du SLA. Il fournit une évaluation claire et immédiate de la performance par rapport aux niveaux de service. Il constitue la métrique centrale du KPI et du Dashboard « Respect des SLA des revues internes et juridiques ». Sa visualisation permet aux responsables de connaître rapidement le pourcentage de revues conformes et d’examiner les dépassements afin d’en comprendre les causes. Pourquoi c’est important Il mesure directement la performance par rapport aux objectifs de service, permettant de suivre clairement le respect des SLA et d’identifier rapidement les dépassements. Où les obtenir Il s’agit d’un attribut dérivé, calculé lors de la transformation des données en comparant ActivityProcessingTime à SlaForReview. Exemples RespectéNon respectéN/A
	Statut du contrat ContractStatus	Statut global actuel du contrat dans son cycle de vie.
Description Cet attribut indique l’état général actuel du contrat, par exemple « Draft », « In Review », « Executed », « Expired » ou « Terminated ». Il se distingue de l’activité, qui correspond à un événement ponctuel, tandis que le statut représente un état sur une période donnée. Cet attribut est essentiel pour des Dashboards tels que « Statut des obligations et des renouvellements contractuels », qui fournissent une vue instantanée du portefeuille de contrats. 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 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 fournit une vue générale de l’état actuel d’un contrat, indispensable à la gestion du portefeuille, au suivi des statuts et à l’analyse du cycle de vie. Où les obtenir Il s’agit d’un champ de statut principal de 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	Système de référence dont 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 constitue une bonne pratique en matière de gouvernance et de traçabilité des données. Elle devient particulièrement importante lorsque des données provenant de plusieurs systèmes sont regroupées, car elle clarifie leur provenance et facilite le diagnostic des problèmes de qualité. Pourquoi c’est important Il fournit le contexte essentiel sur l’origine des données, garantit leur traçabilité et permet l’analyse de plusieurs systèmes. Où les obtenir Il s’agit généralement d’une valeur statique ajoutée lors de l’extraction et de la transformation des données afin d’indiquer l’origine du jeu de données. Exemples SAP Ariba Contracts
	Temps de cycle total du contrat TotalContractCycleTime	Temps total écoulé 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 de bout en bout d’un contrat donné. Il est généralement calculé comme la différence entre la première et la dernière activité, souvent « Contract Workspace Created » et « Contract Executed ». Il s’agit d’un indicateur clé de performance principal, le « Temps de cycle contractuel de bout en bout ». Il fournit une mesure globale de l’efficacité du processus de gestion des contrats. Il est utilisé dans les Dashboards pour suivre la performance dans le temps et comparer les temps de cycle selon les types de contrats, les services ou les régions, afin d’identifier les principaux axes d’amélioration. Pourquoi c’est important Il fournit la mesure de référence de la rapidité et de l’efficacité du processus en synthétisant la performance de l’ensemble du cycle de vie du contrat dans une seule métrique. Où les obtenir Il s’agit d’une métrique calculée 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 et les jalons importants à enregistrer dans votre journal d’événements pour découvrir précisément le 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. Le contrat est alors prêt à être signé, sous réserve de l’accord de la contrepartie.
Pourquoi c’est important Il s’agit d’une étape essentielle avant l’exécution. Le délai entre cet événement et l’exécution finale met en évidence les retards éventuels liés à l’obtention des signatures externes ou à la finalisation du document. Où les obtenir Cette valeur est capturée à partir de l’horodatage d’achèvement de la dernière tâche d’approbation du flux de travail Ariba. Le système consigne le moment où l’ensemble du flux d’approbation est terminé avec succès. Collecte Utilisez l’horodatage d’achèvement du groupe de tâches correspondant à l’ensemble du flux d’approbation. Type d’événement explicit
	Contrat activé	Représente le moment où un contrat signé entre en vigueur et où ses obligations deviennent effectives. 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 c’est important Signale le début de la phase de gestion postérieure à la signature. Il déclenche le suivi des obligations et constitue un élément essentiel du KPI « Taux de respect des obligations ». Où les obtenir Cet événement est généralement déduit du changement du champ « Status » de Contract Workspace à « Active ». Ce changement peut intervenir automatiquement après la signature ou être effectué manuellement. Collecte Enregistrer l’horodatage du changement du champ « Status » du contrat à « Active ». Type d’événement inferred
	Contrat clôturé	Il s’agit d’une activité terminale au cours de laquelle le contrat est officiellement clôturé dans le système. Cette clôture peut intervenir après l’expiration, la résiliation ou l’exécution complète de toutes les obligations.
Pourquoi c’est important Marque la fin définitive du cycle de vie du contrat. Il s’agit d’un événement de fin important pour mesurer la durée totale du cycle de vie et vérifier que les procédures de clôture sont correctement suivies. Où les obtenir Cet événement est déduit du changement du champ « Status » de Contract Workspace à « Closed », « Terminated » ou « Expired ». Le changement de statut peut être automatique ou manuel. Collecte Enregistrer l’horodatage du changement du champ « Status » du contrat vers un état terminal. Type d’événement inferred
	Contrat exécuté	Exécution officielle du contrat, une fois toutes les signatures requises obtenues. Le contrat passe alors du statut de document en cours de traitement à celui d’accord juridiquement contraignant.
Pourquoi c’est important Il s’agit du point de réussite principal du processus précédant la signature. Cet événement est fondamental pour calculer le « Délai du cycle contractuel de bout en bout » et le « Délai moyen du cycle d’approbation des contrats ». Où les obtenir Cet événement est capturé à partir du statut d’achèvement final de la tâche de signature dans le flux de travail Ariba, notamment lorsque celui-ci est intégré à un outil de signature électronique. Le statut de Contract Workspace passe également à « Executed ». Collecte Utilisez l’horodatage d’achèvement de la tâche de signature finale ou le changement de statut vers « Executed ». 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 du contrat est créé dans SAP Ariba et sert de référentiel central pour tous les documents, tâches et échanges liés à un contrat donné.
Pourquoi c’est important Il s’agit de l’événement de début principal du processus de bout en bout. L’analyse du délai entre cette activité et l’exécution est essentielle pour mesurer la durée globale du cycle de vie du contrat. Où les obtenir Cet événement est enregistré à partir de la date de création de l’objet de projet Contract Workspace. Il s’agit d’un horodatage fondamental, disponible dans l’en-tête du contrat ou dans les données du projet. Collecte Utilisez l’horodatage de création de l’objet Contract Workspace. Type d’événement explicit
	Revue juridique commencée	Indique que le contrat a été officiellement transmis au service juridique pour revue. Il s’agit souvent d’une tâche distincte et obligatoire dans le flux de travail global d’approbation.
Pourquoi c’est important La revue juridique constitue fréquemment un goulot d’étranglement majeur. La mesure de sa durée est essentielle pour le KPI « Délai moyen du cycle de revue juridique » et pour optimiser l’affectation des ressources juridiques. Où les obtenir Cette valeur est capturée au début d’une tâche spécifique « Legal Review » dans le flux de travail Ariba. Le système consigne l’horodatage auquel la tâche est attribuée ou démarrée. Collecte Identifiez 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. Cette information est généralement capturée par une solution de signature électronique intégrée ou par une mise à jour manuelle après réception du document signé.
Pourquoi c’est important Cette activité confirme l’accord mutuel et constitue la dernière étape avant que le contrat soit considéré comme juridiquement exécuté. Il s’agit d’une étape essentielle pour finaliser l’accord. Où les obtenir Il peut s’agir d’un événement explicite provenant d’un outil de signature électronique tel que DocuSign, qui enregistre le statut « Completed ». L’information peut également être déduite d’un changement manuel de statut vers « Signed by Counterparty ». Collecte Capturez l’événement d’achèvement dans les journaux du fournisseur de signature électronique intégré. Type d’événement explicit
	Contrat rédigé	Cette activité correspond à la création ou à l’importation initiale du document contractuel principal dans l’espace de travail. Elle constitue souvent 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é permet de comprendre le temps nécessaire à la préparation de la première version. Les retards à cette étape peuvent avoir un impact important sur le délai global du cycle. Où les obtenir Cette information peut être déduite de l’horodatage de création de la première version du document d’accord principal dans le dossier de documents du Contract Workspace. Collecte Identifiez l’horodatage de la première version du document importé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 entraîne souvent la création d’un nouvel espace de travail qui prend la suite de l’espace d’origine.
Pourquoi c’est important Cet indicateur contribue à l’analyse de la fidélisation contractuelle et de l’efficacité des renouvellements. Il constitue un résultat essentiel du cycle de vie du contrat et témoigne de la poursuite de la relation commerciale. Où les obtenir Cet événement peut être capturé lorsqu’un nouveau contrat est créé avec un lien de relation, par exemple « renewal of », vers le contrat arrivant à expiration. Il s’agit souvent d’une action explicite effectuée par un utilisateur. Collecte Identifier 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é intervient lorsqu’une nouvelle version du document contractuel principal est créée ou importée. Elle fait généralement suite aux commentaires issus de la revue interne, de la revue juridique ou des négociations avec la contrepartie.
Pourquoi c’est important La fréquence des révisions mesure directement le niveau de reprise. Le suivi de cette activité est essentiel pour calculer le « Taux de reprise des contrats » et identifier les possibilités de standardiser le langage ou les processus. Où les obtenir Cette information est déduite du système de gestion documentaire du Contract Workspace. Chaque enregistrement d’une nouvelle version du document d’accord principal génère un horodatage. Collecte Utilisez les horodatages de création des versions de document supérieures à un. Type d’événement inferred
	Modification initiée	Cette activité marque le début d’une modification formelle d’un contrat actif. Elle consiste généralement à créer une nouvelle version ou un sous-projet lié à l’espace de travail du contrat d’origine.
Pourquoi c’est important La fréquence et le calendrier des modifications renseignent sur la stabilité des contrats et l’évolution des besoins de l’entreprise. Cet indicateur est essentiel pour le Dashboard « Tendances des modifications et résiliations ». Où les obtenir Il s’agit d’une action explicite par laquelle un utilisateur lance un processus « Amendment » sur un contrat existant, ce qui est enregistré par le système. Collecte 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	Cette activité correspond à la phase durant laquelle le contrat est partagé avec la partie externe pour négociation et suivi des modifications. Elle peut être enregistrée au moyen d’un changement manuel de statut dans l’espace de travail.
Pourquoi c’est important Elle offre une visibilité sur les cycles de négociation externes, qui peuvent être imprévisibles. La mesure de cette phase aide à quantifier le « Nombre moyen de cycles de négociation » et à identifier les négociations complexes. Où les obtenir Cette phase est souvent déduite lorsque le statut du workspace est modifié manuellement pour prendre une valeur telle que « Negotiation » ou « With Supplier ». Elle peut également être déduite de l’envoi d’un document à un contact externe. Collecte Suivez les changements du champ de statut du Contract Workspace vers des valeurs indiquant une revue externe. Type d’événement inferred
	Revue interne commencée	Cette activité marque le début du flux de travail interne de revue et d’approbation du projet de contrat. Le document est transmis aux parties prenantes concernées, par exemple aux services financiers ou opérationnels, afin qu’elles formulent leurs observations.
Pourquoi c’est important Elle marque le début d’un éventuel goulot d’étranglement. L’analyse de la durée de cette phase est essentielle pour identifier les retards du processus de revue interne et alimenter le KPI « Respect des SLA de la revue interne ». Où les obtenir Cet événement est généralement enregistré lorsqu’une tâche de revue est créée et attribuée dans le moteur de flux de travail SAP Ariba. Le statut de la tâche passe à « In Progress » ou à un état similaire. Collecte Capturez l’horodatage auquel une tâche de revue est lancée dans le flux de travail d’approbation du contrat. Type d’événement explicit
	Tâche de conformité terminée	Signale l’achèvement d’une tâche planifiée après la signature, comme une revue de conformité ou une vérification des obligations. Ces tâches sont configurées pour garantir 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 vérifier que l’organisation respecte ses engagements contractuels. Où les obtenir Capturé à partir de l’horodatage d’achèvement de tâches de suivi ou de tâches liées aux obligations dans Contract Workspace. Collecte Utiliser l’horodatage d’achèvement des tâches postérieures à la signature configurées dans l’espace de travail. Type d’événement explicit

Recommandé Facultatif

Guides d’extraction

Comment extraire vos données de SAP Ariba Contracts

Étapes

Accéder au reporting analytique : Connectez-vous à votre système SAP Ariba. Accédez à la section de reporting en cliquant sur le menu principal, puis en sélectionnant Analytical Reports ou un chemin similaire tel que Manage > Analytical Reports.
Créer un nouveau rapport : Cliquez sur le bouton Create, puis sélectionnez New Report. Choisissez de créer un rapport contenant 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 recueillir toutes les activités et tous les attributs requis, joignez les faits suivants au fait Contract Workspace (Projects). Utilisez le champ commun Project Id ou Contract Id comme condition de jointure :
- Approval History : pour obtenir le détail des tâches d’approbation, notamment les soumissions, approbations et refus.
- Task : pour obtenir les informations sur toutes les tâches du Workflow, leurs dates de début et de fin ainsi que leurs responsables.
- Document : pour suivre les versions des documents, ce qui est essentiel pour identifier les activités Contract Drafted et Contract Revised.
Définir les champs du rapport (logique de pivot) : L’objectif est de créer une ligne distincte pour chaque activité métier. Comme l’interface SAP Ariba crée généralement une ligne par contrat, vous devez définir manuellement des champs calculés ou exporter un tableau large, puis le transformer ultérieurement. L’approche recommandée consiste à ajouter une colonne pour chaque horodatage d’événement possible, par exemple :
- Workspace Creation Date provenant du fait Contract Workspace (Projects).
- Main Document Create Date provenant du fait Document (filtré sur l’accord principal et la première version).
- Legal Review Start Date provenant du fait Task (filtré sur la tâche de révision juridique concernée).
- Execution Date provenant du fait Contract Workspace (Projects).
- Continuez à ajouter une colonne dédiée à 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 UserName), Department, Amount (pour ContractAmount) et Contract Type.
Appliquer les filtres : Accédez à l’onglet Filters. Définissez un filtre Time Created pour le fait Contract Workspace (Projects) afin de limiter l’extraction à 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 contenant une ligne par contrat et de nombreuses colonnes correspondant à différents événements de date. Exportez ce rapport dans 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 tel que Microsoft Excel Power Query, 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 créée à l’étape 5. Cette opération convertit le format large en format long, celui du journal d’événements requis par ProcessMind.
Formater le journal d’événements : Dans le fichier transformé, vérifiez que les colonnes portent exactement les noms requis : ContractId, ActivityName, EventTime, EventEndTime, UserName, etc. Formatez les colonnes d’horodatage dans un format cohérent tel que YYYY-MM-DD HH:MI:SS. Enregistrez le fichier final au format CSV.
Importer dans ProcessMind : Le fichier CSV obtenu est désormais 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 afin de reconstituer l’historique complet.
Plage de dates : pour l’analyse initiale, définissez un filtre sur le champ Time Created du fait Contract Workspace (Projects) afin de couvrir les 6 à 12 derniers mois. Pour les volumes importants, envisagez d’exporter les données par lots trimestriels ou mensuels plus petits.
Filtres clés : il est essentiel de filtrer sur Project Type afin de n’extraire que les espaces de travail de contrats, et non d’autres types de projets comme les projets de sourcing. Vous pouvez également filtrer sur Service ou Commodity pour cibler l’analyse.
Granularité des données : sélectionnez des champs fournissant les horodatages d’événements précis, comme les dates d’activation des tâches, les dates d’approbation et les dates de création des documents. Évitez de vous limiter à la date de dernière modification, car elle ne fournit pas de contexte sur l’événement précis.
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 tels que Analysis User ou Reporting Administrator.
Considérations relatives aux 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 une expiration du délai. Faites preuve de patience et envisagez d’exécuter le rapport pendant les heures creuses ou par lots plus petits.

a 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 : 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. Cette procédure vous fournira une clé d’application, un identifiant client OAuth et un secret client OAuth. Vérifiez 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. Installez ensuite 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.
Configurer le script Python. Copiez le script Python fourni dans un fichier, par exemple ariba_extraction.py. Ouvrez le fichier et remplacez les valeurs d’exemple dans la section de configuration située en haut. Vous devrez renseigner votre realm Ariba, votre clé API, votre identifiant client OAuth et votre secret client. Vous devrez également définir la période 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 avec vos identifiants afin d’obtenir un jeton d’accès temporaire. Ce jeton est requis pour toutes les requêtes de données suivantes 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 commence par récupérer la liste de tous les espaces de travail de contrats mis à jour pendant la période indiquée. Il gère automatiquement la pagination afin de récupérer tous les enregistrements pertinents.
Récupérer les données détaillées des espaces de travail. Pour chaque espace de travail identifié à l’étape précédente, le script effectue un nouvel appel API détaillé. Cet appel 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, indispensables à la construction du journal d’événements.
Transformer les réponses de l’API en événements. La logique principale du script parcourt la réponse JSON détaillée de chaque contrat. Elle associe intelligemment différents éléments de données, tels que la date de création de l’espace de travail, les changements de statut des tâches, les chargements de versions de documents et les champs de statut du contrat (contractStatus), aux noms d’activités requis pour le journal d’événements.
Structurer et enrichir le journal d’événements. À mesure que les événements sont identifiés, ils sont ajoutés à un DataFrame pandas. Le script renseigne les colonnes requises (ContractId, ActivityName, EventTime) ainsi que les colonnes recommandées (UserName, ContractAmount, ContractType, etc.) en extrayant les valeurs pertinentes des données de l’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 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 auprès du portail développeur SAP Ariba :
- API_KEY : la clé d’application générée pour votre application enregistrée.
- CLIENT_ID : l’identifiant client OAuth, sous la forme d’une chaîne encodée en base64.
- CLIENT_SECRET : le secret client OAuth.
Realm : le nom du realm SAP Ariba propre à votre entreprise, par exemple « mycompany-T ». Il dirige les appels API vers le centre de données approprié.
Filtres de période : Il est indispensable de définir les paramètres UPDATED_DATE_FROM et UPDATED_DATE_TO afin de limiter le périmètre de l’extraction. Pour commencer, il est recommandé de sélectionner les 3 à 6 derniers mois afin de conserver des volumes de données et une durée d’exécution gérables.
Filtres sur les espaces de travail : Le script peut être modifié pour ajouter des filtres dans l’appel API de la fonction fetch_workspaces. Vous pouvez filtrer des champs tels que contractStatus (par exemple, « Active » ou « Executed ») ou projectType afin de cibler certains types de contrats.
Prérequis : L’accès nécessite un abonnement actif à SAP Ariba Contracts avec la fonctionnalité API activée. Vous devez également disposer d’un compte utilisateur ayant les autorisations suffisantes pour enregistrer des applications sur le portail développeur et consulter les données des 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()

Prêt à commencer ?

Utilisez ce modèle pour préparer vos données en toute confiance et commencer à révéler des analyses utiles sur votre processus de gestion des contrats. Simplifiez la collecte de vos données et accélérez votre démarche d’optimisation des processus.

Retour au guide d’amélioration Télécharger le modèle

Gagnez en efficacité dans la gestion des contrats, démarrez votre essai dès maintenant

Réduisez de 30 % la durée du cycle des contrats et optimisez vos processus SAP Ariba.

Démarrer l’essai gratuit

Aucune carte bancaire requise. Configuration rapide.

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

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

Attributs de la gestion des contrats

Activités de gestion des contrats

Guides d’extraction

Exportation des données depuis l’interface de reporting analytique SAP Ariba

Étapes

Configuration

a Exemple de requête sql

Script Python utilisant l’API de gestion des contrats Ariba

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Gagnez en efficacité dans la gestion des contrats, démarrez votre essai dès maintenant

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

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

Attributs de la gestion des contrats

Activités de gestion des contrats

Guides d’extraction

Exportation des données depuis l’interface de reporting analytique SAP Ariba

Étapes

Configuration

a Exemple de requête sql

Script Python utilisant l’API de gestion des contrats Ariba

Étapes

Configuration

a Exemple de requête python

Prêt à commencer ?

Gagnez en efficacité dans la gestion des contrats, démarrez votre essai dès maintenant

Nous attachons de l’importance à votre confidentialité