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.
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:
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
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)
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:
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.
Der PowerShell-Ausgabebereich wurde ebenfalls verbessert:
Dies sind kleine Details, aber sie sind wichtig, wenn Sie mit echten Vault-Aufrufen arbeiten, die viele Argumente enthalten.
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:
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.