abapGit : Versioning Git pour le code ABAP

" 1. Créez un package pour abapGit
" 2. Clonez le dépôt abapGit lui-même avec la version Standalone
" 3. URL du dépôt : https://github.com/abapGit/abapGit.git

CLASS zcl_abapgit_example DEFINITION
  PUBLIC FINAL
  CREATE PUBLIC.

  PUBLIC SECTION.
    INTERFACES if_oo_adt_classrun.

ENDCLASS.

CLASS zcl_abapgit_example IMPLEMENTATION.

  METHOD if_oo_adt_classrun~main.
    " Cet exemple montre les étapes de manière conceptuelle
    " Le travail réel se fait via l'interface abapGit

    out->write( '=== Configuration du dépôt abapGit ===' ).
    out->write( '1. Lancer la transaction ZABAPGIT ou le report' ).
    out->write( '2. "+ Online" pour un nouveau dépôt Git' ).
    out->write( '3. Entrer l''URL du dépôt' ).
    out->write( '4. Sélectionner ou créer un package' ).
    out->write( '5. Sélectionner la branche (généralement "main")' ).
  ENDMETHOD.

ENDCLASS.

1. Ouvrir abapGit
2. Cliquer sur "+ Online"
3. URL du dépôt : https://github.com/SAP-samples/abap-platform-rap-opensap.git
4. Créer un nouveau package : ZRAP_OPENSAP
5. Branche : main
6. Exécuter "Clone"

Workflow dans l'interface abapGit :

1. Ouvrir le dépôt → Cliquer sur "Stage"
2. Revoir les modifications :
   - Vert (+) : Nouveaux objets
   - Jaune (~) : Objets modifiés
   - Rouge (-) : Objets supprimés
3. Sélectionner les objets pour le commit (Stage)
4. Entrer le message de commit
5. Cliquer sur "Commit"

Après le commit :

1. Bouton "Push" dans la vue du dépôt
2. Pour GitHub : Entrer le Personal Access Token
3. Le push est exécuté
4. Les modifications sont visibles dans le dépôt distant

CLASS zcl_abapgit_workflow DEFINITION
  PUBLIC FINAL
  CREATE PUBLIC.

  PUBLIC SECTION.
    INTERFACES if_oo_adt_classrun.

    METHODS process_order
      IMPORTING
        iv_order_id TYPE i
      RETURNING
        VALUE(rv_success) TYPE abap_bool.

ENDCLASS.

CLASS zcl_abapgit_workflow IMPLEMENTATION.

  METHOD if_oo_adt_classrun~main.
    " Exemple : Cette classe est versionnée avec abapGit
    DATA(lv_result) = process_order( 12345 ).

    IF lv_result = abap_true.
      out->write( 'Commande traitée avec succès.' ).
    ELSE.
      out->write( 'Échec du traitement de la commande.' ).
    ENDIF.
  ENDMETHOD.

  METHOD process_order.
    " Logique métier ici
    " Après modifications : Stage → Commit → Push
    rv_success = abap_true.
  ENDMETHOD.

ENDCLASS.

Dans abapGit :

1. Ouvrir le dépôt
2. Dropdown "Branch" → "Create Branch"
3. Entrer le nom de la branche : feature/new-validation
4. Branche de base : main
5. Créer la branche

La nouvelle branche est maintenant active.

1. Ouvrir le dépôt dans abapGit
2. Cliquer sur le dropdown "Branch"
3. Sélectionner la branche souhaitée
4. Confirmer "Switch"

IMPORTANT : Les modifications non sauvegardées seront écrasées !

1. Créer une nouvelle feature branch
   → feature/customer-validation

2. Développer et tester les modifications
   → Implémenter la nouvelle logique de validation

3. Stage, Commit, Push
   → Commit : "feat: Add customer credit validation"

4. Créer une Pull Request sur GitHub/GitLab
   → feature/customer-validation → main

5. Revue de code par les collègues
   → Les reviewers vérifient les modifications

6. Merge après approbation
   → La PR est mergée dans main

7. Pull de la branche main dans SAP
   → Exécuter Pull dans abapGit

1. Le Pull échoue avec un message de conflit
2. Résoudre le conflit en externe :
   - Cloner le dépôt localement (git clone)
   - Effectuer le merge (git merge)
   - Résoudre les conflits dans l'éditeur
   - Commit et Push
