Show Menu
TEMAS×

Introducción a la personalización del espacio de trabajo de formularios de AEM

El espacio de trabajo de formularios de AEM ofrece funciones para modificar la semántica de presentación y la funcionalidad de su interfaz. A continuación se describen los tipos de personalizaciones para cambiar el estilo, el diseño, el formato, la marca y la funcionalidad básica.
Ejemplo de un espacio de trabajo personalizado

Tipos de personalizaciones

El espacio de trabajo AEM Forms admite una amplia variedad de personalizaciones para actualizar el diseño de la interfaz de usuario, su apariencia, funcionalidad y mucho más. Las personalizaciones implican actualizar una o varias de las siguientes opciones:
  • Aspectos visuales de la interfaz de usuario
  • Funcionalidad mediante personalizaciones semánticas
  • Reutilización de componentes HTML en otras aplicaciones

Cambios en la interfaz de usuario

Puede cambiar la apariencia, el diseño y otras semánticas de presentación del espacio de trabajo AEM Forms. Cambie el espacio de trabajo personalizando los archivos CSS, HTML y JavaScript™. Todos los archivos predeterminados se proporcionan en la instalación predeterminada.
Los pasos más aplicables se tratan en Pasos genéricos para la personalización del espacio de trabajo de AEM Forms. Para obtener ejemplos específicos de dichas personalizaciones, incluidos los pasos detallados, consulte los artículos relacionados al final de este artículo.

Explicación de la hoja de estilo

Antes de personalizar el espacio de trabajo, familiarícese con la hoja de estilo predeterminada que se proporciona con los AEM Forms en /libs/ws/css/style.css.
Para personalizar el espacio de trabajo, se recomienda familiarizarse con la hoja de estilo existente, style.css, ubicada en la carpeta /libs/ws/css. A continuación se describen algunos componentes destacados.
Elemento CSS
Componente de interfaz de usuario modificado
#encabezado
Encabezado del espacio de trabajo AEM Forms
.categoryList
lista de Categoría
.categoryList.header
Encabezado de lista de categoría
.categorías, .filtros
Espacio debajo de la lista de categoría
.categoría, .filter
Categoría
.categoría:pasar el ratón por encima, .categoría.seleccionada, .filter:pasar el ratón, .filter.selected
categoría seleccionada y pasar el ratón sobre el estilo de categoría
categoryListBar.tool, categoryListBar.content
Página de proceso de Inicio (lista de Categoría cerrada)
filterListBar.tool, filterListBar.content
Página Tareas pendientes (lista de filtro cerrada)
processNameListBar.tool, processNameListBar.content
Página de seguimiento (lista de nombre de proceso cerrada)
.startPointList, .tasklist
La lista de punto de partida o la lista de tarea
.startPointList.header, .tasklist.header
El encabezado de una lista de punto de inicio o una lista de tarea
.startpoint.selected, .tarea.selected
El punto de inicio o la tarea seleccionados
.startpoint.selected.description, .tarea.selected.description
Descripción del punto de inicio o la tarea seleccionados
#taskarea
La Tarea
#header.dropdown
Lista desplegable de usuarios en el encabezado
.sortDrop dd ul
Lista desplegable Ordenar tarea

CSS

El aspecto del espacio de trabajo AEM Forms toma su aspecto de una CSS. Al personalizar la CSS, puede cambiar la semántica de presentación del espacio de trabajo, como las fuentes, los colores, la marca y el diseño.
Los pasos de nivel superior para la personalización de CSS son:
  • Cree un archivo CSS.
  • Añada elementos de estilo a esta CSS. Consulte Explicación de los estilos CSS para obtener más información.
  • Actualice sus referencias en html.jsp .
Para ver los pasos exactos para realizar estas personalizaciones, consulte Pasos genéricos para la personalización del espacio de trabajo de AEM Forms. El archivo CSS enviado con el espacio de trabajo AEM Forms se encuentra en /libs/ws/css/. Para las personalizaciones relacionadas con CSS, utilice el paquete de envío. Para ver ejemplos específicos de personalizaciones relacionadas con CSS, consulte los temas de ayuda relacionados al final de este artículo.

