Base de conhecimento

Atualização da interface do usuário

Passa novo conteúdo para a interface do usuário e o atualiza.

Senha: ui_update

Elementos

• widget_params: Faz referência aos elementos da interface do usuário que precisam ser alterados em vez de usar parâmetros predefinidos.
  • Obrigatório: Sim
  • Valor padrão: Vazio

Conteúdo da widget_params

•  widget_params é uma lista de ui_element.
  • ui_element: Contém os parâmetros, que devem ser alterados.
  • name: Atributo de ui_element, que é a referência ao elemento da interface do usuário a ser atualizado.

Exemplo

<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>

Alterar status do botão

Altera o status de um botão. Ele é usado para ativar ou desativar um botão.

Identificador: change_button_status

Elementos

• button_tag: O nome do botão no layout. Esse "nome" deve ser maiúsculo.
  • Obrigatório: Sim
  • Valor padrão: Vazio

• control: Define o status como "ACTIVATE" ou "DEACTIVATE"

Exemplo

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

Notificação

Exibe uma notificação temporária na lateral do aplicativo. Não influencia o fluxo de trabalho.

Identificador: ui_notification

Atributos

• type: Define a visualização da notificação. Valores possíveis: INFO, NOTIFICATION, WARN e ERROR.
  • Obrigatório: Não
  • Valor padrão: INFORMAÇÃO
• duração: o tempo após o qual a notificação desaparece. Valores possíveis: SHORT (3 segundos) e LONG (10 segundos).
  • Obrigatório: Não
  • Valor padrão: SHORT
• show_immediately: Exibe a notificação imediatamente.
  • Obrigatório: Não
  • Valor padrão: False

Elementos

• message: O conteúdo a ser mostrado
  • Obrigatório: Não
  • Valor padrão: cadeia de caracteres vazia

Exemplo

<ui_notification id="error_note" type="ERROR" duration="LONG" show_immediately="true">
   <message>Nenhuma conexão de servidor estabelecida!</message>
</ui_notification>

Diálogo

Exibe uma janela de diálogo que requer interação com o usuário. Ele envia eventos como em quais botões o usuário clicou para uma etapa de chamada específica.

Senha: ui_dialog

Atributos

• type: Define a visualização da caixa de diálogo. Valores possíveis: INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR e FATAL.
  • Obrigatório: Não
  • Valor padrão: INFO
• title: Um nome curto para a caixa de diálogo.
  • Obrigatório: Não
  • Valor padrão: Cadeia de caracteres vazia
• message: O conteúdo a ser mostrado.
  • Obrigatório: Não
  • Valor padrão: Cadeia de caracteres vazia
• close_command: A caixa de diálogo será fechada sempre que o evento de entrada for acionado.
  • Obrigatório: Não
  • Valor padrão: Nenhum

Elementos

• botões: contém uma lista de botões em que o usuário pode clicar. É possível definir até três botões. O mínimo é um botão.
• Obrigatório: Sim
• Valor padrão: Vazio

Botões

• text: Texto do rótulo do botão.
  • Obrigatório: Sim
  • Valor padrão: Vazio
• command: O comando de evento que é acionado quando o botão é pressionado.
  • Obrigatório: Sim
  • Valor padrão: Vazio
• speech_command: O comando de fala que ativa este botão.
  • Obrigatório: Não
  • Valor padrão: Vazio
• focalizado: define um botão a ser pré-selecionado.
  • Obrigatório: Não
  • Valor padrão: Falso
• som: consulte PlaySound Action para obter os sons disponíveis.
  • Obrigatório: Não
  • Valor padrão: Vazio

Saída

Aciona eventos que contêm o comando especificado em um botão depois que ele é clicado (ou seu comando de fala é reconhecido).

Exemplo

<ui_dialog id="test" type="INFO" title="my title" message="my message">
    <buttons>
        <button text="New order" command="NEW_ORDER" speech_command="Neue Order" focused="true"/>
        <button text="Same order" command="SAME_ORDER"/>
     </buttons>
</ui_dialog>

Caixa de diálogo Página

Exibe uma tela de diálogo que requer a interação do usuário. Ele envia os eventos de diálogo que ocorrem quando a janela é fechada.

Identificador: ui_page_dialog

Atributos

• type: Define a visualização da notificação.
• Valores possíveis: INFO, INTERMEDIATEPROGRESS, PROGRESS, QUESTION, NOTIFICATION, WARN, ERROR, FATAL
  • Obrigatório: Sim
  • Valor padrão: Vazio
• title: Um nome curto para a caixa de diálogo.
• Valores possíveis: Pode ser uma referência a um recurso android ou ser uma cadeia de caracteres.
  • Obrigatório: Não
  • Valor padrão: Vazio

Elementos

• mensagens: contém uma lista de mensagens que serão exibidas na caixa de diálogo. Pode fazer referência a uma variável de contexto ou a uma lista de mensagens. Ao fazer referência a uma variável de contexto, o atributo context_variable é definido como o booleano true.
  • Obrigatório: Sim
  • Valor padrão: Vazio

• botões: Contém uma lista de três botões nos quais o usuário pode clicar.

