Help: Integrao Crystal Reports x Protheus 10

Integrao Crystal Reports x Microsiga Protheus No Microsiga Protheus possvel utilizar os relatrios criados pelo gerador de relatrios Crystal Reports (verso 6.5 ou posterior). Este recurso vlido para os ambientes Windows NT, 2000 e XP e Vista.

Procedimentos de Configurao Estaes de Trabalho: Execute o instalador Protheus Crystal Integration.msi ou, caso a estao de trabalho j possuo o aplicativo BDE instalado, execute o Protheus Crystal Integration without BDE.msi. Este procedimento instalar os recursos necessrios para proporcionar a integrao entre o Microsiga Protheus e o Crystal Reports;

Caso o ByYou SmartClient esteja instalado na estao, o arquivo SGCRYS32.EXE dever ser disponibilizado no diretrio de instalao e, para o caso de acesso com o TOTVS SmartClient Activex, no diretrio System32 do Windows.

Crie uma Fonte de Dados ODBC apontando para a base de dados do Microsiga Protheus. Esta Fonte de Dados deve possuir o mesmo nome em todas as estaes. possvel criar essa Fonte de Dados atravs do Painel de Controle do Windows acessando "Ferramentas Administrativas" > Fontes de Dados (ODBC). Lembrando que o tipo do driver da Fonte de Dados depende do tipo da base de dados (DBF, SQL, SERVER, etc.). Caso voc esteja utilizando acesso uma base DBF, utilize o driver Microsoft Visual FoxPro (caso exista) ou o Microsoft FoxPro Driver, ao invs do Microsoft Dbase Driver.

Importante: A Totvs no distribui os drivers ODBC para os diferentes Bancos de Dados. Eles so distribudos pelas empresas que comercializam estes bancos. Assim, caso no possua o driver ODBC para o seu banco, entre em contato com a empresa fornecedora deste Banco de Dados. Servidor Protheus: Os procedimentos a seguir devem ser executados no servidor do Microsiga Protheus, necessrio nvel de permisso adequado ao mdulo Configurador para criao de itens de menu e perguntas: Coloque todos os relatrios gerados pelo Crystal Reports (*.rpt) em um s diretrio logo abaixo do raiz do Microsiga Protheus. Este diretrio deve ser obrigatriamente informado no parmetro MV_CRYSTAL e deve estar visvel em todas as estaes que tm acesso aos relatrios do Crystal Reports.

Exemplo: \CRYSTAL\, que est abaixo do diretrio Rootpath do Microsiga Protheus. Caso deseje utilizar parmetros no relatrio do Crystal Report da mesma maneira que

no Microsiga Protheus atravs do cadastro de perguntas, siga os seguintes passos:

1. O

nome do relatrio criado no Crystal Reports deve ter no mximo 6 caracteres. Crie no seu relatrio Crystal Reports os parmetros desejados, associando a eles uma 2. condio de filtro ou uma frmula; No cadastro de perguntas do Microsiga Protheus deve ser criada uma pergunta para 3. cada parmetro do relatrio, respeitando as seguintes regras: O grupo de perguntas deve ser o nome do relatrio sem a extenso. As perguntas devem ser criadas na mesma ordem de criao dos parmetros do relatrio. Ou seja, as nicas ligaes entre as perguntas do Microsiga Protheus e os parmetros do relatrio so a ORDEM e o GRUPO definidos no cadastro de perguntas do Sistema. Desta forma, o primeiro parmetro criado no relatrio ser preenchido pelo contedo informado para a pergunta de ordem 01 e assim sucessivamente. Em instalaes do Microsiga Protheus com mais de um STARTPATH, caso seja necessrio que a gerao de relatrios considere os arquivos do STARTPATH do ambiente que estiver em uso: Inclua a chave CRWSTARTPATH em cada ambiente, do arquivo de configurao do servidor, que ser utilizado para a gerao de relatrios por meio da Integrao Crystal. O valor da chave dever ser o caminho completo para o STARTPATH que esteja sendo utilizado no ambiente. Veja a sesso Arquivos de Configurao deste documento.

Procedimentos de Utilizao

Ao acessar um relatrio do Crystal Reports a partir do Microsiga Protheus, o Sistema apresenta a tela padro de configurao de um relatrio com algumas modificaes:
1. Ao

invs da impresso em disco, o Crystal Reports imprime em vdeo. H uma caixa de opes chamada "Atualiza". Caso esteja marcada (default), o sistema atualizar os dados do relatrio em tela. Caso contrrio, o Sistema apresenta os dados 2. exibidos na ltima gerao do relatrio. 3. A impressora de destino sempre a marcada como default no Windows. Caso existam perguntas relacionadas, ao acessar o relatrio de qualquer ambiente do Sistema, pode-se configurar as perguntas da mesma maneira que qualquer outro relatrio padro do Microsiga Protheus; Na primeira execuo de um relatrio em uma estao ser apresentada uma tela de configurao na qual devero ser informadas as seguintes informaes do sistema divididas em trs grupos: Diretrios:

