Inclusão de campos customizados em ambiente de produção (block-config)

RT.FAQ-92696

Configurações das interfaces do sistema

PROJET.CAD_OCORRENCIAS.BLOCK_CONFIG

Código

{
  "items": [
      {
          "name": "PERCENTUAL_EXECUTADO",
          "before": "ATIVIDADE",
          "domain": "ADSRT.PERCENT",                      
          "label": "Executado",
          "hint": "Hint do campo",
          "width": "10",
          "expr": "10 + coalesce(ocor.tempo_executado * 100 / ocor.tempo_estimado,0)", 
          "format": "##0.0",
          "suffix":"%",
          "usages": [
              {
                  "operation": "VIEW",
                  "usage": "view"
              },
              {
                  "operation": "UPDATE",
                  "usage": "view"
              },
              {
                  "operation": "LIST",
                  "usage": "view"
              }
          ]
      }
  ]
}

name: Nome do campo. Deve-se utilizar apenas caracteres A-Z (apenas letras maiúsculas), 0-9 e "_". Não pode repetir um nome que já tenha um item cadastrado no bloco. Não pode usar o nome de algum atributo da entidade base.

domain: Nome global do domínio a ser utilizado.

label: Título (label) do campo assim como ele deve ser apresentado nas telas.

format: Texto de formação do campo. Ver a documentação do respectivo domínio para maiores detalhes.

prefix: Prefixo do campo

suffix: Sufixo do campo

hint: Hint do campo

height: Altura do campo

width: Largura do campo

null-text: Texto a ser usado quando o valor do campo for nulo.

expr: Expressão SQL que retorna o valor do campo. Deve seguir a mesma sintaxe que é utilizada para expressões SQL definidas no bloco.

options: Opções estáticas aceitas para o campo (formada por linhas contendo VALOR=Descrição quebradas por \n). Pode ser também informado por um SQL para popular um campo "opção" ou incluir um autocompletar em um campo "texto".

usages: Array contendo o mapeamento de uso do campo nas diferentes operações do bloco. Cada elemento do array é composta por um objeto contendo 2 propriedades: "operation" e "usage".

operation: Nome da operação onde o item é utilizado (nome do formulário).

usage: Como o item é usado nesta operação. Normalmente, será uma dos seguintes valores: view, opt, rqd.

after: Indica que o campo deve ser posicionado logo após o campo indicado.

before: Indica que o campo deve ser posicionado logo antes do campo indicado.

summarize: (S/N) Indica se deve totalizar o campo nas listas

group: (S/N) Indica se permite agrupar nas listas

lov: Indica um nome de bloco que deve ser utilizado como Lista de Valores.

size: Indica o tamanho máximo aceito pelo campo.

Exemplo

Inclusão de campo com uma tabela com os estoques por estabelecimento da view da Produtos:

Código

{
  "items": [                                                            
      {
           "name": "ESTOQUES",
          "domain": "ADSRT.WIKI",                                  
          "label": "Estoques",                                        
          "hint": "Estoques do produto por estabelecimento e tipo de estoque.",                                  
          "expr": "(select '|Estabelecimento|Tipo de estoque|Un.|Estoque|Quant. em OC|\n' || array_to_string(array_agg('|' || nome_estabelecimento || '|' || tipo_estoque || '|' || simbolo || '|' || estoque  || '|' || lpad(coalesce(to_char(quant_oc,'9G999G990D00'), ''),15,' ') || '|'),'\n') || '\n|   |   |   | <b>' || (select lpad(to_char(sum(epx.estoque_atual),'9G999G990D00'),15,' ') from estoques_produtos epx where epx.produto_id = lkp2.id) || '</b>| <b>' || lpad(coalesce(to_char((select sum(quantidade_pendente) from itens_pedidos ip join pedidos p on p.id = ip.pedido_id join tipos_pedidos tp on tp.id = p.tipo_pedido_id where tp.categoria = 'C' and p.situacao not in ('C', 'E') and ip.produto_id = lkp2.id and ip.quantidade_pendente!=0 and ip.situacao in ('P')),'9G999G990D00'), ''),15,' ') || '</b>|' from ( select estab.nome_estabelecimento , te.tipo_estoque , un.simbolo , lpad(to_char(ep.estoque_atual,'9G999G990D00'),15,' ') as estoque, case when tipo_estoque = 'ESTOQUE' then (select sum(quantidade_pendente) from itens_pedidos ip join pedidos p on p.id = ip.pedido_id join tipos_pedidos tp on tp.id = p.tipo_pedido_id where tp.categoria = 'C'and p.situacao not in ('C', 'E') and p.estabelecimento_id = ep.estabelecimento_id and ip.produto_id = ep.produto_id and ip.quantidade_pendente!=0 and ip.situacao in ('P')) else null end as quant_oc from estoques_produtos ep join tipos_estoques te on te.id = ep.tipo_estoque_id join estabelecimentos estab on estab.id = ep.estabelecimento_id join produtos prod on prod.id = ep.produto_id left join unidades_medidas un on un.id = prod.unidade_medida_id where ep.produto_id = lkp2.id group by ep.produto_id, ep.estabelecimento_id, estab.nome_estabelecimento, te.tipo_estoque, un.simbolo, lpad(to_char(ep.estoque_atual,'9G999G990D00'),15,' ') order by estab.nome_estabelecimento, te.tipo_estoque ) q)",   
          "usages": [                                                 
              {
            
                  "operation": "VIEW",                                
                  "usage": "view"                                     
                
           }
        ]
      }
  ]
}

Inclusão de campos customizados em ambiente de produção (block-config)

Suporte a macros de sessão

Exemplo