Processamento da API da Groupon – Parte 3

Para concluir esta série de artigos, neste post vamos aplicar uma folha de estilos para transformar os dados XML gerados a partir do mapeamento da API da Groupon em HTML. Aqui está um exemplo da saída XML resultante do mapeamento de dados que criámos na última vez:

Atribuir uma folha de estilos para transformar XML A caixa de diálogo de configurações do componente, para o componente de saída do mapeamento MapForce, permite-nos atribuir uma folha de estilos criada com o Altova StyleVision.

Atribuir uma folha de estilos ao componente de saída do mapeamento de dados integra as funcionalidades do MapForce e do StyleVision, e uma nova série de botões aparece na parte inferior da janela de mapeamento do MapForce para os formatos HTML, RTF, PDF e Microsoft Word. (É necessário ter tanto o MapForce como o StyleVision instalados no seu computador.)

Quando clica em qualquer um destes botões de formato de saída, o MapForce executa o mapeamento de dados exatamente como vimos no post anterior. O MapForce transmite o resultado XML para o StyleVision, onde é transformado para o formato selecionado. Em seguida, o MapForce exibe o documento formatado na janela de saída. Aqui está a janela de saída do MapForce para HTML, com base na folha de estilos Power do StyleVision atribuída anteriormente:

O menu "Saída" do MapForce permite guardar a correspondência de dados XML ou o documento HTML formatado de acordo com a folha de estilos.

Como criar uma folha de estilos

Desenvolvemos uma folha de estilos para o mapeamento de dados da API da Groupon, utilizando o Altova StyleVision, com base no esquema XML para o componente de saída do MapForce. A interface intuitiva do StyleVision e as suas poderosas funcionalidades de acesso e manipulação de dados facilitam a criação de documentos apelativos em formatos HTML, RTF, PDF e Microsoft Word a partir de ficheiros XML. A captura de ecrã abaixo mostra a vista de design do StyleVision para a folha de estilos "Extreme Groupon". Os círculos azuis numerados identificam a localização de cada elemento de design, conforme listado após a imagem.

Características do ficheiro SPS

1. A definição HTML personalizada especifica a metaetiqueta de viewport para dispositivos móveis. Isto permite-nos criar uma única folha de estilos para gerar um único ficheiro HTML, que será utilizado tanto em computadores como em dispositivos móveis

2. Título do documento com fonte, tamanho e cor personalizados

3. Um elemento de autocalculo utiliza a função XPath "count" para contar o número de transações no documento XML de entrada e insere o total

4. A marca de data e hora é colocada no topo do documento, mesmo que o elemento de data apareça no final do ficheiro de dados de entrada XML

5. As imagens dos sites Altova e Groupon são referenciadas através de hiperligações, e não como dados de imagem incorporados

6. Linhas horizontais separam cada oferta individualmente. Em documentos HTML, as linhas ajustam-se automaticamente à largura da janela do navegador

7. Fontes e tamanhos personalizados atribuídos a diferentes elementos

8. Uma tabela com duas colunas organiza a descrição de cada oferta

9. As URLs no ficheiro XML são atribuídas dinamicamente como hiperligações para imagens incorporadas, texto fixo e dados dinâmicos

As folhas de estilo Power da StyleVision podem combinar vários ficheiros .xsd, folhas de estilo .css existentes, esquemas de bases de dados, taxonomias XBRL e muito mais, para produzir relatórios com formatação avançada que podem até incluir gráficos gerados automaticamente em diversos estilos. Também pode utilizar a StyleVision para definir formulários eletrónicos com campos de introdução de dados, menus suspensos, botões de opção e outras funcionalidades avançadas.

Visualização das transformações de folhas de estilo

O StyleVision permite atribuir um ficheiro XML de trabalho para visualizar o resultado à medida que cria o estilo, e os botões na parte inferior da janela de design facilitam a visualização do ficheiro de trabalho formatado à medida que aperfeiçoa o seu design. Guardámos a saída XML do mapeamento do MapForce e atribuímos-na como o nosso documento de trabalho. Quando o estilo foi concluído, a pré-visualização HTML no StyleVision era idêntica à janela de saída HTML do MapForce mostrada acima. Para visualizar o documento num dispositivo móvel, pode publicar o HTML como uma página num site ou enviá-lo por e-mail como um anexo.

Além da folha de estilos em si e das versões formatadas do documento de trabalho, o StyleVision permite guardar os ficheiros XSLT gerados para transformar outros ficheiros XML, utilizando o design da sua folha de estilos, fora da aplicação StyleVision.

Automação na próxima vez

No futuro, quando quiserem executar novamente um mapeamento de dados e atualizar o documento HTML com informações mais recentes, existem duas formas de automatizar este processo:

• Pode executar o MapForce a partir de um.. linha de comandos com parâmetros para definir o nome do ficheiro de definição de mapeamento, e até mesmo para invocar o StyleVision para criar resultados formatados

• Pode gerar código sem royalties para a mapeamento em XSLT, Java, C++ ou C#, para combinar com o código XSLT do StyleVision e criar a sua própria aplicação completa

O XMLSpy, o MapForce e o StyleVision estão todos disponíveis em conjunto no Altova MissionKit, que tem um preço especial. Veja por si mesmo como é fácil usar o MissionKit para converter dados de uma API web – descarregue uma versão de avaliação gratuita de 30 dias!

Nota do Editor: A nossa série original sobre a utilização da API da Groupon para mapeamento de dados foi publicada em três partes. Pode consultar as partes clicando nos links abaixo: A primeira parte, "Processamento da API da Groupon com o Altova MapForce", descreve como criar entradas dinâmicas através da recolha de dados de várias URLs. A segunda parte, "Processamento da API da Groupon com o MapForce – Parte 2", explica como filtramos os dados da API e definimos a saída para extrair apenas os detalhes mais relevantes. A terceira parte, "Processamento da API da Groupon – Parte 3", descreve como formatar a saída como um único documento HTML, otimizado para dispositivos de secretária e dispositivos móveis, e analisa formas de automatizar a execução repetida.