Deprecated feature

Création d'un fichier get-data-config.xml

Vous pouvez utiliser des balises getData et des demandes de service associées au processus après avoir créé un fichier get-data-config.xml. Le fichier get-data-config.xml contient des générateurs d'expression, chacun représentant une requête SQL différente définie dans le fichier de modèle de requête du projet. Les balises getData dans les fichiers JSP de la vitrine peuvent récupérer des données spécifiques à partir de la base de données en faisant référence au générateur d'expression approprié.

Pourquoi et quand exécuter cette tâche

Exécutez cette tâche pour créer un module de service lorsque le fichier de configuration ne vous a pas été fourni. Si vous voulez modifier le comportement d'un module de service déjà prêt à l'emploi, vous devez néanmoins étendre le fichier de configuration fourni.

Procédure

  1. Créez le fichier get-data-config.xml pour le projet.
    • Ouvrez HCL Commerce Developer et basculez vers la vue vue Explorateur d'entreprise.
    • Depuis la vue Explorateur de projets, développez YourProject > WebContent > WEB_INF > config.

      YourProject correspond au projet exécutant votre code via la balise getData.

    • Cliquez avec le bouton droit de la souris sur config et sélectionnez Nouveau > Dossier.
    • Dans la zone Nom du dossier, entrez com.mycompany.commerce.project et cliquez sur Terminer.
    • Si le dossier com.mycompany.commerce.project n'est pas visible, cliquez avec le bouton droit de la souris sur le répertoire config dans le vue Explorateur d'entreprise puis cliquez sur Actualiser.
    • Cliquez à l'aide du bouton droit de la souris sur le dossier com.mycompany.commerce.project et sélectionnez Nouveau > Fichier .
    • Dans la zone Nom de fichier, entrez get-data-config.xml, puis cliquez sur Terminer. Le fichier get-data-config.xml que vous venez de créer s'ouvre automatiquement.
  2. Insérez vos générateurs d'expression associés au projet dans le fichier get-data-config.xml.
    Chaque générateur d'expression comporte les propriétés suivantes :
    • Le noeud name identifie de manière unique le générateur d'expression et est utilisé par les balises getData dans les pages JSP du projet pour référencer un générateur d'expression.
    • Le noeud data-type-name contient le type de nom renvoyé par le générateur d'expression.
    • Le noeud expression template fait référence à une requête XPath définie dans le fichier de modèle de requête du projet, et qui est utilisée pour extraire des informations spécifiques depuis la base de données. Des paramètres tels que $projectID$ peuvent être transmis au générateur d'expression par une balise getData.
    • Chaque noeud param contient une paire de noeuds de name et value qui définissent un paramètre transmis au fichier modèle de requête. Chaque générateur d'expression est associé à un profil d'accès spécifique. Ce profil d'accès, de pair avec la requête XPath définie, identifie de manière unique une requête dans le fichier modèle de requête.
    Chaque générateur d'expression doit s'apparenter à l'exemple de structure suivant, en remplaçant les noeuds vides par vos propres générateurs d'expression associés au projet :
    
    <!-- Project related expression builder 1. -->	
    <expression-builder>
    		<name> </name>
    		<data-type-name> </data-type-name>
    		<expression-template> </expression-template>
    		<param>
    			<name> </name>
    			<value> </value>
    		</param>
    	</expression-builder>
    
    <!-- Project related expression builder 2. -->
    <expression-builder>
    		<name> </name>
    		<data-type-name> </data-type-name>
    		<expression-template> </expression-template>
    		<param>
    			<name> </name>
    			<value> </value>
    		</param>
    	</expression-builder>
    
    	<!-- Project related expression builder 3. -->
    <expression-builder>
    		<name> </name>
    		<data-type-name> </data-type-name>
    		<expression-template> </expression-template>
    		<param>
    			<name> </name>
    			<value> </value>
    		</param>
    	</expression-builder>
    </wcf:get-data-config>
    
    Remarque : Bien que l'exemple de structure comporte trois générateurs d'expression, vous pouvez disposer d'autant de générateurs d'expression que nécessaire.

Résultats

Après l'exécution de ces étapes, un nouveau module de service aura été créé alors que son fichier de configuration ne vous avait pas été fourni.