Utiliser les API pour accéder aux instances de lettre apis-to-access-letter-instances

Présentation overview

À l’aide de l’interface utilisateur de création de correspondance de Correspondence Management, vous pouvez enregistrer les brouillons d’instances de lettre en cours et il existe des instances de lettre envoyées.

Correspondence Management vous fournit des API à l’aide desquelles vous pouvez créer l’interface de liste pour qu’elle fonctionne avec les instances de lettre envoyées ou les brouillons. Les API répertorient et ouvrent les brouillons et les instances de lettre envoyées d’un agent, de sorte que l’agent puisse continuer de travailler sur les brouillons ou les instances de lettre envoyées.

Récupération des instances de lettre fetching-letter-instances

Correspondence Management expose les API pour récupérer les instances de lettre par le biais du service LetterInstanceService.

Utilisation de getAllLetterInstances using-nbsp-getallletterinstances

L’API suivante recherche les instances de lettre en fonction de l’objet de la requête (envoyée et brouillon). Si l’objet de la requête est nul, il renvoie toutes les instances de lettre. Cette API renvoie une liste d’objets LetterInstanceVO qui peuvent être utilisés pour extraire des informations supplémentaires relatives à l’instance de lettre.

Syntaxe  : List getAllLetterInstances(Query query) throws ICCException;

Exemple 1 : Récupérer toutes les instances de lettre de type ENVOYÉ example-fetch-all-the-letter-instances-of-type-submitted

Le code suivant renvoie la liste des instances de lettre envoyées. Pour afficher uniquement les brouillons, modifiez LetterInstanceType.COMPLETE.name() par LetterInstanceType.DRAFT.name()..

@Reference
LetterInstanceService letterInstanceService;
Query query = new Query();

List<LetterInstanceVO> submittedLetterInstances = new ArrayList<LetterInstanceVO>();

Statement statementForInstanceType = new Statement();
statementForInstanceType.setAttributeName("letterInstanceType");
statementForInstanceType.setOperator(Operator.EQUALS);
statementForInstanceType.setAttributeValue(LetterInstanceType.COMPLETE.name());
query.addStatement(statementForInstanceType);
submittedLetterInstances = letterInstanceService.getAllLetterInstances(query);

Exemple 2 : récupérer toutes les instances de lettre envoyées par un utilisateur, le type d’instance de lettre étant BROUILLON example-nbsp-fetch-all-the-letter-instances-submitted-by-a-user-and-letter-instance-type-is-draft

Le code suivant possède plusieurs instructions dans la même requête pour obtenir les résultats filtrés en fonction de différents critères tels que l’instance de lettre envoyée (attribut submittedby) par un utilisateur, le type de letterInstanceType étant BROUILLON.

@Reference
LetterInstanceService letterInstanceService;

String submittedBy = "tglodman";
Query query = new Query();

List<LetterInstanceVO> submittedLetterInstances = new ArrayList<LetterInstanceVO>();

Statement statementForInstanceType = new Statement();
statementForInstanceType.setAttributeName("letterInstanceType");
statementForInstanceType.setOperator(Operator.EQUALS);
statementForInstanceType.setAttributeValue(LetterInstanceType.COMPLETE.name());
query.addStatement(statementForInstanceType);

Statement statementForSubmittedBy = new Statement();
statementForSubmittedBy .setAttributeName("submittedby");
statementForSubmittedBy .setOperator(Operator.EQUALS);
statementForSubmittedBy .setAttributeValue(submittedBy);
query.addStatement(statementForSubmittedBy );
submittedLetterInstances = letterInstanceService.getAllLetterInstances(query);

Utilisation de getLetterInstance using-nbsp-getletterinstance

Récupérez une instance de lettre identifiée par l’ID de l’instance de lettre en question. Il renvoie « null » si l’ID de l’instance ne correspond pas.

Syntaxe : public LetterInstanceVO getLetterInstance(String letterInstanceId) throws ICCException;

@Reference
LetterInstanceService letterInstanceService;
String letterInstanceId = "/content/apps/cm/letterInstances/1001/sampleLetterInstance";
LetterInstanceVO letterInstance = letterInstanceService.getLetterInstance(letterInstanceId );

Vérification de l’existence de LetterInstance verifying-if-letterinstance-exist

Vérifiez si une instance de lettre existe selon le nom spécifié.

Syntaxe  : public Boolean letterInstanceExists(String letterInstanceName) throws ICCException;

@Reference
LetterInstanceService letterInstanceService;
String letterInstanceName = "sampleLetterInstance";
Boolean result = letterInstanceService.letterInstanceExists(letterInstanceName );

Ouverture d’instances de lettre opening-letter-instances

L’instance de lettre peut être de type Envoyé ou Brouillon. L’ouverture des deux types d’instances de lettre présente des comportements différents :

Ouverture d’une instance de lettre préliminaire  opening-draft-letter-instance-nbsp

L’interface utilisateur CCR prend en charge le paramètre cmLetterInstanceId, qui peut être utilisé pour la lettre rechargée.

https://[hostName]:[portNo]/[contextPath]//aem/forms/createcorrespondence.html?random=[randomNo]&cmLetterInstanceId=[letterInstanceId]

Ouverture d’une instance de lettre envoyée opening-submitted-letter-instance

Le PDF envoyé peut être directement ouvert à l’aide de l’ID d’instance de lettre :

https://[hostName]:[portNo]/[contextPath]/[letterInstanceId]