Hace poco recibimos la siguiente pregunta:
Estoy usando la última versión de Merlin Project en Mac y he creado un archivo de proyecto para un cliente. Él ha solicitado un manual de proyecto que se pueda imprimir o leer en Vista Previa o Acrobat Reader. El manual de proyecto debe listar tareas y archivos adjuntos en una interfaz Maestro-Detalle y exportar un conjunto de propiedades predefinidas que me interesan. No me importa usar un script, pero me gustaría que la acción realice todo el trabajo de una vez; es decir, que itere los elementos, extraiga los datos y cree el PDF. ¿Es esto posible?
Una forma de implementar la solicitud del cliente sería usar el menú Archivo > Exportar > Imagen para exportar vistas de proyecto personalizadas a PDF, o llamar a Archivo > Imprimir para imprimir los documentos.
Sin embargo, para satisfacer el requisito descrito anteriormente, una solución AppleScript desarrollada por nosotros resulta muy práctica.
El script itera todas las tareas del proyecto y extrae las propiedades de cada elemento. Comprueba si hay archivos adjuntos, extrae sus propiedades correspondientes y escribe un archivo de texto AsciiDoc en el Escritorio. Por último, llama a Asciidoctor PDF para crear un PDF usando una hoja de estilos personalizada.
Instalación del script
- Descargue el siguiente archivo.
- Descomprima el archivo zip.
- En el menú del Finder, seleccione Ir > Carpeta personal.
- Mueva la carpeta res-for-script a la carpeta personal.
- En Merlin Project, seleccione Archivo > Acciones > Mostrar carpeta de scripts.
- Abra la carpeta llamada net.projectwizards.merlinproject.
- Mueva el archivo de script Create Project Handbook.scpt a la carpeta de scripts de Merlin Project.
- Haga doble clic en el script Create Project Handbook. Se abrirá en el Editor de Scripts.
- Localice la línea que contiene property pathToAsciidoctorPDF.
- Abra una ventana de Terminal y ejecute command -v asciidoctor-pdf.
- Modifique el pathToAsciidoctorPDF si es necesario.
Si necesita instalar asciidoctor-pdf, siga las instrucciones de instalación y modifique el pathToAsciidoctorPDF cuando corresponda.
Creación del manual de proyecto
Abra cualquier proyecto. Llame al script Create Project Handbook desde el menú Archivo > Acciones > … de Merlin Project.
Espere a que el script cree el archivo AsciiDoc y realice la conversión a PDF con asciidoctor-pdf. Durante la escritura del archivo de texto, se emite una señal sonora cada 75 elementos del proyecto. Tanto el archivo AsciiDoc (.adoc) como el PDF generado aparecerán en el Escritorio.
La hoja de estilos personalizada renderiza una página de título para el manual de proyecto que incluye la fecha de creación y admite emojis de Apple. El archivo PDF tendrá una tabla de contenidos con enlaces activos.
Los archivos adjuntos se listarán bajo sus elementos principales.
Puede abrir el archivo .adoc y modificarlo si desea convertir el PDF en un segundo paso usando sus propias hojas de estilos. Si desea usar su propia hoja de estilos para el PDF, simplemente colóquela en la carpeta res-for-script y cambie el nombre de la propiedad themeName en el script.
Nota sobre los AppleScripts de ProjectWizards: Puede incorporar este código de ejemplo de ProjectWizards en sus programas sin restricciones. El código de ejemplo se proporciona únicamente con fines de demostración. Con gusto le ayudamos con preguntas sobre los scripts, pero la responsabilidad de su funcionamiento recae exclusivamente en usted. Está expresamente autorizado a modificar los scripts y distribuirlos gratuitamente a terceros. En ese caso, indique claramente qué cambios ha realizado y que la base del script proviene de ProjectWizards.
Para modificar este u otros ejemplos de AppleScript, consulte el documento Scripting Merlin Project. Encontrará allí diversos ejemplos y fragmentos de código listos para usar. Este documento está en inglés.
Si tiene alguna pregunta sobre este artículo del blog o desea debatirlo, esperamos su contribución en nuestro foro.
