Documentation Index

Fetch the complete documentation index at: https://payhawk.document360.io/llms.txt

Use this file to discover all available pages before exploring further.

Installation de l'extension ABAP Payhawk via abapGit (SAP S/4HANA Private Cloud)

Prev Next

Cet article explique comment installer l'extension ABAP Payhawk dans votre système SAP S/4HANA® Private Cloud.

Comme les environnements Private Cloud autorisent l'accès aux transactions ABAP traditionnelles, l'installation utilise abapGit, le client Git open-source standard pour ABAP, pour extraire le code directement dans votre environnement. Vous disposez ainsi d'une installation propre, traçable et moderne.

Prérequis

Avant de commencer l'installation, assurez-vous d'avoir rempli les conditions suivantes :

  • Accès au système : accès du développeur à votre système de développement S/4HANA Private Cloud (client 000 ou votre client de configuration principal, en fonction de votre stratégie de transport).

  • Installation d'abapGit : l'outil abapGit doit être disponible dans votre système. Il est généralement exécuté par le biais d'un rapport autonome (par exemple, ZABAPGIT_STANDALONE) ou d'un code de transaction personnalisé (par exemple, /nZABAPGIT).

  • Configuration du réseau et de SSL :

    • Pour la méthode en ligne, votre système SAP doit avoir un accès internet sortant au dépôt Git, et les certificats SSL appropriés doivent être téléchargés dans la transaction STRUST.

    • Si votre système est entièrement protégé par un pare-feu, utilisez la méthode hors ligne (téléchargement ZIP).

  • Détails de l'extension :

    • Paquet cible : ZPAYHAWK (ou un sous-paquet selon les instructions de Payhawk).

    • URL du dépôt Git ou fichier ZIP : fourni par le support Payhawk.

    • Jeton d'accès personnel (PAT) : fourni par le service d'assistance de Payhawk (pour la méthode en ligne).

Guide d'installation étape par étape

Étape 1 : Lancer abapGit

  1. Connectez-vous à SAP GUI pour votre système de développement S/4HANA Private Cloud.

  2. Accédez à la transaction SE38, entrez le nom de votre programme abapGit local (habituellement ZABAPGIT_STANDALONE), et appuyez sur Exécuter(F8). Alternativement, si votre équipe de base l'a mappée, exécutez la transaction /nZABAPGIT.

Étape 2 : Établir le référentiel

En fonction de votre infrastructure réseau, choisissez la méthode A (en ligne) ou la méthode B (hors ligne).

Méthode A : Dépôt en ligne (recommandé)

  1. Dans le menu supérieur du tableau de bord abapGit, cliquez sur Nouveau en ligne.

  2. Entrez l'URL du dépôt Git fourni par Payhawk.

  3. Dans le champ Paquet cible, entrez ZPAYHAWK. Si le paquet n'existe pas encore, cliquez sur l'option permettant de créer un nouveau paquet, de l'affecter à une couche de transport valide et de l'enregistrer.

  4. Cliquez sur Créer une réplique en ligne.

Méthode B : dépôt hors ligne (pour les environnements protégés par un pare-feu)

  1. Téléchargez le fichier .zip de l'extension source Payhawk fourni par Payhawk sur votre ordinateur local.

  2. Dans le menu supérieur du tableau de bord abapGit, cliquez sur Nouveau hors ligne.

  3. Indiquez un nom de référentiel (par exemple, Payhawk_Extension) et entrez le paquet cible ZPAYHAWK.

  4. Cliquez sur Créer une réplique hors ligne.

  5. Une fois créée, cliquez sur Importer ZIP dans les options du référentiel et téléchargez le fichier .zip de Payhawk.

Étape 3 : Maintenir l'authentification (uniquement en ligne)

Avec l'option en ligne, abapGit vous demande des informations d'identification lorsqu'il communique avec le référentiel distant Payhawk.

  1. Lorsque le système vous le demande, entrez le nom d'utilisateur Git qui vous a été fourni.

  2. Collez le jeton d'accès personnel à granularité fine dans le champ mot de passe/jeton.

Ce jeton fournit un accès explicite en lecture seule au référentiel d'extension Payhawk. Il doit être traité avec les mesures de protection habituelles des entreprises.

Étape 4 : Examiner et retirer les objets du code

Une fois le lien vers le référentiel créé, abapGit affiche une matrice Diff claire montrant les objets Payhawk entrants (classes, tables, éléments de données, etc.) comparés à votre paquet local vide.

  1. Cliquez sur le bouton Tirer dans la barre d'actions du référentiel.

  2. abapGit désérialise les fichiers Git et instancie les objets ABAP dans le paquet ZPAYHAWK.

  3. Affectez les objets entrants à un ordre de transport lorsque vous y êtes invité, afin qu'ils puissent être migrés ultérieurement dans votre environnement (test, qualité, production).

Étape 5 : Activation de l'objet

Une fois le tirage terminé, les objets doivent être activés dans votre pile NetWeaver.

  1. en général, abapGit déclenche automatiquement une activation de masse. Si des objets restent inactifs, ouvrez ABAP Development Tools (ADT) dans Eclipse, ou effectuez une transaction SE80.

  2. Localisez le paquet ZPAYHAWK.

  3. Cliquez avec le bouton droit de la souris sur le paquet et sélectionnez Activer. Assurez-vous que tous les composants passent de l'état Inactif à l'état Actif.

Étape 6 : Transport vers l'assurance qualité et la production (systèmes non destinés au développement)

Exécutez les étapes 1 à 5 d'abapGit uniquement dans votre système de développement. Les systèmes d'Assurance Qualité (QA) et de Production sont configurés sur Non Modifiable afin d'assurer la stabilité de l'environnement, de sorte que les extractions directes de Git y sont bloquées.

Pour déployer en toute sécurité l'extension Payhawk dans votre environnement, utilisez le système standard SAP Change and Transport System (CTS) :

  1. Libérez le transport : dans votre système de développement, ouvrez l'organisateur de transport (transaction SE09 ou SE10). Localisez l'ordre de transport Workbench créé à l'étape 4, cliquez avec le bouton droit de la souris sur les tâches et libérez-les, puis libérez le conteneur principal de l'ordre de transport.

  2. Importation vers QA : connectez-vous à votre système d'assurance qualité. Utilisez la transaction STMS (ou l'outil de déploiement de votre organisation, tel que SAP ChaRM) pour trouver l'ordre de transport validé dans la file d'attente d'importation, puis déclenchez l'importation.

  3. Importation en production : effectuez vos tests commerciaux et de régression standard dans l'environnement d'assurance qualité. Après approbation, utilisez le STMS pour importer la même demande de transport dans votre système de production.

Ce cycle de vie permet de sécuriser vos environnements critiques, de les isoler des référentiels Internet et de les rendre structurellement identiques à ce qui a été vérifié lors des tests d'assurance qualité.

Dépannage

  • Échec de la prise de contact SSL (STRUST) : le système SAP ne fait pas confiance à l'autorité de certification racine de GitHub/GitLab. Téléchargez le certificat racine à partir de l'URL Git via votre navigateur web et téléchargez-le vers les identités du client SSL (Anonyme) et du client SSL (Standard) dans la transaction STRUST.

  • Conditions préalables manquantes : si certains éléments de base ne s'activent pas, vérifiez que votre version de S/4HANA Private Cloud est conforme à l'architecture de base minimale spécifiée dans votre documentation contractuelle Payhawk.