Imagen

Puede personalizar el espacio de trabajo AEM Forms para agregar avatares de usuarios o para agregar el logotipo de su organización. Para estas personalizaciones, utilice Enviar paquete .
Los pasos de nivel superior para personalizar las imágenes son:
  • Instale y configure WebDAV.
  • Añadir imágenes nuevas.
  • Añada los nuevos estilos correspondientes a las imágenes agregadas.
  • Vínculo al nuevo archivo CSS del html.jsp archivo.
Para empezar a personalizar las imágenes en el espacio de trabajo AEM Forms, siga los pasos genéricos para la personalización del espacio de trabajo AEM Forms. Para ver ejemplos específicos de personalizaciones relacionadas con imágenes, consulte los temas de ayuda relacionados al final de este artículo.

Plantilla HTML

Las plantillas HTML ayudan a definir el aspecto y el diseño de la interfaz de usuario del espacio de trabajo. Al actualizar las plantillas HTML predeterminadas, puede personalizar la interfaz de usuario predeterminada del diseño.
Los pasos de nivel superior para las personalizaciones de la plantilla HTML son:
  • En una carpeta creada por el usuario, realice copias de los archivos predeterminados necesarios.
  • Añada nuevas plantillas en la carpeta definida por el usuario.
  • Realice las actualizaciones pertinentes a los archivos copiados como, por ejemplo, la ruta de la nueva plantilla.
Para ver ejemplos específicos de dichas personalizaciones, consulte los temas de ayuda que se proporcionan al final de este artículo. Elija entre el paquete de envío o el paquete de desarrolladores, según la plantilla que desee personalizar.

Cambios semánticos

Para modificar la funcionalidad del espacio de trabajo AEM Forms, cambie el código fuente JavaScript. Las modificaciones en la funcionalidad principal se etiquetan como cambios semánticos. Los modelos, la vista y las plantillas se modifican como parte del espacio de trabajo de código fuente de AEM Forms.
Los pasos de nivel superior para realizar cambios semánticos a fin de modificar la funcionalidad del espacio de trabajo de AEM Forms son:
  • En una carpeta creada por el usuario, realice copias de los archivos predeterminados correspondientes.
  • Añada nuevos modelos y vistas en la carpeta definida por el usuario.
  • Realice actualizaciones relevantes como la actualización de rutas de modelos y vistas recién añadidos en los archivos JavaScript predeterminados.
  • Minimice el paquete para optimizar el rendimiento.
Para obtener más información conceptual sobre los componentes que forman parte del código fuente, consulte la Descripción de los componentes reutilizables. Para estas personalizaciones, utilice el paquete Dev.

Componentes reutilizables

Como el espacio de trabajo de AEM Forms es un software basado en componentes, se puede personalizar y reutilizar fácilmente. Puede integrar fácilmente los componentes del espacio de trabajo con sus aplicaciones Web.
Para obtener más información conceptual, consulte la Descripción de los componentes reutilizables y para obtener instrucciones sobre el uso de los componentes, consulte Integración de componentes de espacio de trabajo de AEM Forms en aplicaciones web.

Creación del código del espacio de trabajo de AEM Forms

Paquete SDK

El paquete contiene el código fuente del espacio de trabajo AEM Forms. El paquete está disponible en [LC root]\sdk\html-workspace\adobe-lc-workspace-src.zip .
Está pensado principalmente para personalizaciones, ya que proporciona la capacidad de generar:

