Nous avons récemment reçu la question suivante :
J'utilise la dernière version de Merlin Project sur Mac et j'ai créé un fichier de projet dans lequel j'ai dû saisir divers coûts de base. Je sais que Merlin Project les regroupe en coûts de base planifiés, prévus ou réels, mais mon client a demandé un rapport détaillé des coûts de base, pouvant être imprimé ou consulté dans Aperçu ou Acrobat Reader. Le rapport devrait lister tous les coûts de base du projet et exporter leurs propriétés. Est-ce possible ?
Pour répondre au besoin décrit ci-dessus, vous pouvez utiliser une solution AppleScript que nous avons développée.
Le script parcourt toutes les activités du projet, leurs affectations, pièces jointes et ressources, et extrait les coûts de base de chaque élément. Lors de l'exportation des propriétés correspondantes, il écrit un fichier texte AsciiDoc sur le Bureau. Enfin, il appelle Asciidoctor PDF pour créer un PDF à partir d'une feuille de style personnalisée.
Installation du script
- Téléchargez l'archive suivante.
- Décompressez le fichier ZIP.
- Dans le menu du Finder, accédez à Aller > Dossier personnel.
- Déplacez le dossier res-for-script dans le dossier personnel.
- Dans Merlin Project, accédez à Fichier > Actions > Afficher le dossier des scripts.
- Ouvrez le dossier nommé net.projectwizards.merlinproject.
- Déplacez le fichier de script Create Base Costs Report.scpt dans le dossier des scripts de Merlin Project.
- Double-cliquez sur le script Create Base Costs Report. Il s'ouvrira dans l'Éditeur de scripts.
- Repérez la ligne contenant property pathToAsciidoctorPDF.
- Ouvrez une fenêtre Terminal et exécutez command -v asciidoctor-pdf.
- Modifiez le pathToAsciidoctorPDF si nécessaire.
Si vous devez installer asciidoctor-pdf, suivez les instructions d'installation et modifiez le pathToAsciidoctorPDF le cas échéant.
Création du rapport de coûts de base
Ouvrez un projet comportant des coûts de base. Appelez le script Create Base Costs Report depuis le menu Fichier > Actions > … de Merlin Project.
Attendez que le script crée le fichier AsciiDoc et lance la conversion en PDF via asciidoctor-pdf. Un signal sonore indique que la conversion est terminée. Le fichier AsciiDoc .adoc et le PDF généré apparaissent tous deux sur le Bureau.
Les tableaux affichent les propriétés de coûts de base suivantes :
• Title : le nom du coût de base ainsi qu'un symbole indiquant la classe de l'élément
• Planned Amount : le montant des coûts de base planifiés
• Actual Amount : si défini, ce montant remplace le montant des coûts de base planifiés
• Type : les valeurs possibles sont issues des listes de valeurs des paramètres du projet
• Account : si défini, le nom du compte associé à ce coût
• Status : les valeurs possibles sont issues des listes de valeurs des paramètres du projet
• Added by : si défini, le nom d'une ressource
• Billable : si défini, √
• Accrue : les valeurs possibles sont : au prorata, au début, à la fin, immédiatement
La colorisation personnalisée de l'en-tête du tableau, la taille de police et l'alternance des couleurs de fond des lignes sont définies par la feuille de style YAML Asciidoctor-PDF fournie.
REMARQUE : L'option d'en-tête sur les tableaux du fichier AsciiDoc permet à Asciidoctor-PDF de répéter la ligne d'en-tête lorsque le tableau est paginé sur plusieurs pages.
La pagination des pages de tableau se fait en orientation paysage. Le PDF commence ainsi par une page de titre en portrait, bascule en paysage pour les besoins du rapport puis revient en portrait pour la page de clôture.
Vous pouvez ouvrir le fichier .adoc et le modifier pour convertir le PDF dans une deuxième étape à l'aide de vos propres feuilles de style. Si vous souhaitez utiliser votre propre feuille de style pour le PDF, placez-la simplement dans le dossier res-for-script et renommez la propriété themeName dans le script en conséquence.
Remarque sur les AppleScripts de ProjectWizards : vous pouvez intégrer ce code d'exemple de ProjectWizards dans vos programmes sans restriction. Les scripts sont fournis uniquement à des fins de démonstration. Nous vous aidons volontiers si vous avez des questions sur les scripts, mais la responsabilité de leur fonctionnement vous incombe entièrement. Vous êtes autorisé à modifier les scripts et à les redistribuer gratuitement à des tiers. Dans ce cas, indiquez clairement les modifications apportées et précisez que la base du script provient de ProjectWizards.
Pour modifier cet exemple AppleScript ou d'autres, consultez le document Scripting Merlin Project. Vous y trouverez divers exemples et extraits de code prêts à l'emploi. Ce document est rédigé en anglais.
Si vous avez des questions sur cet article de blog ou si vous souhaitez en discuter, nous attendons avec impatience votre contribution dans notre forum.
