SolidWorksMakroprogrammierung

Objekt · SldWorks

PackAndGo-Objekt

Pack and Go eines Dokuments: Es sammelt alle Dokumente, aus denen das Modell besteht, und kopiert sie, auf Wunsch umbenannt, in einen Ordner oder eine Zip-Datei.

Deklaration Dim x As SldWorks.PackAndGo · in der englischen .NET-Hilfe: IPackAndGo

Beschreibung

PackAndGo gibt Zugriff auf Pack and Go. Pack and Go sammelt alle Dokumente, aus denen ein Modell besteht, auf Wunsch mit Zeichnungen, Simulationsergebnissen, Toolbox-Teilen und weiteren Dateien. Es kopiert sie in einen Ordner oder in eine Zip-Datei, auf Wunsch unter neuen Namen. Du richtest PackAndGo ein und führst es dann mit ModelDocExtension.SavePackAndGo aus. Die meisten Befehle gibt es seit SOLIDWORKS 2011, PackAndGo.FolderStructureOption und PackAndGo.SetSaveToName2 erst seit SOLIDWORKS 2025 SP01.

Zugriff

Beispiel

' Packt das aktive Dokument mit allen Dokumenten und Zeichnungen in den Ordner
' C:\Temp\PackAndGo, alle Dateien in einen Ordner und mit dem Präfix "Kopie_".
' Vorbedingung: Ein gespeichertes Teil oder eine gespeicherte Baugruppe ist offen,
'               den Ordner C:\Temp\PackAndGo gibt es. Ab SOLIDWORKS 2025 SP01.
' Ergebnis:     Die Dateien liegen im Ordner, Quelle und Ziel jeder Datei stehen im
'               Direktfenster.
Option Explicit

