Componente para adjuntar archivos file-attachment-adaptive-forms-core-component
: la característicaTipo de datos del valor enviadoestá disponible en el programa que lo adoptó por primera vez. Puede escribir a aem-forms-ea@adobe.com desde su ID de correo electrónico oficial para unirse al programa de primeros usuarios y solicitar acceso a esta funcionalidad.
El componente para adjuntar archivos de un Formulario adaptable permite a los usuarios seleccionar y cargar archivos desde su equipo o dispositivo local. El componente para adjuntar archivos se puede configurar para permitir tipos y límites de archivo de tamaño específicos y varios adjuntos de archivos.
Ejemplo
Uso reasons-to-use-file-attachment
Existen varias razones por las que resulta beneficioso incluir un componente para adjuntar archivos en un Formulario adaptable, entre ellas, las siguientes:
-
Recopilación de información adicional: un componente para adjuntar archivos permite a los usuarios cargar documentos, imágenes, vídeos u otros tipos de archivos como parte del envío del formulario. Esto puede resultar útil para recopilar información adicional como resúmenes, portafolios o documentación de soporte.
-
Compartir fácilmente archivos grandes: el componente para adjuntar archivos permite a los usuarios compartir fácilmente archivos de gran tamaño, sin tener que depender de servicios de uso compartido de archivos externos.
-
Comodidad: el componente de archivo adjunto permite a los usuarios cargar archivos desde su equipo local, sin tener que desplazarse fuera del formulario ni utilizar otras herramientas.
-
Análisis de datos: el componente de archivo adjunto se puede utilizar para recopilar datos de varias fuentes y analizarlos, o utilizarlo como entrada para un procesamiento posterior.
-
Experiencia del usuario: el componente de archivo adjunto se puede utilizar para que el formulario sea más fácil de usar, ya que proporciona una forma clara e intuitiva de cargar archivos.
Versión y compatibilidad version-and-compatibility
El componente principal del archivo adjunto de Forms adaptable se publicó en febrero de 2023 como parte de los componentes principales 2.0.4 para Cloud Service AEM y los componentes principales 1.1.12 para 6.5.16.0 Forms o posterior. A continuación se muestra una tabla con todas las versiones admitidas, la compatibilidad con AEM y los vínculos a la documentación correspondiente:
versión 2.0.4 y posteriores
versión 1.1.12 y posteriores, pero inferiores a 2.0.0.
Para obtener información sobre las versiones y publicaciones de los componentes principales, consulte el documento Versiones de los componentes principales.
Detalles técnicos technical-details
Obtenga la información más reciente sobre el componente principal de archivos adjuntos de formularios adaptables en la documentación técnica de GitHub. Para obtener más información sobre el desarrollo de los componentes principales, consulte la Documentación para desarrolladores de componentes principales.
Cuadro de diálogo de configuración configure-dialog
Puede personalizar fácilmente la experiencia de archivo adjunto para los visitantes con el cuadro de diálogo de configuración. También puede definir las opciones de archivo adjunto con facilidad para que la experiencia del usuario sea óptima.
Pestaña Básicos basic-tab
-
Nombre: puede identificar fácilmente un componente de formulario con su nombre único tanto en el formulario como en el editor de reglas, pero el nombre no debe contener espacios ni caracteres especiales.
-
Título: con su título, puede identificar fácilmente un componente en un formulario y, de forma predeterminada, el título aparece sobre el componente. Si no agrega un título, se mostrará el nombre del componente en lugar del texto del título.
-
Permitir texto enriquecido en el título: esta función permite a los usuarios dar formato a los títulos de texto sin formato, incorporando funciones como negrita, cursiva, texto subrayado, varias fuentes, tamaños de fuente, colores y opciones adicionales para mejorar la presentación visual y la personalización. Ofrece una mayor flexibilidad y control creativo para hacer que los títulos destaquen dentro de los documentos, sitios web o aplicaciones.
Al seleccionar la casilla de verificación de Permitir texto enriquecido en el título, las opciones de formato se vuelven visibles para aplicar estilo al título del componente. Para acceder a todas las opciones de formato disponibles, puede hacer clic en la pestaña . -
Ocultar título: seleccione la opción para ocultar el título del componente.
-
Título del botón: esta opción se utiliza para definir la etiqueta del botón mostrado en un Formulario adaptable.
-
Referencia de vínculo: una referencia de vínculo es una referencia a un elemento de datos que se almacena en una fuente de datos externa y se utiliza en un formulario. La referencia de enlace permite enlazar datos de forma dinámica a campos de formulario, de modo que el formulario pueda mostrar los datos más actualizados de la fuente de datos. Por ejemplo, se puede utilizar una referencia de enlace para mostrar el nombre y la dirección de un cliente en un formulario, según el ID introducido en el formulario por el cliente. La referencia de enlace también se puede utilizar para actualizar la fuente de datos con los datos del formulario. De este modo, AEM Forms permite crear formularios que interactúen con fuentes de datos externas, lo que proporciona al usuario una experiencia óptima para recopilar y administrar datos.
-
Marcar como elemento de formulario independiente: seleccione la opción para configurar un campo de formulario no vinculado a ningún esquema. Esta opción le permite guardar datos sin actualizar la fuente de datos. También le permite gestionar los datos de forma personalizada, independientemente de la integración de bases de datos estándar.
-
Tipo de datos del valor enviado: seleccione la opción para determinar cómo se enviará el archivo adjunto al servidor. Para enviar los datos adjuntos como datos binarios, elija la opción
File
. Para enviar los datos adjuntos como una cadena codificada en Base64, elija la opciónString
. Si se seleccionaString
, el archivo en formato binario se envía al servidor como una dirección URL de datos. El servidor vuelve a convertir automáticamente la URL de datos al formato binario, lo que garantiza la compatibilidad con las acciones existentes, como enviar correos electrónicos y generar el documento de registro, sin que sea necesario realizar cambios por parte de los usuarios. De manera predeterminada, la opciónFile
está seleccionada. -
Ocultar componente: seleccione la opción para ocultar el componente del formulario. El componente permanece accesible para otros fines, como utilizarlo para los cálculos en el Editor de reglas. Esto resulta útil cuando necesita almacenar información que el usuario no necesita ver o cambiar directamente.
-
Deshabilitar componente: seleccione la opción para desactivar el componente. El componente desactivado no está activo ni puede editarlo el usuario final. El usuario puede ver el valor del campo, pero no modificarlo. El componente permanece accesible para otros fines, como utilizarlo para los cálculos en el Editor de reglas.
-
Solo lectura: seleccione la opción para que el componente no se pueda editar. El usuario puede ver el valor del campo, pero no modificarlo. El componente permanece accesible para otros fines, como utilizarlo para los cálculos en el Editor de reglas.
-
Permitir varios archivos adjuntos: seleccione esta opción para cargar varios archivos adjuntos con el botón Archivo adjunto.
-
Arrastrar y soltar texto: es el texto que se muestra en la parte superior del botón Adjuntar para pedir a los usuarios que adjunten o arrastren y suelten archivos. Tiene la opción de personalizar el texto que se muestra en la parte superior del botón Adjuntar. Además, puede dar formato al texto mediante el menú de texto enriquecido.
Pestaña Validación validation-tab
-
Obligatorio: seleccione esta opción si desea mostrar el componente en un formulario adaptable. Después de seleccionar la opción, debe adjuntar los archivos adjuntos antes de continuar con el envío de un formulario. No puede seleccionar Ocultar componente o Desactivar componente en la pestaña Básico cuando se selecciona esta opción.
-
Mensaje de error: esta opción permite introducir un mensaje que se muestra si se marca la casilla Obligatorio y el campo se deja en blanco.
-
Mensaje de validación de la secuencia de comandos: esta opción permite introducir un mensaje que se mostrará si la validación de la secuencia de comandos falla.
-
Tamaño máximo del archivo (MB): esta opción permite especificar un tamaño máximo de archivo. Los tamaños de archivo se especifican en MB.
-
Mensaje de error de tamaño de archivo máximo: esta opción se utiliza para escribir un mensaje de error que se muestra si se cargan archivos de tamaño superior al tamaño de archivo especificado en la opción de Tamaño máximo del archivo (MB).
-
Tipos de archivo permitidos: aquí se pueden cargar varios tipos de archivos mediante el botón de Adjuntar archivo. También permite agregar un nuevo formato de archivo haciendo clic en el botón de Agregar. Los formatos de archivo admitidos son: audio, vídeo, imagen, texto o PDF. También puede eliminar o reorganizar los tipos de archivo permitidos mediante:
- Eliminar: pulse o haga clic para eliminar tipos de archivos específicos.
- Reorganizar: pulse o haga clic y arrastre para reorganizar el orden de los tipos de archivo permitidos.
-
Mensaje de error de tipo de archivo: esta opción le permite introducir un mensaje de error que se muestra al cargar los formatos de archivo distintos de los que aparecen en la opción de Tipos de archivo permitidos.
Pestaña Contenido de ayuda help-content-tab
-
Descripción breve: una descripción breve es una explicación de texto corta que proporciona información adicional o aclaraciones acerca del propósito de un campo de formulario específico. Ayuda al usuario a comprender qué tipo de datos se deben escribir en el campo y puede proporcionar directrices o ejemplos para garantizar que la información introducida sea válida y cumpla los criterios deseados. De forma predeterminada, las descripciones cortas permanecen ocultas. Active la opción Mostrar siempre una descripción breve para mostrarla debajo del componente.
-
Mostrar siempre una descripción breve: active esta opción para mostrar la descripción breve debajo del componente.
-
Texto de ayuda: este hace referencia a información o directrices adicionales que se proporcionan al usuario para ayudarle a rellenar correctamente un campo de formulario. Aparece cuando el usuario hace clic en el icono de ayuda (i) situado junto al componente. El texto de ayuda proporciona información más detallada que la etiqueta de un campo de formulario o el texto del marcador de posición, y está diseñado para ayudar al usuario a comprender los requisitos o restricciones del campo. También puede ofrecer sugerencias o ejemplos para que el formulario sea más fácil y preciso.
Pestaña Accesibilidad accessibility-tab
-
Texto para lectores de pantalla: el texto para lectores de pantalla se refiere a texto adicional que está específicamente diseñado para que lo lean tecnologías de asistencia, como lectores de pantalla, que utilizan personas con deficiencias visuales. Este texto proporciona una descripción del audio del propósito del campo de formulario y puede incluir información sobre el título, la descripción, el nombre y cualquier mensaje relevante (texto personalizado) del campo. El texto del lector de pantalla ayuda a garantizar que el formulario sea accesible para todos los usuarios, incluidos los que tengan deficiencias visuales, y les ofrezca una comprensión completa del campo del formulario y de sus requisitos.
- Texto personalizado: seleccione esta opción para utilizar el texto personalizado para las etiquetas de accesibilidad de ARIA. Al seleccionar esta opción, aparece el cuadro de diálogo Texto personalizado. Puede agregar información relevante en el cuadro de diálogo Texto personalizado.
- Descripción: seleccione esta opción para utilizar la descripción para las etiquetas de accesibilidad de ARIA.
- Título: seleccione esta opción para utilizar el título para las etiquetas de accesibilidad de ARIA.
- Nombre: seleccione esta opción para utilizar el nombre para las etiquetas de accesibilidad de ARIA.
- Ninguno: seleccione esta opción si no desea agregar etiquetas de accesibilidad de ARIA.
Cuadro de diálogo Diseño design-dialog
El cuadro de diálogo Diseño se utiliza para definir y administrar estilos CSS para el componente Archivo adjunto.
Pestaña Estilos styles-tab
El componente principal de los archivos adjuntos de formularios adaptables es compatible con el Sistema de estilos de AEM.
-
Clases CSS predeterminadas: puede proporcionar clases CSS predeterminadas para el componente principal de los archivos adjuntos de formularios adaptables.
-
Estilos permitidos: puede definir estilos proporcionando un nombre y la clase CSS que representa el estilo. Por ejemplo, puede crear un estilo llamado “texto en negrita” y proporcionar la clase de CSS “grosor de fuente: negrita”. Puede utilizar o aplicar estos estilos a un formulario adaptable en el editor de formularios adaptable. Para aplicar un estilo, en el editor de Formularios adaptables, seleccione el componente al que desee aplicar el estilo, vaya al cuadro de diálogo de propiedades y seleccione el estilo que desee en la lista desplegable Estilos. Si necesita actualizar o modificar los estilos, simplemente vuelva al cuadro de diálogo Diseño, actualice los estilos en la pestaña Estilos y guarde los cambios.
Propiedades personalizadas
Las propiedades personalizadas le permiten asociar atributos personalizados (pares clave-valor) a un componente principal del formulario adaptable mediante la plantilla de un formulario. Las propiedades personalizadas se reflejan en la sección de propiedades de la representación sin encabezado del componente. Permite crear un comportamiento de formulario dinámico que se adapta en función de los valores de atributos personalizados. Por ejemplo, los desarrolladores pueden diseñar varias representaciones de un componente Forms sin encabezado para plataformas móviles, de escritorio o web, lo que mejora significativamente la experiencia del usuario en una amplia gama de dispositivos.
-
Nombre de grupo: puede proporcionar un nombre para identificar el grupo de propiedades personalizadas. Puede agregar, eliminar o reorganizar varios grupos de propiedades personalizadas. Después de añadir el grupo de propiedades personalizadas, podrá ver las siguientes opciones:
-
Pares de clave-valor: puede agregar varios nombres de propiedades personalizadas y valores de propiedades personalizadas haciendo clic en el botón Añadir para cada grupo de propiedades personalizadas.
-
Eliminar: toque o haga clic para eliminar el nombre de la propiedad personalizada y el valor de la propiedad personalizada.
-
Reorganizar: toque o haga clic y arrastre para reorganizar el orden del nombre de la propiedad personalizada y el valor de la propiedad personalizada.
-
Artículos relacionados related-articles
Consulte también see-also
- Crear un formulario adaptable de AEM
- Agregar un formulario adaptable de AEM a la página de AEM Sites
- Aplicar temáticas a un formulario adaptable de AEM
- Añadir componentes a un formulario adaptable de AEM
- Uso de reCAPTCHA en un formulario adaptable de AEM
- Generar la versión de PDF (DoR) de un formulario adaptable de AEM
- Traducir un formulario adaptable de AEM
- Habilitar Adobe Analytics para un formulario adaptable con el fin de realizar un seguimiento del uso del formulario
- Conectar el formulario adaptable a Microsoft SharePoint
- Conectar formularios adaptables a Microsoft Power Automate
- Conectar el formulario adaptable a Microsoft OneDrive
- Conectar el formulario adaptable al almacenamiento de Microsoft Azure Blob
- Conectar el formulario adaptable a Salesforce
- Uso del Inicio de sesión en un formulario adaptable de AEM de Adobe
- Añadir una nueva configuración regional para un formulario adaptable
- Enviar datos de formulario adaptable a una base de datos
- Enviar datos de formulario adaptable a un punto final REST
- Enviar datos de formulario adaptable al flujo de trabajo de AEM
- Utilizar el portal de Forms para ver una lista de formularios adaptables de AEM en un sitio web de AEM