Índice
Introdução
A partir da versão 3.6 foi disponibilizado no Smart View a funcionalidade de configuração de parâmetros. Essa funcionalidade é válida para Tabelas Dinâmicas e Visões de Dados. No caso dos relatórios, a configuração ainda deve ser feita no Design. No entanto, as alterações apenas são refletidas durante a execução no painel correspondente.
A permissão para editar os campos dos parâmetros varia conforme a origem do parâmetro. Para parâmetros originados do Objeto de negócio, apenas o campo 'Valor padrão' é editável.
![](/download/attachments/847875815/image-2024-6-7_9-34-29.png?version=1&modificationDate=1717763669923&api=v2)
![](/download/attachments/847875815/image-2024-6-7_9-44-49.png?version=1&modificationDate=1717764289557&api=v2)
Para parâmetros originados do Filtro, os campos 'Nome amigável', 'Descrição', 'Visível', 'Valor padrão' e 'Opções' são editáveis.
![](/download/attachments/847875815/image-2024-6-7_9-37-45.png?version=1&modificationDate=1717763865777&api=v2)
![](/download/attachments/847875815/image-2024-6-7_9-44-10.png?version=1&modificationDate=1717764250583&api=v2)
Para parâmetros originados do Design, todos os campos são editáveis. Só haverá parâmetros com a origem do Design em relatórios.
![](/download/attachments/847875815/image-2024-6-7_9-42-58.png?version=1&modificationDate=1717764178233&api=v2)
![](/download/attachments/847875815/image-2024-6-7_9-43-32.png?version=1&modificationDate=1717764213060&api=v2)
Configuração de parâmetros
Para configurar os parâmetros, clique no ícone correspondente. Isso abrirá uma janela modal. Observe que essa opção só estará disponível se houver parâmetros no recurso.
![](/download/attachments/847875815/image-2024-6-5_14-21-36.png?version=1&modificationDate=1717608096563&api=v2)
Modal para edição de parâmetros.
![](/download/attachments/847875815/image-2024-5-29_16-31-29.png?version=1&modificationDate=1717592603110&api=v2)
Os parâmetros podem ser reordenados na lista.
![](/download/attachments/847875815/td1.gif?version=1&modificationDate=1717592603193&api=v2)
Grupos
Há a possibilidade de criar grupos para melhor organização dos parâmetros.
![](/download/attachments/847875815/image-2024-4-3_17-52-25.png?version=1&modificationDate=1717592603693&api=v2)
![](/download/attachments/847875815/td2.gif?version=1&modificationDate=1717592603790&api=v2)
Você pode definir se um grupo será exibido inicialmente expandido ou recolhido. Se a opção "Expandir" estiver selecionada, o grupo será exibido expandido por padrão.
![](/download/attachments/847875815/image-2024-6-5_14-41-44.png?version=1&modificationDate=1717609304840&api=v2)
![](/download/attachments/847875815/image-2024-6-5_14-44-33.png?version=1&modificationDate=1717609473977&api=v2)
Caso contrário, o grupo será exibido recolhido.
![](/download/attachments/847875815/image-2024-6-5_14-42-44.png?version=1&modificationDate=1717609364727&api=v2)
![](/download/attachments/847875815/image-2024-6-5_14-43-5.png?version=1&modificationDate=1717609385303&api=v2)
Além disso, é possível adicionar grupos dentro de outros grupos.
![](/download/attachments/847875815/image-2024-6-10_14-48-19.png?version=1&modificationDate=1718041699537&api=v2)
![](/download/attachments/847875815/image-2024-6-10_14-48-36.png?version=1&modificationDate=1718041716497&api=v2)
Separadores
Além disso, há a opção de incluir separadores.
![](/download/attachments/847875815/image-2024-5-29_17-34-49.png?version=1&modificationDate=1717592604337&api=v2)
![](/download/attachments/847875815/vd3.gif?version=1&modificationDate=1717592604440&api=v2)
Nome amigável
Você pode definir um nome amigável para exibição, facilitando a identificação e compreensão dos parâmetros.
![](/download/attachments/847875815/image-2024-6-5_15-7-52.png?version=1&modificationDate=1717610872097&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-8-7.png?version=1&modificationDate=1717610887407&api=v2)
Se o campo "Nome amigável" não for preenchido, será exibido o valor do campo "Nome".
![](/download/attachments/847875815/image-2024-6-5_15-9-53.png?version=1&modificationDate=1717610993797&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-10-9.png?version=1&modificationDate=1717611009060&api=v2)
Descrição
Você pode adicionar uma descrição para cada parâmetro, fornecendo informações adicionais sobre sua finalidade e uso.
![](/download/attachments/847875815/image-2024-6-5_15-22-1.png?version=1&modificationDate=1717611721867&api=v2)
Quando um parâmetro tem uma descrição definida, você pode clicar no ícone "?" correspondente para exibi-la e obter mais informações sobre o parâmetro.
![](/download/attachments/847875815/image-2024-6-5_15-28-47.png?version=1&modificationDate=1717612127527&api=v2)
O ícone "?" para exibir a descrição do parâmetro só será exibido se o campo "Descrição" estiver preenchido. Se estiver vazio, o ícone não será exibido.
![](/download/attachments/847875815/image-2024-6-5_15-33-14.png?version=1&modificationDate=1717612395017&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-33-30.png?version=1&modificationDate=1717612410790&api=v2)
Tipo de dado
O campo "Tipo" exibe o tipo de dado do parâmetro, podendo ser: String, Number, Boolean ou Date.
![](/download/attachments/847875815/image-2024-6-5_15-38-38.png?version=1&modificationDate=1717612718770&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-38-49.png?version=1&modificationDate=1717612729387&api=v2)
Visibilidade
Você pode definir se o parâmetro será visível ou não, conforme necessário para sua configuração.
![](/download/attachments/847875815/image-2024-6-5_15-44-15.png?version=1&modificationDate=1717613056187&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-44-28.png?version=1&modificationDate=1717613068823&api=v2)
Exemplo de campo "Visível" definido como não.
![](/download/attachments/847875815/image-2024-6-5_15-45-15.png?version=1&modificationDate=1717613116217&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-45-34.png?version=1&modificationDate=1717613134507&api=v2)
Limitação de caracteres
O campo "Tamanho máximo" permite definir a limitação de caracteres permitidos para o parâmetro.
![](/download/attachments/847875815/image-2024-6-5_15-58-50.png?version=1&modificationDate=1717613930350&api=v2)
![](/download/attachments/847875815/image-2024-6-5_15-59-4.png?version=1&modificationDate=1717613944523&api=v2)
Valor padrão
O campo "Valor padrão" permite definir um valor que será exibido por padrão ao abrir o menu de parâmetros. No entanto, é permitido alterar esse valor conforme necessário antes de enviá-lo.
![](/download/attachments/847875815/image-2024-6-5_16-13-43.png?version=1&modificationDate=1717614823357&api=v2)
![](/download/attachments/847875815/image-2024-6-5_16-14-0.png?version=1&modificationDate=1717614840593&api=v2)
Se o campo "Valor padrão" não for definido, o comportamento de retorno do parâmetro varia de acordo com o tipo de dado. Para parâmetros do tipo String, o parâmetro será retornado em branco.
![](/download/attachments/847875815/image-2024-6-5_16-54-42.png?version=1&modificationDate=1717617282447&api=v2)
![](/download/attachments/847875815/image-2024-6-5_16-55-38.png?version=1&modificationDate=1717617338870&api=v2)
Para parâmetros do tipo Number, o valor retornado será 0.
![](/download/attachments/847875815/image-2024-6-5_16-56-13.png?version=1&modificationDate=1717617373500&api=v2)
![](/download/attachments/847875815/image-2024-6-5_16-56-29.png?version=1&modificationDate=1717617389650&api=v2)
Para parâmetros do tipo Boolean, o valor retornado será false.
![](/download/attachments/847875815/image-2024-6-5_16-56-49.png?version=1&modificationDate=1717617409297&api=v2)
![](/download/attachments/847875815/image-2024-6-5_16-57-8.png?version=1&modificationDate=1717617428967&api=v2)
Para parâmetros do tipo Date, o valor retornado será a data atual.
![](/download/attachments/847875815/image-2024-6-5_17-3-52.png?version=1&modificationDate=1717617833017&api=v2)
![](/download/attachments/847875815/image-2024-6-5_17-4-43.png?version=1&modificationDate=1717617883267&api=v2)
Permitir nulo
Para os parâmetros numéricos, caso o campo "Permitir nulo" esteja selecionado, é possível envia-los vazios.
![](/download/attachments/847875815/image-2024-6-7_9-26-21.png?version=1&modificationDate=1717763180287&api=v2)
Caso não esteja selecionado, o preenchimento do valor é obrigatório para envio do parâmetro.
![](/download/attachments/847875815/image-2024-6-7_9-27-16.png?version=1&modificationDate=1717763235977&api=v2)
Lookup
Parâmetros com lookup sempre se originam do Objeto de Negócio. Quando um recurso possui um desses parâmetros, um ícone de lupa é disponibilizado, permitindo a abertura de um modal com as opções disponíveis.
![](/download/attachments/847875815/image-2024-6-7_16-0-52.png?version=1&modificationDate=1717786852443&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-1-17.png?version=1&modificationDate=1717786877850&api=v2)
Nesse tipo de parâmetro, é permitido selecionar quantas opções disponíveis desejar.
![](/download/attachments/847875815/image-2024-6-7_16-3-17.png?version=1&modificationDate=1717786997310&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-3-33.png?version=1&modificationDate=1717787013450&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-14-53.png?version=1&modificationDate=1717787693407&api=v2)
Múltiplas opções
Parâmetros com múltiplas opções sempre se originam do Objeto de Negócio.
![](/download/attachments/847875815/image-2024-6-7_16-11-42.png?version=1&modificationDate=1717787502563&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-12-20.png?version=1&modificationDate=1717787540703&api=v2)
Nesse tipo de parâmetro, é permitido selecionar quantas opções disponíveis desejar.
![](/download/attachments/847875815/image-2024-6-7_16-15-33.png?version=1&modificationDate=1717787733690&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-16-6.png?version=1&modificationDate=1717787766827&api=v2)
![](/download/attachments/847875815/image-2024-6-7_16-16-22.png?version=1&modificationDate=1717787782593&api=v2)
Lista estática e multivalorados
Há a opção de adicionar listas estáticas e multivalorados nos parâmetros.
Lista estática
Para adicionar uma lista estática, selecione 'Lista estática' em 'Opções'.
![](/download/attachments/847875815/image-2024-6-6_10-14-23.png?version=1&modificationDate=1717679664053&api=v2)
Após isso, clique no ícone "+" para adicionar quantas opções desejar. Se o parâmetro for booleano, será limitado a adicionar apenas duas opções.
![](/download/attachments/847875815/image-2024-6-6_10-20-10.png?version=1&modificationDate=1717680010817&api=v2)
![](/download/attachments/847875815/image-2024-6-6_10-20-44.png?version=1&modificationDate=1717680044737&api=v2)
Além disso, é possível definir um valor padrão.
![](/download/attachments/847875815/image-2024-6-6_10-33-57.png?version=1&modificationDate=1717680837973&api=v2)
![](/download/attachments/847875815/image-2024-6-6_10-34-20.png?version=1&modificationDate=1717680861037&api=v2)
No entanto, é permitido selecionar qualquer uma das opções adicionadas.
![](/download/attachments/847875815/image-2024-6-6_10-37-2.png?version=1&modificationDate=1717681022307&api=v2)
Multivalorado
Para adicionar um multivalorado, basta selecionar selecionar a opção correspondente no parâmetro.
![](/download/attachments/847875815/image-2024-6-6_11-9-24.png?version=1&modificationDate=1717682965083&api=v2)
Após isso, clique no ícone "+" para adicionar quantas opções desejar. Se o parâmetro for booleano, será limitado a adicionar apenas duas opções.
![](/download/attachments/847875815/image-2024-6-6_11-10-14.png?version=1&modificationDate=1717683018480&api=v2)
![](/download/attachments/847875815/image-2024-6-6_11-10-39.png?version=1&modificationDate=1717683047220&api=v2)
Multivalorado no menu de parâmetros.
![](/download/attachments/847875815/image-2024-6-6_11-12-48.png?version=1&modificationDate=1717683168963&api=v2)
Observação: Caso seja adicionado uma lista estática e um multivalorado, a lista estática é ignorada.
![](/download/attachments/847875815/image-2024-6-6_12-12-24.png?version=1&modificationDate=1717686744693&api=v2)
![](/download/attachments/847875815/image-2024-6-6_12-12-40.png?version=1&modificationDate=1717686760937&api=v2)
![](/download/attachments/847875815/image-2024-6-6_12-12-57.png?version=1&modificationDate=1717686777403&api=v2)