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

Caso de Uso¶

No Vinyl podemos definir um objeto de dados para um controle de list box na página de uma aplicação. 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 serão frequentemente exibidos nas páginas do aplicativo à medida que os registros se tornam inativos.

O valor Selecionável pelo usuário disponível para ser configurado para uso no Vinyl é compatível com List Objects, Radio e Button Group Controls. Este recurso permite aos usuários configurar informações sobre ele no nível do painel de controle e opcionalmente no nível do objeto de negócio. Quando configurado no nível de controle do painel (o que o Vinyl olha ao executar a página) para um determinado objeto resultará na apresentação apenas de linhas de dados ativas para seleção.

Visão Geral¶

Em segundo plano, 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ócio e aplicado dentro do controle de lista. Com esta nova abordagem selecionável pelo usuário, quando os dados estiverem 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 percorrerá a criação de selecionável pelo usuário para um objeto de lista. O recurso também é compatível com controles de grupo de rádio e botão.

Para que o recurso Selecionável pelo usuário funcione corretamente, ele deve ser configurado em um painel Configurações de caso extremo. O controle Lista tem um novo campo Caso extremo chamado Selecionável pelo usuário no conjunto de controles Pesquisa (Opções de filtro). Este campo é onde você pode definir uma coluna booleana do seu objeto de dados que é a coluna do indicador ativo. Quando o controle Lista entra em 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 esta página
3. Selecione o painel que contém o controle de lista
4. Clique no ícone pop-up do controle de lista
5. Clique no botão Configurações de caso extremo
6. No campo Selecionável pelo usuário do conjunto Pesquisa (Opções de filtro), defina a coluna que deseja indicar como indicador ativo. Por exemplo: ReportsTo
7. Clique em Salvar

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

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

Exemplo de Configuração¶

Neste exemplo, veremos como desativar a exibição de categorias em uma lista marcada como Inativa 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 List Object da 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 Coluna e selecione "Selecionável pelo usuário" como o valor para Tipo de uso.

   

5. Navegue de volta ao Control Designer para o controle de lista 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 "Ativa".

   

7. Navegue de volta para a visualização do Aplicativo e teste. Neste exemplo, você verá agora que as duas Categorias Não Ativas (Alt-Carnes e Cremes) não aparecem mais como opções na lista ao editar ou criar um Produto.