Runtime

Programando com o Telescope SQL Script Engine

RT.FAQ-51266
Como o próprio nome diz, o Telescope SQL Script Engine é uma linguagem de script baseada no SQL integrada ao sistema. O principal objetivo desta linguagem é de permitir aos usuários consultar e interagir com os dados do sistema:

Os scripts podem ser executados dinamicamente através da interface Executor de SQL e DML e/ou armazenados como Cadastro de Operações customizadas. Neste caso, eles também poderão ser agendados para serem executados periodicamente através de Agendamento de tarefas.

Segue um breve resumo da linguagem de script:

Regras gerais


SELECT - Apresentação de consultas SQL em forma de tabela

A linguagem aceita a execução de SQL nativo do banco. Qualquer comando iniciado com a palavra reservada SELECT será automaticamente executada no banco de dados e seu resultado será apresentado em uma tabela. Para formatar os valores das colunas apresentadas, basta definir antes os itens com os mesmos nomes destas colunas (ver comando ITEM).

Exemplo: 
SELECT login, nome_completo
from usuarios
order by login;

DISPLAY - Apresentação de consultas SQL em forma de formulário

O comando DISPLAY utiliza a mesma sintaxe do comando SELECT mas apresenta os registros em forma de formulário ao invés de uma tabela.

Exemplo: 
DISPLAY login, nome_completo
from usuarios
order by login;

EXPORT - Exportar dados

O comando EXPORT utiliza a mesma sintaxe do comando SELECT mas gera um arquivo CSV para ser baixado.

Exemplo: 
EXPORT * from tipos_pedidos;

ITEM - Definir item

O comando ITEM permite definir e configurar itens que serão utilizados automaticamente em comandos como SELECT, DISPLAY, CHART, etc.

A sintaxe do comando é 
ITEM nome dominio [, propriedade = valor , propriedade = valor ... ] ;

As propriedades aceitas são:

Exemplo: 
ITEM valor decimal_value; label='Valor total', width=12, prefix='R$', null-text='Não informado';

ITEMS - Definir conjunto de items conforme entidade

Permite capturar a definição de itens conforme estabelecido em uma determinada entidade do sistema.

Sintaxe: 
ITEMS entidade [, entidade ...] ;

Exemplo: 
ITEMS pedidos, itens_pedidos;

CONNECT - Conexão a outros bancos de dados

Permite que o script passe a utilizar outros bancos de dados para extrair dados.

Sintaxe: 
CONNECT nome-do-banco;

SUM - Definir somatórios

Permite estabelecr items que deverão ser totalizados no final de consultas tipo SELECT.

Sintaxe: 
SUM item [, item ...] ;

Exemplo: 
SUM valor_total;

SELECT pedido, valor_total
from pedidos
where tipo_pedido_id = 27634;


DML - Execuçao e geração de scripts DML