Editorial EDITORIAL. MeGAZINE 3

Transcrição

1

2

3 EDITORIAL Editorial Editorial THE CLUB Av. Celso Ferreira da Silva, 190 Jd. Europa - Avaré - SP - CEP Informações: (0xx14) Suporte: (0xx14) Fax: (0xx14) Internet Cadastro: cadastro@theclub.com.br Suporte: suporte@theclub.com.br Informações: info@theclub.com.br Dúvidas Correspondência ou fax com dúvidas devem ser enviados ao - THE CLUB, indicando "Suporte". Opinião Se você quer dar a sua opinião sobre o clube em geral, mande a sua correspondência para a seção "Tire sua dúvida". Reprodução A utilização, reprodução, apropriação, armazenamento em banco de dados, sob qualquer forma ou meio, de textos, fotos e outras criações intelectuais em cada publicação da Revista The Club são terminantemente proibidos sem autorização escrita dos titulares dos direitos autorais. Olá amigos, Muita enforia na comunidade Delphi com o recente lançamento do Delphi 2005, a mais nova versão do Delphi. Conforme já mencionamos na edição de Outubro/2004, são muitas as novidades do novo Delphi, onde destacamos a integração do desenvolvimento Delphi Win32 (análogo ao Delphi 7), Delphi For.NET (análogo ao Delphi 8) e a linguagem C# (análogo ao C#Builder). Além das novidades, foram efetuadas muitas correções de bugs e melhorias nos componentes já existentes. Confira o tour do Delphi 2005 pelo Brasil, para maiores informações acesse: Deixando a euforia de lado, trazemos até você mais uma edição da The Club Megazine, com artigos, dicas e muita informação para tornar o dia-a-dia do programador Delphi, boa leitura e abraços à todos. Copyright The Club 2004 Impressão e acabamento: GRAFILAR Tel.: (0xx14) Fax: (0xx14) Rua Cel. Amando Simôes, Cep São Manuel - SP Tiragem: exemplares Diretor - Presidente Celso Jefferson M. Paganelli Diretor Técnico Mauro Sant Anna Colaboradores Victory Fernandes, Marcelo Nogueira Delphi é marca registrada da Borland International, as demais marcas citadas são registradas pelos seus respectivos proprietários. Celso Jefferson Paganelli Presidente - The Club Editorial Dicas & Truques Indy - Obtendo a cotação do dólar on-line SIntegra - Abordagem completa - Parte Acessando o Active Directory via ADO Delphi 8 - Visualizando Imagens na Web (thumbnail).. 16 Ajustes no Firewall do Windows XP Service Pack 2 para rodar o Interbase/Firebird Aspectos relevantes na gestão de projetos e Software Perguntas & Respostas MeGAZINE 3

4 Dicas & Truques QuickReport Criando controle de número de cópias O QuickReport possui vários problemas relacionados a incompatibilidade com muitos drivers de impressoras existentes no mercado. Uma destas incompatibilidades, faz com que a propriedade Copies responsável em enviar várias cópias de um mesmo relatório à impressora, não funcione e até o momento, sem solução por parte do fabricante, pelo menos na versão standard do QuickReport que acompanha o Delphi. Aqui apresentamos um solução paliativa para o problema, na qual efetuamos uma cópia da imagem gerada pelo preview do QuickReport e depois, fazemos a impressão da mesma quantas vezes necessário. Para estes exemplo, vamos utilizar um componente TspinEdit o qual será responsável em setar o número de cópias à imprimir e um botão para chamar o relatório. Declare na sessão private uma variável chamada Copia, do tipo TQRPrinter. private { Private declarations } Copia: TQRPrinter; { declarar na lista uses QrPrNtr } public { Public declarations } var Form1: TForm1; implementation {$R *.dfm} { Evento AfterPrint do QuickReport } procedure TForm1.QuickRep1AfterPrint(Sender: TObject); var i: Integer; if (QuickRep1.QRPrinter.PrinterOK) and (Tag=0) and (Spin_Copias.Value > 1) then Tag := 1; { Propriedade Tag do formulário } for i := 1 to Spin_Copias.Value-1 do Copia.Print; { Imprime as cópias } procedure TForm1.Button1Click(Sender: TObject); { Propriedade Tag do formulário } Tag := 0; { instância objeto que irá receber a cópia do relatório } Copia := TQRPrinter.Create; try QuickRep1.Prepare; { Copia a imagem do preview gerado } Copia := QuickRep1.QRPrinter; QuickRep1.Preview; finally Copia.Free; O projeto de exemplo referente esta dica está disponível para download em qrcopies.zip 4 MeGAZINE

