Knowledge base

Volver a la descripción general del soporte

Actualización de la interfaz de usuario

Pasa contenido nuevo a la interfaz de usuario y la actualiza.

Identificador: ui_update

Elementos

  • widget_params: Hace referencia a los elementos de la interfaz de usuario que se deben cambiar en lugar de usar parámetros predefinidos.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío

Contenido de widget_params

  •  widget_params es una lista de ui_element.
    • ui_element: Contiene los parámetros que deben cambiarse.
    • name: Atributo de ui_element, que es la referencia al elemento de la interfaz de usuario que se va a actualizar.

Ejemplo

<ui_update id="show_specified_amount">
   <widget_params><ui_element
      name="EXT_SCANNER_NAME">
         <param name="content">Socket 7Xi</param>
      </ui_element>
      <ui_element name="STATUS">
         <param name="content">CONNECTED</param>
         <param name="text_color">green.dark</param>
      </ui_element>
   </widget_params>
</ui_update>

Cambiar el estado del botón

Cambia el estado de un botón. Se utiliza para activar o desactivar un botón.

Identificador: change_button_status

Elementos

  • button_tag: El nombre del botón en el diseño. Este "nombre" debe estar en mayúsculas.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • control: Establece el estado en "ACTIVAR" o "DESACTIVAR"

Ejemplo

<change_button_status id="deactivate_continue_btn">
    <button_tag>CONTINUE_BTN</button_tag>
    <control>DEACTIVATE</control>
</change_button_status>

Notificación

Muestra una notificación temporal en el lateral de la aplicación. No influye en el flujo de trabajo.

Identificador: ui_notification

Atributos

  • type: Define la visualización de la notificación. Valores posibles: INFO, NOTIFICATION, WARN y ERROR.
    • Obligatorio: No
    • Valor predeterminado: INFORMACIÓN
  • duration: El tiempo después del cual desaparece la notificación. Valores posibles: SHORT (3 segundos) y LONG (10 segundos).
    • Obligatorio: No
    • Valor predeterminado: SHORT
  • show_immediately: Muestra la notificación inmediatamente.
    • Obligatorio: No
    • Valor predeterminado: False

Elementos

  • message: El contenido que se va a mostrar
    • Obligatorio: No
    • Valor predeterminado: Cadena vacía

Ejemplo

<ui_notification id="error_note" type="ERROR" duration="LONG" show_immediately="true">
   <message>No se ha establecido conexión con el servidor!</message>
</ui_notification>

Diálogo

Muestra una ventana de diálogo que requiere interacción con el usuario. Envía eventos como los botones en los que el usuario hizo clic para un paso de llamada determinado.

Identificador: ui_dialog

Atributos

  • type: Define la visualización del cuadro de diálogo. Valores posibles: INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR y FATAL.
    • Obligatorio: No
    • Valor predeterminado: INFO
  • title: Un nombre corto para el cuadro de diálogo.
    • Obligatorio: No
    • Valor predeterminado: Cadena vacía
  • message: El contenido que se va a mostrar.
    • Obligatorio: No
    • Valor predeterminado: Cadena vacía
  • close_command: El cuadro de diálogo se cerrará cada vez que se active el evento de entrada.
    • Obligatorio: No
    • Valor predeterminado: Ninguno

Elementos

  • botones: contiene una lista de botones en los que el usuario puede hacer clic. Es posible definir hasta tres botones. El mínimo es un botón.
  • Obligatorio: Sí
  • Valor predeterminado: Vacío

Botones

  • text: Etiqueta el texto del botón.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • command: El comando de evento que se activa una vez que se presiona el botón.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • speech_command: El comando de voz que activa este botón.
    • Obligatorio: No
    • Valor predeterminado: Vacío
  • focused: Establece un botón para que sea preseleccionado.
    • Obligatorio: No
    • Valor predeterminado: Falso
  • sonido: Consulte la acción Reproducirsonido para ver los sonidos disponibles.
    • Obligatorio: No
    • Valor predeterminado: Vacío

Salida

Desencadena eventos que contienen el comando especificado dentro de un botón una vez que se hace clic en él (o se reconoce su comando de voz).

Ejemplo

<ui_dialog id="test" type="INFO" title="mi título" message="mi mensaje">
    <buttons>
        <button text="Nuevo pedido" command="NEW_ORDER" speech_command="Neue Order" focused="true"/>
        <button text="Mismo orden" command="SAME_ORDER"/>
     </buttons>
</ui_dialog>