Contenido de WS

  • client-pkg:
    • src: contiene artefactos necesarios para crear nodos CRX.
    • pom.xml: secuencia de comandos para crear paquetes de implementación para varios paquetes de perfiles WS-Deploy
  • client-html:
    • ensamblado: contiene zip.xml utilizado por la secuencia de comandos para crear el SDK de espacio de trabajo de AEM Forms.
    • src/main/webapp -
      • css: contiene hojas de estilo para el espacio de trabajo AEM Forms.
      • imágenes: contiene imágenes utilizadas en el espacio de trabajo AEM Forms.
      • js:
        • libs: contiene todas las bibliotecas de terceros utilizadas en el espacio de trabajo de AEM Forms.
        • licencias: contiene licencias para archivos HTML y JS, así como código para anteponer estas licencias a los respectivos archivos de origen.
        • minifier: se utiliza para la combinación, minimización y simplificación del código personalizado de JavaScript.
        • resourcejs_optimizer: se utiliza para la combinación, minimización y simplificación del código fuente JavaScript.
        • resource_generator: se utiliza para generar register.js y modelcontrollerpath.js.
        • tiempo de ejecución:
          • inicializer: contiene inicializer.js utilizado para inicializar vistas de red troncal y modelos utilizados en el espacio de trabajo de AEM Forms.
          • modelos: contiene modelos de red troncal de todos los componentes presentes en el espacio de trabajo de AEM Forms.
          • rutas: contiene archivos JavaScript y archivos HTML que cargan procesos de inicio, tareas de tareas, seguimiento y preferencias en el espacio de trabajo de AEM Forms.
          • services: contiene service.js utilizado en el espacio de trabajo de AEM Forms. Todas las llamadas al servidor se realizan a través de service.js.
          • plantillas: contiene todas las plantillas, es decir, archivos HTML de todas las vistas del espacio de trabajo de AEM Forms.
          • util: contiene todos los archivos de utilidad (javascript) que se utilizan en el espacio de trabajo de AEM Forms.
          • vistas: contiene vistas de red troncal de todos los componentes del espacio de trabajo de AEM Forms.
        • main.js
        • router.js
      • libs/ws: pdf.html y pluginPing.pdf se utilizan para cargar PDF forms en el espacio de trabajo AEM Forms y WSNextAdapter.swf se utiliza para cargar formularios SWF y guías en el espacio de trabajo AEM Forms.
      • configuraciones regionales:
        • de-DE - Contiene translate.json para alemán.
        • en-US - Contiene translate.json para inglés.
        • fr-FR: contiene Translation.json para francés.
        • ja-JP - Contiene translate.json para japonés.
        • html.jsp: contiene código para averiguar la configuración regional actual del explorador.
      • html.jsp
      • GET.jsp

Paquete CRX

El paquete CRX se puede implementar en el repositorio de CRX™. Está disponible en [LC root]\crx-repository\install\adobe-lc-workspace-pkg.zip .
Este paquete se puede crear utilizando los tres perfiles que se describen a continuación.
Perfil
Descripción
Uso
perfil de envío
Este perfil crea un paquete CRX del tamaño más pequeño posible mediante la minimización. Este paquete es el más eficiente. Todos los archivos JavaScript™ se combinan y minimizan en un solo archivo JS.
Utilice este perfil cuando no se requieran más cambios semánticos en los archivos JS.
perfil de depuración
Este perfil crea un paquete CRX moderadamente eficiente. El tamaño del paquete es ligeramente superior al del paquete creado mediante el perfil de envío. Este paquete tiene la mayoría de los archivos JavaScript combinados en un solo archivo JS.
Utilice este perfil para la depuración.
perfil Dev
Este perfil crea un paquete CRX del mayor tamaño posible. Todos los archivos JavaScript están disponibles por separado, como en el paquete SDK.
Utilice este perfil al incorporar cambios semánticos.

Perfil de envío

Comando

  • mvn clean -P Se envía la instalación en la carpeta client-pkg del paquete de origen enviado al cliente.
  • La ejecución de comandos de perfil de envío solo funciona en un JVM de 64 bits.

