Le mois dernier je vous ai présenté ma classe d'abstraction pour faire communiquer SAP et Word en utilisant les liens OLE. Bien que j'adore cette méthode pleine de poésie, ce n'est pas très rapide ni pratique pour générer de gros ou nombreux documents. J'ai donc du réfléchir à une autre méthode : créer des fichiers DOCX directement sans utiliser Microsoft.

Afin de pouvoir transformer rapidement mes différents projets clients utilisant l'ancienne classe, j'en ai repris l'interface : les méthodes portent le même nom et utilisent les mêmes paramètres (autant que possible)

Je vous livre donc cette nouvelle classe d'abstraction qui permet de générer un fichier DOCX directement en ABAP. Contrairement aux différents projets balbutiants et aux tutos que j'ai pu voir sur le net, ici la prise en main est ultra simple : un document "hello world" se génère en quelques lignes !

Code pour générer un DOCX Hello World en ABAP

Sont gérés par la classe :

• Création de document vierge ou via template (docx/docm/dotx/dotm)
• Écriture de texte avec ou sans style (style de paragraphe et/ou de police)
• Option bold, italique, souligné, barré, indice, exposant, petite majuscules, choix de police et taille, couleur, surlignage, espacement de caractères
• Gestion de l'alignement, de l'indentation, du retrait, des espaces avant et après le paragraphe, de l'interligne, des bordures de paragraphe et couleur de fond
• Saut de ligne, de page, de section et section continue
• Écriture de tableau avec ou sans style de tableau (et possibilité de définir des option de formatage par cellule : gras, couleur...)
• Écriture d’entête/pied de page simples
• Gestion de l'orientation (portrait/paysage) et des bordures de page
• Insertion d'image
• Insertion de note de bas de page ou de fin de document
• Insertion de commentaires
• Insertion de dessin (canvas)
• Insertion de table des matières
• Insertion de libellés numérotés (figure, table...)
• Insertion de table de libellés (figures, tables...)
• Insertion de propriété de document et de champs personnalisés (custom fields)
• Mise à jour des propriétés de document
• Création de style (caractère, paragraphe)
• Prise en charge des images/templates dans le SAP Web Repository (SAPWR via la stransaction SMW0)
• Pour les utilisateurs avancées ayant des besoins non gérés, possibilité d'inclure un fragment XML de votre composition dans le document en cours

Pour le téléchargement, je livre un programme de démo de la classe qui montre comment l'utiliser. Le zip contient :

• Le package NUGG avec programme de démo et classe dans un "include" séparé
• Un template word et 3 images utilisés par le programme démo
• Un fichier TXT contenant la classe pour ceux qui veulent jeter un oeil au code sans saplink

Prochainement, un cas d'usage sur BW...

Cela fait des années que je pratique cette méthode de communication, pour des petites "bidouilles" entre SAP et Microsoft. C'est rapide et ludique (j'adore voir Word se remplir tout seul, c'est "magique", un peu comme quand je regarde un piano automatique dont les touches s'enfoncent seules lorsqu'il joue).

Enfin rapide... une fois qu'on a réussi a trouver les bonnes commandes ! Car c'est assez galère à programmer :

• commande obscure
• pas ou peu de documentation ou d'exemple
• de nombreuses questions sur le net, mais les réponses sont rares

Cette fois j'ai eu un gros besoin. Je devais générer un document complet, sous word, à partir de tonnes de données SAP. Prenant mon courage à 2 mains, j'ai de nouveau déguainé OLE, et pour que ca soit réutilisable, j'en ai fait une classe d'abstraction.

En utilisant ma classe, fini la galère, vous avez juste a l'inclure en début de votre programme, et ensuite de simples appels aux méthod write_text ou write_table vont vous permettre de remplir votre document... magiquement !

Sont gérés par la classe :

• Création de document vierge ou via template dotx
• Ecriture de texte avec ou sans style (style de paragraphe et/ou de police)
• Option bold, italique, souligné, choix de police et taille, couleur
• Saut de ligne, de page, de section et section continue
• Ecriture de tableau avec ou sans style de tableau (et possibilité de définir des option de formatage par cellule : gras, couleur...)
• Note de bas de page
• Ecriture d'entete/pied de page simples
• Gestion de l'orientation (portrait/paysage)
• Insertion d'image
• Insertion de dessin (canvas)
• Insertion de table des matières
• Insertion de champs personnalisés (custom fields)
• Mise a jour du titre de la fenetre word
• Sauvegarde du document et fermeture de word

A l'usage, je me suis malgré tout rendu compte que la génération était assez longue (5 à 10 minutes pour un document de 50 pages). Ce sont les tableaux qui sont particulièrement lents.