Caminho do ROOTPATH do Protheus. Caminho do STARTPATH do Protheus. Definir se o caminho do STARTPATH ser definido de acordo com o ambiente em uso. Caminho para exportao de relatrios Opes: Definir se dever ser gerado o arquivo de LOG denominado CRLOG.LOG. Definir se dever ser exibida a opo para impresso do relatrio. Definir se os arquivos SX do ERP devem ser acessados atravs de DLL especfica. Esta opo dever ser selecionada apenas quando no for possvel acessar o diretrio SYSTEM do Microsiga Protheus atravs de mapeamento de rede. Configuraes do Servidor: Driver utilizado para comunicao com o servidor Protheus. Endereo IP do servidor Protheus. Porta para acesso ao servidor Protheus. Os itens do grupo Configuraes do Servidor devem ser preenchidos apenas quando a opo Acessar SXs via DLL estiver selecionada. Informe os parmetros solicitados e, em caso de dvida, contate o administrador do sistema. Desenvolvimento de Relatrios Para facilitar a gerao de relatrios para serem utilizados na integrao com o Microsiga Protheus, foram criadas algumas funes que possibilitam aos desenvolvedores inclurem caractersticas do Sistema nos relatrios Crystal Reports de forma simples aumentando a produtividade e garantindo a conformidade dos documentos criados. Tratamento de Empresas e Filiais: Ao executar o relatrio, o sistema considera os arquivos da empresa em uso, no sendo necessrio construir o mesmo relatrio para empresas diferentes. Como os campos de filiais no Sistema influem diretamente em todo relacionamento entre tabelas, no se deve relacionar os campos filiais das tabelas no Crystal Reports, pois assim pode-se trazer resultados nulos para seu relatrio, pois existem tabelas nas quais o campo "filial" vazio e outras tabelas onde o campo "filial" preenchido com o

cdigo da filial, dependendo da sua configurao encontrada no arquivo SX2. Funo TRATAFILIAL: Supondo que o Sistema opere no ambiente "Compras", na empresa 01 e filial 01. Para que o Microsiga Protheus respeite as filiais de cada tabela dentro do relatrio, basta criar no relatrio uma frmula com o nome de "tratafilial", cujo contedo dever ser S A seguir, na execuo do relatrio o Microsiga Protheus efetua . automaticamente um filtro pelas filiais das tabelas utilizadas.

Tratamento de Registros Deletados: Como os registros deletados das tabelas do Microsiga Protheus criadas em ambiente ByYou DBAccess so marcados com um "*" (asterisco) em determinado campo, os relatrios criados baseados em ODBCs para bases que trabalhem embaixo do ByYou DBAccess devem sempre possuir um filtro para que desconsiderem estes registros deletados.
Funo TRATASQLDEL:

Para que o Microsiga Protheus desconsidere automaticamente todos os registros deletados de todas as tabelas envolvidas, basta criar uma frmula, no relatrio, chamada "TRATASQLDEL", cujo contedo seja S . Acessando um Relatrio atravs de um Rdmake: Para acessar um relatrio do Crystal Reports atravs do menu do Microsiga Protheus , basta inser-lo no menu do ambiente desejado. Entretanto, existem casos em que a simples configurao do relatrio no menu no atende a necessidade, sendo necessrias opes flexveis e poderosas para a gerao do relatrio.

A funo CallCrys permite que o relatrio seja executado atravs de qualquer ponto de um programa, desde que haja interface com o usurio atravs do ByYou Smart Client, criando inmeras possibilidades para sua utilizao. Alm disto, possibilita a realizao de exportao direta dos relatrios para os seguintes formatos: Excel, Excel Tabular, PDF e Texto. Para acesso realizados de fora da rede local altamente recomendado que a gerao do relatrio seja realizada utilizando a funo CallCrys, ao invs da gerao do relatrio atravs de item de menu, uma vez que diversos fatores relacionados a conexo podem ocasionar problemas de conexo com o Protheus que podem impedir o funcionamento da integrao. Funo Callcrys: CALLCRYS (rpt , params, options), onde: rpt = Nome do relatrio, sem o caminho. params = Parmetros do relatrio, separados por vrgula ou ponto e vrgula. Caso seja

marcado este parmetro, sero desconsiderados os parmetros marcados no SX1. options = Opes para no se mostrar a tela de configurao de impresso , no formato x;y;z;w ,onde: x = Impresso em Vdeo(1), Impressora(2), Impressora(3), Excel (4), Excel Tabular(5), PDF(6) e Texto (7) . y = Atualiza Dados(0) ou no(1) z = Nmero de Cpias, para exportao este valor sempre ser 1. w =Ttulo do Report, para exportao este ser o nome do arquivo sem extenso.

Exemplo: /*Definio dos paramentos para o relatrio.*/ cParams := 000001;01/10/2000;31/10/2000;SP /*Definio das opes para gerao do relatrio.*/ cOptions := "2;0;2;Pedido de Compras" /*Chamada da funo .*/ CallCrys( REP01 cParams,cOptions) , Return .T.

Caso o contedo do segundo parmetro seja muito extenso, deve-se grav-lo em um arquivo temporrio com extenso .TXT e passar este arquivo temporrio como o parmetro. Exemplo:

/*Arquivo que conter os valores dos parmetros.*/ cFile := CriaTrab(nil,.f.)+.Txt /*Definio das opes para gerao do relatrio.*/ cOptions := "2;0;2;Pedido de Compras"

/*Chamada da funo com passagem de parmetros por arquivo.*/ CallCrys( REP01 ,cFile,cOptions) Return .T.