Création de systèmes de génération de documents à partir de modèles avec Word 2010 et Word 2007

Résumé :   certains scénarios d’entreprise nécessitent la génération de nombreux documents à l’aide d’un modèle de document et d’une source de données. Cet article contient des instructions relatives à ce scénario et des liens vers des articles MSDN et des billets de blogs.

Dernière modification : lundi 9 mars 2015

S’applique à : Office 2007 | Office 2010 | Open XML | Visual Studio Tools for Microsoft Office | Word 2007 | Word 2010

Dans cet article
Création de systèmes de génération de documents à partir d’un modèle
Remplacement de contrôles de contenu par du contenu
Liaison de contrôles de contenu à du XML dans des composants XML personnalisés
Gestion d’événements lors de la manipulation de contrôles de contenu
Conclusion

Publication :   mars 2010

Auteur :Eric White (éventuellement en anglais), Microsoft Corporation

Sommaire

• Création de systèmes de génération de documents à partir d’un modèle

• Remplacement de contrôles de contenu par du contenu

• Liaison de contrôles de contenu à du XML dans des composants XML personnalisés

• Gestion d’événements lors de la manipulation de contrôles de contenu

• Conclusion

Création de systèmes de génération de documents à partir d’un modèle

Il arrive que des systèmes logiciels doivent générer automatiquement des documents afin de prendre en charge différents scénarios. La conception du système peut inclure la possibilité, pour un expert, de créer un modèle de document sur lequel repose la génération. Ce modèle doit déterminer les zones spécifiques du document devant être remplacées par du contenu généré automatiquement. Par exemple, un espace réservé dans le document doit être remplacé par une formule de salutation et le nom du destinataire de la lettre. Par ailleurs, le modèle peut identifier des sections spécifiques du document à supprimer du document généré. Par exemple, un modèle de document juridique peut inclure toutes les clauses juridiques possibles mais, sur la base de circonstances spécifiques, certaines clauses sont omises dans le document généré. La numérotation des en-têtes et des sections du document généré doit être ajustée automatiquement en conséquence.

Les contrôles de contenu conviennent parfaitement à ce scénario. Il est très facile d’inclure des contrôles de contenu grâce à l’insertion de macros à cet effet. Vous pouvez définir automatiquement le titre et l’étiquette du contrôle de contenu dans la macro, ou encore développer un complément managé qui crée un Ruban personnalisé avec des boutons permettant d’ouvrir diverses instances de contrôles de contenu. Vous pourriez par exemple avoir des boutons qui insèrent des contrôles de contenu avec un jeu spécifique de balises tels que Nom, Adresse, Téléphone et Clause_juridique.

Il est parfois nécessaire de conserver des informations secondaires relatives à chaque contrôle de contenu. Peut-être souhaiterez-vous autoriser le concepteur de documents à définir un ensemble spécifique de propriétés pour chacun d’eux. Les contrôles de contenu n’offrent pas de fonctionnalité telle qu’un attribut ou élément spécial dans le balisage pour le stockage de ces informations. Par ailleurs, l’interface utilisateur de Microsoft Word 2010 et Microsoft Office Word 2007 ne permet pas au concepteur de document de conserver des informations secondaires pour un contrôle de contenu. Il existe cependant un moyen de permettre au concepteur de document de créer et de configurer des informations associées à chaque contrôle de contenu. Pour plus d’informations sur ce processus, voir Association de données à des contrôles de contenu (éventuellement en anglais). Ce billet de blog montre un complément managé qui crée un volet Office personnalisé pour la conservation de ces informations. Ces informations secondaires sont stockées dans un composant XML personnalisé. Les informations relatives à chaque contrôle de contenu sont associées à un ID unique généré automatiquement par Word pour chaque contrôle de contenu. La figure suivante tirée de cet exemple montre un volet Office qui permet à l’auteur du contenu de définir des informations secondaires sur un contrôle de contenu.