Sub main()
    Dim swApp As SldWorks.SldWorks
    Dim swModel As SldWorks.ModelDoc2
    Dim swPackAndGo As SldWorks.PackAndGo
    Dim vQuellen As Variant, vZiele As Variant, vArten As Variant
    Dim vStatus As Variant
    Dim i As Long

    Set swApp = Application.SldWorks
    Set swModel = swApp.ActiveDoc
    If swModel Is Nothing Then Exit Sub
    If swModel.GetPathName = "" Then Exit Sub                  ' noch nie gespeichert

    Set swPackAndGo = swModel.Extension.GetPackAndGo
    swPackAndGo.IncludeDrawings = True
    swPackAndGo.FolderStructureOption = swPackAndGoFolderOptions_SingleFolder
    swPackAndGo.AddPrefix = "Kopie_"
    If False = swPackAndGo.SetSaveToName2(True, "C:\Temp\PackAndGo\") Then Exit Sub

    If swPackAndGo.GetDocumentNames(vQuellen) Then
        If swPackAndGo.GetDocumentSaveToNames(vZiele, vArten) Then
            For i = 0 To UBound(vQuellen)
                Debug.Print vQuellen(i) & " -> " & vZiele(i)
            Next i
        End If
    End If

    vStatus = swModel.Extension.SavePackAndGo(swPackAndGo)
    If IsArray(vStatus) Then
        For i = 0 To UBound(vStatus)
            If vStatus(i) <> swPackAndGoSaveStatus_Succeed Then Debug.Print "Datei " & i & ": Status " & vStatus(i)  ' swPackAndGoSaveStatus_e
        Next i
    End If
End Sub

Bemerkungen

Ablauf: Richte Pack and Go erst ein und rufe dann ModelDocExtension.SavePackAndGo auf. Der Aufruf führt Pack and Go aus und beendet die Sitzung. Ein zweiter Aufruf schlägt fehl, solange du die Einstellungen nicht neu setzt.

Zielnamen: Die Ziele legst du je Dokument mit PackAndGo.SetDocumentSaveToNames fest oder für alle mit PackAndGo.SetSaveToName2. SetSaveToName2 überschreibt die einzelnen Pfade und Namen. Präfix und Suffix (PackAndGo.AddPrefix, PackAndGo.AddSuffix) gelten für alle Dateinamen. PackAndGo.GetDocumentSaveToNames liefert die Namen samt Präfix und Suffix.

Ordnerstruktur: Seit SOLIDWORKS 2025 SP01 legt PackAndGo.FolderStructureOption fest, ob alle Dateien in einen Ordner kommen, in möglichst wenige Ordner oder in die ganze Ordnerstruktur (swPackAndGoFolderOptions_e). Ältere Makros nutzen PackAndGo.FlattenToSingleFolder, das es seit SOLIDWORKS 2015 gibt.

Zielordner: Die Hilfebeispiele geben den Zielordner mit abschließendem \ an und setzen voraus, dass es ihn gibt. Ob SOLIDWORKS fehlende Ordner anlegt, sagt die Hilfe nicht.

Hilfebeispiele: „Pack and Go an Assembly“ gibt Quell- und Zielnamen einer Baugruppe aus, nimmt Zeichnungen, Simulationsergebnisse und Toolbox-Teile mit, setzt Präfix und Suffix und packt alles in einen Ordner. „Add and Remove Files from Pack and Go“ nimmt die Render-Dateien aus ModelDocExtension.GetRenderStockReferences und weitere Dateien mit und entfernt eine davon wieder. „Pack and Go Part and Linked Equation“ packt ein Teil, dessen Gleichungen in einer verknüpften Datei stehen. Die Gleichungsdatei kommt dabei mit, ohne dass das Makro sie eigens hinzufügt.

Eigenschaften und Methoden

Eigenschaften 8, davon 8 beschrieben

NameBeschreibung
AddPrefixLiest oder setzt ein Präfix, das Pack and Go vor alle Dateinamen setzt.
AddSuffixLiest oder setzt ein Suffix, das Pack and Go an alle Dateinamen anhängt.
FlattenToSingleFolderLiest oder setzt, ob Pack and Go alle Dateien direkt in den Zielordner speichert, statt die Ordnerstruktur des Modells nachzubilden.
FolderStructureOptionLiest oder setzt, in welcher Ordnerstruktur Pack and Go die Dateien speichert: ein Ordner, möglichst wenige Ordner oder die ganze Struktur.
IncludeDrawingsLiest oder setzt, ob Pack and Go die Zeichnungen des Modells mitnimmt.
IncludeSimulationResultsLiest oder setzt, ob Pack and Go die Ergebnisse von SOLIDWORKS Simulation mitnimmt.
IncludeSuppressedLiest oder setzt, ob Pack and Go unterdrückte Komponenten mitnimmt.
IncludeToolboxComponentsLiest oder setzt, ob Pack and Go die Komponenten aus SOLIDWORKS Toolbox mitnimmt.

Methoden 10, davon 9 beschrieben, 1 veraltet

NameBeschreibung
AddExternalDocumentsNimmt Dateien, die nicht von SOLIDWORKS sind, mit in Pack and Go auf, etwa Render-Dateien oder Dokumente aus anderen Programmen.
GetDocumentNamesLiefert die ursprünglichen Pfade und Namen aller Dokumente des Modells für Pack and Go.
GetDocumentNamesCountLiefert die Zahl der Dokumente, aus denen das Modell für Pack and Go besteht.
GetDocumentSaveToNamesLiefert Zielpfad und Namen jedes Dokuments und die Art der Dokumente, etwa ob sie virtuell sind.
GetExternalDocumentsLiefert Pfad und Namen der Dateien, die nicht von SOLIDWORKS sind und in Pack and Go aufgenommen wurden.
GetSaveToNameLiefert den gemeinsamen Zielordner oder die Zip-Datei, die für Pack and Go gesetzt ist.
RemoveExternalDocumentsEntfernt Dateien, die nicht von SOLIDWORKS sind, wieder aus Pack and Go.
SetDocumentSaveToNamesSetzt Zielpfad und Namen für jedes Dokument des Modells, ein leerer Name nimmt das Dokument heraus.
SetSaveToNameveraltet ersetzt durch PackAndGo.SetSaveToName2
SetSaveToName2Legt einen gemeinsamen Zielordner oder eine Zip-Datei für alle Dokumente fest und überschreibt damit die einzelnen Zielpfade und Namen.

Nicht aufgeführt sind 3 C++-Varianten (Namen mit I davor, zum Beispiel IGetDocumentNames). In VBA nimmst du immer den Befehl ohne I.

Siehe auch

Englisches Original: IPackAndGo in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.