...
| Deck of Cards |
|---|
|
Um Data Source é mecanismo que guarda os dados de conexão com a fonte de dados, por exemplo, configurações JDBC, Web Service, entre outros. No caso desse relatório será utilizado o acesso aos dados via linguagem JavaScript. | Card |
|---|
| Ao criar o novo relatório, selecione a aba Data Explorer, clique com o botão direito do mouse sobre o item Data Source em seguida selecione a opção New Data Source conforme a figura 5. 
Figura 5 – Novo Data Source. |
| Card |
|---|
| Ao abrir a janela New Data Source, selecione a opção Scripted Data Source e define o nome dsColleague como Data Source Name em seguida clique no botão Finish, conforme a figura 6. 
Figura 6 – Tipo de Data Source. |
| Card |
|---|
| Na aba Data Explorer clique com o botão direito do mouse sobre o item Data Sets em seguida clique na opção New Data Set conforme figura 7. Data Set é uma tabela temporária do BIRT no qual os dados são armazenados do Data Source e renderizados no relatório. 
Figura 7 – Novo Data Set. |
| Card |
|---|
| Ao abrir a janela New Data Set define colleagueDataSet como Data Set Name, clique no botão Next em Output Columns clique no botão Add e adicione todas as os registros do DataSet: | Column Name | Data Type | Column Alias | Display Name |
|---|
| colleagueId | String | Vazio | Vazio | | Login | String | Vazio | Vazio | | colleagueName | String | Vazio | Vazio | | mail | String | Vazio | Vazio | | active | String | Vazio | Vazio | | adminuser | String | Vazio | Vazio |
Em seguida clique no botão Finish conforme a figura 8. 
Figura 8 – Colunas do Data Set. |
|
Incluindo parâmetros no relatório
| Deck of Cards |
|---|
|
É possível incluir parâmetros no relatório a serem solicitados para o usuário antes da sua renderização, auxiliando no filtro de consulta aos dados gerando um relatório específico. | Card |
|---|
| Selecione a aba Data Explorer, em seguida clique com o botão direito do mouse no item Report Parameters, selecione a opção New Parameter conforme a figura 9.  Image Added
Figura 9 – Parâmentros do Relatório. |
| Card |
|---|
| A figura 10 ilustra a janela de inclusão de parâmetros.  Image Added
Figura 10 – Configuração de parâmetros. Ao abrir a janela New Parameter inclua os seguintes parâmetros:
Matrícula - Name: Matrículo;
- promptText: Matrícula do Colaborador ou "*" para mostrar todos;
- Data type: String;
- Display type: Text Box;
- Is Requered: true.
Mostrar usuários - Name: paramEnable;
- Prompt text: Mostrar usuários;
- Data type: String;
- Display type: List Box;
- Is Requered: true.
Selection Values | Value | Display Text | | * | Todos | | true | Ativos | | false | Inativos |
Ordenar por - Name: paramSort;
- Prompt text: Order por;
- Data type String;
- Display type: List Box;
Selection Values | Value | Display Text | | c.colleaguePK.colleagueId | Matrícula | | c.colleagueName | Nome | | c.login | Login |
|
|
TAG's
O TOTVS | ECM disponibiliza TAG’s de substituição que auxiliam no desenvolvimento e na segurança da geração das informações do relatório, são elas:
- ${WKCompany}: substitui a variável pelo código da empresa autenticada no TOTVS | ECM;
- ${WKUser}: substitui a variável pelo código do usuário autenticado no TOTVS | ECM;
As TAG’s são úteis em casos de informações que só devem ser geradas a respeito da empresa em que o usuário está autenticado, ou em relatórios que mostrem somente informações a respeito do usuário autenticado no TOTVS | ECM.
Populando o DataSet
No exemplo apresentado neste documento será populado o relatório através de dados providos de consultas JPA acessando o banco do TOTVS | ECM, porém é possível utilizar outros recursos para popular o Data Set: XML, Web Service e JDBC.
O BIRT renderiza o relatório através da execução de seus eventos, são muitos os eventos disponibilizados pelo BIRT, nesse exemplo serão utilizados:
- initialize: primeiro evento disparado pelo BIRT, é recomendado utilizar esse evento para importação de bibliotecas e inicialização de variáveis;
- beforeOpen: evento disparado antes do BIRT abrir a conexão com a fonte de dados (Data Source);
- fetch: evento disparado pelo BIRT depois da busca de cada registro no Data Set e antes de aplicar os filtros e campos calculados.
Através dos eventos é possível desenvolver a lógica de consulta e geração de dados através da linguagem de programação JavaScript , além disso é possível fazer uso de vários recursos e bibliotecas da linguagem Java™.
| Deck of Cards |
|---|
|
| Card |
|---|
| Selecione a aba Script na pagina do relatório e em seguida selecione o evento initialize, em inclua o seguinte código conforme figura 11:  Image Added
Figura 11 – Evento initialize
| Bloco de código |
|---|
importPackage(Packages.java.io);
importPackage(Packages.com.datasul.technology.webdesk.dataset.service);
importPackage(Packages.java.util);
var query = null;
var resultSet = null;
var rowMap = null;
var count = 0;
var sqlJpa = ""; |
O código a cima importa as bibliotecas Java™ e a biblioteca disponibilizada pelo TOTVS | ECM para consulta aos dados do produto |
|
