A inmediato Es una instrucción o entrada que desencadena una acción. En Joule, la calidad del código se basa en indicaciones claras: las indicaciones bien diseñadas producen resultados precisos y relevantes, lo que mejora la experiencia del usuario.
Según las aportaciones de consultores funcionales y usuarios empresariales, los desarrolladores pueden crear indicaciones a través de Joule para habilitar la generación de aplicaciones en Código de compilación de SAP. La siguiente figura demuestra cómo los desarrolladores interactúan con Joule en SAP Build Code.
En pocas palabras, el propietario del proceso de negocio define los requisitos del negocio y el consultor funcional los traduce en especificaciones funcionales. Luego, el desarrollador convierte las especificaciones en solicitudes y las ingresa en el código de compilación de SAP, donde Joule, el copiloto de IA de SAP, genera automáticamente modelos de datos, definiciones de servicios, elementos de interfaz de usuario, lógica de negocios e incluso scripts de pruebas unitarias.
A continuación resumiremos los comandos clave de Joule para el desarrollo con Modelo de programación de aplicaciones en la nube de SAPsu uso y ejemplos de indicaciones. Sirve como referencia rápida para estructurar indicaciones en tareas como la generación de modelos, la edición de datos y la implementación de lógica.
/aplicación-cap-gen
Esto genera una aplicación completa del modelo de programación de aplicaciones en la nube de SAP (incluido el modelo CDS, datos de muestra y lógica). Admite indicaciones vagas o detalladas. Joule guía el refinamiento.
Mensaje de muestra: cree una aplicación de gestión de carga con remitentes, envíos y artículos de carga. Incluya datos de muestra. Si el peso del envío supera los 1000 kg, establezca automáticamente la prioridad en Alta.
/cap-gen-modelo
Este crea solo el modelo de datos del modelo de programación de aplicaciones en la nube de SAP (entidades, asociaciones). La precisión mejora los resultados.
Mensaje de muestra: Defina un modelo de carga: Transportista (ID, Nombre, Contacto) y Envío (ID, Origen, Destino, Peso).
/cap-edit-modelo
Esto edita modelos existentes, agrega comentarios o revisa modelos para conocer las mejores prácticas. Requiere # para incluir el archivo que desea incluir.
Mensaje de ejemplo: FreightService.cds: Reemplace Puerto con Almacén y agregue un campo Fecha de entrega al Envío.
/cap-gen-datos
Esto genera datos de muestra para modelos. Especifica rangos/formatos para realismo.
Mensaje de muestra: Genere datos de muestra de flete: establezca el peso del envío entre 500 y 5000 kg y los países portuarios a los principales centros comerciales.
/cap-editar-datos
Esto modifica los datos de muestra existentes (archivos CSV). Se requiere variable de contexto.
Mensaje de ejemplo: #shipments.csv: actualice los pesos a toneladas métricas (divida los valores entre 1000).
/cap-app-logic
Esto agrega/edita la lógica de la aplicación (por ejemplo, validaciones, activadores). Divide las tareas complejas en pasos.
Mensaje de muestra: Freight-service.js: si el envío se retrasa más de 3 días, envíe automáticamente un correo electrónico al remitente.
/prueba-de-unidad-cap
Esto genera pruebas unitarias para lógica. Proporcionar casos de prueba positivos/negativos.
Mensaje de muestra: Freight-service-test.js: Verifique que la prioridad alta esté configurada cuando el peso sea superior a 1000 kg (casos de aprobación/rechazo).
/aplicación-fiori-gen-spec
Esto crea un SAP Fiori Aplicación de elementos a partir de requisitos comerciales (admite entradas de texto/imagen).
Mensaje de muestra: genere una aplicación SAP Fiori habilitada para borrador para seguimiento de carga con informes de lista y páginas de objetos.
/añadir-ui
Esto agrega SAP Fiori UI (web/móvil) a los servicios backend existentes del modelo de programación de aplicaciones en la nube de SAP.
Mensaje de muestra: cree una interfaz de usuario móvil para el seguimiento de envíos utilizando CargoService existente.
/ui5-mecanografiado
tEsto convierte proyectos/archivos SAPUI5 a TypeScript (admite migración incremental).
Mensaje de muestra: migre Main.controller.js a TypeScript sin cambiar la configuración del proyecto.
/ui5-crear-página
Esto crea una nueva página SAPUI5 con vista, controlador y configuración de enrutamiento.
Mensaje de ejemplo: Crear página AddressForm con navegación desde el botón de encabezado de la vista principal.
Además de nuestra biblioteca de avisos específica para nuestro caso de uso de gestión inteligente de pedidos de flete, a continuación se muestran las mejores prácticas clave para usar Joule en el desarrollo, ofreciendo pautas prácticas y ejemplos prácticos para mejorar la ingeniería rápida y la calidad del código.
| Categoría | Mejores prácticas | Ejemplos |
| Especificidad inmediata | Describa entidades, campos y reglas comerciales explícitamente. |
Vago: crea una aplicación de carga. Mejorado. Cree una aplicación de carga con el Envío (ID, Peso, Prioridad) vinculado al Remitente (ID, Nombre, Contacto). Establezca automáticamente la prioridad en Alta si el peso es superior a 1000 kg. |
| Modelado de datos | Evite términos técnicos de CDS (por ejemplo, «aspecto», «enumeración»). Describir entidades en términos comerciales. |
Evitar: Agregar composiciones para CargoItems. Uso: Vincular envío a CargoItems a través de asociaciones. |
| Lógica de la aplicación | Definir reglas de validación y flujo de datos. | Para updateShipmentStatus, valide que el peso sea superior a 0 antes de asignar el estado Aprobado. |
| Pruebas unitarias | Incluya casos extremos (por ejemplo, envíos con sobrepeso). | Pruebe calcular el costo del flete con peso = 50 kg (válido) y peso = -10 kg (no válido). |
| Refinamiento iterativo | Modifique las indicaciones en función de los resultados iniciales. | Regenerar datos de muestra: use kg para peso y códigos ISO para países portuarios. |
| Descomposición de tareas | Divida las tareas en tareas modelo, luego tareas lógicas y luego tareas de interfaz de usuario. |
Paso 1: /cap-gen-model para entradas de envío/puerto Paso 2: /ui5-create-page para el panel de seguimiento |
| Conciencia del contexto | Archivos de referencia con el carácter #. Joule detecta automáticamente el alcance del proyecto. | #ShipmentService.cds: agregue el campo CustomsCleared. |
Nota del editor: Esta publicación ha sido adaptada de una sección del libro. Desarrollo de aplicaciones con código de compilación SAP e IA generativa por Mohit Bansal, Adwait Fadnavis, Kuldeep Sharmay Mohamed Zain Ul Abideen. Mohit es un mentor de SAP con más de 18 años de experiencia trabajando con diversas tecnologías de SAP con un enfoque en SAP BTPIA, SAP Fiori y SAP S/4HANA desarrollo. Adwait es un experimentado profesional de SAP con más de 8 años de experiencia especializado en SAP BTP, Automatización de procesos de construcción de SAPSAP Fiori y el modelo de programación de aplicaciones en la nube de SAP. Kuldeep es arquitecto de tecnología senior en una empresa de servicios de TI líder a nivel mundial, donde dirige el centro de experiencia y las ofertas de servicios de automatización e inteligencia artificial de SAP BTP. Mohammed es un desarrollador SAP experimentado con más de 8 años de experiencia en SAPUI5SAP Fiori y soluciones SAP BTP.
Esta publicación se publicó originalmente el 3/2026.
