[toc]

A partir de la versión 1.30 de la aplicación SAPUI5, SAP introduce el archivo manifest.json que sustituye a los archivos de configuración de las anteriores versiones.

En este artículo descubrirás en qué consiste dicho archivo y cada una de sus partes, componentes y atributos.

El nuevo fichero de configuración que mencionábamos al comienzo, manifest.json, proporciona una ubicación central, legible y de fácil acceso para almacenar metadatos asociados con una aplicación SAPUI5, un componente de aplicación o una biblioteca.

El archivo manifest.json, está ubicado en la carpeta webapp del proyecto. El WebIDE nos permite modificarlo mediante un editor gráfico o un editor por código.

Puesto que la segunda de las opciones que acabamos de nombrar, mediante un editor por código, nos aporta mayor libertad, es la que utilizaremos en este artículo.

La estructura del manifest está dividida en diferentes namespaces, cada uno de los cuales tiene sus respectivos atributos.

Los namespaces más habituales en una aplicación SAPUI5 son los siguientes:

  • app
  • ui
  • ui5

Cuando se crea un proyecto nuevo, la mayoría de los atributos básicos nos los encontraremos definidos en el archivo manifest.json.

A continuación veremos los atributos más usados en el principal fichero de configuración de una aplicación SAPUI5.

sap.app

Atributo Descripción
id Atributo obligatorio:

Identificador único de la aplicación, que debe ser igual al nombre del componente.

type Sólo admite los siguientes tipos:

  • application
  • component
  • library
i18n URL relativa:

Indica el archivo de propiedades que contiene los símbolos de texto.

dataSources Claves o alias únicas:

Especifica las fuentes de datos utilizadas y contiene la siguiente información:

  • uri: URL
  • type: OData (predeterminado), ODataAnnotation, INA, XML o JSON
  • settings: Atributos específicos del tipo de la fuente de datos, por ejemplo:
    • odataVersion
    • localUri
    • annotations
    • maxAge

SAPUI5 manifest.json, sap.app

sap.ui

Atributo Descripción
technology Especifica la tecnología de interfaz de usuario.

Valor: UI5

deviceTypes Atributo obligatorio:

Indica en que dispositivos funcionará la aplicación.

  • desktop
  • tablet
  • phone

SAPUI5 manifest.json, sap.ui

sap.ui5

Atributo Descripción
resources URL relativas:

Apuntan a los recursos js (JavaScript) y css.

dependencies Especifica las dependencias externas cargadas por el núcleo de SAPUI5 durante la fase de inicialización del componente y las usa posteriormente, como bibliotecas o componentes.
models Definiremos los modelos que usaremos en la aplicación. La clave representa el nombre del modelo. Utilizaremos una cadena vacía (“”) para el modelo predeterminado.
routing Parámetros de configuración para rutas y enrutadores.

SAPUI5 manifest.json, sap.ui5

Una vez comentado el fichero manifest.json en su totalidad, no nos cabe duda de que la inclusión de éste en las últimas versiones de la aplicación marca una gran diferencia en lo que a sencillez y agilidad se refiere a la hora de configurar SAPUI5.