Valor selecionável pelo usuário para objetos de lista no Jitterbit App Builder

Caso de uso

No App Builder, podemos definir um objeto de dados para um controle de caixa de lista em uma página de aplicativo. Os designers frequentemente 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, GUIDs frequentemente aparecem nas páginas do aplicativo à medida que os registros se tornam inativos.

O valor Selecionável pelo Usuário disponível para configuração no App Builder é compatível com Objetos de Lista, Controles de Botão de Opção e Grupos de Botões. Esse recurso permite que os usuários configurem informações sobre ele no nível do controle do painel e, opcionalmente, no nível do objeto de negócios. Quando configurado no nível do controle do painel (o que o App Builder considera 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

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 estão 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, terão acesso a todas as linhas de dados ativas e inativas. Quando o valor da lista está aberto em modo de edição, a lista apresentará apenas linhas de dados ativas para seleção.

Para configurar

Este exemplo irá detalhar a criação de Selecionável pelo Usuário para um Objeto de Lista; o recurso também é suportado em Controles de Botão de Opção e Grupos de Botões.

Para que o recurso Selecionável pelo Usuário funcione corretamente, ele deve ser configurado em um painel de Configurações de Caso Limite. O controle de Lista possui um campo de Caso Limite chamado Selecionável pelo Usuário no grupo de campos Lookup (Opções de Filtro). Este campo é onde você pode definir uma coluna Booleana do seu objeto de dados que é a coluna de indicador ativo. Quando o controle de Lista entra em um estado de edição, quaisquer linhas retornadas onde esta coluna Selecionável pelo Usuário avalia como falsa serão excluídas da lista de seleção.

1. Navegue até a página do aplicativo que contém um objeto de lista que você deseja modificar
2. Vá para Ação > Projetar esta página
3. Selecione o painel contendo o controle de lista
4. Clique no ícone de pop-up para o controle de lista
5. Clique no botão Configurações de Casos Especiais
6. No campo Selecionável pelo Usuário do conjunto Lookup (Opções de Filtro), defina a coluna que você deseja indicar como o 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 da coluna do objeto de negócios. Este Tipo de Uso é apropriadamente chamado de 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 for feito, quando um controle de Lista for adicionado a um painel que aponta para este objeto de negócios, ele preencherá automaticamente o valor de Configuração de Caso Especial Selecionável pelo Usuário para o controle de Lista com o nome desta coluna. Este valor preenchido no nível do Controle do painel pode ser removido ou alterado manualmente para um valor diferente, se desejado.

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

Exemplo de configuração

Neste exemplo, vamos passar por como desabilitar Categorias de aparecer em uma lista que estão marcadas como Inativas ao criar um novo Produto.

1. Para começar, vá para Ação > Projetar esta página e clique no ícone de pop-up para abrir o Controle de Lista que você deseja configurar.

   

2. Clique no nome do Objeto da Lista na região de Propriedades da Tabela de Consulta para editá-lo.

   

3. Neste passo, você pode criar ou modificar uma Coluna Boolean para representar o status; no nosso exemplo aqui, vamos adicionar "Ativo".

   

4. Clique no ícone de pop-up da Coluna e selecione "Selecionável pelo Usuário" como o valor para Tipo de Uso.

   

5. Navegue de volta para o Designer de Controle para o Controle de Lista e clique em "Configurações de Casos Limite" no painel de Recursos

   

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

   

7. Navegue de volta para a visualização da Aplicação 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.