cadMasterCLI/README.md

cadMasterCLI

Outil de lancement simplifié de scripts PowerShell pour les automates Distech Controls Eclypse.

---

IMPORTANT : Ce projet est un développement personnel indépendant.

Ce projet a été développé par Charles-Arthur DAVID à titre personnel. Distech Controls n'est pas responsable de ce projet et ne le supporte pas. Aucune demande de support ne sera prise en charge par Distech Controls. Distech Controls ne fournit aucune garantie ni assistance technique pour ce projet.

---

À quoi ça sert ?

cadMasterCLI est une interface graphique qui vous permet de lancer des scripts d'automatisation sans savoir utiliser le terminal, sans connaître PowerShell, et sans configuration technique.

Il suffit de :

1. Faire un clique-droit sur le fichier cadMasterCLI.ps1 et choisir "Exécuter avec Powershell"
2. Sélectionner le script que vous souhaitez exécuter
3. Remplir les informations demandées (adresse IP, fichier CSV, etc.)
4. Cliquer sur Lancer le script

Les scripts sont téléchargés automatiquement depuis un serveur centralisé (Gitea). Si vous n'avez pas accès au réseau, les scripts déjà utilisés restent disponibles en mode hors ligne.

---

Prérequis

Élément	Détail
Système d'exploitation	Windows 10 ou Windows 11
PowerShell	Version 5.1 — déjà inclus dans Windows 10/11, rien à installer
Accès réseau	Nécessaire pour télécharger les scripts (hors ligne possible si déjà téléchargés)

Aucun autre logiciel n'est nécessaire.

---

Installation

Aucune installation requise. cadMasterCLI est un seul fichier .ps1.

1. Téléchargez le fichier cadMasterCLI.ps1 et placez-le dans un dossier de votre choix.
2. C'est tout.

---

Premier lancement

Étape 1 — Débloquer le fichier (première fois uniquement)

Windows peut bloquer les fichiers téléchargés depuis Internet. Pour lever ce blocage :

1. Faites un clic droit sur cadMasterCLI.ps1
2. Cliquez sur Propriétés
3. En bas de la fenêtre, cochez Débloquer si la case est présente
4. Cliquez sur OK

Si la case "Débloquer" n'apparaît pas, l'étape n'est pas nécessaire.

Étape 2 — Autoriser l'exécution des scripts (première fois uniquement)

Si un message d'erreur apparaît à propos de la "stratégie d'exécution" :

1. Appuyez sur la touche Windows, tapez PowerShell
2. Faites un clic droit sur Windows PowerShell → Exécuter en tant qu'administrateur
3. Copiez-collez la commande suivante et appuyez sur Entrée :

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

4. Tapez O pour confirmer, puis fermez la fenêtre PowerShell.

Étape 3 — Lancer cadMasterCLI

Méthode simple : faites un clic droit sur cadMasterCLI.ps1 → Exécuter avec PowerShell.

Méthode alternative :

1. Ouvrez PowerShell (touche Windows → tapez PowerShell → Entrée)
2. Naviguez vers le dossier contenant le fichier, par exemple :

   cd C:\Outils\cadMasterCLI
   

3. Lancez le script :

   .\cadMasterCLI.ps1
   

---

Utilisation

1. Sélectionner un script

Au démarrage, une fenêtre de sélection s'affiche avec la liste des scripts disponibles.

Colonne	Signification
Nom	Nom du script
Description	Ce que fait le script
Mis à jour	Date de la dernière mise à jour
Cache local	Indique si le script a déjà été téléchargé
MAJ dispo	[NOUVEAU] si une mise à jour est disponible

Double-cliquez sur le script souhaité, ou sélectionnez-le et cliquez sur OK.

Pour fermer sans rien exécuter, fermez simplement la fenêtre.

2. Remplir les paramètres

Une fenêtre s'ouvre avec :

• À gauche : la documentation du script (README), pour comprendre à quoi il sert et comment le remplir.
• À droite : le formulaire de paramètres à remplir.

Types de champs :

Apparence	Ce qu'il faut faire
Champ texte blanc	Saisir une valeur (adresse IP, nom d'utilisateur, etc.)
Boutons ronds (RadioButtons)	Sélectionner une option parmi les choix proposés
Case à cocher	Activer ou désactiver une option
Bouton Parcourir...	Choisir un fichier CSV sur votre ordinateur

Les champs marqués Obligatoire doivent impérativement être remplis avant de pouvoir lancer le script. Le bouton Lancer le script reste grisé tant que ces champs sont vides — il devient vert une fois tout renseigné.

Cliquez sur [?] Voir l'aide sous un champ pour afficher une description détaillée de ce paramètre.

Panneau README :

• Cliquez sur Fermer README pour masquer la documentation et agrandir le formulaire.
• Cliquez sur Ouvrir README pour la réafficher.
• Vous pouvez redimensionner le panneau README en faisant glisser la barre de séparation entre les deux zones.

3. Lancer le script

Une fois tous les champs obligatoires remplis :

• Cliquez sur Lancer le script (bouton vert).
• Le script s'exécute dans le terminal. Attendez la fin de l'exécution.
• Appuyez sur Entrée pour fermer.

Cliquez sur Annuler pour revenir à la liste des scripts sans rien exécuter.

---

Mise à jour automatique des scripts

Lorsqu'une nouvelle version d'un script est disponible sur le serveur, cadMasterCLI vous le signale avec [NOUVEAU] dans la liste et vous propose de télécharger la mise à jour.

Les scripts sont stockés localement dans le sous-dossier scripts\ à côté de cadMasterCLI.ps1.

---

Mode hors ligne

Si le serveur Gitea est inaccessible (pas de réseau), cadMasterCLI utilise automatiquement les scripts déjà téléchargés. Un message vous prévient que vous êtes en mode hors ligne.

---

Cas d'erreurs fréquents

Message	Cause probable	Solution
Erreur de stratégie d'exécution	PowerShell bloque les scripts	Voir Étape 2 du premier lancement
Impossible de contacter Gitea	Pas d'accès réseau	Vérifiez votre connexion ou utilisez le mode hors ligne
Script introuvable en cache	Script jamais téléchargé + pas de réseau	Connectez-vous au réseau et relancez
Fichier bloqué par Windows	Script téléchargé depuis Internet	Voir Étape 1 du premier lancement

---

Structure des fichiers

cadMasterCLI/
├── cadMasterCLI.ps1          ← fichier principal à lancer
├── README.md                 ← cette documentation
├── CONTRIBUTING_SCRIPTS.md   ← guide pour créer de nouveaux scripts
├── _template_script.ps1      ← modèle de script
└── scripts/                  ← scripts téléchargés (créé automatiquement)
    └── NomDuScript/
        └── NomDuScript.ps1