Prezeráte obsah pomocníka verzie:

Overview

Using the Create Correspondence UI of Correspondence Management, you can save drafts of letter instances under progress and there are submitted letter instances.

Correspondence Management provides you APIs using which you can build the listing interface to work with submitted letter instances or drafts. The APIs list and open submitted and draft letter instances of an agent, so that the agent could continue working on the draft or submitted letter instances.

Fetching letter instances

Correspondence Management exposes APIs to fetch letter instances through the LetterInstanceService service.

Method

Description

getAllLetterInstances

Fetches letter instances based on the input query parameter. To fetch all letter instances, pass the query parameter as null.

getLetterInstance

Fetches the specified letter instance based on letter instance Id.

letterInstanceExists

Checks if a LetterInstance exists by the given name. 

Poznámka:

LetterInstanceService is OSGI service and its instance can be retrieved by using @Reference in Java
Class or sling.getService(LetterInstanceService. Class ) in JSP.

Using getAllLetterInstances

The following API finds the letter instances based on the query object (both Submitted and Draft). If query object is null then, it returns all the letter instances. This API returns list of LetterInstanceVO objects, which can be used for extracting additional information of letter instance 

SyntaxList getAllLetterInstances(Query query) throws ICCException;

Parameter Description
query The query parameter is used to find/filter Letter instance. Here query supports only top-level attributes/properties of the object. Query consists of statements and the "attributeName" used in the Statement object should be the name of the property in the Letter instance object.

Example 1: Fetch all the letter instances of type SUBMITTED

The following code returns the list of submitted letter instances. To get only drafts, change the LetterInstanceType.COMPLETE.name() to 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);

Example 2: Fetch all the letter instances submitted by a user and letter instance type is DRAFT

The following code has multiple statements in the same query to get the results filtered based on different criteria such as letter instance submitted (attribute submittedby) by a user and type of letterInstanceType is DRAFT.

@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);

Using getLetterInstance

Fetch the letter instance identified by the given letter instance id. It returns null if instance id is not matched.

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

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

Verifying if LetterInstance exist

Check if a Letter Instance exists by the given name 

Syntaxpublic Boolean letterInstanceExists(String letterInstanceName) throws ICCException;

Parameter Description
letterInstanceName Name of letter instance that you want to check if it exists.
@Reference
LetterInstanceService letterInstanceService;
String letterInstanceName = "sampleLetterInstance";
Boolean result = letterInstanceService.letterInstanceExists(letterInstanceName );

Opening letter instances

Letter Instance can be of type Submitted or Draft. Opening both the letter instance types show different behaviors:

  • In case of Submitted letter instance a PDF representing the letter instance is opened. Submitted Letter instance persisted on the server also contains the dataXML & processed XDP, which can be used to accomplish and further custom use a case such as creating a PDF/A.
  • In case of Draft letter instance, the create correspondence UI is reloaded to exact previous state as it was during the time when draft was created
     

Opening Draft Letter Instance 

CCR UI support the cmLetterInstanceId parameter, which can be used to reloaded letter.

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

Poznámka:

You do not have to specify the cmLetterId or cmLetterName/State/Version when reloading a correspondence, as the submitted data already contains all the details about the correspondence that is reloaded. RandomNo is used to avoid browser cache issues, you can use timestamp as a random number.

Opening submitted letter instance

Submitted PDF can be directly opened using letter instance Id:

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

Licencia na používanie tohto diela sa poskytuje v súlade s podmienkami licencie Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Na príspevky v sociálnych sieťach Twitter™ a Facebook sa nevzťahujú podmienky licencií Creative Commons.

Právne upozornenia   |   Zásady ochrany osobných údajov online