3. Dans abapGit : Exécuter à nouveau le Pull

<?xml version="1.0" encoding="utf-8"?>
<asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
 <asx:values>
  <DATA>
   <MASTER_LANGUAGE>D</MASTER_LANGUAGE>
   <STARTING_FOLDER>/src/</STARTING_FOLDER>
   <FOLDER_LOGIC>FULL</FOLDER_LOGIC>
   <IGNORE>
    <item>/.gitignore</item>
    <item>/LICENSE</item>
    <item>/README.md</item>
    <item>/.github/</item>
   </IGNORE>
   <REQUIREMENTS>
    <item>
     <component>SAP_BASIS</component>
     <min_release>756</min_release>
    </item>
   </REQUIREMENTS>
  </DATA>
 </asx:values>
</asx:abap>

PREFIX (Standard pour les structures plates) :
  /src/zcl_myclass.clas.abap
  /src/zif_myinterface.intf.abap

FULL (Recommandé pour les grands projets) :
  /src/zpackage/
    /src/zpackage/zcl_myclass.clas.abap
    /src/zpackage/subpackage/
      /src/zpackage/subpackage/zcl_helper.clas.abap

MIXED (Combinaison) :
  /src/zpackage/
    zcl_myclass.clas.abap
    subpackage/
      zcl_helper.clas.abap

<?xml version="1.0" encoding="utf-8"?>
<asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
 <asx:values>
  <DATA>
   <MASTER_LANGUAGE>D</MASTER_LANGUAGE>
   <STARTING_FOLDER>/src/</STARTING_FOLDER>
   <FOLDER_LOGIC>FULL</FOLDER_LOGIC>
   <IGNORE>
    <item>/.gitignore</item>
    <item>/LICENSE</item>
    <item>/README.md</item>
    <item>/.github/</item>
    <item>/docs/</item>
   </IGNORE>
   <REQUIREMENTS>
    <item>
     <component>SAP_BASIS</component>
     <min_release>756</min_release>
    </item>
   </REQUIREMENTS>
   <ORIGINAL_SYSTEM>NPL</ORIGINAL_SYSTEM>
  </DATA>
 </asx:values>
</asx:abap>

CLASS zcl_string_utils DEFINITION
  PUBLIC FINAL
  CREATE PUBLIC.

  PUBLIC SECTION.
    "! Supprime tous les espaces d'une chaîne
    METHODS remove_spaces
      IMPORTING
        iv_input TYPE string
      RETURNING
        VALUE(rv_output) TYPE string.

    "! Inverse une chaîne
    METHODS reverse_string
      IMPORTING
        iv_input TYPE string
      RETURNING
        VALUE(rv_output) TYPE string.

    "! Vérifie si une chaîne est un palindrome
    METHODS is_palindrome
      IMPORTING
        iv_input TYPE string
      RETURNING
        VALUE(rv_result) TYPE abap_bool.

ENDCLASS.

CLASS zcl_string_utils IMPLEMENTATION.

  METHOD remove_spaces.
    rv_output = iv_input.
    REPLACE ALL OCCURRENCES OF ` ` IN rv_output WITH ``.
  ENDMETHOD.

  METHOD reverse_string.
    rv_output = reverse( iv_input ).
  ENDMETHOD.

  METHOD is_palindrome.
    DATA(lv_cleaned) = to_lower( remove_spaces( iv_input ) ).
    DATA(lv_reversed) = reverse_string( lv_cleaned ).
    rv_result = xsdbool( lv_cleaned = lv_reversed ).
  ENDMETHOD.

ENDCLASS.

my-abap-utils/
├── .abapgit.xml
├── README.md
├── LICENSE
└── src/
    └── zcl_string_utils.clas.abap
    └── zcl_string_utils.clas.xml

{
  "global": {
    "files": "/src/**/*.*"
  },
  "syntax": {
    "version": "v756",
    "errorNamespace": "^(Z|Y)"
  },
  "rules": {
    "avoid_use": {
      "statics": true,
      "default": true
    },
    "line_length": {
      "length": 120
    },
    "method_length": {
      "statements": 50
    }
  }
}