Cuadro de diálogo de página

Muestra una pantalla de diálogo que requiere la interacción del usuario. Envía los eventos de diálogo que se producen una vez que se cierra la ventana.

Identificador: ui_page_dialog

Atributos

  • type: Define la visualización de la notificación.
  • Valores posibles: INFO, INTERMEDIOPROGRESO, PROGRESO, PREGUNTA, NOTIFICACIÓN, ADVERTIR, ERROR, FATAL
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • title: Un nombre corto para el cuadro de diálogo.
  • Valores posibles: puede ser una referencia a un recurso de Android o ser una string.
    • Obligatorio: No
    • Valor predeterminado: Vacío

Elementos

  • messages: Contiene una lista de mensajes que se mostrarán en el cuadro de diálogo. Puede hacer referencia a una variable de contexto o a una lista de mensajes. Cuando se hace referencia a una variable de contexto, el atributo context_variable se establece en el valor booleano true.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • botones: Contiene una lista de tres botones en los que el usuario puede hacer clic.

Botones

Hay tres botones en los que el usuario puede hacer clic:

  • previous_page_btn
  • next_page_btn
  • close_btn
  • speech_command: El comando de voz que activa este botón.
    • Obligatorio: No
    • Valor predeterminado: Vacío
  • focused: Establece un botón para que sea preseleccionado.
    • Obligatorio: No
    • Valor predeterminado: False
  • text: El texto de la etiqueta del botón.
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • command: El comando de evento que se activa una vez que se presiona el botón. Esto solo está disponible para close_btn.

Salida

Desencadena eventos que contienen el comando especificado dentro de un botón, una vez que se hace clic en el botón (o se reconoce su comando de voz).

Ejemplos

Mínimo

<ui_page_dialog id="show-server-errors-dialog" type="ERROR" title="Error en el procedimiento">
   <messages>
      <message>First Error... </message>
      <message>Second Error... </mensaje>
      <mensaje>Tercer error... </message>
   </messages>
   <buttons>
      <previous_page_btn>
         <param name="text">←</param>
         <param name="speech_command">PREVIOUS</param>
      </previous_page_btn>
      <next_page_btn>
         <param name="text">→</param>
         <param name="speech_command">NEXT</param>
         <param name="focused">true</param>
      </next_page_btn>
      <close_btn>
         <param name="text">ANDRRES_cancel</param>
         <param name="command">EXIT_PAGER</param>
         <param name="speech_command">CANCEL</param>
      </close_btn>
   </buttons>
</ui_page_dialog>

Todas las opciones

<ui_page_dialog id="confirm_pick" type="INFO" title="Aquí vamos de nuevo">
   <messages>
      <message>what</message>
      <message>to</message>
      <message>do</message>
   </messages>
   <buttons>
      <previous_page_btn>
         <text><![ CDATA[<]]></PREVIOU<speech_command>>S<
         /speech_command><
         focused>false</focused>
      </previous_page_btn>
      <next_page_btn>
         <text><![ CDATA[>]]></text>
         <speech_command>NEXT</speech_command><
         focused>true</focused>
      </next_page_btn>
      <close_btn>
         <text>Return</text>
         <command>BW</command>
         <speech_command>RETURN</speech_command>
         <focused>false</focused>
      </close_btn>
   </buttons>
</ui_page_dialog>

Uso de context_variable = true

<ui_page_dialog id="confirm_what_to_do" type="INFO" title="Aquí vamos de nuevo">
   <messages context_variable="true">#{what_to_do}</messages>
   <buttons>
      <previous_page_btn>
         <text><!
[CDATA[<]]></texto> <speech_command>ANTERIOR</speech_command> <focalizado>falso</enfocado> </previous_page_btn> <next_page_btn> <texto><! [CDATA[>]]></texto> <speech_command>SIGUIENTE</speech_command> <focalizado>falso</enfocado> </next_page_btn> <close_btn> <texto>ANDRRES_cancel</texto> <comando>BW</comando> <speech_command>REGRESO</speech_command> <focalizado>falso</enfocado> </close_btn> </botones> </ui_page_dialog>

Manejo del resultado

