Histórico da Página

...

• Inclua a chave CRWSTARTPATH em cada ambiente, do arquivo de configuração do servidor, que será utilizado para a geração de relatórios por meio da Integração Crystal. O valor da chave deverá ser o caminho completo para o STARTPATH que esteja sendo utilizado no ambiente.
• Veja a sessão Arquivos de Configuração deste documento.

Procedimentos de Utilização

Ao acessar um relatório do Crystal Reports a partir do Microsiga Protheus®, o Sistema apresenta a tela padrão de configuração de um relatório com algumas modificações:

1. Ao invés da impressão em disco, o Crystal Reports imprime em vídeo.
2. Há uma caixa de opções chamada Atualiza. Caso esteja marcada (default), o sistema atualizará os dados do relatório em tela. Caso contrário, o Sistema apresenta os dados exibidos na última geração do relatório.
3. A impressora de destino é sempre a marcada como default no Windows.
Caso existam perguntas relacionadas, ao acessar o relatório de qualquer ambiente do Sistema, pode-se configurar as perguntas da mesma maneira que qualquer outro relatório padrão do Microsiga Protheus®;

Na primeira execução de um relatório em uma estação será apresentada uma tela de configuração na qual deverão ser informadas as seguintes informações do sistema divididas em três grupos:

Diretórios:

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 exportação de relatórios.

Opções:

Definir se deverá ser gerado o arquivo de LOG denominado CRLOG.LOG.

Definir se deverá ser exibida a opção para impressão do relatório.

Definir se os arquivos SX do ERP devem ser acessados através de DLL específica. Esta opção deverá ser selecionada apenas quando não for possível acessar o diretório SYSTEM do Microsiga Protheus® através de mapeamento de rede.

Configurações do Servidor:

Driver utilizado para comunicação com o servidor Protheus.

Endereço IP do servidor Protheus.

Porta para acesso ao servidor Protheus.

Os itens do grupo Configurações do Servidor devem ser preenchidos apenas quando a opção Acessar SXs via DLL estiver selecionada.

Informe os parâmetros solicitados e, em caso de dúvida, contate o administrador do sistema.

Desenvolvimento de Relatórios

Para facilitar a geração de relatórios para serem utilizados na integração com o Microsiga Protheus®, foram criadas algumas funções que possibilitam aos desenvolvedores incluírem características do Sistema nos relatórios Crystal Reports de forma simples aumentando a produtividade e garantindo a conformidade dos documentos criados.

Tratamento de Empresas e Filiais:

Ao executar o relatório, o sistema considera os arquivos da empresa em uso, não sendo necessário construir o mesmo relatório para empresas diferentes.

Como os campos de filiais no Sistema influem diretamente em todo relacionamento entre tabelas, não se deve relacionar os campos filiais das tabelas no Crystal Reports, pois assim pode-se trazer resultados nulos para seu relatório, pois existem tabelas nas quais o campo filial é vazio e outras tabelas onde o campo filial é preenchido com o código da filial, dependendo da sua configuração encontrada no arquivo SX2.Função 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 relatório, basta criar no relatório uma fórmula com o nome de tratafilial, cujo conteúdo deverá ser S. A seguir, na execução do relatório 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 DBAccess são marcados com um * (asterisco) em determinado campo, os relatórios criados baseados em ODBCs para bases que trabalhem embaixo do DBAccess devem sempre possuir um filtro para que desconsiderem estes registros deletados.

Função TRATASQLDEL:

Para que o Microsiga Protheus® desconsidere automaticamente todos os registros deletados de todas as tabelas envolvidas, basta criar uma fórmula, no relatório, chamada TRATASQLDEL, cujo conteúdo seja S.

Acessando um Relatório através de um Rdmake:

Para acessar um relatório do Crystal Reports através do menu do Microsiga Protheus®, basta inserí-lo no menu do ambiente desejado. Entretanto, existem casos em que a simples configuração do relatório no menu não atende a necessidade, sendo necessárias opções flexíveis e poderosas para a geração do relatório.

A função CallCrys permite que o relatório seja executado através de qualquer ponto de um programa, desde que haja interface com o usuário através do Smart Client, criando inúmeras possibilidades para sua utilização. Além disto, possibilita a realização de exportação direta dos relatórios para os seguintes formatos: Excel®, Excel Tabular®, PDF e Texto.

Para acesso realizados de fora da rede local é altamente recomendado que a geração do relatório seja realizada utilizando a função CallCrys, ao invés da geração do relatório através de item de menu, uma vez que diversos fatores relacionados a conexão podem ocasionar problemas de conexão com o Protheus que podem impedir o funcionamento da integração.

Função Callcrys:

CALLCRYS (rpt , params, options), onde:

rpt = Nome do relatório, sem o caminho.

params = Parâmetros do relatório, separados por vírgula ou ponto e vírgula. Caso seja marcado este parâmetro, serão desconsiderados os parâmetros marcados no SX1.

options = Opções para não se mostrar a tela de configuração de impressão , no formato x;y;z;w ,onde:

x = Impressão em Vídeo(1), Impressora(2), Impressora(3), Excel (4), Excel Tabular(5), PDF(6) e Texto (7) .

y = Atualiza Dados(0) ou não(1)

z = Número de Cópias, para exportação este valor sempre será 1.

w =Título do Report, para exportação este será o nome do arquivo sem extensão.

Exemplo:

/*Definição dos paramentos para o relatório.*/

cParams := “000001;01/10/2000;31/10/2000;SP”

/*Definição das opções para geração do relatório.*/

cOptions := 2;0;2;Pedido de Compras

/*Chamada da função .*/

CallCrys(‘REP01’, cParams,cOptions)

Return .T.

Caso o conteúdo do segundo parâmetro seja muito extenso, deve-se gravá-lo em um arquivo temporário com extensão .TXT e passar este arquivo temporário como o parâmetro.

Exemplo:

/*Arquivo que conterá os valores dos parâmetros.*/

cFile := CriaTrab(nil,.f.)+.Txt

/*Definição das opções para geração do relatório.*/

cOptions := 2;0;2;Pedido de Compras

/*Chamada da função com passagem de parâmetros por arquivo.*/

CallCrys(‘REP01’,cFile,cOptions)

Return .T.