Solidworks Macro

2. Consulter les références

Avant de générer le code, lis les fichiers de référence pertinents :

Et les templates correspondants :

3. Générer la macro

Génère le code VBA en respectant toutes les règles ci-dessous.

Règles de génération obligatoires

Structure du code

1. Option Explicit en première ligne de chaque module
2. Sub main() comme point d'entrée (convention SolidWorks pour les macros .swp)
3. En-tête standardisé :

' ============================================================
' [Nom de la macro]
' Description : [Description courte]
' Auteur : Bureau d'Études
' Date : [Date du jour]
' ============================================================

4. Commentaires en français partout
5. Noms de variables avec préfixes conventionnels :
   • sw → objets SolidWorks (swApp, swModel, swPart, swDraw)
   • pdm → objets PDM (pdmFile, pdmFolder)
   • frm → UserForms (frmMain, frmProgress)
   • b → Boolean (bRet, bCancelled)
   • n → compteurs/Long (nCount, nErrors)
   • str → String (strPath, strNom)

Gestion d'erreurs

6. Toujours inclure On Error GoTo ErrHandler dans Sub main()
7. Toujours un bloc Cleanup pour la libération des ressources :

Cleanup:
    On Error Resume Next
    swApp.CommandInProgress = False
    swApp.UserControl = True
    Set swModel = Nothing
    Exit Sub

ErrHandler:
    MsgBox "Erreur " & Err.Number & ": " & Err.Description, vbCritical, "[NOM]"
    Resume Cleanup

8. Vérifier Is Nothing pour tout objet COM avant utilisation
9. Vérifier IsEmpty pour tout tableau Variant avant itération

Performance