5 Indy Obtendo a cotação do dólar on-line por Alessandro Ferreira, alessandro@theclub.com.br Introdução Uma solicitação que temos recebido frequentemente aqui no suporte técnico The Club, é de como buscar a cotação on-line do dólar para ser utilizada em aplicações desenvolvidas em Delphi. Existem várias abordagens que poderiam ser utilizadas para esta implementação e particularmente acho a mais prática e viável fazer acesso a um serviço de web ou seja, um WebService, contudo, desconheço algum serviço gratuíto que disponibilize este tipo de informação. Dentro deste contexto, vamos demonstrar aqui uma abordagem paliativa que disponibilizará esta informação (cotação do dólar), utilizando como fonte o site do Banco Central do Brasil ( o qual disponibiliza uma página com a cotação do dólar no endereço: Nossa abordagem será bastante simples, consistindo em acessar o endereço da página que possui a cotação do dólar, contudo, trazendo o seu código fonte. De posse do código fonte da página iremos processá-lo a fim de extrair somente as informações que nos interessam. Este tipo de abordagem tem um problema, pois, caso a página sofra alguma alteração, teremos que fazer um novo estudo do código fonte da mesma para conseguir extrair a informação desejada. (Por isso, a utilização de um webservice seria o mais indicado!). Para a obtermos o código fonte da página, iremos utilizar o componente TIdHTTP (pertencente a suite de componente Indy), o qual através do método GET devolve o código fonte de um URL informada como parâmetro. Verificando o código HTML Ao executarmos o método GET do componente TIdHTTP, iremos receber o código fonte apresentado na listagem 1. <HTML><HEAD><TITLE>BCB - Taxas de Câmbio </TITLE><Link rel= stylesheet href= > <STYLE TYPE= text/css ><! A:hover {color:blue;} ></STYLE></HEAD> <BODY class= semtemplate ><br><blockquote> <table> <tr><td><img src= /gifs/quadro-p.gif align=middle></td><td>cotação de fechamento do dólar no dia 05/11/2004, sexta-feira: </td></tr><tr><td> </ td><td><blockquote><li>dólar-dos-eua:<br> <table cellspacing=1><tr><th VALIGN=TOP class= fundopadraobescuro3">data</th> <th class= fundopadraobescuro3" NOWRAP>Taxa de Compra</th><th class= fundopadraobescuro3" NOWRAP>Taxa de Venda</th></TR><tr> <td ALIGN=CENTER class= fundopadraobclaro2"> 05/11/2004</td><td ALIGN=RIGHT class= fundopadraobclaro2">2,8178 2,8178</td><td ALIGN=RIGHT class= fundopadraobclaro2"> 2,8186</td></tr></table></td></tr></table> </blockquote></ol></center></body></html> Listagem 1 Código fonte da página Analisando o código fonte recebido, não é muito difícil identificar as informações que nos serão úteis, ou seja, a data, a cotação de compra e a cotação de venda. Contudo, para facilitar nossa abordagem, iremos utilizar uma unit de terceiros (HtmlUtils) que disponibiliza uma função (HTMLToPlainText) para limparmos o código HTML, deixando o texto puro, o qual MeGAZINE 5

6 ficará mais simples de manipularmos. (O código fonte da HTMLUtils está disponível junto ao projeto de exemplo que será apresentado neste artigo, o qual está disponível para download no endereço indicado no final deste artigo). Após submetermos o código fonte da página a função HTMLToPlainText, teremos o resultado apresentado na listagem 2. BCB - Taxas de CâmbioCotação de fechamento do dólar no dia 05/11/2004, sexta-feira: Dólardos-EUA:DataTaxa de CompraTaxa de Venda05/11/ 20042,81782,8186 Listagem 2 Código fonte sem as tags HTML Bem, agora o texto ficou bem mais simples e fácil de ser manipulado! Usando o componente TIdHTTP Bem, vamos agora implementar nosso projeto para trazer a cotação do dólar. Para isso, vamos utilizar um componente TIdHTTP, o qual poderá ser nomeado como IdHTTP_PegaDolar, um componente TEdit, nomeie como EdURL e configure a propriedade Text= (que é o endereço onde iremos buscar a cotação do dólar), um Tlabel, ajuste a propriedade Caption= URL para obtenção da cotação do Dólar, um componente TSpeedButton, nomeie como sbtndolar e finalmente um componente TMemo o qual será responsável em apresentar as informações obtidas, nomeie como Memo_Dolar. Na figura 1 poderá verificar o layout sugerido para o formulário de nosso projeto de exemplo. HTMLToPlainText } {$R *.dfm} procedure DevolveUS(var HTML: String; out Dia: String; out UsVenda, UsCompra: Double); var PosI, PosF: Integer; Tmp: String; { Remove formatação HTML } HTML := HTMLToPlainText(HTML); { converte tudo para minúsculo } HTML := AnsiLowerCase(HTML); { Apaga o início do texto até a palavra dia } Delete(HTML, 1, Pos( dia, HTML)+2); { Pega a data } Dia := Trim(Copy(HTML, 1, Pos(,, HTML)- 1)); { Apaga a primeira data encontrada } Delete(HTML, 1, Pos(,, HTML)); { Apaga a segunda data e deixa apenas os valores na string } Delete(HTML, 1, Pos(Dia, HTML)+9); { Tenta converter valor de compra } if not TryStrToFloat(Copy(HTML, 1, 6), UsCompra) then raise Exception.Create( Problemas ao obter valor do dólar! ); { Tenta converter valor de venda } if not TryStrToFloat(Copy(HTML, 7, 6), UsVenda) then raise Exception.Create( Problemas ao obter valor do dólar! ); Listagem 3 procedimento DevolveUS. Figura 1 layout sugerido Vamos agora implementar o código fonte que irá fazer a coisa funcionar. Primeiramente, vamos criar uma procedure que irá receber como parâmetro o código fonte (HTML) obtido via TIdHTTP, e três parâmetros de saída onde retornaremos a data, o valor de venda e o valor de compra. Acompanhe o codigo na listagem 3. implementation uses HtmlUtils; { Responsável pela função A lógica da procedure DevolveUS é bastante simples. Primeiro, efetuamos um tratamento para retirar as tags HTML do código fonte recebido (veja listagem 1 e 2 anteriormente apresentadas). Para evitar problemas com caixa alta/baixa, converteremos tudo para minúsculo e após isso, apagaremos todo o texto até a primeira ocorrência da palabra dia. Após isso, apenar iremos copiando e apagando o texto e retornando apenas o que nos interessa. (Através da função TryStrToFloat tentamos fazer a conversão dos valores obtidos e caso a conversão não seja bem sucedida, levantaremos um exceção). 6 MeGAZINE

7 Prosseguindo, vamos agora codificar o evento OnClick do botão sbtndolar, confira o código apresentado na listagem 4. var HTML, Dia: String; UsVenda, UsCompra: Double; { Buscar página com a cotação do dolar } HTML := IdHTTP_PegaDolar.Get(EdURL.Text); DevolveUS(HTML, Dia, UsVenda, UsCompra); Memo_Dolar.Lines.Add( Cotação do Dólar ); Memo_Dolar.Lines.Add(Format( Dia: %s, Venda: %g, Compra: %g, [Dia, UsVenda, UsCompra])); Listagem 4 Código responsável em buscar a cotação do dólar O código utilizado no evento OnClick do botão sbtndolar é bastante simples. Primeiro, chamamos o método GET do componente TIdHTTP e atribuímos o resultado para a variável string HTML. Depois, executamos a procedure DevolveUS passando o HTML e as variáveis que irão receber/retornar a data e a cotação de venda e compra do dólar, as quais serão apresentada no componente TMemo. Validando a URL Nosso código poderia parar por aqui, contudo, antes de tentarmos obter a cotação do dólar seria interessante verificar se o endereço (URL) está respondendo, ou seja, se a referida URL está no ar e dessa forma evitar uma mensagem de erro desagradável ao usuário. Uma forma para efetuar este tipo de verificação é disparar um PING contra o endereço desejado e analisar a resposta. Para isso, vamos lançar mão do componente TIdIcmpClient, também pertecente a suíte de componente Indy, o qual serve exatamente para este fim. Mãos a massa, adicione um componente TIdIcmpClient e vamos nomeá-lo como ICMP. Continuando nossa implementação, declare uma variável chamada abytesreceived do tipo integer na sessão private (abaixo o type TForm1). Vamos agora criar um método para disparar o ping e verificar se o endereço está respondendo, veja a listagem 5. procedure TForm1.PingBCB; var i: integer; abytesreceived := 0; ICMP.ReceiveTimeout := 1000; ICMP.Host := ; { Vamos disparar 4 pings } try for i := 1 to 4 do ICMP.Ping; Application.ProcessMessages; except {exceção silenciosa. Trataremos o valor da variável abytesreceived.} Listagem 5 método para executar o ping. Lembre-se de declarar o método PingBCB abaixo do type TForm1. Para isso, poderá utilizar o atalho Shift+Ctrl+C. Vamos agora codificar o evento OnReply do componente TIdIcmpClient. É através deste evento que iremos analisar o retorno da execução do Ping, onde iremos verificar a quantidade de bytes recebidos acumulando na variável abytesreceived, confira a listagem 6. procedure TForm1.ICMPReply(ASender: TComponent; const AReplyStatus: TReplyStatus); { Totaliza bytes recebidos na execução do ping } abytesreceived := abytesreceived + AReplyStatus.BytesReceived; Listagem 6 Evento OnReply. E para finalizar, vamos efetuar uma pequena implementação no evento OnClick do botão sbtndolar, acompanha na listagem 7. procedure TForm1.sbtnDolarClick(Sender: TObject); var HTML, Dia: String; UsVenda, UsCompra: Double; { Testa a URL executando ping } PingBCB; { Verifica número de bytes recebidos } if abytesreceived = 0 then MeGAZINE 7

8 raise Exception.Create( URL indisponível no momento! Verifique sua conexão de internet. ); { Buscar página com a cotação do dolar } HTML := IdHTTP_PegaDolar.Get(EdURL.Text); DevolveUS(HTML, Dia, UsVenda, UsCompra); Memo_Dolar.Lines.Add( Cotação do Dólar ); Memo_Dolar.Lines.Add(Format( Dia: %s, Venda: %g, Compra: %g, [Dia, UsVenda, UsCompra])); Listagem 7 Evento OnClick do sbtndolar com implementação do ping. A alteração é bem simples. Primeiramente, vamos executar o método PingBCB o qual irá disparar 4 pings contra a URL do Banco Central do Brasil. Depois, testamos o valor da variável abytesreceived e caso o resultado seja igual a zero, indica que a URL não está respondendo e dessa forma levantaremos uma exceção informando ao usuário para verificar a conexão internet ou, caso o retorno seja maior que zero, continuaremos o processamento e apresentaremos a cotação do dólar ao usuário. Conclusão Apresentamos aqui uma abordagem demonstrando a utilização dos componentes TIdHTTP e TIdIcmpClient da suite Indy, a qual possui muitos componentes interessantes para diversas situações do dia-a-dia. Como mencionamos no início deste artigo, o ideal seria obter este tipo de informação através de um webservice, contudo, na falta deste, a abordagem aqui sugerida funciona bem, lembrando que o único cuidado à ser tomando seria em relação a possíveis mudanças na página HTML utilizada para obtenção das informações, apesar ainda, de ser possível criar parâmetros na aplicação a fim de deixar customizável o endereço (URL) e posicionamento dos campos na mesma. Abraços à todos e até a próxima... Download disponível em: Sobre o autor Alessandro Ferreira, Consultor Técnico do The Club alessandro@theclub.com.br 8 MeGAZINE

9 SIntegra Abordagem Completa - Ferramentas Relacionadas Parte 3 por Victory Fernandes No segundo artigo da série, foram abordados os conceitos gerais acerca da implementação do Sintegra, estruturação básica do sistema gerencial e o fluxograma de procedimentos a serem seguidos para a geração do arquivo. Tendo sido demonstrado a partir do exemplo do registro 50, a forma geral de implementação, geração e tratamento de erros de um registro do Sintegra a partir de informações contidas em um banco de dados Interbase. Continuando a nossa série de artigos sobre o Sintegra, iremos agora abordar o processo de validação, visualização e transmissão do arquivo gerado, utilizando as ferramentas oficiais disponíveis relacionadas ao tema. Serão abordados o Programa Validador, Programa Visualizador de Arquivos do Sintegra, Programa Visualizador de Notas Fiscais de Arquivos do Sintegra e o Programa para Transferência Eletrônica de Documentos (TED) sob a ótica de aplicação do desenvolvedor. O Programa Validador Uma vez gerado o arquivo de saída, estamos prontos para verificar no Programa Validador a consistência do arquivo gerado. Vamos agora conhecer um pouco mais sobre o Programa Validador, mostrado na Figura 04, que verifica a consistência dos dados informados pelos contribuintes e prepara os arquivos para entrega às repartições fazendárias estaduais, com uso de algoritmos de integridade e criptografia. O programa evita o fornecimento de dados incorretos, como Inscrições Estaduais e CNPJ inválidos, registros inexistentes, inconsistência entre os registros informados, etc. Após a validação, o programa permite gerar um arquivo de mídia para ser enviado às repartições fiscais. Criado o arquivo de mídia, pode-se emitir um recibo, contendo dados informativos sobre a validação. Se o arquivo for transmitido pela Internet, através do programa de Transmissão Eletrônica de Documentos (TED), é emitido também um recibo comprovando a transmissão do documento ao órgão competente. Este recibo garante que o arquivo passou pela validação prévia e foi encaminhado corretamente. Figura 04: Programa oficial do Fisco para validação de arquivos do Sintegra Validando um arquivo.txt 1- Ative a página Validar 2- Selecione o arquivo do documento. 3- Clique no botão Abrir. 4- Clique no botão Validar. Se a validação não for cancelada pelo usuário, a página Resumo ficará ativa, onde poderão ser analisados os resultados da MeGAZINE 9

10 validação e a quantidade de registros aceitos e/ou rejeitados. Após a validação, a página Criticas lista todos os erros e/ou advertências encontrados durante o processamento. Teoricamente, se o seu programa foi bem implementado, o nível de falhas apresentados na validação será mínimo, mas ainda assim existem erros de operação por parte do usuário no momento da entrada de dados que podem gerar problemas na validação. Neste momento o usuário deve ser capaz de identificar as falhas apresentadas, voltando ao programa gerencial, para realizar as alterações nos dados que apresentarem problemas e gerar o arquivo.txt novamente. Acontece que nem sempre seu usuário será capaz de interpretar as informações de erro e associá-las com o tipo de alteração que deve ser feita em seu programa gerencial. Nestes casos, a experiência mostra que a melhor solução é pedir que o usuário envie por o arquivo.txt gerado com erro e o relatório de críticas do Validador, para que você interprete o mesmo e sugira as devidas correções no banco de dados. Este serviço de consultoria na geração do arquivo do Sintegra é, na maioria dos casos, indispensável ao usuário inexperiente e é mais um serviço que pode ser oferecido pela software house e acrescido ao valor de manutenção do software. Para exportar o Relatório de Críticas para um arquivo texto, clique no botão Exportar na tela de críticas. O arquivo do Relatório de Críticas exportado é do tipo texto ASCII e contém campos de tamanho fixo conforme o seguinte formato, sendo a primeira linha a identificação do Contribuinte e Declaração: (ver tabela acima). Além do arquivo de Relatório de Críticas, constituem também ferramentas poderosas para a análise das informações dos clientes, o programa Visualizador de Arquivos Texto e o programa Visualizador de Notas Fiscais. O Programa Visualizador de Arquivos do Sintegra É uma ferramenta para leitura de arquivos no padrão do Sintegra com o objetivo esclarecer dúvidas quanto ao conteúdo dos mesmos, através da visualização campo a campo dos registros contidos no arquivo. Quando a opção de navegação campo a campo está ativa, ao selecionar um campo como mostrado na Figura 05, são mostradas na barra inferior as informações referentes de Número da linha, Número da coluna, Tipo de Registro, Posição do campo na linha (intervalo) e Descrição do campo. Descrição Tamanho Posição Inicial Nº Seqüencial do Erro Linha do Erro Tipo do Registro Nome do Campo Documento Item Conteúdo do Campo Mensagem de Erro Tipo do Erro Posição Final Esta ferramenta é super importante quando nós desenvolvedores estamos testando nossas implementações ou desejamos obter informações mais detalhadas sobre um determinado campo do arquivo gerado. Em arquivos muito grandes, fica praticamente impossível se verificar visualmente, por exemplo, se um determinado campo foi colocado na posição correta durante a construção do arquivo. Neste momento a ferramenta entra em ação, permitindo o cruzamento imediato entre as informações passadas pelo programa e o respectivo valor encontrado no campo. Figura 05: Programa oficial do Fisco para visualização de arquivos do Sintegra. 10 MeGAZINE

11 O Programa Visualizador de Notas Fiscais de Arquivos do Sintegra Constitui, a partir dos registros 50, 51, 53, 54 e 75, o espelho completo das notas fiscais de entrada e saída, permitindo ao usuário, a conferência e análise do arquivo magnético selecionado. Com ele é possível navegar de forma rápida e intuitiva nas notas fiscais contidas em um determinado arquivo, visualizando todos os parâmetros das notas individualmente e com a possibilidade de filtrar as notas para visualização apenas das notas de saída ou entrada. Ao contrário do programa Visualizador de Arquivos do Sintegra descrito anteriormente, o programa Visualizador de Notas Fiscais de Arquivos do Sintegra é muito mais aplicável aos usuários finais, que desejam fazer a leitura do arquivo magnético gerado sob uma ótica de mais alto nível, na maioria das vezes, para ver se as notas fiscais lançadas no sistema gerencial para um determinado mês correspondem às notas fiscais listadas no arquivo final. Caso contrário, houve erro no lançamento do documento fiscal em questão ou erro na implementação da seleção dos dados no sistema gerencial utilizado. O Programa para Transferência Eletrônica de Documentos (TED) Uma vez validado o arquivo magnético.txt e gerado o arquivo de mídia no formato.zip, o programa validador pergunta de você deseja enviar as informações e em caso positivo chama o TED, para que seja efetuada a transmissão dos documentos pela Internet. O TED é um programa muito simples, e devemos apenas instruir nossos clientes a operá-lo, uma vez que a transmissão dos arquivos para o Fisco é de responsabilidade do informante. Para efetuar o envio basta selecionar o arquivo de mídia gerado pelo validador, testar a conexão com a secretaria do estado respectivo através da página Testar, e por fim enviar o arquivo clicando no botão Enviar. Após o envio, aconselha-se que o cliente guarde em local Figura 06: Programa oficial do Fisco para visualização de Notas Fiscais em arquivos do Sintegra MeGAZINE 11

12 Figura 07: Programa oficial do Fisco para Transferência seguro o comprovante de validação e envio do arquivo, bem como o arquivo magnético.txt e a mídia.zip geradas, para caso seja solicitado durante fiscalização ou em caso de eventual necessidade de reenvio. Conclusão Com esta série de artigos, espero ter esclarecido critérios e questionamentos básicos sobre a sistemática do Sintegra, sua implementação e utilização das ferramentas relacionadas, bem como ter trazido ao seu conhecimento a SIntegra32Dll.dll, uma solução única no mercado, capaz de simplificar, e muito, o trabalho de implementação ou adaptação do seu software ao Sintegra. Sobre o autor Victory Fernandes é Mestrando em Redes de Computadores e desenvolvedor sócio da TKS Software - Soluções de Automação Softwares Dedicados. Pode ser contactado em victory@igara.com.br, ou através dos sites MeGAZINE

13 Acessando o Active Directory via ADO Por Claudinei Rodrigues Sobre o autor Claudinei Rodrigues, Consultor Técnico do The Club nei@theclub.com.br Neste artigo eu vou mostrar como você pode acessar o Active Directory através do ADO. O Active Directory é instalado a partir do Windows Ele armazena informações sobre todos os recursos em uma rede, como usuários, grupos, computadores, arquivos, impressoras e aplicativos. O Active Directory armazena informações sobre recursos em uma estrutura hierárquica. Ele contém objetos que representam os diferentes tipos de recursos da rede: usuários, impressoras, etc. Cada objeto tem atributos, como o nome, o sobrenome e o endereço eletrônico de um usuário, a localização de uma impressora. Os objetos são mantidos em um domínio. Um domínio é a unidade básica de organização e segurança no Active Directory. Figura 1: Propriedades do componente ADOConnection Bem, agora vamos criar a nossa aplicação. Chame o seu Delphi e crie um novo projeto. Adicione um Data Module a este projeto. Vá até a palheta de componentes na aba ADO e arraste um componente ADOConnection e um componente ADOQuery para o Data Module. Clique no componente ADOConnection e altere a propriedade LoginPrompt para False e configure a propriedade Provider para ADsDSOObject, como mostrado na figura 1. Agora dê um duplo clique sobre o componente ADOConnection para que possamos montar a string de conexão. Agora clique no botão Build..., veja figura 2. Após clicar no botão Build... você terá acesso a próxima tela. Na aba Provider selecione o item OLE DB Provider for Microsoft Directory Services e depois clique no botão Next >> (ver figura 3) Figura 2: Montagem da string de conexão MeGAZINE 13

14 Figura 3: Selecionando o Provider Figura 4: Informações para a conexão Na próxima tela (figura 4) selecione o radiobutton Use Windows NT Integrated Security. Não há necessidade de alterar nenhuma informação das abas Advanced e All, apenas clique no botão OK. Agora nós vamos testar a conexão alterando a propriedade Connected para True. Agora estando conectado ligue o componente ADOQuery ao componente ADOConnection através da propriedade Connection. A instrução SQL que você vai usar é muito similar às instruções padrão. O código da listagem 1 mostra um exemplo de instrução SQL que retorna as informações de um determinado usuário cadastrado no ActiveDirectory. domínio de modo que um domínio especifico não seja requerido. Cada diretório servidor tem uma entrada chamada RootDSE. Através do RootDSE, você pode determinar o domínio que o usuário atual está logado. Ele fornece um caminho fácil para adicionar flexibilidade ao seu programa. Para usar o RootDSE, você precisa importar a biblioteca ADSI Para isto vá até o menu do Delphi e clique em Project Import Type Library. procedure TDataModule2.GetUserInfo; var Query: string; ADOQuery1.Sql.Clear; Query := SELECT Name, distinguishedname, + samaccountname, PrimaryGroupID + FROM LDAP://DC=teste2000server, DC=com, DC=br + WHERE samaccountname = antonio ; ADOQuery1.Sql.Add(Query); ADOQuery1.Open; Listagem 1: Este trecho utiliza uma query LDAP para obter informações de usuários do ActiveDirectory. A interface ADSI fornece um caminho para determinar o seu Figura 5: Opção do menu do Delphi Selecione o item Active DS Type Library como mostrado na figura 6 e clique no botão Create Unit. Uma unit ActiveDs_TLB.pas será criada e adicionada ao seu projeto. Adicione esta unit a cláusula uses da unit1. (ver figura 6) Existem duas funções que nós precisamos criar para poder receber o RootDSE. São elas, GetObject e GetDefaultPath. Veja as funções na listagem 2. function GetObject(const const Name: string): IDispatch; var Moniker: IMoniker; 14 MeGAZINE

15 Figura 6: Importando a biblioteca. Result) then Raise Exception.Create(E.Message); Listagem 2: Funções usadas para pegar o path do dominio corrente Usando o caminho do seu domínio como o nome da tabela em suas querys, você pode construir instruções SQL para pesquisar um usuário ou grupo especifico. Veja a seguir na listagem 3 alguns exemplos de pesquisa. Eaten: integer; BindContext: IBindCtx; Dispatch: IDispatch; OleCheck(CreateBindCtx(0, BindContext)); OleCheck(MkParseDisplayName(BindContext, PWideChar(WideString(Name)),Eaten,Moniker)); OleCheck(Moniker.BindToObject(BindContext, nil, IDispatch, Dispatch)); Result := Dispatch; function GetDefaultPath: string; var RootDse : Iads; Result := ; try rootdse := GetObject( LDAP://rootDSE ) as IAds; Result := LDAP:// +rootdse.get ( defaultnamingcontext ); rootdse := nil; except on E:Exception do Result := LDAP://DC=activenet, DC=com,DC=br ; if not InputQuery] ( Dominio não encontrado., Por favor, informe o dominio correto., // Retorna informações de um usuário especifico Query := SELECT Name,distinguishedName, samaccountname, + PrimaryGroupID,MemberOf FROM +GetDefaultPath + WHERE samaccountname = + FUsername + ; // Retorna a lista de Organizational Units. Query := SELECT name FROM + GetdefaultPath + WHERE objectclass= organizationalunit ; // Retorna uma lista de usuários. Query := SELECT distinguishedname FROM +GetDefaultPath + WHERE objectclass= user ; // Se você configurar Groupnname = Domain Users você recebe um VarArray // dos membros daquele grupo. Query := SELECT member FROM +GetDafaultPath+ WHERE samaccountname= +GroupName+ ; // Recebe a lista de computadores. Query := SELECT distinguishedname FROM +GetDefaultPath+ WHERE objectclass= computer ; Listagem 3: Alguns exemplos de pesquisa Conclusão Acessar o Active Directory através do ADO é o caminho mais fácil para obter as informações de usuário que você precisa. Você pode obter maiores informações sobre o ActiveDirectory no próprio site da Microsoft no link windows2000/techinfo/howitworks/activedirectory/adsilinks.asp. Até a próxima edição e um forte abraço a todos. MeGAZINE 15

16 Delphi 8 Visualizando imagens na Web (Thumbnail ) Sobre o autor por André Colavite André Colavite Consultor Técnico do The Club colavite@theclub.com.br Introdução Montando projetos para web algumas vezes nos deparamos com a necessidade de apresentar uma lista de imagens ao usuário e para facilitar a visualização essas imagens devem ser apresentadas em miniatura, mas também devem permitir ao usuário clicar sobre a imagem para visualizá-la em seu tamanho real. Sendo assim o propósito dessa matéria é exatamente esse, montar um projeto em Delphi8 Web Application para a visualização de imagens em tamanho reduzido. Configurando o DataList Vamos criar nosso projeto no Delphi8 do tipo ASP.NET Web Application e como primeiro passo vamos montar uma grade para visualização das imagens pelo usuário. Esse processo é bastante simples sendo que para essa visualização usaremos um componente do tipo DataList. Portanto coloque na janela um componente DataList e neste componente iremos configurar as propriedades para definir a apresentação da grade, são elas: CellSpacing = 5 RepeatColumns = 6 RepeatDirection = Vertical O componente DataList é uma componente de grade que utiliza outros componentes para apresentar valores ao usuário. Ao incluir um componente dentro desse DataList, como por exemplo um Label, esse Label será apresentado sequencialmente seguindo a estrutura de linha e coluna da grade do DataList. Neste momento iremos incluir os componentes dentro do DataList e para isso iremos visualizar a codificação ASPX do projeto para incluir no DataList um itemtemplate, pois é dentro desse itemtemplate que iremos incluir os componentes utilizados para a visualização dos valores na grade. Portanto clique na aba WebForm1.aspx e procure a codificação do DataList, conforme o exemplo abaixo: <asp:datalist id=datalist1 runat= server > </asp:datalist> Dentro dessa instrução iremos incluir a codificação que define o itemtemplate e dentro desse itemtemplate iremos incluir os componentes para visualização dos dados que serão, um Label utilizado para apresentar o nome do arquivo, e um ImageButton utilizado para apresentar a imagem com a possibilidade de clicar sobre essa imagem. Abaixo poderemos observar a instrução do itemtemplate contendo o Label e o ImageButton: <itemtemplate> <asp:label id=lbarquivo runat= server > LbArquivo</asp:label> <p> <asp:imagebutton id=imagebutton1 runat= server > </asp:imagebutton> </p> </itemtemplate> Após incluir essa codificação a instrução do DataList ficará da seguinte forma: <asp:datalist id=datalist1 runat= server repeatcolumns= 6"> 16 MeGAZINE

17 <itemtemplate> <asp:label id=lbarquivo runat= server >LbArquivo</asp:label> <p> <asp:imagebutton id=imagebutton1 runat= server > </asp:imagebutton> </p> </itemtemplate> </asp:datalist> Voltando a visualização do Design podemos observar que o DataList irá apresentar os dois componentes, conforme figura 1: uses. A nossa visualização está quase pronta, na verdade agora somente devemos configurar no DataList qual o tipo de informação que iremos apresentar ao usuário, pois essa classe System.IO.DirectoryInfo utilizada nos permite visualizar diversas informações, como por exemplo: Name - apresenta somente o nome do arquivo FullName - apresenta o caminho e o nome do arquivo Extension - apresenta somente a extensão do arquivo Conforme já indicado iremos apresentar no DataList o nome do arquivo e visualizar a imagem, portanto iremos trabalhar com a propriedade Name e FullName. Sendo assim visualize novamente a codificação WebForm1.aspx e inclua no label a seguinte codificação: Figura1: Visualizando o DataList Lendo os arquivos do diretório Neste momento iremos criar a instrução para ler os arquivos de imagens que estão num subdiretório IMAGENS do projeto, sendo que para isso iremos utilizar a seguinte instrução no evento Page_Load. procedure TWebForm1.Page_Load(sender: System.Object; e: System.EventArgs); var dirinfo: System.IO.DirectoryInfo; if (not IsPostBack) then { lê o subdiretório imagens do projeto } dirinfo := System.IO.DirectoryInfo.Create (Server.MapPath(.\imagens )); { Retorna informações dos arquivos com extensão JPG } DataList1.DataSource := dirinfo. GetFiles( *.jpg ); { atualiza a visualização do DataList } DataList1.DataBind(); Podemos observar que atribuímos diretamente para o DataList a lista de arquivos que visualizamos. Observação: Devemos declarar a unit System.IO na lista de <%# DataBinder.Eval (Container.DataItem, Name ) %> Ficando a instrução do Label da seguinte forma: <asp:label id=lbarquivo runat= server > <%# DataBinder.Eval(Container. DataItem, Name ) %> </asp:label> Agora iremos incluir no componente ImageButton a codificação que irá atribuir às propriedades imageurl e commandname o caminho com o nome do arquivo a ser apresentado ao usuário no DataList. Sendo assim atribua ao ImageButton a seguinte instrução: <%# DataBinder.Eval(Container. DataItem, FullName ) %> Segue abaixo como ficou a codificação do ImageButton: <asp:imagebutton id=imagebutton1 runat= server imageurl= <%# DataBinder.Eval(Container.DataItem, FullName ) %> commandname= <%# DataBinder.Eval (Container.DataItem, FullName ) %> > </asp:imagebutton> A propriedade imageurl é utilizada para ler o arquivo da imagem a ser apresentada, já a propriedade commandname é MeGAZINE 17

18 utilizada para definir um comando que será lido no evento ItemCommand acessado quando o usuário clica sobre a imagem. Esse evento será codificado mais a frente. Após incluir os dois componentes e a instrução para ler os valores a codificação do DataList ficará da seguinte forma: <asp:datalist id=datalist1 runat= server repeatcolumns= 6"> <itemtemplate> <asp:label id=lbarquivo runat= server ><%# DataBinder.Eval(Container.DataItem, Name ) %></asp:label> <p> <asp:imagebutton id=imagebutton1 runat= server imageurl= <%# DataBinder.Eval(Container.DataItem, FullName ) %> commandname= <%# DataBinder.Eval(Container.DataItem, FullName ) %> > </asp:imagebutton> </p> </itemtemplate> </asp:datalist> Pronto, podemos voltar a visualização do Design. Neste momento podemos compilar e executar o projeto ao qual irá apresentar as imagens existentes no subdiretório imagens do diretório do projeto. Observação: Não se esqueça de criar esse subdiretório e incluir algumas imagens para serem visualizadas. Visualizando as imagens reduzidas Nesta segunda parte do projeto iremos incluir as instruções para visualizar as imagens num tamanho reduzido dentro do DataList, permitindo assim que todas as imagens fiquem visíveis com o mesmo tamanho. Para montar esse visualização iremos utilizar o método GetThumbnailImage do objeto System.Drawing.Image, ao qual permitirá gerar um cópia da imagem no tamanho desejado. Para fazer esse processo iremos ler a imagem no tamanho real e atribuí-la ao DataList. Antes de apresentar a imagem ao usuário o evento ItemDataBound do DataList é executado e neste momento é gerado uma miniatura da imagem, apresentando essa miniatura ao usuário. Veja abaixo como ficou a instrução dentro do evento ItemDataBound do DataList: procedure TWebForm1.DataList1_ItemDataBound(sender: System.Object; e: System.Web.UI.WebControls. DataListItemEventArgs); var Nome_Arq, Nome_Mini: String; { pesquisa o item colocado dentro do Datalist } if e.item.findcontrol( ImageButton1 ) <> Nil then { lê a informação da propriedade imageurl do item do datalist } Nome_Arq :=ImageButton(e.item.FindControl ( ImageButton1 )).ImageUrl; { gera a imagem em miniatura } Nome_Mini := Gerar_Miniatura( Nome_Arq ); { apresenta a imagem em miniatura no item dentro do datalist } ImageButton(e.item.FindControl ( ImageButton1 )).ImageUrl := Nome_Mini; Neste evento foi utilizado a function Gerar_Miniatura, sendo que essa function irá ler a imagem no seu tamanho original calcular uma porcentagem de diminuição para chegar ao tamanho miniatura. Essa porcentagem é necessária para poder diminuir o tamanho da imagem por igual tanto na sua altura como no seu comprimento evitando assim deformar a imagem. Veja abaixo a function contendo algumas explicações das linhas utilizadas: function TWebForm1.Gerar_Miniatura (NomeArqOrigem: String): String; var Img, Img2: System.Drawing.Image; mycallback: System.Drawing.Image.GetThumbnailImageAbort; ntamimg, np, nt : Integer; ntamimg := 100; {tamanho das mini-imagens } try Img := System.Drawing.Image.FromFile ( NomeArqOrigem ); try { verifica se a imagem apresentada já não é menor que o tamanho pré-definido } if (Img.Width > ntamimg) or (Img.Height 18 MeGAZINE

19 > ntamimg) then mycallback := System.Drawing.Image. GetThumbnailImageAbort (ThumbnailCallback); { calcula a porcentagem de diminuição da imagem. Essa porcentagem é utilizada para definir o novo tamanho da imagem na altura e no comprimento } if (Img.Width > Img.Height) and (Img.Width > ntamimg) then np := Round((nTamImg*100)/ img.width); nt := Round((img.Height*nP)/100); {gera uma nova imagem em miniatura } img2 := img.getthumbnailimage (ntamimg, nt, mycallback, System.IntPtr.Zero); end else if img.height > ntamimg then np := Round((nTamImg*100)/ img.height); nt := Round((img.Width*nP)/100); {gera uma nova imagem em miniatura } img2 := img.getthumbnailimage(nt, ntamimg, mycallback, System.IntPtr.Zero); try {cria a string contendo a path e o nome da imagem no sub-diretório imagens_mini } Result := GetTempPath + imagens_mini\ + PrepareFileName( Path.GetFileName(NomeArqOrigem) ); { salva a imagem em miniatura no subdiretorio } img2.save( Result, ImageFormat. Jpeg); finally img2.free; end else { imagem já é miniatura, portanto visualiza ela mesma } Result := NomeArqOrigem; finally img.free; except Dentro dessa function utilizamos três functions, são elas: Function ThumbnailCallback, sendo uma function de controle obrigatório no uso do método GetThumbnailImage. function ThumbnailCallback: boolean; Result := false; Function GetTempPath, utilizada para retornar o caminho físico do servidor onde o projeto está. function TWebForm1.GetTempPath: string; Result := Page.Request. PhysicalApplicationPath; Function PrepareFileName, utilizada para preparar o nome do arquivo a ser gerado em miniatura. function TWebForm1.PrepareFileName (aname: string): string; Result := aname.replace(, ) +.jpg ; Observação: Devemos declarar a unit System.Drawing.Imaging na lista de uses e declarar também as functions criadas na seção private, veja exemplo abaixo: private function Gerar_Miniatura (NomeArqOrigem: String): String; function GetTempPath: string; function PrepareFileName (aname: string): string; public Para concluir o nosso projeto iremos criar o evento ItemCommand do componente DataList, pois através desse evento iremos controlar quando o usuário clicar sobre a miniatura da imagem ao qual irá apresentar uma nova janela mostrando a imagem em seu tamanho original. MeGAZINE 19