Botões

Há três botões em que o usuário pode clicar:

• previous_page_btn
• next_page_btn
• close_btn

• speech_command: O comando de fala que aciona esse botão.
  • Obrigatório: Não
  • Valor padrão: Vazio
• focalizado: define um botão a ser pré-selecionado.
  • Obrigatório: Não
  • Valor padrão: False
• text: O texto do rótulo do botão.
  • Obrigatório: Sim
  • Valor padrão: Vazio
• command: O comando de evento que é acionado quando o botão é pressionado. Isso só está disponível para close_btn.

Saída

Aciona eventos que contêm o comando especificado dentro de um botão, uma vez que o botão é clicado (ou seu comando de fala é reconhecido).

Exemplos

Mínimo

<ui_page_dialog id="show-server-errors-dialog" type="ERROR" title="Falha no procedimento">
   <messages>
      <message>Primeiro erro... </message>
      <message>Erro de segundo... </message>
      <message>Terceiro erro... </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 as opções

<ui_page_dialog id="confirm_pick" type="INFO" title="Aqui vamos nós novamente"><
   messages<>
      message>what</message>
      <message>to</message>
      <message>do</message>
   </messages>
   <buttons>
      <previous_page_btn>
         <text><![ CDATA[<]]></text>
         <speech_command>PREVIOUS</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>

Usando context_variable = true

<ui_page_dialog id="confirm_what_to_do" type="INFO" title="Aqui vamos nós novamente">
   <messages context_variable="true">#{what_to_do}</messages>
   <buttons>
      <previous_page_btn>
         <text><!

[CDATA[<]]></texto> <speech_command>ANTERIOR</speech_command> <focado>falso</focado> </previous_page_btn> <next_page_btn> <texto><! [CDATA[>]]></texto> <speech_command>PRÓXIMO</speech_command> <focado>falso</focado> </next_page_btn> <close_btn> <texto>ANDRRES_cancel</texto> <comando>BW</comando> <speech_command>RETORNO</speech_command> <focado>falso</focado> </close_btn> </botões> </ui_page_dialog>

Manipulando o resultado

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

Notificação de progresso

Abre e fecha uma notificação intermediária e não interruptiva no canto superior direito da tela. Isso permite que o trabalhador saiba se algo está acontecendo em segundo plano.

Casos de uso sugeridos:

• Um trabalhador tem que esperar até que a comunicação seja executada.
• Aguardando comunicação de rede síncrona (baixando ou carregando arquivos ou confirmando dados para o BackEnd).

Senha: ui_progress_notification

Atributos

• id: Referência à notificação exibida, necessária para manipular a ação "fechar".
• Valores possíveis: underscore_separated_string
  • Obrigatório: Sim
  • Valor padrão: Necessário ser definido, nenhum valor padrão.

• título: Texto exibido na TitleBar
• Valores possíveis: Título opcional (variáveis wf serão resolvidas)
  • Obrigatório: Sim
  • Valor padrão: Vazio

• mensagem: texto exibido em um espaço de mensagem
• Valores possíveis: Mensagem de notificação (variáveis wf serão resolvidas)
  • Obrigatório: Sim
  • Valor padrão: Necessário ser definido, nenhum valor padrão.

• action: Executa um comando ou uma lista de comandos.
• Valores possíveis: Mostrar e fechar
  • Obrigatório: Sim
  • Valor padrão: Necessário ser definido, nenhum valor padrão.

Exemplos

Mínimo

Para abrir a notificação:

<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 fechar a notificação novamente:

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

Todas as opções

<ui_progress_notification id="show_progress"><
  param name="id">group_confirmation</param>
  <param name="title">CommitProcess</param>
  <param name="message">Confirmando 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

Modificações no repositório de estilo

Permite a criação de novos estilos e a modificação dos já existentes em seu layout.

Casos de uso sugeridos:

• Tornar os itens de lista do mesmo tamanho de texto

Identificador: modify_style_repo

Atributos

• style_name: Nome de destino para estilos criados

• Valores possíveis: Underscore_separated_string
  • Obrigatório: Sim
  • Valor padrão: Necessário ser definido, nenhum valor padrão.

• base_on: Nome do estilo existente, o novo estilo herdará seus atributos.
• Valores possíveis: underscore_separated_string
  • Obrigatório: Não
  • Valor padrão: Opcional, sem valor padrão

• substituir: Substitui as propriedades do estilo criado anteriormente.
• Valores possíveis: verdadeiro, falso
  • Obrigatório: Não
  • Valor padrão: False

Elementos

• properties: Estes são os atributos da interface do usuário.
  • Obrigatório: Sim
  • Valor padrão: Necessário ser definido, nenhum valor padrão.

Exemplos

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 referência nos elementos de layout da interface do usuário:

<Nome da lista="SELF_MENU_TABLE_MENU" Weight="0.75" FocusOrder="0" 
      TextStyle="LIST_ITEM_STYLE_SAME_SIZE" 
      PageIndicatorStyle="PAGE_INDICATOR_STYLE" EntradasPerPage="5" Border="0,gray.dark,black" Padding="10,0,10,0"/>

Produz: