Présentation de l’implémentation

Si les données XML de l’application de création de correspondance sont accessibles à l’aide d’une URL directe, l’adresse cmDataUrl peut pointer directement vers cette URL hébergée. L’application de création de correspondance tente de récupérer les données XML à l’aide de cette URL et d’effectuer le rendu de la correspondance.

Les données XML peuvent également être stockées dans le référentiel CRX. Le chemin d’accès au référentiel est transmis à l’application de création de correspondance à l’aide du protocole crx://. Par exemple, si les données XML nécessaires sont stockées dans /content/correspondence/data/test.xml, l’URL permettant de lancer l’application de création de correspondance est http://<serveur>:<port>/content/cm/createcorrespondence.html?<paramètres de demande habituels>&cmDataUrl=crx://content/correspondence/data/test.xml.

Pour intégrer la source de données personnalisée à l’aide de l’implémentation d’une servlet personnalisée, vous devez procéder comme suit :

• Créez une servlet HTTP personnalisée permettant de récupérer les données XML du fournisseur de contenu. Renvoyez les données XML récupérées dans la « réponse » de la servlet.

• Lors de l’appel de l’URL de création de correspondance, définissez la valeur cmDataUrl comme URL de votre servlet.

Par exemple, si la servlet est créée dans l’application de gestion de la correspondance et qu’elle est mappée à l’URL /CustomDataUrl, l’URL de l’interface utilisateur de création de correspondance est http://<serveur>:<port>/content/cm/createcorrespondence.html?<paramètres de demande habituels>&cmDataUrl=http://<serveur>:<port>/apps/solutions/cm/CustomDataUrl.

package sample; 
 
import javax.servlet.ServletException; 
import javax.servlet.http.*; 
import java.io.*; 
 
 
public class CustomDataUrl extends HttpServlet { 
    public void doGet(HttpServletRequest request, 
             HttpServletResponse response) 
                throws ServletException, IOException 
          { 
            response.setContentType("text/xml"); 
            PrintWriter out = response.getWriter(); 
 
                // Replace the below line with an invocation to an external/legacy data source/API. 
                String xml = "<?xml version='1.0' encoding='UTF-8'?><F><P1><WCCFileNumber>9875</WCCFileNumber><SSN>3459837</SSN></P1></F>"; 
 
                // Write to the response stream 
            out.println(xml); 
            out.close(); 
          } 
 
}

Avant d’appeler l’interface utilisateur de création de correspondance, votre application de gestion de la correspondance appelle l’orchestration et capture la réponse/sortie du processus (qui est le chemin d’accès au fichier de données est indiqué ci-dessus).

Appelez l’interface utilisateur de création de correspondance en définissant la valeur de l’adresse cmDataUrl comme chemin vers le fichier renvoyé.