UI Integration Cards

Una UI integration card separa lo que muestra la card del lugar donde se muestra:

1. El desarrollador de la card escribe un manifest.json con una sección sap.card que define el tipo de card, la cabecera (título, subtítulo, icono, estado o un KPI numérico), el contenido, la petición de datos y las acciones, como la navegación a una aplicación.
2. El host, por ejemplo un sitio de SAP Build Work Zone, integra la card, decide su tamaño y su posición y resuelve la conectividad, normalmente mediante destinations configuradas en el lado del host.
3. En tiempo de ejecución, el control de card de SAPUI5 lee el manifest, carga los datos y representa un contenedor con un área de cabecera y un área de contenido.

Como la definición es declarativa, la misma card puede reutilizarse en varios hosts. El sitio de compras de Alder Manufacturing podría mostrar una card de lista con las entregas vencidas de Bright Freight que abra la aplicación completa. Por tanto, una UI integration card es una pieza de contenido portable, no una aplicación propiamente dicha.

Las cards declarativas pueden ejecutar igualmente lógica personalizada mediante extensiones JavaScript. La comparación de SAP también subraya que estas cards son distintas del control freestyle sap.f.Card y de las cards de la overview page, que pertenecen a SAP Fiori elements. Elegir primero una UI integration card declarativa mantiene la card portable entre hosts y ediciones.

• SAP Build Work Zone: ambas ediciones ejecutan cards en las páginas del sitio. Las cards declarativas tienen soporte completo en la standard edition y en la advanced edition; algunas funciones de las component cards solo funcionan en la advanced edition. En la standard edition, una card llega a los usuarios a través de un content package.
• My Home en SAP S/4HANA: los usuarios pueden crear cards de insights a partir de tablas de list report y gráficos de analytical list page en aplicaciones SAP Fiori elements, una vez que un administrador ha habilitado My Home; SAP documenta las cards creadas a partir de una tabla de list report como integration cards. Esto se aplica a SAP S/4HANA Cloud Public Edition y a SAP S/4HANA, donde My Home está disponible a partir de la release 2023 FPS01.
• Joule y dispositivos móviles: Joule puede devolver manifests de cards en sus respuestas, y SAP incluye SAP Mobile Start entre los consumidores de cards. La aplicación móvil Joule Work filtra las component cards.
• Otras soluciones de SAP: por ejemplo, SAP SuccessFactors admite UI integration cards personalizadas en algunas áreas del perfil.

Dónde puede aparecer una UI integration card depende del host, de su edición y del tipo de card, no solo de la card.

1. Funciones de component card en la standard edition. SAP documenta que una card que usa una función reservada para SAP Build Work Zone, advanced edition aparece en la galería de contenido y en el editor de páginas, pero falla en tiempo de ejecución en la standard edition. Compruebe la tabla de funciones admitidas para la edición de destino.
2. Filtrado en móviles. Las component cards no se muestran en la aplicación móvil Joule Work. Use una card declarativa si el móvil es importante.
3. Destination inexistente. Las peticiones de datos se resuelven a través del host. Una destination que falta en la subcuenta deja la card vacía o con error.
4. No incluida en un content package. En la standard edition, SAP exige que una card desplegada se añada a un content package antes de poder usarla en un sitio.
5. Límites del editor. SAP indica que el editor de UI cards de Work Zone solo admite funciones de card hasta una versión concreta de SAPUI5; consulte la documentación de Work Zone para conocer la actual.

La mayoría de los fallos de las UI integration cards son problemas de configuración del host, más que errores en el manifest de la card.