CLASS zcl_customer_validator DEFINITION
  PUBLIC FINAL
  CREATE PUBLIC.

  PUBLIC SECTION.
    TYPES:
      BEGIN OF ty_validation_result,
        valid   TYPE abap_bool,
        message TYPE string,
      END OF ty_validation_result.

    METHODS validate_customer
      IMPORTING
        iv_customer_id TYPE i
      RETURNING
        VALUE(rs_result) TYPE ty_validation_result.

    METHODS validate_credit_limit
      IMPORTING
        iv_customer_id TYPE i
        iv_order_value TYPE p
      RETURNING
        VALUE(rs_result) TYPE ty_validation_result.

ENDCLASS.

CLASS zcl_customer_validator IMPLEMENTATION.

  METHOD validate_customer.
    " Fonctionnalité développée sur la branche : feature/customer-validation
    " Commit : "feat: Add basic customer validation"

    IF iv_customer_id <= 0.
      rs_result = VALUE #(
        valid   = abap_false
        message = 'ID client invalide"
      ).
      RETURN.
    ENDIF.

    " Vérifier le client en base de données
    SELECT SINGLE @abap_true
      FROM scustom
      WHERE id = @iv_customer_id
      INTO @DATA(lv_exists).

    IF lv_exists = abap_true.
      rs_result = VALUE #(
        valid   = abap_true
        message = 'Client valide"
      ).
    ELSE.
      rs_result = VALUE #(
        valid   = abap_false
        message = 'Client non trouvé"
      ).
    ENDIF.
  ENDMETHOD.

  METHOD validate_credit_limit.
    " Fonctionnalité développée sur la branche : feature/credit-validation
    " Commit : "feat: Add credit limit validation"

    " D'abord valider le client
    DATA(ls_customer_valid) = validate_customer( iv_customer_id ).
    IF ls_customer_valid-valid = abap_false.
      rs_result = ls_customer_valid.
      RETURN.
    ENDIF.

    " Vérifier la limite de crédit
    SELECT SINGLE discount
      FROM scustom
      WHERE id = @iv_customer_id
      INTO @DATA(lv_limit).

    DATA(lv_credit_limit) = CONV p( lv_limit * 10000 ).

    IF iv_order_value <= lv_credit_limit.
      rs_result = VALUE #(
        valid   = abap_true
        message = |Commande dans la limite de crédit ({ lv_credit_limit })|
      ).
    ELSE.
      rs_result = VALUE #(
        valid   = abap_false
        message = |Commande dépasse la limite de crédit ({ lv_credit_limit })|
      ).
    ENDIF.
  ENDMETHOD.

ENDCLASS.

* 7a3f2b1 (HEAD -> main) Merge pull request #42: Credit validation
|\
| * 5c2d1e3 (feature/credit-validation) feat: Add credit limit validation
| * 2b1a0c4 feat: Add customer validation helper
|/
* 9f8e7d6 Initial commit

feat: Add customer validation endpoint
fix: Correct date calculation in report
docs: Update README with setup instructions
refactor: Extract common validation logic
test: Add unit tests for order processing

feature/customer-validation    # Nouvelles fonctionnalités
bugfix/date-calculation       # Corrections de bugs
hotfix/critical-security      # Corrections urgentes
refactor/extract-utils        # Améliorations du code

my-abap-project/
├── .abapgit.xml              # Configuration abapGit
├── .gitignore                # Fichiers ignorés
├── README.md                 # Documentation du projet
├── LICENSE                   # Licence
├── abaplint.json            # Configuration du linter
├── .github/
│   └── workflows/
│       └── ci.yml           # Pipeline CI/CD
└── src/
    └── zpackage/            # Objets ABAP
        ├── zcl_class.clas.abap
        └── zif_interface.intf.abap

Ne JAMAIS commiter dans Git :
- Mots de passe ou clés API
- Paramètres spécifiques au système
- Données de production
- Code personnalisé (User codé en dur)

À inclure dans .gitignore :
*.log
*.tmp
local_config.*

Solution : Importer les certificats SSL dans le système SAP
→ Transaction STRUST
→ Ouvrir SSL Client (Standard)
→ Importer le certificat de github.com

Solution : Utiliser un Personal Access Token
1. GitHub → Settings → Developer Settings → Personal Access Tokens
2. Créer un token avec le scope 'repo"
3. Entrer le token comme mot de passe dans abapGit

Solution : Vérifier les dépendances
- Tous les objets référencés sont-ils clonés ?
- La version SAP Basis est-elle correcte ?
- Les packages requis sont-ils présents ?