e.Toscana Compliance 
Request for Comments: 56.1
Del: 01/10/2007
Categoria: Applicativa
Destinatari: Applicazioni che vogliono sottoscrivere eventi ci creazione o modifica di RFC e.Toscana


Metadati RFC e.Toscana
======================


1. Contesto di riferimento
==========================
Il sito http://web.rete.toscana.it/eCompliance  il luogo dove i soggetti della
Comunit e.Toscana si incontrano per discutere degli standard con cui le
applicazioni cooperanti si scambiano le informazioni. Il risultato di tale
collaborazione  la scrittura di documenti detti RFC e.Toscana Applicativi. Gli
elementi essenziali di tali documenti devono essere diffusi capillarmente in
modo da stimolare la discussione ottenendo la massima condivisione. La
cooperazione applicativa  un canale di diffusione che pu essere sfruttato a
tale scopo.

2. Obiettivi
============
Le applicazioni che possono beneficiare della pubblicazione degli estremi degli
RFC sono molteplici: supporto al processo di sviluppo dei servizi basato su RFC,
monitoraggio di servizi, diffusione degli RFC multicanale.

3. Analisi:
===========

3.1 Lista degli agenti coinvolti
================================
Sito e.Compliance: il sito http://web.rete.toscana.it/eCompliance deve
pubblicare tutte le informazioni essenziali relative ad un RFC posto sul portale
stesso. Varie sono le componenti software che sono interessate a questo tipo di
informazioni: gestori del processo di sviluppo di un servizio basati su RFC,
monitoraggio dell'esercizio di un servizio, diffusori multicanali di
informazioni.

3.2 Ruoli:
==========
Pubblicatore: attore che conosce tutte le informazioni dell'RFC e le rende
disponibile ai Sottoscrittori. 
Sottoscrittore: attore interessato alle informazioni relative all'RFC

3.3 Ruoli/Agenti
================
Sito e.Compliance: pubblica le informazioni essenziali relative ad un RFC
Gestori, Monitori, Diffusori dell'RFC: sottoscrivono le informazioni relative all'RFC

3.4 Interazioni Previste:
=========================
CU1: 
----
* quando vengono inseriti o modificati i metadati relativi ad una RFC e.Toscana
il sito e.Toscana Compliance pubblica tali informazioni.
* i sottoscrittori, quando vogliono, prelevano le informazioni pubblicate e
aggiornano, se lo reputano necessario, le loro banche dati.

