Configurar uma tela de registro com parâmetros

Configure uma tela de registro para consultar um usuário em busca de um parâmetro. A tela usa esse parâmetro para determinar o registro que aparece na tela.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Todos > Sistema Móvel > Construtor de apps para celular.
   O Construtor de apps para celular
2. Pesquise o escopo da aplicação no qual você está trabalhando e selecione o nome do escopo da aplicação.
   O Construtor de apps para celular
3. Selecione a categoria Telas e, em seguida, selecione Novo.
4. Selecione a opção Registro na página Criar uma tela e selecione Continuar.
5. Preencha os seguintes campos conforme necessário.

   Tabela 1. Campos da tela de registro

   Campo	Descrição
   Nome	O nome da sua tela. Este nome aparece como um bloco no aplicativo para celular.
   Descrição	Informações adicionais sobre sua tela.
   Buscar tipo	Configurações que determinam quando os dados são carregados na tela. Selecione um dos seguintes tipos de busca: Pré-busca: esta opção pré-carrega os dados da tela de registro quando um usuário final acessa uma lista, calendário ou tela de registro. Sob demanda: o app envia uma solicitação de rede para carregar o app somente quando os usuários finais navegam até ele. Plano defundo: o app faz uma solicitação de rede em segundo plano para carregar telas integradas ou gravar segmentos de tela. Pré-buscadinâmica: as telas das primeiras 10 linhas são carregadas conforme descrito para o tipo de busca Pré-busca. Depois que as 10 primeiras linhas forem carregadas, linhas adicionais de telas serão carregadas com o tipo de busca sob demanda.
   Contagem de pré-busca dinâmica	Você pode alterar o número de linhas carregadas com pré-busca alterando o valor do campo Contagem de pré-busca dinâmica.
   Ocultar nome da tela	Opção para ocultar o nome da tela do registro.
   Exibir usando (Cartão legado/Cartão)	Um cartão usado para a seção de cabeçalho da tela de registro. Use o Construtor de cartões para Mobile para mudar a aparência do seu cartão móvel ou os campos exibidos no cartão. Para obter mais detalhes sobre como usar Construtor de cartões para Mobile, consulte Personalizar uma tela usando Construtor de cartões para Mobile. A prática recomendada é usar o Cartão.
   Cartão	Este é um elemento que exibe visualmente informações de diferentes registros. Você pode estilizar essas informações definindo condições específicas para cada tipo de informação.
   Ícone	Ícone que aparece no cabeçalho da tela do inicializador.
   Alerta	Esta é uma sobreposição de alerta móvel para uma tela de registro. Use-o para informar os usuários sobre uma mensagem importante e para redirecioná-los para uma tela específica. Somente um alerta móvel está disponível por instância.
   Item de dados	Isso define a tabela de origem dos dados e quais condições devem ser atendidas para os dados serem exibidos.
   Segmentos da tela do registro	Este é um elemento de IU para alternar entre diferentes listas em uma única tela de registro. Use-o para dividir o conteúdo em diferentes áreas na tela.
   Altura dos segmentos dinâmicos	Define a altura dos segmentos dimensionados dinamicamente.
   Largura mínima dos segmentos dinâmicos	Define a largura mínima para segmentos dimensionados dinamicamente.
   Instâncias de função do menu principal	Funções colocadas no menu superior da tela de registro.
   Parâmetros de IU	Esta é uma variável que afeta o comportamento de um campo ou elemento de IU. Use-o para determinar como um valor pode ser inserido ou se ele será preenchido automaticamente para um elemento de IU com base no que o usuário fez.
   Título da tela dinâmica	É assim que você pode criar um elemento e mapeá-lo para um parâmetro de IU. Use-o para passar um valor de uma tela para outra e incluí-lo no título da tela de destino.
   Acesso à função	Opção para limitar o acesso do usuário à tela por função.

