Valor Selecionável pelo Usuário para Objetos de Lista¶

Caso de Uso¶

Em App Builder podemos definir um objeto de dados para um controle de caixa de listagem em uma página de aplicativo. Os designers geralmente adicionam critérios a esses objetos de dados para que os usuários selecionem apenas registros ativos no momento do uso. O desafio é que, com o tempo, os GUIDs geralmente são exibidos nas páginas do aplicativo à medida que os registros se tornam inativos.

O valor User Selectable disponível para ser configurado para uso em App Builder é compatível com List Objects, Radio e Button Group Controls. Este recurso permite que os usuários configurem informações sobre ele no nível de controle do painel e, opcionalmente, no nível do objeto de negócios. Quando configurado no nível de controle do painel (o que App Builder olha ao executar a página) para um dado objeto resultará em apenas linhas de dados ativas sendo apresentadas para seleção.

Visão Geral¶

Para contextualizar, o problema subjacente é que, ao aplicar um filtro ativo como parte dos critérios de seleção do objeto de negócios, os dados não ficam disponíveis para valores de lista que apontam para linhas de dados inativas. Para resolver isso, o filtro ativo precisa ser removido dos critérios de seleção do objeto de negócios e aplicado dentro do controle de lista. Com essa nova abordagem Selecionável pelo Usuário, quando os dados estão sendo visualizados, eles terão acesso a todas as linhas de dados ativas e inativas. Quando o valor da lista é aberto no modo de edição, a lista apresentará apenas linhas de dados ativas para seleção.

Para Configurar¶

Este exemplo mostrará como criar Selecionável pelo Usuário para um Objeto de Lista, o recurso também é suportado em Controles de Grupo de Botão e Rádio.

Para que o recurso Selecionável pelo Usuário funcione corretamente, ele deve ser configurado em um painel Edge Case Settings. O controle List tem um novo campo Edge Case chamado Selecionável pelo Usuário no conjunto de controle Lookup (Opções de Filtro). Este campo é onde você pode definir uma coluna Booleana do seu objeto de dados que é a coluna indicadora ativa. Quando o controle List entra em um estado de edição, todas as linhas retornadas onde esta coluna Selecionável pelo Usuário for avaliada como falsa serão excluídas da lista de seleção. Veja a Figura 1.

1. Navegue até a página do aplicativo que contém um objeto de lista que você deseja modificar
2. Vá para Action Drawer > Design this page
3. Selecione o painel que contém o controle de lista
4. Clique no ícone pop-up para o controle de lista
5. Clique no botão Edge Case Settings
6. No campo User Selectable do conjunto Lookup (Filter Options), defina a coluna que você deseja indicar como o indicador ativo. Por exemplo: ReportsTo
7. Clique em Save

Para auxiliar no desenvolvimento rápido, um novo Tipo de Uso foi adicionado ao pop-up da Coluna do objeto de negócios. Este Tipo de Uso é apropriadamente chamado de Selecionável pelo Usuário. Você pode marcar uma coluna no seu objeto de negócios com o tipo de uso Selecionável pelo Usuário. Se isso tiver sido feito, quando um controle de Lista for adicionado a um painel apontando para este objeto de negócios, ele preencherá o valor da Configuração de Caso de Borda Selecionável pelo Usuário para o controle de Lista automaticamente com este nome de coluna. Este valor preenchido no nível de Controle do painel pode ser removido manualmente ou alterado para um valor diferente, se desejado.

1. Navegue até a Camada de Lógica de Negócios, até um objeto de negócios que você deseja modificar
2. Analise o ícone de engrenagem do SQL para o objeto de negócios
3. Localize a Coluna que você deseja configurar como o valor Selecionável pelo Usuário
4. Clique no ícone pop-up correspondente para a Coluna identificada
5. Selecione Selecionável pelo Usuário como o valor Tipo de Uso para Avançado (Opções de PK e Vinculação)
6. Clique em Salvar

Exemplo de Configuração¶

Neste exemplo, mostraremos como desabilitar Categorias de aparecer em uma lista que são marcadas como Inativas ao criar um novo Produto.

1. Para começar, vá para Action Drawer > Design this page e clique no ícone pop-up para abrir o Controle de Lista que você deseja configurar.

   

2. Clique no nome do List Object na região Lookup Table Properties para editá-lo.

   

3. Nesta etapa, você pode criar ou modificar uma coluna booleana para representar o status; em nosso exemplo aqui, adicionaremos "Ativo".

   

4. Clique no ícone pop-up Column e selecione "User Selectable" como o valor para Usage Type.

   

5. Navegue de volta para o Control Designer para o List Control e clique em "Edge Case Settings" no painel Features

   

6. Defina o valor Selecionável pelo usuário para a coluna que indica o status. Para nosso exemplo, esta é a coluna "Ativo".

   

7. Navegue de volta para a visualização do aplicativo e teste. Neste exemplo, você verá que as duas categorias não ativas (Alt-Meats e Custards) não aparecem mais como opções na lista ao editar ou criar um produto.