Secuencias avanzadas de comandos Marionette
El programador informático avanzado que trabaje con Marionette puede crear nodos personalizados para sí mismo o para otros. Si necesita instrucciones adicionales para crear nodos Marionette, consulte la página principal del programador informático en wiki: developer.vectorworks.net.
Hay varias bibliotecas Python a disposición de los programadores informáticos avanzados. Puede probar varios paquetes de bibliotecas Python durante el desarrollo para confirmar el uso de las mejores para la secuencia de comandos. Los paquetes están enumerados en la página wiki del programador informático. Si desea acceso rápido, pulse Repositorio de bibliotecas Python en la sección Contenido de Preferencias de Marionette. También puede pedir paquetes específicos que Vectorworks puede cargar en esa página.
Puede referenciar en los nodos Marionette que haya creado los paquetes de bibliotecas Python incluidos en la página del programador informático de Vectorworks. El paquete correspondiente a la plataforma y versión que haya indicado se autocargan luego de que el usuario ejecuta la secuencia de comandos.
Procedimiento para referenciar bibliotecas Python
Si desea referenciar un paquete de bibliotecas Python en el nodo Marionette personalizado, el siguiente modelo de construcción sintáctica Marionette.Node especifica las dependencias de versión y paquete del nodo:
this.CustomNode("CustomNodeName", "OptionalLocalizedName", "OptionalNodeVersionNumber", [('Geopy', '2.2.0'), ('scipy', '1.7.3')])
La expresión sintáctica de ejemplo entre corchetes ilustra cómo especificar dos paquetes Python distintos de los que el nodo va a depender, además del número de versión optativo de cada uno.
Si la biblioteca Python que necesita no va incluida en el servidor Vectorworks, visite la página web del wiki del programador informático arriba descrita para preguntar a Vectorworks por correo electrónico sobre el paquete necesario. El equipo de Marionette se encargará de poner el paquete en el servidor. Ya que las dependencias Python siempre están presentes e instaladas a pedido, puede quedarse tranquilo porque los nodos personalizados van a funcionar correctamente en todas las versiones.
Instalación de bibliotecas Python
Si ya tiene instalado el paquete Python referenciado, se ejecutará la secuencia de comandos.
Por otro lado, si no lo tiene instalado, el usuario de la secuencia de comandos tendrá la oportunidad de autoinstalar el paquete de los servidores Vectorworks.
Pasos para instalar los archivos necesarios de las bibliotecas Python:
Si Marionette detecta la necesidad de instalar un archivo de biblioteca de los servidores Vectorworks, aparece el cuadro de diálogo Instalar paquetes Python.
Aparece luego una lista de los paquetes necesarios y los detalles correspondientes. Pulse Sí para instalar los paquetes en la carpeta Python Externals en la carpeta del usuario. Tal carpeta queda autogenerada si no la tenía antes.
Tras concluir la instalación, se abre el cuadro de diálogo Detalles de la instalación. Pulse Detalles para leer el archivo de texto que contiene los resultados de la instalación. En él aparecerán los paquetes instalados, dónde fueron instalados y el resultado de la instalación.
Tras la instalación satisfactoria de los paquetes de bibliotecas Python necesarios, se ejecutará la secuencia de comandos.
Instalación manual de bibliotecas Python
|
Modo |
Herramienta |
Conjunto de herramientas |
|
Preferencias
|
Marionette
|
Básica |
Puede instalar manualmente ciertas bibliotecas Python durante el desarrollo para confirmar el uso de las mejores para el nodo personalizado que está confeccionando.
Pasos para instalar una biblioteca Python:
Pulse la herramienta y el modo deseado.
A continuación, se abre el cuadro de diálogo Preferencias de Marionette.
Pulse Repositorio de bibliotecas Python en la sección Contenido para ver las bibliotecas Python que puede usar del servidor Vectorworks.
Pulse Instalar biblioteca Python.
A continuación, se abre el cuadro de diálogo Ubicación de biblioteca Python.
Escriba la dirección URL del archivo de biblioteca Python para instalar el archivo correspondiente.
Pruebe la secuencia de comandos. Si considera útil el archivo de biblioteca y lo necesita para la programación personalizada en Marionette, pídalo para añadirlo al servidor Vectorworks. Para ello, envíe un correo electrónico al desde la página wiki del programador informático.
Si desea ver los archivos y paquetes de biblioteca instalados, consulte el archivo InstallOutput.txt en la carpeta Python Externals en la carpeta del usuario.