<rule id="confirm_what_to_do_back">
   <expression> <![ CDATA[#{event:command} == 'BW' || #{event:command} == 'RETURN']]> </expression>
   <actions>
      <action ref="backwards"></action>
   </actions><
/rule>

Notificación de progreso

Abre y cierra una notificación intermedia y sin interrupciones en la esquina superior derecha de la pantalla. Esto le permite al trabajador saber si algo está sucediendo en segundo plano.

Casos de uso sugeridos:

  • Un trabajador tiene que esperar hasta que se ejecute la comunicación.
  • A la espera de la comunicación de red síncrona (descarga o carga de archivos o confirmación de datos en el back-end).

Identificador: ui_progress_notification

Atributos

  • id: Referencia a la notificación mostrada, necesaria para manejar la acción de "cerrar".
  • Valores posibles: underscore_separated_string
    • Obligatorio: Sí
    • Valor predeterminado: Obligatorio para establecerse, sin valor predeterminado.
  • title: Texto que se muestra en la barra de título
  • Valores posibles: Título opcional (se resolverán las variables wf)
    • Obligatorio: Sí
    • Valor predeterminado: Vacío
  • message: Texto que se muestra en un espacio de mensajes
  • Valores posibles: Mensaje de notificación (se resolverán las variables wf)
    • Obligatorio: Sí
    • Valor predeterminado: Obligatorio para establecerse, sin valor predeterminado.
  • action: Ejecuta un comando o una lista de comandos.
  • Valores posibles: Mostrar y cerrar
    • Obligatorio: Sí
    • Valor predeterminado: Obligatorio para establecerse, sin valor predeterminado.

Ejemplos

Mínimo

Para abrir la notificación:

<ui_progress_notification id="show_progress">
    <param name="id">group_confirmation</param>
    <param name="message">Bestätige Schritt</param>
    <param name="action">show</param><
/ui_progress_notification>

Para volver a cerrar la notificación:

<ui_progress_notification id="close_progress">
    <param name="id">group_confirmation</param>
    <param name="action">close</param>
</ui_progress_notification>

Todas las opciones

<ui_progress_notification id="show_progress">
  <param name="id">group_confirmation</param>
  <param name="title">CommitProcess</param>
  <param name="message">Confirming PickGroup</param>
  <param name="action">show</param>
</ui_progress_notification>
<ui_progress_notification id="close_progress">
    <param name="id">group_confirmation</param>
    <param name="action">close</param>
</ui_progress_notificatio

Modificaciones del repositorio de estilos

Permite la creación de nuevos estilos y la modificación de los existentes en su diseño.

Casos de uso sugeridos:

  • Hacer que los elementos de la lista tengan el mismo tamaño de texto

Identificador: modify_style_repo

Atributos

  • style_name: Nombre-destino para los estilos creados
  • Valores posibles: Underscore_separated_string
    • Obligatorio: Sí
    • Valor predeterminado: Obligatorio para establecerse, sin valor predeterminado.
  • base_on: Nombre del estilo existente, el nuevo estilo heredará sus atributos.
  • Valores posibles: underscore_separated_string
    • Obligatorio: No
    • Valor predeterminado: Opcional, sin valor predeterminado
  • invalidar: Anula las propiedades del estilo creado anteriormente.
  • Valores posibles: Verdadero, falso
    • Obligatorio: No
    • Valor predeterminado: False

Elementos

  • properties: Son los atributos de la interfaz de usuario.
    • Obligatorio: Sí
    • Valor predeterminado: Obligatorio para establecerse, sin valor predeterminado.

Ejemplos

Mínimo

<modify_style_repo id="change_exception_style" style_name="list_item_style_same_size"><
    properties>
        <param name="text_group" type="string">#{test_group}</param>
    </properties>
</modify_style_repo>

Estilo de referencia en los elementos de diseño de la interfaz de usuario:

<Nombre de la lista="SELF_MENU_TABLE_MENU" Peso="0.75" FocusOrder="0" 
      TextStyle="LIST_ITEM_STYLE_SAME_SIZE" 
      PageIndicatorStyle="PAGE_INDICATOR_STYLE" EntradasPerPágina="5" Borde="0,gris.oscuro,negro" Padding="10,0,10,0"/>

Produce:

Todas las opciones

<modify_style_repo id="change_exception_style" style_name="list_item_style_same_size">
    <param name="base_on" type="string">list_item_style</param>
    <properties>
        <param name="text_group" type="string">#{test_group}</param>
        <param name="maxtextsize" type="string">15</param>
        <param name="gravity" type="string">center</param>
    </properties>
</modify_style_repo>

Elemento de enfoque del conjunto de la interfaz de usuario

Establece un elemento de foco dentro de la interfaz de usuario (UI).

Identificador: ui_set_focus_item

Ejemplo

<ui_set_focus_item id="myaction"><ui_set_focus_item/>