3.4.1:
======
Quando qualche membro della Comunit e.Toscana Compliance inserisce o modifica
un RFC sul sito della e.Toscana Compliance
(http://web.rete.toscana.it/eCompliance) viene pubblicato un messaggio con il
seguente XML-Schema:

[Metadati.xsd]
<?xml version="1.0" encoding="UTF-8"?>
<schema
	xmlns="http://www.w3.org/2001/XMLSchema"
	targetNamespace="http://www.regione.toscana.it/metadati"
	xmlns:tns="http://www.regione.toscana.it/metadati"
	elementFormDefault="qualified"
	xmlns:Q1="http://www.regione.toscana.it/codifiche/RFC">

	<import
		schemaLocation="Codifiche.xsd"
		namespace="http://www.regione.toscana.it/codifiche/RFC">
		<annotation>
		<documentation>
		CodificheRFC.xsd e' definito dall'RFC e.Toscana standard numero 55 
		"Codifica Aree Intervento e Stati di una RFC"  
		</documentation>
		</annotation>
	</import>

	<!-- Messaggio con cui vengono notificati i metadati degli RFC -->

	<element
		name="MetadatiRFC"
		type="tns:metadati_rfc_Type">
	</element>

	<complexType name="metadati_rfc_Type">
		<sequence>
			<element
				name="numero"
				type="integer"
				maxOccurs="1"
				minOccurs="1">
				<annotation>
					<documentation>
						Viene inserito il progressivo che in modo
						univoco individua l'RFC
					</documentation>
				</annotation>
			</element>
			<element
				name="versione"
				type="integer"
				maxOccurs="1"
				minOccurs="1">
				<annotation>
					<documentation>
						Un RFC pu avere pi versioni dovute alla
						discussione collaborativa della Comunit
						e.Toscana. Questo numero ne individua il numero
						di proposte e insieme al numero di RFC definisce
						in modo univoco il documento
					</documentation>
				</annotation>
			</element>
			<element name="data">
				<annotation>
					<documentation>
						Data di presentazione sul portale del documento
					</documentation>
				</annotation>
				<simpleType>
					<restriction base="date">
						<pattern value="\p{Nd}{4}-\p{Nd}{2}-\p{Nd}{2}" />
					</restriction>
				</simpleType>
			</element>

			<element
				name="stato"
				minOccurs="1"
				maxOccurs="1"
				type="Q1:Stato">
				<annotation>
					<documentation>
						Stato del documento. Si faccia riferimento al
						documento delle codifiche per ulteriori dettagli
					</documentation>
				</annotation>
			</element>

			<element
				name="area_intervento"
				minOccurs="1"
				maxOccurs="1"
				type="Q1:AreaIntervento">

				<annotation>
					<documentation>
						Individua l'area di intervento dell'RFC. Si
						faccia riferimento al documento delle codifiche
						per ulteriori dettagli
					</documentation>
				</annotation>
			</element>

			<element
				name="titolo"
				type="string"
				maxOccurs="1"
				minOccurs="1">
				<annotation>
					<documentation>
						Si inserisce il titolo dell'RFC
					</documentation>
				</annotation>
			</element>


			<element
				name="descrizione"
				type="string"
				minOccurs="1"
				maxOccurs="1">
				<annotation>
					<documentation>
						Si inserisce la descrizione dell'RFC
					</documentation>
				</annotation>
			</element>

			<element
				name="url"
				type="string"
				minOccurs="1"
				maxOccurs="1">
				<annotation>
					<documentation>
						Si inserisce l'URL in cui l'RFC pu essere
						reperita.Si fa riferimento ad uno specifico link
						all'interno del portale per l'e.Toscana
						Compliance
					</documentation>
				</annotation>
			</element>

		</sequence>
	</complexType>
</schema>


Di seguito e' riportato un esempio di documento XML valido rispetto allo schema.

[Metadati.xml]
<?xml version="1.0" encoding="UTF-8"?>
<tns:MetadatiRFC
	xmlns:tns="http://www.regione.toscana.it/metadati"
	xmlns:tns1="http://www.regione.toscana.it/codifiche/RFC"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.regione.toscana.it/metadati Metadati.xsd">
	<tns:numero>56</tns:numero>
	<tns:versione>1</tns:versione>
	<tns:data>2007-10-01</tns:data>
	<tns:stato>CANDIDATO</tns:stato>
	<tns:area_intervento>ALTRO</tns:area_intervento>
	<tns:titolo>Metadati RFC e.Toscana</tns:titolo>
	<tns:descrizione>RFC che poropone di pubblicare i metadati 
	sugli RFC e.Toscana raccolti dal sito e.Toscana Compliance</tns:descrizione>
	<tns:url>http://web.rete.toscana.it/eCompliance/portale/</tns:url>
</tns:MetadatiRFC>


4.Prodotti Attesi:
=================
Il sito per l'e.Toscana Compliance dovr produrre dei messaggi in conformit a
quanto sopra decritto.

5. Bibliografia
===============
[1] "RFC Applicativo e.Toscana", RFC 17, 
http://web.rete.toscana.it/eCompliance/portale/mostraRFC?idRev=55&idRfc=17

[2] "XML Schema: patterns for data type restrictions" 
http://www.w3.org/TR/xmlschema-2/#dt-pattern

[3] "RFC Codifiche e.Toscana", RFC 55, 
http://web.rete.toscana.it/eCompliance/portale/mostraRFC?idRev=128&idRfc=55
