Das Umwandeln von Vault-API-Aufrufen in nutzbare PowerShell-Skripte ist jetzt viel einfacher geworden

vapiTrace in Fidder Classic: Lernen Sie die Vault-API und erzeugen Sie schneller bessere PowerShell

Autodesk Vault 2027 ist da, und mit ihm kommt eine neue Gelegenheit, sich genauer anzusehen, wie Vault unter der Haube funktioniert.

Die neueste Version von vapiTrace wurde mit Autodesk Vault 2027 getestet und enthält nun mehrere Verbesserungen, die es einfacher machen, den Vault-API-Verkehr zu verstehen, echtes Clientverhalten zu untersuchen und erfasste Aufrufe in nützlichen PowerShell-Code umzuwandeln.

Wenn Sie Vault-Anpassungen mit PowerShell und der Vault-API erstellen, konzentriert sich diese Version auf ein praktisches Ziel: Es ist einfacher, von echten Vault-Client-Aktivitäten zu lernen und das, was Sie entdecken, wiederzuverwenden.

Was ist vapiTrace?

vapiTrace ist ein klassischer Fiddler-Inspektor für den Autodesk Vault SOAP-Verkehr.

Anstatt rohe XML-Umschläge zu betrachten, können Sie eine erfasste Vault-Anfrage in Fiddler auswählen und sie in einer besser lesbaren Form untersuchen:

• den aufgerufenen Vault-Dienst
• den Namen der API-Methode
• die Anfrageparameter
• den Antworttyp
• die Nutzlast der Antwort
• die zugehörige Vault-API-Dokumentation, sofern lokal verfügbar

Die Idee ist einfach: Führen Sie eine Aktion im Vault-Client aus, erfassen Sie die Anfrage und lassen Sie vapiTrace zeigen, welcher Vault-API-Aufruf getätigt wurde und welche Daten übergeben wurden.

Erfahren Sie mehr über vapiTrace in unserem vorherigen Blog: https: //www.coolorange.com/en/blog/enhancing-autodesk-vault-api-traffic-tracing-with-vapitrace

Was ist neu in der neuesten Version?

Bessere PowerShell-Code-Generierung

Die größte Verbesserung in dieser Version ist die verbesserte PowerShell-Code-Generierung.

Bisher generiertevapiTrace ein Code-Snippet für einen Methodenaufruf wie diesen:

$vault.PropertyService.GetProperties($entityClassId, $entityIds, 
$propertyDefIds)

Das war als Hinweis nützlich, aber die Benutzer mussten immer noch den Anforderungsbaum untersuchen und die Parameterwerte manuell neu erstellen.

In der neuen Version werden nun Variablen aus der verfolgten Anfrage initialisiert, bevor die Vault-API-Methode aufgerufen wird:

$entityClassId = 'FLDR'
$entityIds = @([long]2)
$propertyDefIds = @(
 [long]39,
 [long]54,
 [long]119
)

$vault.PropertyService.GetProperties($entityClassId, 
$entityIds, $propertyDefIds)

Arrays, primitive Werte und Objektparameter

Vault-API-Aufrufe enthalten oft Arrays und strukturierte Objekte, nicht nur einfache Zeichenketten und Zahlen.

Der aktualisierte Codefragment-Generator liest jetzt die verfolgte SOAP-Anforderung und konvertiert Parameterwerte in PowerShell-freundliche Darstellungen:

• Strings werden zu zitierten PowerShell-Strings
• numerische Werte werden mit nützlichen Typinformationen ausgegeben
• Boolesche und Null-Werte werden als $true, $false und $null dargestellt
• Arrays werden als @(...) ausgegeben
• komplexe Objekte werden als Hashtabellen dargestellt

Bei Parametern im Objektstil kann die generierte Ausgabe wie folgt aussehen:

$someObject = @{ 'Name' = 'Beispiel' 'Id' = [long]123 }

Der generierte Codeschnipsel ist nach wie vor als Ausgangspunkt gedacht, insbesondere für komplexe Vault-API-Objekte, aber er erspart einen Großteil der sich wiederholenden Arbeit des Kopierens von Werten aus der Anforderungsstruktur in ein Skript.

Verbesserte Erfahrung bei der Wiederverwendung von Code

Der PowerShell-Ausgabebereich wurde ebenfalls verbessert:

• generierter Code wird syntaktisch hervorgehoben
• Zeichenketten, Zahlen, Typliterale, Variablen und Methodennamen sind einfacher zu scannen
• der Codebereich ist standardmäßig größer
• Mit einem Splitter können Benutzer die Größe der Anforderungsstruktur und des generierten Codebereichs ändern
• eine Schaltfläche Code kopieren kopiert das generierte Skript in die Zwischenablage

Dies sind kleine Details, aber sie sind wichtig, wenn Sie mit echten Vault-Aufrufen arbeiten, die viele Argumente enthalten.

Zusammenfassung

Die neue Version von vapiTrace macht es einfacher, den Autodesk Vault-API-Verkehr zu untersuchen und erfasste Aufrufe in nützliche PowerShell-Beispiele zu verwandeln.

Die wichtigsten Verbesserungen sind:

• getestet mit Autodesk Vault 2025, 2026, und 2027
• Bessere PowerShell-Generierung mit verfolgten Parameterwerten
• Unterstützung für Arrays und objektähnliche Parameter
• verbesserte Syntaxhervorhebung
• Größenveränderbares Code-Panel
• Ein-Klick-Kopie für generierten Code

Ganz gleich, ob Sie einfach nur die Möglichkeiten der neuen Vault-API erkunden möchten oder an umfangreichen Anpassungsprojekten arbeiten müssen, mit diesem Update können Sie schneller vom Vault-Client lernen und PowerShell-Skripte auf der Grundlage echter Vault-API-Aufrufe erstellen.