É um Valor Ativo para Objetos de Lista

Caso de Uso

Em App Builder podemos definir um objeto de negócios para um controle de caixa de listagem em uma página de aplicativo. Os designers geralmente adicionam critérios a esses objetos de negócios 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 Is Active está 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 determinado objeto resultará em apenas linhas de dados ativas sendo apresentadas para seleção.

Se você aproveitar App Builder opção Aprimorar Tabela, App Builder adicionará automaticamente uma coluna Is Active à tabela. Isso pode ser aproveitado como uma configuração de controle para qualquer conjunto de registros onde você nunca deseja excluir um registro (por exemplo, tabelas auditadas).

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 Is Active, 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 Está Ativo para uma Lista de uma Página

Este exemplo mostrará como criar Está Ativo para um Objeto de Lista. O recurso também é suportado em Controles de Grupo de Botões e Rádio.

Para que o recurso Is Active funcione corretamente, ele deve ser configurado em List Options no Live Designer. O controle List tem um campo chamado Active (Column) nas configurações de List Options. Este campo é onde você pode definir uma coluna Boolean do seu objeto de negócios que é a coluna indicadora ativa. Quando o controle List entra em um estado de edição, todas as linhas retornadas onde esta coluna Is Active é avaliada como false serão excluídas da lista de seleção.

1. Navegue até a página do aplicativo que contém uma lista que você deseja modificar
2. Vá para Action Drawer > Live Designer
3. Selecione o controle de lista na visualização do aplicativo
4. Selecione a aba List Options no Live Designer
5. Para o campo Ativo (Coluna), defina a coluna que você deseja indicar como o indicador ativo. Por exemplo: IsActive
6. Clique em Salvar

Para Configurar Está Ativo a Partir de um Objeto de Negócio

Para auxiliar no desenvolvimento rápido, um novo Tipo de Uso foi adicionado à Camada de Negócios. Este Tipo de Uso é apropriadamente chamado de Está Ativo. Você pode marcar uma coluna no seu objeto de negócios com o tipo de uso Está Ativo. 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 Ativo (Coluna) 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.

Observe que a configuração Está ativo no objeto de negócios é opcional e, se configurada, é usada como uma "dica" para fornecer qualquer painel que contenha uma fonte de pesquisa de lista.

1. Navegue até a Camada de Negócios, até um objeto de negócios que você deseja modificar
2. Clique na aba Colunas
3. Localize a coluna que deseja configurar como o valor Is Active
4. Selecione Está ativo como o valor do tipo de uso
5. Clique em Continuar para salvar a configuração

Exemplo de Configuração

Neste exemplo, mostraremos como desabilitar a exibição de categorias em uma lista marcadas como Inativas ao criar um novo produto.

1. Na página que contém o controle Categoria, vá para Action Drawer > Live Designer
2. Selecione o controle Categoria na visualização do aplicativo
3. Clique na aba List Options do Live Designer
4. Para o campo Ativo (Coluna), selecione o valor IsActive
5. Clique em Salvar
6. Saia do Live Designer 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.