6. No formulário da tela Registro, selecione um item de dados existente ou crie um novo.

   Tabela 2. Novos campos de item de dados

   Campo	Descrição
   Nome	Nome do item de dados.
   Descrição	Informações adicionais sobre o item de dados.
   Tabela	Tabela da qual o item de dados obtém seus dados.
   Agrupar por	Determine por quais valores a tabela será agrupada.
   Tipo de Condição	Se as condições do item de dados são declarativas, com script ou usam uma consulta codificada. Deixe este campo com sua configuração padrão.
   Condição offline	Condições a serem aplicadas quando o usuário define o app para o modo off-line.
   Parâmetros	Parâmetro de dados usado para filtrar o item de dados. Use parâmetros para aceitar valores passados de telas ou de outras fontes.

7. Na tela Item de dados, crie um novo parâmetro de dados selecionando o botão Novo no campo Parâmetros.
8. Na tela Novo parâmetro de dados, insira um nome para o parâmetro no campo Nome e selecione o parâmetro Tipo.
   Os tipos disponíveis são Inteiro, Cadeia de caracteres, Decimal, Booliano, Data/hora ou Data. Para obter mais detalhes sobre as opções disponíveis ao criar itens de dados parametrizados, consulte Configurar um item de dados parametrizado.
9. Use a árvore de hierarquia do painel esquerdo para retornar ao item de dados para o qual você acabou de criar um parâmetro de dados.
   No campo Condição, crie uma consulta que usa seu parâmetro para filtrar seus registros.
10. Use a árvore de hierarquia do painel esquerdo para retornar à Tela de registro e selecione Novo no campo Parâmetros de IU para criar um novo parâmetro.
11. Na seção Propriedades, insira um nome para o parâmetro de IU.
12. Na seção Configuração, preencha os seguintes campos.

    Tabela 3. Formulário de configuração de parâmetro de IU

    Campo	Descrição
    Tipo de entrada	Como os usuários inserem um valor para este parâmetro. Selecione uma das seguintes opções: Texto Lista de Seleção Lista de pesquisa QR/Código de barras
    Nome da tabela	Tabela usada para a lista de seleção em que os usuários selecionam um valor de parâmetro. Nota: Este campo fica visível somente quando o Tipo de entrada está definido como Lista de seleção ou Lista de pesquisa.
    Nome do campo	O campo usado para a lista de seleção em que os usuários selecionam um valor de parâmetro. Nota: Este campo fica visível somente quando o Tipo de entrada está definido como Lista de seleção ou Lista de pesquisa.
    Valor-padrão	Valor padrão para o seu parâmetro. Nota: Este campo só fica visível quando o Tipo de valor padrão é definido como Manual.
    Estilo de entrada	Estilo de entrada para o seu parâmetro. Selecione Em linha ou Pop-up.
    Tipo de valor padrão	Se o parâmetro tem um valor padrão. Selecione Nenhum para não ter nenhum valor padrão ou Manual para inserir um valor manual no campo Valor padrão.
    Obrigatório	Determina se a entrada do usuário para o parâmetro é obrigatória.
    Texto de espaço reservado	Texto que aparece no campo de entrada do parâmetro antes que os usuários insiram um valor.
    Seleção múltipla	Se o usuário pode selecionar vários valores na lista de seleção. Nota: Este campo fica visível somente quando o Tipo de entrada está definido como Lista de seleção.
    Tipo de busca	O tipo de pesquisa usado ao encontrar um valor de parâmetro. Nota: Este campo fica visível somente quando o Tipo de entrada está definido como Lista de pesquisa.
    Suportados	Se este parâmetro é um parâmetro transportado. Use parâmetros transportados para mover informações entre diferentes telas e ações.

13. Na seção Mapeamento de parâmetro de dados, selecione o botão Escolher para criar um novo mapeamento de parâmetro.
14. Selecione o parâmetro de dados que você criou para o item de dados.
15. Selecione Aplicar.
16. Selecione Salvar.

Resultado

O parâmetro de IU no seu formulário está associado ao parâmetro de dados no seu item de dados. Quando um usuário acessa este formulário, a tela solicita um valor para o parâmetro. O item de dados usa esse valor para filtrar o registro exibido no formulário.