{{:bk_cab_rh3software.png?200|}} **Formatador de Relatório - Manual do RAP** ====INTRODUÇÃO AO RAP - VISÃO GLOBAL - O Calc Workspace==== ---- O Calc Workspace (área de trabalho Calc) oferece um ambiente de script baseado em eventos que pode ser usado para executar cálculos e dinamicamente controlar aspectos visuais do layout do relatório, enquanto o relatório está gerando. Scripts que respondem a eventos são chamados de manipuladores de eventos. O Report Designer é dividido em quatro áreas principais, como mostrado no diagrama abaixo. Cada uma dessas áreas é abordada em detalhes nas páginas seguintes. {{ :manual_usuario:outros:formatador_2.png?700 |}} **A -** //Code Explorer//: Usado para organizar e gerenciar a caixa de ferramentas: Repositório de código Visual, os scripts de um relatório; **B -** //Editor de código//: Usado para editar scripts; **C -** //The Code Toolbox//: Repositório de código Visual, suporta drag-and-drop (arrastar e soltar) criação de scripts; **D -** //Janela de mensagens//: Mensagens do compilador de scripts que verifica o seu código. **Code Explorer** O Code Explorer está contido nos painéis superiores esquerdo e direito do Calc workspace. O painel esquerdo contém uma tree view - use-o para navegar no código do relatório. O painel direito contém uma list view - ele irá mostrar uma variedade de itens, dependendo do que for selecionado na tree view. Clicando com o botão direito na "árvore" você pode exibir um menu de contexto que permite controlar o comportamento do Code Explorer. **Visualizações** A guia Calc permite que você gerencie o report code utilizando três pontos de vista diferentes. Ao selecionar o menu View ou clicando com o botão direito sobre o espaço em branco do painel esquerdo: * Variáveis; * Eventos; * Módulo. A série de capturas de tela abaixo ilustram a forma como o relatório pode ser exibido. Você pode selecionar um modo de exibição usando o menu View ou posicionando o mouse sobre o espaço em branco do painel esquerdo e pressionando o botão direito do mouse para exibir um menu de contexto. **Variáveis da visualização** Esta visão permite que você veja as variáveis dentro de um relatório. Variáveis permitem executar cálculos. Observe que apenas as bandas são exibidas no painel esquerdo. O único componente visível a partir deste ponto de visão é a variável. Todos os outros componentes do relatório estão escondidos nesta visão. {{ :manual_usuario:outros:formatador_3.png?600 |}} **Eventos da Visão** Esta visão mostra uma tree view com todos os componentes contidos no relatório. O painel direito exibe eventos associados com o componente selecionado. Seleção de um evento irá mostrar o script do evento, se houver. {{ :manual_usuario:outros:formatador_4.png?600 |}} **Módulo View** Esta visão mostra uma visão global de todo o módulo calc. Ele lista as declarações, eventos, programas e manipuladores de eventos. Esta visão é útil quando você deseja examinar todo o código do relatório. {{ :manual_usuario:outros:formatador_5.png?500 |}} Este ponto de vista exibe itens, que são visíveis para todos os manipuladores de eventos do relatório: **Declarations -** Estas variáveis e constantes são globalmente visíveis ao longo do relatório; **Events -** Estes são, em essência, os eventos do relatório. No caso em que a janela de pré-visualização é exibida, os eventos OnCreate e OnDestroy são executados quando a janela é aberta e fechada, respectivamente. Os eventos BeforePrint e AfterPrint são métodos disparados a cada impressão, antes e depois da mesma, respectivamente. Os eventos OnCreate e OnDestroy são bons lugares para a inicialização e finalização de código, como a criação e liberando objetos e inicialização de variáveis; **Programs -** Estes são procedimentos e funções que são globalmente visíveis em todo o relatório e podem, portanto, serem chamados de qualquer manipulador de eventos; **Event Handlers -** Estes são todos os manipuladores de eventos que têm sido implementados no relatório. **Code Toolbox** O Code Toolbox é um repositório de código visual. Ele contém a maioria dos identificadores e elementos de código que o compilador RAP reconhece. Note que o Code Toolbox tem três abas: Dados, objetos, e Idioma. Cada guia é composta de um treeview e uma lista de identificadores. **Guia de dados** A guia de dados do Code Toolbox exibe pipelines de dados e campos, o que lhe permite arrastar e soltar referências de campo no editor de código. {{ :manual_usuario:outros:formatador_6.png?500 |}} A seleção de um pipeline a partir da lista irá exibir todos os campos do mesmo, bem como: tipo e tamanho de dados de informações para os campos. Para inserir um valor de campo para a janela de edição do código, selecione o campo e arraste-o para o editor de código. O código necessário para recuperar o valor do campo a partir do pipeline será gerado. Por exemplo: arrastando o campo 'City' do Code Toolbox resultaria neste código abaixo: Value := Clients['City'] **Guia de Objetos** A guia de Objetos do Code Toolbox exibe objetos de relatório e as suas propriedades, o que lhe permite arrastar e soltar propriedades no Editor de Código. {{ :manual_usuario:outros:formatador_7.png?500 |}} A seleção de um objeto a partir da árvore irá exibir uma lista de propriedades do objeto. Para inserir uma propriedade no editor de código, selecione a propriedade e arraste-a para o editor de código. O código necessário para recuperar o valor da propriedade ou chamar o método será gerado. Por exemplo, arrastando a propriedade 'AutoSize' do Code Toolbox resultaria no código abaixo: Label1.AutoSize **Guia de idiomas** A guia de Idiomas do Code Toolbox exibe elementos de linguagem RAP, o que lhe permite arrastar e soltar elementos no Editor de código. {{ :manual_usuario:outros:formatador_8.png?500 |}} Seleção de uma categoria a partir de uma "árvore" que irá exibir uma lista de elementos para essa categoria. Para inserir um elemento no editor de código, selecione o elemento e arraste-o para o editor de código. O código necessário para fazer referência ou o elemento irá ser gerado. Note que quando você arrasta um item, como uma chamada de função, a lista de parâmetros da função é fornecida. Por exemplo, se você arrastar Copy para o editor de código, ele irá se expandir como: Copy(S, Index, Count); **Editor de código** O código aparece no editor de código quando você seleciona um evento na list view do Code Explorer ou clica com o botão direito e seleciona New. Você pode criar um código, arrastando e soltando-o do Code Toolbox, ou você pode escrever seu próprio código. Quando for compilar o código, basta clicar com o botão direito sobre o espaço em branco do editor de código e selecione 'Compile'. Na janela abaixo o editor de código vai indicar se houve ou não algum erro no seu código. O menu do editor de código contém os seguintes itens: **New** New tem o mesmo efeito que clicar no Editor de código. Ele só é ativado se não houver uma implementação para o item selecionado no Código Explorer. **Compile** Compile ativa o compilador RAP para tentar compilar o procedimento atual e quaisquer procedimentos sobre os quais o atual dependa. **Save** O Calc workspace mantém um buffer intermediário para o editor de código. Selecionando Save vai enviar o conteúdo atual do editor de código para o buffer; ele não vai salvar todo o relatório. Selecionar Save tem o mesmo efeito que navegar, e, em seguida, retornar para a procedure atual. **Revert** Use Revert para substituir o conteúdo do editor de código com o código que está atualmente contido no buffer. Isso tem o efeito de remover todas as alterações desde a última gravação. **Delete** Selecione Delete para excluir o atual procedimento. **Message Window** As mensagens do compilador são exibidas aqui. Você pode navegar para a localização do erro do compilador com um duplo clique na mensagem de erro.