Installation & Setup Guide

Installation On-Premise

L'installation dans un environnement On-Premise suit le même processus que SaaS.

On-Premise Installation

Installation in an On-Premise environment follows the same process as SaaS.

Compiler et Personnaliser les ID d'objets

Si vous souhaitez modifier le code source et utiliser votre propre plage d'ID d'objets, suivez ce guide.

Étape 1: Cloner le dépôt GitHub

git clone https://github.com/FloFOS/BCFHSTimeline.git
cd BCFHSTimeline

Étape 2: Modifier les ID d'objets

Vous avez deux options : la méthode manuelle VS Code ou le script automatisé.

🔹 Méthode 1: Via VS Code (Recommandé pour une première utilisation)

1. Ouvrez le projet dans VS Code
2. Utilisez Ctrl+H (Cmd+H sur Mac) pour ouvrir le Find and Replace
3. Cherchez: 99900 et remplacez par votre ID de départ (ex: 50000)
4. Assurez-vous que « Match Whole Word » est activé
5. Cliquez sur « Replace All »
6. Répétez pour 99919 → votre ID final

🔹 Méthode 2: Script Bash automatisé

Si vous avez plusieurs plages à remplacer, utilisez ce script :

#!/bin/bash

# Définissez les paramètres
START_ID=50000    # Votre ID de départ
END_ID=50019      # Votre ID final (minimum 20 IDs)
OLD_START=99900   # ID actuel de départ
OLD_END=99919     # ID actuel final

# Fonction pour calculer le nouvel ID
calculate_new_id() {
  local current_id=$1
  local base_original=$OLD_START
  local offset=$((current_id - base_original))
  local new_id=$((START_ID + offset))
  echo $new_id
}

# Traiter tous les fichiers AL
find src -name "*.al" -type f | while read -r file; do
  echo "Traitement: $file"
  
  # Remplacer les déclarations d'objets
  sed -i.bak -E "s/(table|page|codeunit|report) $OLD_START /\1 $(calculate_new_id $OLD_START) /g" "$file"
  
  # Ajouter d'autres remplacements selon vos besoins
  rm -f "$file.bak"
done

echo "✅ IDs remplacés avec succès!"

Étape 3: Modifier app.json

Mettez à jour manuellement la plage d'ID dans src/app.json :

{
  "idRanges": [
    {
      "from": 50000,
      "to": 50019
    }
  ]
}

Étape 4: Compiler avec AL-Go

Validation des modifications

Avant de déployer, vérifiez que :

• ✅ Les IDs dans app.json correspondent à ceux du code
• ✅ Aucune erreur de compilation
• ✅ Les plages d'ID ne chevauchent pas avec d'autres extensions

Compile & Customize Object IDs

If you want to modify the source code and use your own object ID range, follow this guide.

Step 1: Clone the GitHub repository

git clone https://github.com/FloFOS/BCFHSTimeline.git
cd BCFHSTimeline

Step 2: Modify object IDs

You have two options: manual VS Code method or automated script.

🔹 Method 1: Via VS Code (Recommended for first-time)

1. Open the project in VS Code
2. Use Ctrl+H (Cmd+H on Mac) to open Find and Replace
3. Find: 99900 and replace with your start ID (e.g., 50000)
4. Ensure "Match Whole Word" is enabled
5. Click "Replace All"
6. Repeat for 99919 → your end ID

🔹 Method 2: Automated Bash script

If you need to replace multiple ranges, use this script:

#!/bin/bash

# Set parameters
START_ID=50000    # Your start ID
END_ID=50019      # Your end ID (minimum 20 IDs)
OLD_START=99900   # Current start ID
OLD_END=99919     # Current end ID

# Function to calculate new ID
calculate_new_id() {
  local current_id=$1
  local base_original=$OLD_START
  local offset=$((current_id - base_original))
  local new_id=$((START_ID + offset))
  echo $new_id
}

# Process all AL files
find src -name "*.al" -type f | while read -r file; do
  echo "Processing: $file"
  
  # Replace object declarations
  sed -i.bak -E "s/(table|page|codeunit|report) $OLD_START /\1 $(calculate_new_id $OLD_START) /g" "$file"
  
  # Add other replacements as needed
  rm -f "$file.bak"
done

echo "✅ IDs replaced successfully!"

Step 3: Modify app.json

Manually update the ID range in src/app.json:

{
  "idRanges": [
    {
      "from": 50000,
      "to": 50019
    }
  ]
}

Step 4: Compile with AL-Go or VS Code

Validate changes

Before deploying, verify that:

• ✅ IDs in app.json match those in the code
• ✅ No compilation errors
• ✅ ID ranges don't overlap with other extensions