Propiedades del proyecto
Las propiedades del proyecto se definen en el panel Estilos y propiedades y se describen a continuación. Al pasar el puntero sobre una propiedad, aparece información rápida con una breve descripción de la misma.
Esta propiedad especifica el nivel de acceso al servidor durante la ejecución de la solución. Su valor predeterminado es siempre.
•Siempre: La conexión al servidor es necesaria para poder ejecutar la solución. Al servidor se accede de forma continua mientras se ejecuta la solución. •Cuando se solicite: La aplicación de MobileTogether Client ejecuta la solución por sí misma. Se conecta al servidor solamente cuando necesita intercambiar datos. Para ejecutar la solución, la aplicación utiliza los datos de la estructura $PERSISTENT interna y otros datos persistentes o incrustados. Puede usar la función XPath mt-has-serveraccess para comprobar si existe una conexión con el servidor y usar las acciones correspondientes. Por ejemplo, si no existe conexión con el servidor, puede guardar los datos como datos persistentes en el cliente. En cuanto se establezca una conexión con el servidor, los datos se pueden guardar en la base de datos o en archivos del servidor. •Nunca: La aplicación de MobileTogether Client ejecuta la solución por sí misma sin necesidad de conectarse al servidor ni de usar datos de Internet.
|
La cantidad de tiempo que el cliente espera para obtener una respuesta del servidor. El valor es un valor entero en segundos que se puede introducir o seleccionar de la lista desplegable del cuadro combinado. El valor predeterminado es 15 segundos. Si se supera el tiempo de espera aparece un mensaje de error en el cliente.
|
Esta es la cantidad de tiempo que el servidor espera a que los datos se recuperen de fuentes externas (por ejemplo, de una BD o de una URL). El valor es un valor entero en segundos que se puede introducir o seleccionar de la lista desplegable del cuadro combinado. El valor predeterminado es de 10 segundos. Si se supera el tiempo de espera aparece un mensaje de error. La única excepción es cuando las acciones de carga tienen la opción Cuando haya errores configurada con el valor Continuar. En este caso se ejecutan las acciones definidas en el valor Continuar de la acción Cuando haya errores.
|
Hay tres opciones disponibles: (i) Usar la configuración del sistema. (ii) Garantizar tema ligero y (iii) Garantizar tema oscuro. La opción predeterminada es Usar la configuración del sistema. Un tema ligero muestra texto oscuro sobre fondo claro. Un tema oscuro muestra texto claro sobre fondo oscuro. Si la definición del estilo es Usar la configuración del sistema, entonces el tema lo determina la configuración del dispositivo.
|
La definición de eventos de audio es global para todo el proyecto. Estos son los eventos de audio disponibles: CuandoAudioComienza, CuandoErrorAudio y CuandoAudioFinaliza. Las acciones que se definan para estos eventos afectan a todos los eventos de reproducción de audio del proyecto. Si hace clic en el botón Examinar de la propiedad, aparece un cuadro de diálogo con las definiciones de los eventos de audio del proyecto. Por cada evento puede definir qué acciones se deben llevar a cabo (con solo arrastrar acciones del panel izquierdo hasta la pestaña del evento). Consulte la descripción de la característica Reproducción de audio.
|
Si hace clic en el botón Examinar de la propiedad Acciones Texto a voz aparecen las acciones Texto a voz del cuadro de diálogo "Acciones del proyecto" (ver imagen siguiente). Estos son los eventos Texto a voz que están disponibles:
•CuandoEmpiezaTextoAVoz: Las acciones que se especifiquen en este panel se ejecutan por orden en cuanto comienza la reproducción de una acción Texto a voz. Por ejemplo, en el diseño de la imagen anterior, se iniciará una acción Grabación de audio para grabar la reproducción de la acción Texto a voz en un archivo. •CuandoErrorTextoAVoz: Acciones que se deben ejecutar si se produce un error de texto a voz (que el texto no se encuentre, por ejemplo). •CuandoTextoAVozFinaliza: Acciones que se deben ejecutar cuando finalice la reproducción de texto a voz. Por ejemplo, puede iniciar otra reproducción de texto a voz especificando una acción Texto a voz para este evento.
|
Permite definir acciones para dos eventos relacionados con NFC:
•CuandoFinaliceEnvíoMensajeNDEF especifica qué acción o acciones se debe(n) llevar a cabo cuando finaliza la transmisión de datos NFC (con la acción Enviar NFC). •CuandoSeDetecteEtiquetaNFC especifica qué acciones (adicionales) se deben llevar a cabo cuando se detecta una etiqueta NFC.
Haga clic en el botón Examinar de las propiedades para ir a las definiciones de estos dos eventos. Para más información consulte el apartado Eventos relacionados con NFC.
|
En tiempo de diseño abre la pestaña del evento AlRecibirNotificaciónAutomática, donde puede especificar las acciones que se deben llevar a cabo cuando se recibe una notificación automática. Cuando se añade una acción al evento, la fuente de página $MT_PUSHNOTIFICATION se añade automáticamente al diseño.
Cuando se recibe una notificación automática (NA) en un dispositivo, pueden pasar dos cosas dependiendo de lo especificado en la opción Si la solución ya está en ejecución cuando se recibe:
•La fuente de página $MT_PUSHNOTIFICATION de la solución receptora se actualiza en segundo plano con la carga de la NA y se ejecutan las acciones de la pestaña del evento AlRecibirNotificaciónAutomática. Todo esto se hace directamente sin mostrar la NA. •Se muestra la NA. Esto es lo que ocurre cuando el usuario final pulsa la NA (o un botón de la NA): (i) se inicia la solución especificada (si no está ejecutándose todavía); (ii) la fuente de página $MT_PUSHNOTIFICATION de la solución se actualiza con los datos de la carga de la NA; (iii) se ejecutan las acciones de la pestaña del evento AlRecibirNotificaciónAutomática.
Consulte la sección Notificaciones automáticas para obtener más información sobre esta característica.
|
El botón de acción Compras desde la aplicación abre el cuadro de diálogo Acciones para el evento SiCompraActualizada. Durante una compra dentro de la aplicación, una vez el usuario final haya confirmado una compra en el dispositivo cliente, la tienda de aplicaciones envía al dispositivo datos sobre esa compra. Esa información se guarda en un elemento Compra nuevo en la fuente de página $MT_IN_APP_PURCHASE. Cuando se actualiza la fuente de página se desencadena también el evento SiCompraActualizada. En el cuadro de diálogo Acciones del evento SiCompraActualizada puede definir las acciones que quiere que ocurran en ese momento del proceso de compra dentro de la aplicación. Normalmente (i) se comprueba el código de respuesta para ver si la transacción se ha realizado correctamente o si ha fallado, y (ii) se reconoce la compra.
Consulte también los apartados Productos adquiridos y Proyecto de ejemplo: El botón "Comprar" para más información.
|
Un cambio en la configuración del teléfono es un evento (AlCambiarConfiguraciónTeléfono) para el que puede desencadenar cualquiera de las acciones estándar. Haga clic en el botón Más opciones, a la derecha de la propiedad de proyecto, para definir el conjunto de acciones que quiere ejecutar cuando se desencadene este evento. El evento se desencadena con cualquier cambio en la configuración del teléfono, como cambiar el tema o el idioma.
|
Además de configurar las acciones a realizarse a nivel de página al recibir un mensaje MQTT, también puede configurar acciones a nivel de solución (o proyecto). Las acciones a nivel de proyecto se activarán cuando se reciba un mensaje MQTT en cualquier página de la solución y si no se han definido acciones MQTT a nivel de página para esa misma. Las acciones a nivel de proyecto también permiten utilizar un único conjunto de acciones en todas las páginas.
Para definir acciones a nivel de proyecto para los mensajes MQTT, haga clic en el botón Más opciones, a la derecha del ajuste Acciones MQTT y, a continuación, añada las acciones que desee definir.
|
Cuando se recibe un mensaje de difusión en una solución, las acciones que se deben realizar pueden definirse en las Acciones de difusión del proyecto. Si no se han definido acciones para el evento de página AlRecibirDifusión de la página activa en ese momento, se ejecutarán las Acciones de difusión del proyecto, si están definidas.
Para definir las Acciones de difusión del proyecto, haga clic en el botón Más opciones situado a la derecha del ajuste Acciones de difusión y, a continuación, añada las acciones que desee definir.
|
La propiedad Acciones del escáner de códigos de barras define las acciones que se deben realizar cuando se activan eventos relacionados con los escáneres de códigos de barras (imagen siguiente). Puede definir una secuencia de acciones para cada uno de los siguientes eventos, cuyos nombres se explican por sí mismos:
•AlEstablecerConexión escáner Zebra •AlRecibirDatos escáner Zebra •AlFinalizarConexión escáner Zebra •AlRecibirDatos ordenador de mano Zebra •AlRecibirDatos escáner Datalogic La imagen anterior muestra la definición de una acción que se debe ejecutar cuando se establezca una conexión con un escáner Zebra (evento = Escáner Zebra AlEstablecerConexión).
Después de que la solución se conecte a un escáner, los datos de cualquier código de barras que lea un escáner se envían a la solución y se almacenan en la estructura de la fuente de página correspondiente. Los controladores de eventos AlRecibirDatos de los distintos escáneres le permiten especificar qué acciones se deben realizar una vez recibidos los datos del código de barras en la fuente de página.
Para definir las acciones del escáner de códigos de barras del proyecto, haga clic en el botón Más opciones situado a la derecha de la opción Acciones del escáner de códigos de barras y, a continuación, añada las acciones que desea definir. Para ver un resumen sobre el funcionamiento de los escáneres de códigos de barras, consulte el tema Escáneres de códigos de barras.
|
Propiedad booleana que determina si se pide al usuario que confirme salir de la solución. Seleccione true o false en el cuadro combinado. El valor predeterminado es true. Cuando su valor es true, el texto definido como valor de la siguiente propiedad (Mensaje de salida del flujo de trabajo) aparece antes de que se cierre la solución. Por lo general, se suele pedir confirmación al usuario cuando pulsa el botón Atrás de la primera página de la solución. No se le pide confirmación si el usuario pulsa el botón Enviar o si se procesa una acción Cancelar ejecución de acción.
|
El texto del mensaje que aparece para que el usuario confirme si se sale de la solución o no. El mensaje solamente aparece si la propiedad anterior (Preguntar al usuario al salir del flujo de trabajo) tiene el valor true. El mensaje predeterminado es: ¿Seguro que desea salir de esta solución?
|
Mientras se ejecuta una solución, el usuario final puede cambiar a otra solución. Si esto ocurre, la propiedad Al cambiar a otra solución determina si se suspende la solución original (se pone en pausa y se minimiza) o si se cancela. Si la solución se suspende, la solución se pone en pausa en ese justo momento y no se ejecutan más acciones. Por ejemplo, no se ejecutan temporizadores ni se utilizan geoubicaciones. Cuando la solución se reanuda, se ejecutan las acciones definidas para la opción Al reabrir del evento AlActualizarPágina. Los posibles valores de esta propiedad son:
•Cancelar esta solución: Es el valor predeterminado. La solución se cancela y se pierden los datos que no se guardaran. •Suspender esta solución: La solución se pone en pausa pero no se cierra. Su icono estará disponible en la pestaña En ejecución del dispositivo. Para volver a la solución, el usuario final hace clic en el icono de la solución de la pestaña En ejecución.
Nota: Para probar esta propiedad debe implementar la solución en el servidor y ejecutarla desde allí.
Nota: Consulte también el apartado Ejecución de la solución, donde se describe otra manera de especificar si la solución se debe cancelar o minimizar.
Nota: Los clientes web no son compatibles con la suspensión de soluciones. Solamente admiten la solución activa.
|
Al hacer clic en el botón Examinar de esta propiedad aparece el cuadro de diálogo Abrir, donde puede seleccionar el archivo de imagen PNG que quiere utilizar como icono del proyecto en las aplicaciones cliente. El tamaño máximo de píxeles del icono del flujo de trabajo es 200x200. Se usa por defecto el icono de MobileTogether.
|
Al hacer clic en el botón Examinar de esta propiedad aparece el cuadro de diálogo Configuración del explorador (ver imagen siguiente). Aquí puede definir algunas opciones relacionadas con el explorador del dispositivo cliente. Más abajo explicamos estas configuración. Se pueden configurar estas opciones:
Orientación en escritorioLas opciones del cuadro combinado permiten seleccionar la orientación para el explorador: Forzar orientación vertical y Forzar orientación horizontal. El valor predeterminado es Forzar orientación vertical.
Archivo CSSSolamente para la aplicación de estilos en clientes web (es decir, en exploradores). Esta opción de configuración especifica el archivo CSS externo que se lee para evaluar las propiedades CSS asignadas a los selectores de clases de los controles del diseño. El archivo CSS externo se puede modificar en cualquier momento para cambiar el aspecto de los componentes del diseño. Cada componente de diseño tiene una propiedad llamada Clase CSS del explorador que define un nombre de clase CSS propio del control. Las propiedades CSS para estos selectores de clase se pueden definir más tarde en un archivo CSS externo, que se implementa en el servidor. El archivo CSS que sirve para buscar las reglas de clase se define con esta opción (archivo CSS). Puede seleccionar el archivo CSS con una ruta de archivo o con un alias de recurso global. También puede usar una expresión XPath para generar la ruta de acceso del archivo. Tenga en cuenta estos aspectos: i) las reglas CSS definidas en el archivo CSS externo tienen menor prioridad que las definiciones realizadas en las propiedades de los controles y ii) el archivo CSS externo no está disponible en simulaciones para exploradores web.
Archivo de fuentesEspecifica uno o más archivos de fuentes que se deben incrustar en el diseño y usar junto con las fuentes del sistema. Puede buscar el archivo en el sistema de archivos, usar un recurso global o generar su ruta de acceso con una expresión XPath. Los tipos de archivo de fuentes que se admiten son: .ttf, .otf, .woff y .woff2. Además, MobileTogether generará correctamente fuentes .eot, .svg y .svgz. Sin embargo, estos tipos de archivo de fuentes no son compatibles con todos los exploradores. Si quiere incrustar varios archivos de fuentes, introduzca una expresión XPath que sea una cadena que contenga las distintas rutas de acceso de los archivos separadas por comas (ver imagen anterior). Se pueden usar la propiedad font-family y CSS para hacer referencia a las fuentes que se incrusten en el diseño de esta manera. Si se ha incrustado una fuente que también está disponible en el sistema local, entonces se usará la fuente del sistema. Si se indica la misma fuente en distintos tipos de archivo (por ejemplo, WOFF2 y TTF), entonces el explorador descargará el tipo con el que sea más compatible, pero no los tipos de archivo alternativos. Para más información sobre CSS e información sobre fuentes y exploradores consulte las páginas web MDN: @font-face y font-family.
Permitir la navegación de regreso en <iframe>Esta propiedad afecta a las Soluciones incrustadas en páginas web, que son soluciones que se cargan en el elemento IFrame de una página web. Si esta opción se establece en true, el botón de navegación Atrás del navegador permite al usuario final navegar hacia atrás dentro del IFrame. El valor predeterminado para esta opción es false.
Tamaño de fuente predeterminadoEsta opción permite seleccionar un tamaño de fuente base a partir del cual se calculan todos los tamaños de fuente de los controles. La opción Predeterminado del explorador selecciona el tamaño predeterminado del explorador. La opción predeterminada es 16px.
Pedir confirmación al usuario cuando se cierren ventanas/pestañas del exploradorEsta opción habilita un cuadro de mensaje que aparece cuando el usuario final quiere cerrar la ventana o una pestaña del explorador en la que se ve la solución. El mensaje (i) pide al usuario confirme si realmente quiere abandonar la página e (ii) informa al usuario de que si pulsa Salir, se perderán los cambios que no se hayan guardado. Esta opción se aplica a todas las páginas del proyecto. Si está habilitada y quiere deshabilitarla para una o varias páginas de forma individual, entonces debe definir el valor de la propiedad Clase CSS del explorador como mt-no-browser-exit-confirmation en cada una de esas páginas (véase Propiedades de página).
Fuentes para el control Texto enriquecidoAgregue las fuentes que quiera que estén disponibles para el usuario final. Estas fuentes aparecerán en la lista desplegable de fuentes del cuadro combinado del control Texto enriquecido. Si no se indica ninguna fuente en esta lista se deshabilitará la opción de escoger una fuente en la solución.
NotaLas rutas relativas de este cuadro de diálogo son relativas a: (i) al directorio de la solución en el servidor y (ii), en MobileTogether Designer, al directorio en el que está ubicado el diseño.
|
Al hacer clic en el botón Examinar de la propiedad Más opciones de configuración del proyecto aparece el cuadro de diálogo del mismo nombre (ver imagen siguiente). Observe que estas opciones están divididas en dos pestañas. Se pueden configurar estas opciones:
•Tiempo de espera de la reimplementación: Una vez reimplementada la solución, el número de horas durante las que se conserva la solución reemplazada en el servidor. Este tiempo de superposición permite finalizar el trabajo a los clientes que utilicen la solución antigua. El valor predeterminado es 5 horas.
•Modo de compatibilidad con Xpath: Si tiene el valor true, las construcciones XQuery que no son válidas en XPath se resuelven de modo que las instrucciones XQuery que contengan estas construcciones sean compatibles con XPath y se puedan usar allí donde se permitan expresiones XPath. En concreto se trata de las referencias de entidad y de caracteres XQuery, que están permitidas en XQuery pero no en XPath. Si esta opción tiene el valor true, las referencias de entidad y caracteres XQuery se leen como texto en XPath, es decir, no se resuelven. El valor predeterminado es true.
•Anular el control de acciones si hay errores: Anula el control de acciones si ocurre un error. El error puede estar en una expresión XPath o en otro punto del control de acciones. Los errores menores, como los errores de XPath a la hora de seleccionar una propiedad de estilo, se ignoran y el control de acciones continúa. El valor predeterminado es true.
•Omitir espacio de nombres predet. en documentos HTML: Como en los documentos XML solamente se permite un espacio de nombres predeterminado, si no omite el espacio de nombres predeterminado de los documentos HTML, podrían darse errores a la hora de leer fuentes de datos XML. El valor predeterminado es true: Es decir, el espacio de nombres HTML predeterminado se omite.
•Reincrustación automática: Hace referencia a la función de incrustación de fuentes de página en el archivo (de diseño) del proyecto. Si habilita esta opción con el valor true, entonces las fuentes de página se reincrustan cuando se implemente o se simule el diseño. Esto garantiza que se incrusten los archivos de fuente de datos más recientes y que lo datos, por tanto, sean actuales. El valor predeterminado para esta opción es true.
•Guardar visualización del dispositivo: Si esta opción está habilitada, entonces la configuración del dispositivo (tipo de dispositivo, nivel de acercamiento y orientación de página) se guarda con el diseño. El diseño siempre se abre con la configuración que tenía la última vez que se guardó. El valor predeterminado para esta opción es false.
•Control de acciones Al implementar en servidor: Al hacer clic en esta opción se abre un cuadro de diálogo Acciones para el evento AlImplementarEnServidor. Aquí puede introducir una secuencia de acciones para que se ejecuten cuando se implemente en el servidor. Solo se pueden añadir acciones relacionadas con el servidor y que estén habilitadas (es decir, las que no aparezcan en gris claro). Mientras se realiza el control de las acciones, el servidor está bloqueado y los clientes no se puede conectar a él. Los valores de los parámetros de entrada para esta acción se envían durante el proceso de implementación. Durante la implementación los valores de los parámetros se pasan a la variable $MT_InputParameters de la solución, desde donde se puede acceder a ellos. La estructura de datos de la variable $MT_InputParameters se especifica en una de las opciones del proyecto (véase el punto siguiente).
•Parámetros de entrada: Indica el tipo de estructura de datos de la variable $MT_InputParameters. Las opciones son: (i) Parámetros nombrados, que es una estructura de asignación de datos (por ejemplo: {{"name":"Altova", "location":"Boston"}) y (ii) Secuencia de valores, que es una estructura de secuencia de datos (por ejemplo: ("Altova", "Boston")). El valor predeterminado es Parámetros nombrados. Para más información consulte la descripción de MT_InputParameters, las opciones de proyecto anteriores, Control de acciones Al implementar en servidor y el comando Implementar en MobileTogether Server.
•Todos los estilos: Esta opción indica si la propiedad Todos los estilos de un componente o una página del diseño está o no disponibles. Los valores que puede tener son true o false. El valor predeterminado es false. Si se cambia a true, entonces la propiedad Todos los estilos aparece en el panel Estilos y propiedades. La propiedad permite colocar todos los estilos del componente o la página seleccionados en un solo lugar, por ejemplo usando una expresión XPath de asignación. Para más información sobre cómo usar la propiedad Todos los estilos consulte su descripción, por ejemplo en el control Botón.
•Opciones avanzadas ActualizarImagen: Indica si la acción Actualizar imagen en pantalla cuenta con opciones avanzadas (true) o no (false). Las opciones avanzadas permiten indicar qué controles de una página se actualizan. Si las opciones avanzadas no están habilitadas, entonces se actualizan todos los controles de una página. El valor predeterminado es false. Para más detalles sobre las opciones de esta acción consulte Actualizar imagen en pantalla.
•Relleno de tabla iOS: Determina si se utiliza o no relleno en las tablas en dispositivos iOS. El valor predeterminado es true. Si el valor de la propiedad es true, lo que incluye el estado predeterminado de la misma, la tabla tendrá asignado un valor de relleno de 9px a la derecha y a la izquierda y un valor de relleno de 5px en la parte inferior y superior. Si también se han establecido valores para alguna propiedad de Relleno de tablas individuales, entonces el valor Relleno (superior, derecho, inferior e izquierdo) se añadirá al valor correspondiente de Relleno de tabla iOS. Si el valor de la propiedad Relleno de tabla iOS es false, pues no se aplica relleno a las tablas de forma predeterminada, sino que se aplican solamente los valores que defina para tablas individuales. Recuerde que la opción Relleno de tabla iOS afecta a las tablas iOS de todo el proyecto.
•Modo de compatibilidad de la interfaz gráfica: Algunas de las propiedades de estilo predeterminadas no se ven igual en los dispositivos cliente según la plataforma. El valor predeterminado del Modo de compatibilidad de la interfaz gráfica es false. Si lo cambia a true, los valores predeterminados de estilo tendrán un aspecto parecido en todas las plataformas. Lo que ocurre es que se modifica el valor predeterminado de los valores de estilo discordantes. Por ejemplo, el relleno de tabla iOS se definió como false, los márgenes de nivel superior son 0px para todos los dispositivos y el relleno de los botones es de 0px para Android y 1dp para el resto de plataformas. Recuerde que esta opción modifica los estilos predeterminados. Si quiere definir estilos personalizados puede hacerlo de la forma habitual. Para ver una lista de los valores predeterminados de estilos que son distintos consulte Variación del estilo entre los clientes.
•Márgenes de nivel superior: Los controles de nivel superior son aquellos situados dentro del diseño directamente (es decir, todos los controles que no están dentro de una tabla). El margen que establezca en estas opciones para los controles de nivel superior reemplazarán los márgenes predeterminados propios de cada dispositivo. Básicamente establecen un margen para cada página del proyecto y, por tanto, permiten un mayor control del diseño. Por ejemplo, actualmente los dispositivos Android establecen un margen predeterminado de 9px (ver nota sobre controles Etiqueta al final del párrafo). Si prefiere otro margen para las páginas del proyecto, puede usar estas propiedades del proyecto para ajustar los márgenes. El campo Predeterminado para todos en Margen de control de nivel superior establece el margen especificado en los cuatro lados de la página. También puede configurar por separado los márgenes superior, inferior, derecho e izquierdo. Si deja en blanco uno de los márgenes, se usará el margen predeterminado propio del dispositivo. (Nota: En Android los controles Etiqueta tienen un margen inferior de 0px. Para modificar esta configuración puede cambiar el margen de nivel superior (esta opción) o el margen inferior del control Etiqueta.)
•Mensaje de límite de tiempo de la sesión del cliente: Puede introducir un mensaje en el dispositivo cliente cuando se agote el límite de tiempo del servidor. Puede introducir ese mensaje directamente u obtenerlo como resultado de evaluar una expresión XPath.
|