Proporción de atributos de descripción para enlace de espacios de nombres en la infraestructura de interfaz de usuario web

El atributo namespaces en una pantalla ofrece información sobre los espacios de nombres que se han utilizado para los controles de enlace. Los personalizadores pueden ver los espacios de nombres y sus descripciones (si las han proporcionado los desarrolladores) en la vista de detalles de control de Extensibility Workbench o en la ventana Propiedades de Designer Workbench. No tienen que abrir los archivos de origen JavaScript para ver los espacios de nombres.

El atributo namespaces es un objeto con dos atributos (source y target) que individualmente son matrices de un objeto. En pantallas más antiguas, este atributo es un objeto con dos atributos (source y target) que individualmente son matrices de un string. Puede utilizar Designer Workbench para actualizar las estructuras de espacios de nombres de las pantallas más antiguas para utilizar matrices de objetos en lugar de matrices de string.

A continuación se muestra la estructura de namespaces:

namespaces: {
     source: ['a', 'b']
     , target: ['c', 'd'] 
} 
, namespacesDesc: {
     sourceDesc: ['description for a', 'description for b']
     , targetDesc: ['description for c', 'description for d'] 
}

Los espacios de nombres se guardan en el objeto namespaces mientras que las descripciones se guardan en el objeto namespacesDesc. Existe una correlación de uno a uno entre el contenido de namespaces y namespacesDesc. De esta manera, se conserva la compatibilidad con versiones anteriores de aplicaciones más antiguas que utilizan una estructura de namespaces distinta.

Una pantalla más antigua que utiliza la estructura de espacios de nombres diferentes se actualiza en Designer Workbench y la nueva estructura se graba en los archivos JavaScript y JavaScript Object Notation. El usuario recibe una solicitud, y cuando éste confirma, la actualización finaliza. Una vez actualizado, el archivo ya no se podrá abrir en una versión anterior de Designer Workbench. El contenido nuevo se escribe en los archivos js y json una vez que el usuario los guarda con el botón Guardar.

Después de la actualización, el campo de descripción para el origen y el destino tomará como valor predeterminado, respectivamente, Descripción para < nombre de origen > y Descripción para < nombre de destino >.

En pantallas más antiguas en las que no se proporcionaban espacios de nombres en Designer Workbench y no existían en los archivos js y json, esta actualización genera el archivo js siguiente:

namespaces: {
     target: []
     , source: [] 
} 
, namespacesDesc: {
     targetDesc: []
     , sourceDesc: [] 
}

Con estos tipos de pantallas, debe proporcionar una correlación de uno a uno entre las matrices de origen (source) y destino (target) de los datos de enlace (bindingData) con namespacesDesc. En extensibilidad, si namespacesDesc tiene valores no vacíos al tiempo que los espacios de nombres están vacíos, los valores se muestran en correspondencia con los datos de enlace (bindingData).