Et donc finalement j'ai du changer de méthode pour mon projet, mais je publie malgré tout cette classe car elle est pleinement fonctionnelle, et pourra toujours vous servir de "how to" sur vos petits besoins OLE :)

Pour le téléchargement, je livre un programme de "test" de la classe qui montre comment l'utiliser. Le zip contient également un template, et quelques images qui sont utilisées par le programme test.

Après ZAL11 il était temps de dépoussiérer ZSPRO, qui passe de la version 1.05 à 2.1
Au menu des nouveautés on trouve :

• Réécriture complète du code pour permettre de gérer de nouveaux type d'entrées
• Gestion des entrées de type transaction, module fonction, URL et activité IMG
• Meilleur affichage de la doc des programmes
• Suivi des liens dans les docs
• Meilleur gestion du transport des noeuds
• Export de l'arborescence en XML
• Small Bug fix

Le lien de téléchargement est disponible sur la fiche principale de l’outil : ZSPRO - la boite à outils

Attention : le changement de structure de l'arborescence rend incompatible cette nouvelle version avec l'ancienne. Il faudra prévoir de refaire les noeuds (perte des noms de table/programme) ou prévoir un petit abap de conversion.

Merci à Mathieu pour m'avoir relancé dessus ;-)

ZAL11 a un peu évolué depuis la dernière version mise en ligne (1.4.1).

La nouvelle version est estampillée 2.1, rien que çà. C'est dire si les nouveautés sont nombreuses :

• Gestion des serveurs SAP sous windows
• Répertoire "bureau"
• Possibilité de glisser des fichiers/répertoires vers l'arborescence de répertoires et plus seulement vers la grille ALV.
• Simplification de la personnalisation : tous les paramètres ont été mis au début du programme
• Affichage du propriétaire des fichiers
• Calcul de la taille des répertoires (automatique ou a la demande)
• Choix du nom lors de la création d'un répertoire
• Affichage de liens vers les répertoires système
• Acces a des serveurs distants (//serveur/chemin/) par copier coller d'adresse
• Réécriture de la gestion des commandes serveurs pour permettre plus de souplesse
• Correction d'erreurs
• Nettoyage du code

Le lien de téléchargement est disponible sur la fiche principale de l'outil : ZAL11 - L'explorateur de fichiers

Le travail sur un datawarehouse nous confronte régulièrement à des injections de fichier. Et sur SAP, nous ne sommes pas gâté niveau outils...
J'entendais souvent mes collègues râler à propos de la transaction AL11, la seule chose dont nous disposons en standard pour naviguer sur le serveur SAP.

J'ai parcouru la toile à la recherche d'une solution de remplacement mais ne fut pas convaincu par ce que j'y ai trouvé, aussi j'ai pris mon courage (et mon clavier) à deux mains afin de réaliser ma propre solution : plus complète, plus lisible et avec l'ergonomie qui me sied (mais je ne crache pas dans leur soupe, j'ai d'ailleurs repris leur manière de déterminer l'icone relatif a chaque type de fichier).

ZAL11 display local and server file explorer

Entièrement graphique, le programme "ZAL11" (tout simplement ;-) ) vous permettra de naviguer sur le serveur SAP, mais également :

• D'ouvrir les fichiers avec votre application par défaut sur votre PC (excel pour les CSV par exemple)
• D'ouvrir les fichiers avec un éditeur de texte sur votre PC
• De télécharger ou télédécharger des fichiers
• De gérer les fichiers/répertoires du serveur (ajout, copie, déplacement, renommage)
• De compresser (tar+bz2) ou décompresser (zip, tar, gz, bz2) des fichiers et répertoires sur le serveur
• De copier dans le presse-papier le chemin d'un fichier sur le serveur, ou d'accéder directement au répertoire d'un chemin contenu dans le presse-papier.

La gestion des raccourcis serveur de AL11 est conservée (et débuggée ;-) )
Vu qu'il s'agit de manipulation sur le serveur, chaque action demande une confirmation via un popup qui récapitule ce qui est en train d'être fait.

ZAL11 File and folder context menu

Le code a été écrit dans une optique de sécurité, de maintenabilité et de respect des normes de développement usuels. Il est entièrement documenté en anglais (25% de commentaires ajoutés par rapport au code brut).
La principale "entorse" aux règles est que le code est fourni dans un seul pavé de 3500 lignes au lieu d'être découpé en includes (top, class, pbo, pai, form). C'est volontaire afin de n'avoir qu'un seul code source à fournir. Néanmoins chaque partie est clairement délimitée et il ne devrait pas falloir plus d'une minute à un développeur pour recréer les includes nécessaires. Pour la même raison de simplicité de partage, aucune classe de message n'a été créée.

A noter : n’oubliez pas que vous aurez besoin de SAPLINK pour installer le programme.