Figure 1. Exemple de volet Office personnalisé pour la modification de données de contrôle de contenu secondaires

Lorsque vous créez un volet Office personnalisé dans une application qui utilise plusieurs fenêtres pour afficher des documents et autres éléments, vous devez prendre des mesures supplémentaires afin de vous assurer que le volet Office est visible lorsque l’utilisateur s’attend à ce qu’il le soit. L’article intitulé Managing Custom Task Panes in Multiple Application Windows décrit ce qu’il faut savoir sur le fonctionnement des volets de tâches avec les interfaces multidocuments (MDI, Multiple Document Interfaces). L’article intitulé Managing Task Panes in Multiple Word and InfoPath Documents fournit davantage de détails et un exemple de code.

Synthèse des ressources

Remplacement de contrôles de contenu par du contenu

Il existe deux approches : remplacer complètement le contrôle de contenu par le contenu ou lier le contrôle de contenu à du XML dans un composant XML personnalisé. Les sections suivantes explorent chacune de ces approches en détail.

Il peut arriver que vous souhaitiez supprimer complètement les contrôles de contenu du document généré et les remplacer par du texte ou du contenu spécifique. Les ressources suivantes fournissent des instructions et des exemples sur la façon d’implémenter ce scénario.

Synthèse des ressources

Liaison de contrôles de contenu à du XML dans des composants XML personnalisés

Une autre manière d’utiliser des contrôles de contenu pour générer des documents consiste à lier les contrôles de contenu à des données XML personnalisées. Cette approche présente un avantage : lors de la génération du document personnalisé, il n’est pas nécessaire de former de WordprocessingML pour remplacer les contrôles de contenu. Au lieu de cela, si vous débutez avec un document comportant déjà des contrôles de contenu liés à des données XML personnalisées, il vous suffit de remplacer le composant XML personnalisé par des données XML qui contiennent les données destinées au nouveau document. Les contrôles de contenu liés aux données sont mis à jour automatiquement avec les nouvelles données.

<w:sdt>
  <w:sdtPr>
    <w:alias w:val="Name"/>
    <w:tag w:val="Name"/>
    <w:id w:val="13264407"/>
    <w:dataBinding
      w:xpath="/Root/Name"w:storeItemID="{F351E99C-3283-4B75-927A-A56C9FD3BFFC}"/>
    <w:text/>
  </w:sdtPr>
  <w:sdtContent>
    <w:tc>
      <w:tcPr>
        <w:tcW w:w="4410"
               w:type="dxa"/>
      </w:tcPr>
      <w:p>
        <w:r>
          <w:t>Eric White</w:t>
        </w:r>
      </w:p>
    </w:tc>
  </w:sdtContent>
</w:sdt>

L’élément w:storeItemId contient un GUID qui indique la relation avec le composant XML personnalisé spécifique. L’élément w:xpath contient le chemin d’accès à l’élément lié dans le composant XML personnalisé.

L’une des particularités de cette approche est le fait que les contrôles de contenu restent dans le document généré, ce qui est susceptible de ne pas convenir à votre scénario.

Synthèse des ressources

Gestion d’événements lors de la manipulation de contrôles de contenu

Dans votre solution, vous souhaiterez peut-être effectuer une action spécifique lorsqu’un contrôle de contenu est inséré, supprimé ou mis à jour. Par exemple, vous pouvez écrire un gestionnaire d’événements appelé lorsque l’utilisateur se déplace hors d’un contrôle de contenu. Vous pouvez ensuite valider les données entrées par l’utilisateur.

Les événements de contrôles de contenu sont associés à l’objet Document. Vous pouvez écrire des gestionnaires pour les événements suivants.

Synthèse des ressources

Conclusion

Les systèmes de génération de documents constituent l’un des usages les plus enrichissants d’Open XML WordprocessingML. Les contrôles de contenu sont un excellent moyen de donner une structure à votre contenu et de simplifier la création de systèmes de génération de documents.