20 Segue a instrução do evento ItemCommand do DataList: procedure TWebForm1.DataList1_ItemCommand (source: System.Object; e: System.Web.UI.WebControls. DataListCommandEventArgs); var Img: System.Drawing.Image; nw, nh: integer; { verifica o tamanho da imagem para controlar o tamanho da janela } nw := 200; nh := 200; try Img := System.Drawing.Image. FromFile(e.CommandName); if Img.Width > nw then nw := Img.Width+20; if Img.Height > nh then nh := Img.Height+20; Img.Free; except { Executa uma instrução Java Script para abrir uma nova janela contendo a página webform2.aspx} Response.Write( <script language= javascript > window.open( webform2.aspx?arq= + Path.GetFileName(e.CommandName)+, _blank,[ toolbar=no,width= +nw.tostring+,height= +nh.tostring+ ] ) </script> ); Observação: Devemos criar um subdiretório do projeto chamado Imagens, contendo algumas imagens, e criar também um subdiretório chamado imagens_mini. Neste momento nosso pequeno projeto está pronto, podemos executá-lo normalmente ao qual irá apresentar as imagens em miniatura, conforme figura 2 e clicando sobre a imagem poderemos vê-las em seu tamanho original, conforme figura 3. Figura2: Apresentando imagem em miniatura Crie essa nova página webform2.aspx no projeto e dentro dela coloque um componente Image ao qual irá apresentar a imagem em seu tamanho original. No evento Page_Load dessa nova página coloque a instrução que irá atribuir o arquivo original para o componente Image, veja a instrução do evento PageLoad. procedure TWebForm2.Page_Load(sender: System.Object; e: System.EventArgs); Image1.ImageUrl := Page.Request.PhysicalApplicationPath+ imagens\ +Request.Params[ arq ].ToString; Figura3: Apresentando imagem no tamanho original Conclusão Conforme podemos observar nesta matéria, utilizando o Framework é bastante simples mostrar uma grade de imagens em miniatura no browse, com isso poderemos montar projetos com visualização de imagens no Delphi 8 com bastante facilidade. Um abraço a todos e até a próxima. Download: Visual_Imagem_D8.zip 20 MeGAZINE