Runtime Database Utilities

Índice

Executor de SQL e DML

RTDBUT.UTL_DB_SQL_2

Descrição

Interface que permite ao usuário executar consultas e DMLs livremente no banco de dados.
O usuário pode escrever vários comandos em sequencia em uma mesma entrada. Estes comandos serão executados em uma transação e automaticamente comitados no final.

O resultado dos comandos SELECT executados será através de uma tabela.

Para os demais comandos de DML ou DDL, apenas o número de registros processados será informado.

Além dos comandos tradicionais de SQL, DML e DDL, os seguintes comandos são reconhecidos:

Todos os DML e DDL registrados são registrados no log de replicação, ou seja, são automaticamente replicados para os outros servidores conectados à base de replicação.

Campos:

Número máximo de registros a serem listados nos comandos SELECT.
Indica se deve ou não replicar os comandos de DML e DDL para os outros servidores da rede.
Componente utilizado para representar campos que contém códigos-fontes em uma determinada linguagem de programação. Para a persistência, é um campo texto (contendo quebras de linha) como qualquer outro. Na interface é apresentado como um campo multi-linha, que não quebra as linhas automaticamente e usa um fonte de tamanho fixo.

Propriedades (format)

language

No formato, pode-se incluir a propriedade "language" para definir a sintaxe da linguagem a ser utilizada.

Exemplo:
language:java
Outras linguagens suportadas:
  • java
  • sql
  • html
  • csharp
  • css
  • javascript
  • ruby
  • php
  • velocity
Chave de identificação interna
Nome global que identifica a operação do sistema. Não existem duas operações com mesmo nome global. Para interfaces, por exemplo, é composta por um padrão SISTEMA.BLOCO_INTERFACE.OPERACAO.
Exemplos: "PROJET.CAD_ATIVIDADES.INSERT", "PEDIDOS.CAD_PEDIDOS.UPDATE", etc.
Título original dado para a operação no idioma de desenvolvimento. Normalmente equivale ao nome de um botão ou de um label.
Exemplos: Insert, Delete, Update, Cancelar pedido, etc.
Texto descritivo sobre a operação.
Indica a interface que está associada a esta operação.
Indica o tipo de política de acesso que é usado para esta funcionalidade.
Note que, dependendo da arquitetura utilizada, este atributo serve apenas como referência para o que foi codificado no sistema. Alterar o valor do mesmo não siginifica que seja possível mudar o comportamento do sistema. As arquiteturas poderão ou não implementar as regras de acesso com base neste atributo.
  • Público - A interface pode ser acessada livremente (mesmo usários não logados no sistema).
  • Usuário - Qualquer usuário logado no sistema tem acesso aos recursos da interface
  • Restrito - O acesso é restrito a usuários específicos.
  • Exige credencial - É um tipo especial de política de acesso que pede as credenciais do usuário no momento da operação.
DEPRECIADO - Usar TIPO_OPERACAO
Classifica a operação quanto a forma com que ela é implementadas.
Passará a ser igual à operação (feature) do bloco no Telescope.
  • Custom - A operação é implementada através de um script customizado. Neste caso, a linguagem utilizada neste script deve estar indicada no "Tipo de implementação".
  • Query - A operação é formulário de parâmetros utilizados nas pesquisas genéricas.
  • Report - A operação é implementada através de um comando SQL que poderá ser filtrado por alguns parâmetros. Na execução, o usuário informará os parâmetros e o resultado do SQL é apresentado sob forma de tabela com os mesmos recursos da operação LIST.
  • Service - A operação é um serviço que pode ser acessado por outros sistemas.
  • Empacotada (bundled) - Indica uma operação padrão que vem distribuída nas releases do sistema.

Operações

Topo

Novo

Permite criar novos registros no sistema. Ao ser executado, o sistema apresenta um formulário com todos os campos do registro que deverão ser preenchidos. Quando todos os campos desejados estiverem preenchidos, clique em [b:Salvar].
Comportamento:Topo

Custom

Apenas inicializa o valor da replicação
Público
Comportamento:Topo

Custom

Tela sem operações geradas. Totalmente customizada.
Comportamento:Topo

Pesquisar

Ao pesquisar, o usuário poderá informar critérios de filtro para listar apenas os registros desejados. Normalmente depois de informar os filtros desejados, o usuário deverá executar a operação [b:Listar].
Obtenha maiores detalhes em Como utilizar a tela de pesquisa?.
Topo

Listar

Apresenta uma lista com os registros que atendem aos filtros informados.
A lista possui diversos recursos práticos e importantes para o usuário:
Topo

Alterar

A partir da tela de consulta de um registro, esta operação permite alterar os dados do mesmo.
O sistema abre um formulário com os campos editáveis. Após alterar os campos, o usuário deverá clicar em [b:Salvar].
Comportamento:Topo

Excluir

Exclui o registro selecionado. A exclusão do registro pode ser disparada a partir da tela de consulta e/ou de manutenção do mesmo.
O registro somente será excluído se todas as condições necessárias forem encontradas, gerando um erro, caso alguma destas condições não estiver sendo atendida.
Topo

Executar comandos

Executa os comandos informados no campo de comando.

Regras

Definir consulta realizada

Regra que irá preencher o item CONSULTAS_EXECUTADAS com o resultado que encontrou na rotina de execute().
Eventos que disparam esta regra:
  • Antes de apresentar cada registro formulário "Custom"

Execute

Executa um comando específico.

Execute DML

Executa um comando DML

Execute SUM

Executa a interpretação do comando SUM.

Execute Select

Executa um comando do tipo SELECT
Apresenta uma tabela com os dados resultantes.

Execute desc

Apresenta uma descrição de uma tabela.

Inicializa replicação

Eventos que disparam esta regra:
  • Depois de apresentar formulário "Custom"