10. swApp.CommandInProgress = True au début des macros longues
11. swApp.UserControl = False pour éviter les confirmations de fermeture
12. Restaurer ces valeurs dans le bloc Cleanup (même en cas d'erreur)
13. Opérations batch PDM au lieu de boucles unitaires quand possible
14. DoEvents uniquement dans les boucles avec UserForm (pas dans les boucles silencieuses)

Validation des entrées

15. Vérifier que swApp.ActiveDoc n'est pas Nothing avant toute opération
16. Vérifier le type de document (GetType) si la macro ne s'applique qu'à un type
17. Vérifier que le document est enregistré (GetPathName <> "") avant export
18. Vérifier l'existence des dossiers avant export (fso.FolderExists)
19. Vérifier vault.IsLoggedIn avant toute opération PDM

Export de fichiers

20. Vérifier le retour de SaveAs3 (bRet) ET le code d'erreur (errors)
21. Pour PDF : toujours configurer ExportPdfData avec SetSheets
22. Pour les dessins multi-feuilles : itérer avec GetSheetNames
23. Construire les chemins avec FileSystemObject.GetBaseName (jamais de parsing manuel)
24. Créer les dossiers de sortie avant d'exporter

PDM

25. LoginAuto plutôt que Login (credentials Windows)
26. Vérifier IsLocked avant check-out, et le propriétaire avant check-in
27. Flush + CloseFile True après SetVar sur les variables PDM
28. Set vault = Nothing en fin de macro pour libérer les ressources COM
29. Batch operations (IEdmBatchGet, IEdmBatchUnlock2) pour les traitements en masse

UserForm

30. vbModal par défaut (sauf besoin explicite d'interaction avec SW)
31. BrowseForFolder via Shell.Application (pas FileDialog)
32. Barre de progression simulée avec un Label (Width + BackColor)
33. Bouton Annuler avec vérification dans la boucle de traitement
34. DoEvents dans les boucles pour garder l'UI réactive

Modes de génération

--export : Macro d'export

Génère une macro d'export de fichiers (PDF, DXF, DWG, STEP, IGES).

Questions à poser si non précisé :

• Format(s) de sortie ?
• Dossier de destination (fixe, relatif au fichier, configurable INI) ?
• Document actif ou batch (dossier) ?
• PDM : check-out avant, check-in après ?

Fichiers à lire : references/api-solidworks.md, templates/macro-export.bas.md

--proprietes : Macro de propriétés

Génère une macro de gestion des propriétés personnalisées (lecture, écriture, suppression, copie entre configurations).

Questions à poser si non précisé :

• Quelles propriétés (noms, valeurs) ?
• Configuration cible (générale, spécifique, toutes) ?
• Source des valeurs (codées en dur, Excel, INI, saisie utilisateur) ?

Fichiers à lire : references/api-solidworks.md, templates/macro-proprietes.bas.md

--pdm : Macro PDM

Génère une macro d'opérations PDM (check-out/in, variables, workflow, recherche).

Questions à poser si non précisé :

• Nom du coffre PDM ?
• Opération(s) : check-out, check-in, get latest, variables, changement d'état ?
• Scope : fichier actif ou dossier ?

Fichiers à lire : references/api-pdm.md, templates/macro-pdm-batch.bas.md

--batch : Macro de traitement par lots

Génère une macro qui traite plusieurs fichiers (dossier, assemblage, sélection).

Questions à poser si non précisé :

• Source des fichiers (dossier, composants d'assemblage, liste) ?
• Traitement à appliquer (export, propriétés, PDM) ?
• Récursif (sous-dossiers / sous-assemblages) ?
• Interface : silencieux ou avec progression ?

Fichiers à lire : references/patterns-vba.md (patterns 13, 14, 15), templates selon le traitement

--userform : Macro avec interface

Génère une macro avec UserForm interactif.

Questions à poser si non précisé :

• Quels contrôles (champs texte, options, listes) ?
• Quelles actions (boutons) ?
• Barre de progression nécessaire ?
• Sauvegarde des préférences (INI) ?

Fichiers à lire : templates/macro-userform.bas.md, templates/config-ini.md

Sans flag : Analyse et proposition

Si aucun flag n'est précisé, analyser la description et :

1. Identifier le(s) type(s) de macro nécessaire(s)
2. Proposer l'architecture (modules, UserForm, INI)
3. Demander confirmation avant de générer

Environnement de l'utilisateur

Chemins de référence

• Macros production : G:\admin_solidworks\Macro\
• Macros dev/beta : G:\admin_solidworks\_En cours\Macro\
• Icônes BMP : G:\admin_solidworks\Macro\Icone_bmp\
• Fichiers INI : même dossier que la macro .swp

Macros existantes (référence)

• Export_PDF.swp — Export PDF avec configuration INI
• Mise a jour proprietes.swp — CRUD propriétés personnalisées
• Poincon.swp — Macro spécifique métier
• _BETA_v2_Export_PDF_PDM.swp — Export PDF avec intégration PDM

Conventions du bureau d'études

• SolidWorks 2021 SP5
• PDM Professional (nom du coffre à demander si non précisé)
• Fichiers .swp pour les macros (format binaire OLE)
• Fichiers .ini pour la configuration externe
• Icônes .bmp pour les boutons de la barre d'outils

Livrables

Pour chaque macro générée, fournir :

1. Code VBA complet dans un bloc de code unique, prêt à copier dans l'éditeur VBA
2. Fichier INI si la macro utilise une configuration externe
3. Instructions d'installation :
   • Comment créer la macro .swp (Outils > Macro > Nouvelle)
   • Comment copier le code dans l'éditeur VBA
   • Comment configurer le fichier INI
   • Comment ajouter un bouton dans la barre d'outils SolidWorks (optionnel)
4. Références VBA requises : liste des bibliothèques à cocher dans Outils > Références

Références VBA standard à inclure

☑ SolidWorks 2021 Type Library
☑ SolidWorks 2021 Constant Type Library
☑ SOLIDWORKS PDM 2021 Type Library          (si PDM utilisé)
☑ Microsoft Scripting Runtime               (si FileSystemObject utilisé)
☑ Microsoft Excel XX.0 Object Library       (si Excel utilisé)

Exemples de prompts

/solidworks-macro --export Macro d'export PDF de tous les dessins d'un dossier avec check-in PDM après export

/solidworks-macro --proprietes Mettre à jour Description, Matière et Traitement sur le document actif et toutes ses configurations

/solidworks-macro --pdm --batch Check-out de tous les fichiers d'un dossier PDM, mise à jour de la variable Description, puis check-in

/solidworks-macro --userform Interface pour exporter le document actif en PDF + DXF + STEP avec choix du dossier de sortie et progression

/solidworks-macro Macro qui parcourt un assemblage, lit la propriété "Masse" de chaque composant, et génère un rapport Excel avec la nomenclature complète