Contenido de WS

  • css: contiene style.css, ie.css y jquery-ui.css.
  • imágenes: contiene todas las imágenes.
  • js:
    • libs:
      • requerir - Contiene required.js.
      • jqueryui: contiene jquery.ui.datepicker.ja.js.
    • tiempo de ejecución:
      • plantillas: contiene todas las plantillas, es decir, archivos HTML de todos los componentes del espacio de trabajo de AEM Forms.
    • main.js (combinado, minimizado y desacreditado).
    • registry.js
  • libs:
    • ws - Contiene pluginPing.pdf, pdf.html y WSNextAdapter.swf.
  • Configuración regional: contiene .content.xml.
  • configuraciones regionales:
    • de-DE - Contiene translate.json para alemán.
    • en-US - Contiene translate.json para inglés.
    • fr-FR: contiene Translation.json para francés.
    • ja-JP - Contiene translate.json para japonés.
    • html.jsp: contiene código para averiguar la configuración regional actual del explorador.
  • Índice: contiene .content.xml
  • perfil: contiene offline.jsp.
  • GET.jsp
  • html.jsp
  • content.xml
  • _rep_policy.xml

Perfil de depuración

Comando

  • mvn clean -P Instalación de depuración en client-pkg
  • La ejecución del comando Debug perfil solo funciona en JVM de 64 bits.

Contenido de WS

  • css: contiene style.css, ie.css y jqueri-ui.css.
  • imágenes: contiene todas las imágenes.
  • js:
    • libs:
      • requerir - Contiene required.js.
      • jqueryui: contiene jquery.ui.datepicker.ja.js.
    • tiempo de ejecución:
      • plantillas: contiene todas las plantillas, es decir, archivos HTML de todos los componentes del espacio de trabajo de AEM Forms.
    • main.js (combinado).
    • registry.js
  • libs:
    • ws - Contiene pluginPing.pdf, pdf.html y WSNextAdapter.swf.
  • Configuración regional: contiene .content.xml.
  • configuraciones regionales:
    • de-DE - Contiene translate.json para alemán.
    • en-US - Contiene translate.json para inglés.
    • fr-FR: contiene Translation.json para francés.
    • ja-JP - Contiene translate.json para japonés.
    • html.jsp: contiene código para averiguar la configuración regional actual del explorador.
  • Índice: contiene .content.xml
  • perfil: contiene offline.jsp.
  • GET.jsp
  • html.jsp
  • content.xml
  • _rep_policy.xml

Perfil Dev

Comando

mvn clean -P Instalación de Dev en client-pkg

Contenido de WS

  • css: contiene style.css, ie.css y jqueri-ui.css.
  • imágenes: contiene todas las imágenes.
  • js:
    • libs: contiene todas las bibliotecas utilizadas en el espacio de trabajo de AEM Forms.
    • requerir - Contiene required.js
    • jqueryui: contiene jquery.ui.datepicker.ja.js
    • tiempo de ejecución:
      • inicializer: contiene inicializer.js y modelcontrollerpath.js.
      • modelos: contiene modelos de todos los componentes del espacio de trabajo de AEM Forms.
      • rutas: contiene archivos JavaScript y archivos HTML que cargan procesos de inicio, tareas de tareas, seguimiento y preferencias en el espacio de trabajo de AEM Forms.
      • services: contiene service.js utilizado en el espacio de trabajo de AEM Forms.
      • plantillas: contiene todas las plantillas, es decir, archivos HTML de todos los componentes del espacio de trabajo de AEM Forms.
      • util: contiene todos los archivos de utilidad (JavaScript) que se utilizan en el espacio de trabajo de AEM Forms.
      • vistas: contiene vistas de todos los componentes del espacio de trabajo de AEM Forms.
    • main.js
    • registry.js
    • router.js
  • libs:
    • ws - Contiene pluginPing.pdf, pdf.html y WSNextAdapter.swf.
  • Configuración regional: contiene .content.xml.
  • configuraciones regionales:
    • de-DE - Contiene translate.json para alemán.
    • en-US - Contiene translate.json para inglés.
    • fr-FR: contiene Translation.json para francés.
    • ja-JP - Contiene translate.json para japonés.
    • html.jsp: contiene código para averiguar la configuración regional actual del explorador.
  • Índice: contiene .content.xml
  • perfil: contiene offline.jsp.
  • GET.jsp
  • html.jsp
  • content.xml
  • _rep_policy.xml