API para acceder a instancias de carta

Información general

Mediante la interfaz de usuario Crear correspondencia de la administración de correspondencia, puede guardar borradores de instancias de cartas en curso y se envían instancias de cartas.

Correspondence Management le proporciona API que permiten crear la interfaz de listado para trabajar con las instancias de cartas enviadas o los borradores. La lista de API y las instancias de carta de borrador y envío abiertas de un agente, de modo que el agente pueda continuar trabajando en las instancias de carta de borrador o envío.

Obteniendo instancias de letras

Correspondence Management expone a las API a recuperar instancias de letras a través del servicio LetterInstanceService.

Uso de getAllLetterInstances

La siguiente API busca las instancias de letras basadas en el objeto de consulta (tanto Enviada como Borrador). Si el objeto de consulta es nulo, devuelve todas las instancias de letras. Esta API devuelve la lista de objetos LetterInstanceVO, que se pueden utilizar para extraer información adicional de la instancia de letra

Sintaxis: List getAllLetterInstances(Query query) throws ICCException;

Ejemplo 1: Buscar todas las instancias de letras de tipo ENVIADO

El siguiente código devuelve la lista de instancias de cartas enviadas. Para obtener solo borradores, cambie LetterInstanceType.COMPLETE.name() a 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);

Ejemplo 2: Buscar todas las instancias de letras enviadas por un usuario y el tipo de instancia de letra es DRAFT

El siguiente código tiene varias afirmaciones en la misma consulta para que los resultados se filtren en función de diferentes criterios como la instancia de carta enviada (atributo enviado por) por un usuario y el tipo de letterInstanceType es 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);

Uso de getLetterInstance

Recupere la instancia de letra identificada por la identificación de instancia de letra dada. Devuelve "null si no coincide la identificación de instancia.

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

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

Comprobando si LetterInstance existe

Comprobar si existe una instancia de carta con el nombre dado

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

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

Abrir instancias de carta

La instancia de carta puede ser del tipo Enviado o Borrador. La apertura de ambos tipos de instancias de letras muestra diferentes comportamientos:

• En el caso de la instancia de carta enviada, se abre un PDF que representa la instancia de carta. La instancia de carta enviada que persiste en el servidor también contiene el archivo dataXML y XDP procesado, que se puede utilizar para realizar y utilizar un caso personalizado como crear un archivo PDF/A.
• En el caso de la instancia de borrador de carta, la interfaz de usuario de creación de correspondencia se vuelve a cargar con el estado anterior exacto, tal como era durante el tiempo en que se creó el borrador

Abrir instancia de letra borrador 

La interfaz de usuario de CCR admite el parámetro cmLetterInstanceId, que se puede utilizar para volver a cargar la letra.

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

Abriendo instancia de carta enviada

El PDF enviado se puede abrir directamente con el identificador de instancia de la carta:

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