Integración de aplicaciones de terceros en AEM Forms Workspace integrating-third-party-applications-in-aem-forms-workspace

CAUTION
AEM 6.4 ha llegado al final de la compatibilidad ampliada y esta documentación ya no se actualiza. Para obtener más información, consulte nuestra períodos de asistencia técnica. Buscar las versiones compatibles here.

AEM Forms Workspace admite la administración de las actividades de asignación y finalización de tareas en formularios y documentos. Estos formularios y documentos pueden ser formularios XDP, formularios de Flex® o guías (obsoletos) que se han procesado en los formatos XDP, PDF, HTML o Flex.

Estas capacidades se han mejorado aún más. AEM Forms admite ahora la colaboración con aplicaciones de terceros compatibles con funcionalidades similares a las de AEM Forms Workspace. Uno de los aspectos comunes de estas funcionalidades son los flujos de trabajo de asignación y posterior aprobación de tareas. AEM Forms proporciona una experiencia unificada única para los usuarios empresariales de AEM Forms, de forma que todas estas asignaciones de tareas o aprobaciones para las aplicaciones compatibles se puedan administrar a través de AEM Forms Workspace.

Por ejemplo, consideremos Administración de correspondencia como el candidato de muestra para la integración con AEM Forms Workspace. Administración de correspondencia incluye el concepto de "carta", la cual puede procesarse y permite realizar acciones.

Crear recursos de Administración de correspondencia create-correspondence-management-assets

Comience creando una plantilla de Administración de correspondencia de ejemplo que se procese en AEM Forms Workspace. Para obtener más información, consulte Creación de una plantilla de carta.

Acceda a la plantilla de Administración de correspondencia en su URL para comprobar que se puede procesar correctamente. La URL tiene un patrón similar al siguiente: https://[server]:[port]/lc/content/cm/createcorrespondence.html?cmLetterId=encodedLetterId&cmUseTestData=1&cmPreview=0;,

donde encodedLetterId es el ID de carta con codificación URL. Especifique el mismo ID de carta a la hora de definir el proceso de representación para la tarea de Workspace en Workbench.

Creación de una tarea para procesar y enviar una carta en AEM Workspace create-a-task-to-render-and-submit-a-letter-in-aem-workspace

Antes de ejecutar estos pasos, asegúrese de que es miembro de los siguientes grupos:

  • cm-agent-users
  • Workspace Users

Para obtener más información, consulte Adición y configuración de usuarios.

Siga estos pasos para crear una tarea para procesar y enviar una carta en AEM Workspace:

  1. Inicie Workbench. Inicie sesión en localhost como administrador.

  2. Haga clic en Archivo > Nuevo > Aplicación. En el campo Nombre de la aplicación, introduzca CMDemoSample y, a continuación, haga clic en Finalizar.

  3. Seleccione CMDemoSample/1.0 y haga clic con el botón derecho en NewProcess. En el campo de nombre, introduzca CMRenderer y, a continuación, haga clic en Finalizar.

  4. Arrastre el selector de actividades de Punto de inicio y configúrelo:

    1. En Datos de presentación, seleccione Usar un recurso CRX.

      Usar-recurso-CRX

    2. Busque un recurso. En el cuadro de diálogo Seleccionar recurso de formulario, la pestaña Cartas muestra todas las cartas del servidor.

      lettertab

    3. Seleccione la carta adecuada y haga clic en Aceptar.

  5. Haga clic en Administrar perfiles de acción. Aparecerá el cuadro de diálogo Administrar perfil de acción. Asegúrese de que las opciones Procesar y Enviar procesos están correctamente seleccionadas.

  6. Para abrir la carta con un archivo XML de datos, busque y seleccione el archivo de datos correspondiente en el Proceso de preparación de datos.

  7. Haga clic en Aceptar.

  8. Defina las variables para la salida del punto de inicio y los archivos adjuntos de la tarea. Las variables definidas contendrán los datos de salida del punto de inicio y los datos de los archivos adjuntos de la tarea.

  9. (Opcional) Para agregar otro usuario al flujo de trabajo, arrastre un selector de actividades, configúrelo y asígnelo a un usuario. Escriba un contenedor personalizado (a continuación se muestra un ejemplo) o descargue e instale el DSC (el cual aparece más abajo) para la plantilla de carta exacta, la salida del punto de inicio y los archivos adjuntos de la tarea.

    A continuación, se muestra un ejemplo de contenedor personalizado:

    code language-java
    public LetterInstanceInfo getLetterInstanceInfo(Document dataXML) throws Exception {
    try {
    if(dataXML == null)
    throw new Exception("dataXML is missing");
    
    CoreService coreService = getRemoteCoreService();
    if (coreService == null)
    throw new Exception("Unable to retrive service. Please verify connection details.");
    Map<String, Object> result = coreService.getLetterInstanceInfo(IOUtils.toString(dataXML.getInputStream(), "UTF-8"));
    LetterInstanceInfo letterInstanceInfo = new LetterInstanceInfo();
    
    List<Document> attachmentDocs = new ArrayList<Document>();
    List<byte[]> attachments = (List<byte[]>)result.get(CoreService.ATTACHMENT_KEY);
    if (attachments != null){
    for (byte[] attachment : attachments)
    { attachmentDocs.add(new Document(attachment)); }
    
    }
    letterInstanceInfo.setLetterAttachments(attachmentDocs);
    
    byte[] updateLayout = (byte[])result.get(CoreService.LAYOUT_TEMPLATE_KEY);
    if (updateLayout != null)
    { letterInstanceInfo.setLetterTemplate(new Document(updateLayout)); }
    
    else
    { throw new Exception("template bytes missing while getting Letter instance Info."); }
    
    return letterInstanceInfo;
    } catch (Exception e)
    { throw new Exception(e); }
    
    }
    

    Obtener archivoDSCSample.zip
    Descargar DSC: hay disponible un DSC de ejemplo en el archivo adjunto anteriormente. Descargue y descomprima el DSCSample.zip archivo. Antes de utilizar el servicio DSC, debe configurarlo. Para obtener más información, consulte Configuración del servicio DSC.

    En el cuadro de diálogo Definir actividad, seleccione la actividad adecuada, como getLetterInstanceInfo, y haga clic en Aceptar.

  10. Implemente la aplicación. Si se le solicita, inicie sesión y guarde los recursos.

  11. Inicie sesión en el espacio de trabajo de formularios AEM en https://[server]:[port]/lc/content/ws.

  12. Abra la tarea que ha agregado, CMRenderer. Aparecerá la carta de Administración de correspondencia.

    cminworkspace

  13. Rellene los datos necesarios y envíe la carta. La ventana se cierra. En este proceso, la tarea se asigna al usuario especificado en el flujo de trabajo en el paso 9.

    note note
    NOTE
    El botón Enviar no está habilitado hasta que no se rellenan todas las variables obligatorias de la carta.
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da