Blocs de création

Les blocs de création constituent la base d’une solution. Ce sont des modules personnalisables à volonté, réutilisables et extensibles, qui définissent les fonctionnalités d’une solution. Ils permettent d’exploiter les services hébergés par CRX. Ils exposent également des composants UX basés sur Flex et des API réutilisables dont les développeurs peuvent se servir pour personnaliser la solution.

La solution Correspondence Management contient trois blocs de création :

  • le bloc de création Asset Composer ;

  • le bloc de création Data Dictionary ;

  • le bloc de création Expression Manager.

Les blocs de création sont des fonctionnalités du produit spécifiques à la solution accompagnées d’une documentation technique, propre à chaque bloc de création, qui en explique l’utilisation pour les applications de production.

    Structure du bloc de création

    Les blocs de création Correspondence Management sont fournis sous forme de package CRX que vous pouvez décompresser dans n’importe quel répertoire d’installation. Chacun des packages CRX appartient à l’une des catégories suivantes :

    • Packages de plateforme : packages contribuant à l’ensemble de la plateforme Adobe Enterprise.

    • Packages de blocs de création : packages contribuant à l’ensemble des blocs de création utilisés par les partenaires pour faciliter la conception de solutions personnalisées.

    • Packages de modèles de solution : packages de composants de démonstration d’une solution cible. Ces packages reposent sur les blocs de création déjà déployés sur le serveur LiveCycle.

    • Packages d’installation unique de solution : ils comprennent un modèle de solution et un ensemble de blocs de création regroupés dans un même package CRX.

      Bloc de création Asset Composer

      Le bloc de création Asset Composer fait partie de la solution Correspondence Management, disponible avec Adobe LiveCycle Enterprise Suite 3 (ES3). Il offre des fonctionnalités de base de création et de gestion des actifs tels que du texte, des images, des modules de liste et des modules conditionnels. Il permet également la définition et le rendu d’une correspondance.

        Composants du bloc de création Asset Composer

        Le bloc de création Asset Composer est déployé sous forme de package LiveCycle avec des lots OSGI. Les services du bloc de création sont enregistrés en tant que services OSGi.

        Services de persistance

        Le composant de services de persistance (Persistence) fournit au modèle d’objet et aux API les actifs individuels (catégorie, module de données, mise en page, mise en page de fragment, lettre, document et portfolio) interagissant avec les API côté serveur du contenu LiveCycle. Les services facilitent les opérations de type CRUD (création, lecture, mise à jour et suppression) et les autres API utilitaires, comme la publication, pour récupérer la liste de dépendances et télécharger le contenu d’un actif.

        Service de rendu

        Le service de rendu (Render) est un composant côté serveur permettant le rendu d’une lettre, d’un portfolio ou d’un package en fonction d’une instance de données ou d’un modèle de lettre ou de portfolio. Il fournit également des fonctionnalités de post-traitement de ces modèles à l’aide de l’intégration à des services Web externes.

        Modules Web

        Ce composant est constitué d’artefacts associés au calque Web, tels que des servlets et d’autres services connexes.

        Ce composant inclut les services suivants :

        • Submit : cette servlet soumet les données XML et le rendu PDF au service post-processus sélectionné pour un modèle de lettre ou de portfolio. Avant l’envoi, elle appelle LetterRenderService pour effectuer le rendu de la lettre avec les données XML correspondantes, envoyées par l’application de création de correspondance. La servlet appelle ensuite les API ServiceInvoker pour envoyer le fichier PDF et les données XML au post-processus.

        • FlexConfigurationService : ce service utilitaire permet aux applications client d’accéder aux propriétés configurées spécifiques à l’application Web hôte, par exemple le contexte Web et les mappages de servlet.

        • ExternalDataUtil : ce service permet la connexion à diverses sources de données, en enregistrant les gestionnaires d’URL appropriés. Les protocoles Java standard et le protocole crx:// sont pris en charge pour l’accès au contenu du référentiel CRX.

        Création de correspondance

        L’application de création de correspondance se compose de plusieurs composants Flex dans le bloc de création Asset Composer. Cette application se compose de modèles de présentation, de modèles de domaines, de lots de ressources et de fichiers SWC de style que vous pouvez étendre de manière à créer une expérience personnalisée.

        Bloc de création Data Dictionary

        Le bloc de création Data Dictionary repose sur la technologie de modélisation de l’application Adobe, qui permet une représentation indépendante des métadonnées et une intégration en arrière-plan. Les métadonnées, dans le contexte de la solution, représentent les descriptions des structures de données et des attributs qui y sont associés. C’est pourquoi un dictionnaire de données correspond à un catalogue d’objets de domaines spécifiques et des définitions qui y sont associées. Le bloc de création Data Dictionary permet aux utilisateurs en entreprise d’utiliser les modèles à un niveau de solution. Ils peuvent également créer des dictionnaires de données de domaines spécifiques ou améliorer les artefacts sans qu’une intégration de données ne soit nécessaire en arrière-plan. Par exemple, un dictionnaire de données d’assurance peut contenir des éléments de dictionnaire de données tels que l’âge, l’admissibilité, le montant d’un prêt, etc. Les modèles de dictionnaires de données peuvent être développés et exportés facilement dans un modèle d’application étendu pour ensuite être importés dans des systèmes de production.

          Composants du bloc de création Data Dictionary

          Le bloc de création Data Dictionary est constitué de clients et de services qui se connectent au système en arrière-plan.

          Clients du bloc de création Data Dictionary

          Les clients Data Dictionary comprennent notamment :

          • Les clients Java du dictionnaire de données (adobe-dct-client.jar). Les clients Java comprennent les objets de valeur côté serveur, les API de service et les classes d’exception nécessaires à tout code personnalisé pour le bloc de création.

          • Le client Flex du dictionnaire de données (adobe-dct-flex-services.swc). Le client Flex comprend divers objets de valeur ActionScript, des API Flex du service Data Dictionary, des événements et la gestion des erreurs.

          • Les composants de l’interface utilisateur du bloc de création Data Dictionary. Les composants de l’interface utilisateur du bloc de création Data Dictionary (Editeur du dictionnaire de données et Panneau des éléments de données) utilisent les services Data Dictionary pour interagir avec le référentiel en arrière-plan.

            • Editeur du dictionnaire de données : l’interface utilisateur de l’administrateur pour la création et la modification d’un dictionnaire de données, ses propriétés et éléments. Dans les vues Définition et Propriétés, vous pouvez associer la valeur de diverses propriétés aux éléments du dictionnaire de données. Il vous est également possible d’associer les métadonnées à un dictionnaire de données et à chacun de ses éléments en ajoutant des propriétés étendues.

            • Panneau des éléments de données : interface utilisateur pour la création de DDE et de variables d’espace réservé qui sont affichés dans un tableau et dans une arborescence. Vous pouvez également effectuer des recherches en direct sur le nom d’affichage pour un DDE.

          Services du bloc de création Data Dictionary

          Les services du bloc de création Data Dictionary sont exposés en tant que beans Spring. Voici la liste des beans fournis dans le bloc de création Data Dictionary :

          • DataDictionaryRegistryService : ce service permet des opérations de création, de mise à jour et de suppression pour le bloc de création Data Dictionary.

          • DataDictionaryUtilService : ce service fournit les fonctions utilitaires du dictionnaire de données.

          • Le service d’évaluation d’expression : ce service est un composant réutilisable qui se sert des bibliothèques et de la syntaxe du langage d’expression standard pour l’évaluation d’expression. Ce composant dispose d’API côté serveur pour l’évaluation d’expression sur le serveur et d’un équivalent côté client destiné à l’évaluation d’expression sur le client.

          Couche d’intégration en arrière-plan

          Le composant côté serveur de Platform Content expose les opérations et API devant interagir avec le référentiel sous-jacent contenant les actifs. Le composant de services pour le bloc de création Asset Composer encapsule les API pour les actifs individuels interagissant avec les API côté serveur de Platform Content. Le composant côté serveur de Platform Content facilite les opérations et les autres API utilitaires telles que la liste des dépendances d’un actif et le téléchargement des octets de contenu pour un actif.

          Développement à l’aide du bloc de création Data Dictionary

          Développer une solution comportant un dictionnaire de données implique généralement l’utilisation des outils suivants :

          1. L’éditeur du dictionnaire de données : interface utilisateur permettant la création et la maintenance du dictionnaire de données et fournie avec ce bloc de création.

          2. Les outils de développement Java :

            • environnement de développement intégré pour la création de projets Java/Spring ;

            • outils de génération ANT.

          3. Outils LiveCycle :

            • Adobe® Flash® Builder™

          Exemples de dictionnaires de données

          Vous pouvez personnaliser votre dictionnaire de données en fonction de vos besoins. Le Guide technique du bloc de création Data Dictionary contient les exemples suivants :

          Pour plus d’informations, voir Présentation des actifs du bloc de création Data Dictionary.

          Bloc de création Expression Manager

          Le bloc de création Expression Manager offre la possibilité d’évaluer les expressions du côté serveur et du côté client. L’évaluation de l’expression côté client est réalisée en utilisant la bibliothèque du client Expression Manager qui interprète l’expression à l’exécution, sans aller-retour avec le serveur.

          Par défaut, Expression Manager utilise les bibliothèques et la syntaxe du langage EL (Expression Language) standard, mais il offre également la possibilité de se connecter à toute autre base de règles.

            Composants du bloc de création Expression Manager

            Un service d’évaluation d’expression nécessite une instance du résolveur de variable pour récupérer les valeurs de variables. En règle générale, une expression a besoin d’un module de mappage de fonction pour récupérer les définitions de fonctions dans la bibliothèque. Le résolveur de variable d’élément de dictionnaire de données est nécessaire à la connexion au dictionnaire de données.

            • Variable Resolver : résolveur de variable permettant de récupérer la valeur des variables utilisées dans les expressions par la bibliothèque d’évaluation d’expression.

            • Function Mapper : mappeur de fonction fournissant les définitions des fonctions personnalisées utilisées dans les expressions.

            • DDE Variable Resolver : résolveur de variable d’élément de dictionnaire de données utilisé pour résoudre les valeurs des éléments de dictionnaire de données.

            Le bloc de création Expression Manager peut être divisé en deux modules : l’évaluation des expressions côté serveur et de celles côté client.

            Evaluation d’expression côté serveur

            Le module d’évaluation d’expression côté serveur offre la possibilité d’évaluer les expressions du côté serveur. Le service Expression Evaluator est l’élément de base du module d’évaluation d’expression côté serveur. Il fournit des API pour l’évaluation et la validation des expressions. Les expressions peuvent être évaluées en mode unique ou par lots. Ce composant agit comme une enveloppe pour la bibliothèque d’évaluation des expressions (EL JSP). La tâche d’évaluation d’expression en tant que telle est déléguée à la bibliothèque d’expressions.

            Evaluation d’expression côté client à l’aide de Flex

            Le module d’évaluation d’expression côté client offre la possibilité d’évaluer les expressions dans une application cliente Flex, sans aller-retour avec le serveur. Le gestionnaire d’expression Flex peut interpréter et évaluer les expressions conformes au langage EL JSP. L’interface IExpressionManager constitue le point d’entrée pour l’évaluation d’expression côté client. Les applications de traitement des données doivent transmettre une expression conforme au langage EL JSP. Le gestionnaire d’expression côté client nécessite un résolveur de variable et un module de mappage de fonction pour résoudre les appels de fonctions et références de variables dans les expressions.