Innovación y transformación
vapiTrace en Fidder Classic: Aprende la API de Vault y genera mejor PowerShell más rápido
Autodesk Vault 2027 ya está aquí, y con él llega una nueva oportunidad para ver más de cerca cómo funciona Vault bajo el capó.
La última versión de vapiTrace ha sido probada con Autodesk Vault 2027 y ahora incluye varias mejoras que facilitan la comprensión del tráfico de la API de Vault, la inspección del comportamiento real del cliente y la conversión de las llamadas capturadas en código PowerShell útil.
Si crea personalizaciones de Vault utilizando PowerShell y la API de Vault, esta versión se centra en un objetivo práctico: facilitar el aprendizaje de la actividad real del cliente de Vault y reutilizar lo que descubra.
¿Qué es vapiTrace?
vapiTrace es un inspector Fiddler Classic para el tráfico SOAP de Autodesk Vault.
En lugar de mirar los sobres XML sin procesar, puede seleccionar una solicitud de Vault capturada en Fiddler e inspeccionarla de una forma más legible:
- el servicio de Vault al que se llama
- el nombre del método API
- los parámetros de la solicitud
- el tipo de respuesta
- la carga útil de la respuesta
- la documentación relacionada con la API de Vault, si está disponible localmente
La idea es simple: realizar una acción en el cliente de Vault, capturar la solicitud y dejar que vapiTrace muestre qué llamada a la API de Vault se realizó y qué datos se pasaron.
Más información sobre vapiTrace en nuestro blog anterior: https: //www.coolorange.com/en/blog/enhancing-autodesk-vault-api-traffic-tracing-with-vapitrace
Novedades de la última versión
Mejor generación de código PowerShell
La mayor mejora de esta versión es la generación mejorada de código PowerShell.
Anteriormente, vapiTrace generaba un fragmento de código para una llamada a un método como este:
$vault.PropertyService.GetProperties($entityClassId, $entityIds,
$propertyDefIds)
Eso era útil como pista, pero los usuarios seguían teniendo que inspeccionar el árbol de peticiones y recrear manualmente los valores de los parámetros.
La nueva versión inicializa ahora las variables de la solicitud rastreada antes de llamar al método de la API de Vault:
$entityClassId = 'FLDR'
$entityIds = @([long]2)
$propertyDefIds = @(
[long]39,
[long]54,
[long]119
)
$vault.PropertyService.GetProperties($entityClassId,
$entityIds, $propertyDefIds)
Matrices, valores primitivos y parámetros de objeto
Las llamadas a la API de Vault a menudo incluyen matrices y objetos estructurados, no sólo simples cadenas y números.
El generador de fragmentos de código actualizado lee ahora la solicitud SOAP rastreada y convierte los valores de los parámetros en representaciones compatibles con PowerShell:
- las cadenas se convierten en cadenas de PowerShell entrecomilladas
- los valores numéricos se emiten con información de tipo útil
- los valores booleanos y nulos se representan como $true, $false y $null
- las matrices se emiten como @(...)
- los objetos complejos se representan como hashtables
Para parámetros de tipo objeto, la salida generada puede tener este aspecto
$algunObjeto = @{ 'Nombre' = 'Ejemplo' 'Id' = [long]123 }
El fragmento de código generado sigue siendo un punto de partida, especialmente para objetos complejos de la API de Vault, pero elimina gran parte del trabajo repetitivo de copiar valores del árbol de peticiones en un script.
Experiencia de reutilización de código mejorada
También se ha mejorado el área de salida de PowerShell:
- el código generado se resalta con la sintaxis
- las cadenas, números, literales de tipo, variables y nombres de métodos son más fáciles de escanear
- el panel de código es más alto por defecto
- un divisor permite a los usuarios cambiar el tamaño del árbol de peticiones y del área de código generado
- un botón Copiar código copia el script generado en el portapapeles
Se trata de pequeños detalles, pero son importantes cuando se trabaja con llamadas reales a Bóvedas que contienen muchos argumentos.
Resumen
La nueva versión de vapiTrace facilita la inspección del tráfico de la API de Autodesk Vault y convierte las llamadas capturadas en útiles ejemplos de PowerShell.
Las mejoras clave son:
- probado con Autodesk Vault 2025, 2026 y 2027
- mejor generación de PowerShell con valores de parámetros rastreados
- compatibilidad con matrices y parámetros de tipo objeto
- resaltado de sintaxis mejorado
- panel de código redimensionable
- copia del código generado con un solo clic
Tanto si simplemente quieres explorar las capacidades de la nueva API de Vault como si tienes que trabajar en extensos proyectos de personalización, esta actualización debería agilizar el aprendizaje del cliente de Vault y la creación de scripts PowerShell basados en llamadas reales a la API de Vault.
.jpg)
.jpg)