A.3 Guia de Acesso
A.4.1 Conteúdos
Esta operação permite obter um resumo das notícias, podendo estar incluídas imagens no texto (atra- vés da respectiva tag no formato HTML) [Pereira 2011b].
URL http://uaonline.ua.pt/xml/contents_xml.asp
Método HTTP GET
Formato da Resposta XML Argumentos:
• lid: Identificador da língua pretendida. Valor por defeito: 18 (Português). Consultar Linguagens (A.4.2).
• dt: Flag indicadora da inclusão de destaques (0 ou 1). Valor por defeito: 0.
• n: Número máximo de notícias a serem listadas. Valor por defeito: 6.
• di: data de início.
• df: Data de fim.
• i: Identificador da categoria do conteúdo. Consultar Categorias (A.4.3).
• d: Identificador do departamento. Consultar Departamentos (A.4.4).
Exemplo http://uaonline.ua.pt/xml/contents_xml.asp?n=2
Resposta
1 <?xml version="1.0" encoding="utf-16"?>
2 <?xml-stylesheet type="text/xsl" href="style.xsl" version="1.0"?> 3 <rss version="2.0">
4 <channel>
5 <title>@UA_online</title>
6 <link>http://uaonline.ua.pt</link>
7 <description>Jornal Online da Universidade de Aveiro</description>
8 <language>pt-pt</language>
9 <copyright>2012Universidade de Aveiro</copyright>
10 <lastBuildDate>Fri, 13 Apr 2012 15:24 GMT</lastBuildDate>
11 <ttl>2</ttl>
12 <image>
13 <title>www.ua.pt</title>
14 <url>http://uaonline.ua.pt/images/logo_ua_44.gif</url>
15 <link>http://uaonline.ua.pt</link>
16 <width>44</width>
17 <height>44</height>
18 </image>
19 <item>
20 <guid>http://uaonline.ua.pt/detail.asp?c=23722</guid>
21 <title>Novo ranking de Leiden destaca boa performance da UA</title>
22 <link>http://uaonline.ua.pt/detail.asp?c=23722</link>
23 <description><img src="http://uaonline.ua.pt/upload/img/thumb_img_c2_9638.jpg" alt="" title="" />A UA é a universidade portuguesa que consegue um impacto mais elevado com a sua produção científica (artigos publicados), no período 2011/2012, de acordo com os critérios definidos no Ranking da Universidade de Leiden, posição cimeira que repete a avaliação do ranking do Times Higher Education (THE) feita em outubro do ano passado. De resto, o ranking de Leiden
atribui boas prestações às universidades portuguesas, mesmo no contexto internacional.</description>
24 <pubDate>Fri, 13 Apr 2012 00:00 GMT</pubDate>
25 </item>
26 (...)
27 </channel>
28 </rss>
A.4.2
Linguagens
Operação que permite obter uma lista das linguagens disponíveis para os conteúdos.
URL http://uaonline.ua.pt/xml/languages_xml.asp
Método HTTP GET
Resposta
1 <?xml version="1.0" encoding="utf-16"?> 2 <linguas>
3 <item>
4 <guid>18</guid>
5 <nome>português</nome>
6 <sigla>pt</sigla>
7 </item>
8 <item>
9 <guid>19</guid>
10 <nome>inglês</nome>
11 <sigla>en</sigla>
12 </item>
13 <item>
14 <guid>43</guid>
15 <nome>espanhol</nome>
16 <sigla>es</sigla>
17 </item>
18 </linguas>
A.4.3
Categorias
Esta operação permite obter uma lista das categorias de conteúdos disponíveis para um dado site, e numa determinada linguagem.
URL http://uaonline.ua.pt/xml/categs_xml.asp
Método HTTP GET
Formato da Resposta XML Argumentos:
• lid: Identificador da linguagem pretendida. Valor por defeito: 18 (Português). Consultar Lin- guagens (A.4.2). Resposta 1 <?xml version="1.0" encoding="utf-16"?> 2 <categorias> 3 <item> 4 <guid>60</guid>
5 <nome>notícias</nome>
6 </item>
7 <item>
8 <guid>67</guid>
9 <nome>Distinções</nome>
10 </item>
11 (...)
12 </categorias>
A.4.4
Departamentos
URL http://uaonline.ua.pt/xml/deps_xml.asp Método HTTP GET Formato da Resposta XML Resposta 1 <?xml version="1.0" encoding="utf-16"?> 2 <departamentos> 3 <item> 4 <guid>0</guid>
5 <nome>@UA_online</nome>
6 <sigla>uaonline</sigla>
7 </item>
8 <item>
9 <guid>1</guid>
10 <nome>Departamento de Ambiente e Ordenamento</nome>
11 <sigla>dao</sigla>
12 </item>
13 (...)
14 </departamentos>
A.4.5
Banners
Operação que permite obter os banners publicitários institucionais. É também possível obter os ban- ners publicitários associados a um determinado departamento.
URL http://uaonline.ua.pt/xml/banners_xml.asp
Método HTTP GET
Formato da Resposta XML Argumentos:
• d: Identificador do departamento. Valor por defeito: 0 (banners do Jornal Online). Consultar Departamentos (A.4.4). Resposta 1 <?xml version="1.0" encoding="utf-16"?> 2 <pub> 3 <item> 4 <guid>551</guid>
5 <descricao>forum 3e_2012</descricao>
6 <url_ficheiro>http://uaonline.ua.pt/upload/pub/banner_551.swf</url_ficheiro>
7 <url_site>http://</url_site> 8 <posicao>0</posicao> 9 <peso>10</peso> 10 </item> 11 <item> 12 <guid>547</guid>
13 <descricao>revista turismo</descricao>
14 <url_ficheiro>http://uaonline.ua.pt/upload/pub/banner_547.swf</url_ficheiro>
15 <url_site>http://</url_site> 16 <posicao>0</posicao> 17 <peso>1</peso> 18 </item> 19 (...) 20 </pub>
A.4.6
Pesquisa
Esta operação permite efectuar pesquisas de texto nos campos Título, Ante-título e Resumo, tanto nas notícias como nos eventos.
URL http://uaonline.ua.pt/xml/pesquisa_xml.asp
Método HTTP GET
Formato da Resposta XML Argumentos:
• str: Texto a ser pesquisado.
• lid: Identificador da linguagem pretendida. Valor por defeito: 18 (Português). Consultar Lin- guagens (A.4.2).
• d: Identificador do departamento. Valor por defeito: 0 (banners do Jornal Online). Consultar Departamentos (A.4.4).
• di: Permite especificar uma data de início para os resultados da pesquisa. A data deve estar no formato dd-mm-aaaa. Valor por defeito: 1 ano precedente à data da pesquisa.
• df: Permite especificar uma data de fim para os resultados da pesquisa. A data deve estar no formato dd-mm-aaaa. Valor por defeito: 1 ano procedente à data da pesquisa.
• t: Tipo de pesquisa a ser efectuada:
– and: Devolve os resultados de todas as palavras presentes no argumento str.
– or: Devolve os resultados que contenham qualquer uma das palavras presentes no argu- mento str.
• e: Indica a categoria onde deve ser feita a pesquisa: – j: Notícias. – e: Eventos. Exemplo http://uaonline.ua.pt/xml/pesquisa_xml.asp?str=deti&lid=18 Resposta 1 <?xml version="1.0" encoding="utf-16"?> 2 <resultados> 3 <item guid="23571">
4 <titulo><![CDATA[Robôs humanoides da UA à conquista do pódio na Alemanha]]></titulo>
5 <data>3/29/2012</data>
6 <url>http://uaonline.ua.pt/detail.asp?lg=pt&c=23571</url>
7 </item>
8 <item guid="23005">
9 <titulo><![CDATA[Novidades tecnológicas podem ser conhecidas no DETI]]></titulo>
10 <data>2/1/2012</data>
11 <url>http://uaonline.ua.pt/detail.asp?lg=pt&c=23005</url>
12 </item>
13 (...)
A.4.7
Eventos
Através desta operação é possível obter os eventos disponíveis no Jornal Online. Estes eventos são devolvidos no formato vCalendar.
URL http://uaonline.ua.pt/xml/events_vcal.asp
Método HTTP GET
Formato da Resposta XML Argumentos:
• lid: Identificador da linguagem pretendida. Valor por defeito: 18 (Português). Consultar Lin- guagens (A.4.2).
• d: Identificador do departamento. Valor por defeito: 0 (banners do Jornal Online). Consultar Departamentos (A.4.4).
• di: Permite especificar uma data de início para os resultados da pesquisa. A data deve estar no formato dd-mm-aaaa.
• df: Permite especificar uma data de fim para os resultados da pesquisa. A data deve estar no formato dd-mm-aaaa.
• i: Tipo de evento a ser devolvido.
Exemplo http://uaonline.ua.pt/xml/events_vcal.asp?d=23&di=01-04-2012 Resposta 1 <?xml version="1.0" encoding="utf-16"?> 2 <eventos> 3 <evento guid="16692"> 4 BEGIN:VCALENDAR 5 PRODID: ua_online 6 VERSION: 1.0 7 METHOD:PUBLISH 8 BEGIN:VEVENT
9 SUMMARY: Provas do Programa Doutoral em Música, de Ana Veloso
10 DESCRIPTION: As Provas do Programa Doutoral em Música de Ana Luísa Setas Veloso, no âmbito do Programa Doutoral em Música, decorrem a 18 de abril, a partir das
15h00, no Departamento de Engenharia Mecânica. «Voar até ao comboio dos Segredos: A construção de significados partilhados no desenvolvimento do pensamento musical em crianças do 1o ciclo do EB.» é o título da tese a apresentar.
11 LOCATION:
12 DTSTART: 4/18/2012 3:00:00 PM
13 DTEND: 4/18/2012 11:59:00 PM
14 CATEGORIES: Provas Académicas
15 END:VEVENT
16 END:VCALENDAR </evento>
17 (...)