From f9a590837d317983768bc3d98cd57ac4d9f22a0c Mon Sep 17 00:00:00 2001 From: Alberto Abella Date: Thu, 7 Sep 2023 07:31:45 +0200 Subject: [PATCH] updated Project/doc/spec_IT.md --- Project/doc/spec_IT.md | 155 ++++++++++++++++++++++++++++++----------- 1 file changed, 115 insertions(+), 40 deletions(-) diff --git a/Project/doc/spec_IT.md b/Project/doc/spec_IT.md index 1940a89..b897855 100644 --- a/Project/doc/spec_IT.md +++ b/Project/doc/spec_IT.md @@ -7,16 +7,25 @@ [documento generato automaticamente](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60) + Descrizione globale: **Insieme di attività che, una volta eseguite, supportano il raggiungimento di un obiettivo strategico (Fornitura di servizi chiave, Evoluzione della gestione, Stretto contatto con il territorio, Rafforzamento delle imprese, Investimenti mirati, Promozione sociale/culturale/sportiva, ecc.) L'obiettivo stesso è composto da uno o più progetti e si rivolge a uno degli assi strategici (Modello di lavoro, Sviluppo economico, Sviluppo sociale, Sviluppo ambientale) che danno una forma di alto livello al Piano strategico**. + versione: 0.0.1 ## Elenco delle proprietà [*] Se non c'è un tipo in un attributo è perché potrebbe avere diversi tipi o diversi formati/modelli. - +- `address[object]`: L'indirizzo postale . Model: [https://schema.org/address](https://schema.org/address) - `addressCountry[string]`: Il paese. Ad esempio, la Spagna . Model: [https://schema.org/addressCountry](https://schema.org/addressCountry) + - `addressLocality[string]`: La località in cui si trova l'indirizzo civico e che si trova nella regione . Model: [https://schema.org/addressLocality](https://schema.org/addressLocality) + - `addressRegion[string]`: La regione in cui si trova la località, e che si trova nel paese . Model: [https://schema.org/addressRegion](https://schema.org/addressRegion) + - `district[string]`: Un distretto è un tipo di divisione amministrativa che, in alcuni paesi, è gestita dal governo locale. + - `postOfficeBoxNumber[string]`: Il numero di casella postale per gli indirizzi di casella postale. Ad esempio, 03578 . Model: [https://schema.org/postOfficeBoxNumber](https://schema.org/postOfficeBoxNumber) + - `postalCode[string]`: Il codice postale. Ad esempio, 24004 . Model: [https://schema.org/https://schema.org/postalCode](https://schema.org/https://schema.org/postalCode) + - `streetAddress[string]`: L'indirizzo stradale . Model: [https://schema.org/streetAddress](https://schema.org/streetAddress) +- `alternateName[string]`: Un nome alternativo per questa voce - `areaServed[string]`: L'area geografica in cui viene fornito il servizio o l'articolo offerto. . Model: [https://schema.org/Text](https://schema.org/Text) - `axis[string]`: Asse strategico di appartenenza del progetto - `challenges[string]`: Sfide che il progetto deve affrontare - `dataProvider[string]`: una sequenza di caratteri che identifica il fornitore dell'entità di dati armonizzata - `dateCreated[date-time]`: Timestamp di creazione dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `dateModified[date-time]`: Timestamp dell'ultima modifica dell'entità. Di solito viene assegnato dalla piattaforma di archiviazione - `delegations[array]`: Delegazioni o dipartimenti interni a cui il progetto appartiene - `delegationsInvolved[array]`: Delegazioni o dipartimenti interni coinvolti nel progetto - `description[string]`: Descrizione dell'articolo - `id[*]`: Identificatore univoco dell'entità - `interestGroups[array]`: Delegazioni o dipartimenti interni coinvolti nel progetto - `location[*]`: Riferimento geojson all'elemento. Può essere un punto, una stringa di linea, un poligono, un multi-punto, una stringa di linea o un poligono multiplo. - `modifications[string]`: Modifiche che il progetto ha incorporato in un eventuale aggiornamento - `name[string]`: Il nome di questo elemento - `observations[string]`: Testo libero sulle caratteristiche specifiche del progetto - `owner[array]`: Un elenco contenente una sequenza di caratteri codificata JSON che fa riferimento agli ID univoci dei proprietari. - `plan[string]`: Sottotipo di progetto. Enum:'EDS, PPE' - `refDevice[array]`: Dispositivo/i utilizzato/i per ottenere la misura - `sdg[string]`: Obiettivo di sviluppo sostenibile a cui il progetto appartiene - `seeAlso[*]`: elenco di uri che puntano a risorse aggiuntive sull'elemento - `source[string]`: Una sequenza di caratteri che indica la fonte originale dei dati dell'entità come URL. Si consiglia di utilizzare il nome di dominio completamente qualificato del provider di origine o l'URL dell'oggetto di origine. - `strategicObjective[string]`: Obiettivo strategico del progetto - `type[string]`: Deve essere uguale a Progetto Proprietà richieste -- Nessuna proprietà richiesta +- `id` - `type` @@ -33,29 +42,51 @@ Project: description: The mailing address properties: addressCountry: - description: 'Property. The country. For example, Spain. Model:''https://schema.org/addressCountry''' + description: 'The country. For example, Spain' type: string + x-ngsi: + model: https://schema.org/addressCountry + type: Property addressLocality: - description: 'Property. The locality in which the street address is, and which is in the region. Model:''https://schema.org/addressLocality''' + description: 'The locality in which the street address is, and which is in the region' type: string + x-ngsi: + model: https://schema.org/addressLocality + type: Property addressRegion: - description: 'Property. The region in which the locality is, and which is in the country. Model:''https://schema.org/addressRegion''' + description: 'The region in which the locality is, and which is in the country' type: string + x-ngsi: + model: https://schema.org/addressRegion + type: Property district: - description: 'A district is a type of administrative division that, in some countries, is managed by the local government.' + description: 'A district is a type of administrative division that, in some countries, is managed by the local government' type: string + x-ngsi: + type: Property postOfficeBoxNumber: - description: 'Property. The post office box number for PO box addresses. For example, 03578. Model:''https://schema.org/postOfficeBoxNumber''' + description: 'The post office box number for PO box addresses. For example, 03578' type: string + x-ngsi: + model: https://schema.org/postOfficeBoxNumber + type: Property postalCode: - description: 'Property. The postal code. For example, 24004. Model:''https://schema.org/https://schema.org/postalCode''' + description: 'The postal code. For example, 24004' type: string + x-ngsi: + model: https://schema.org/https://schema.org/postalCode + type: Property streetAddress: - description: 'Property. The street address. Model:''https://schema.org/streetAddress''' + description: The street address type: string + x-ngsi: + model: https://schema.org/streetAddress + type: Property streetNr: - description: Number identifying a specific property on a public street. + description: Number identifying a specific property on a public street type: string + x-ngsi: + type: Property type: object x-ngsi: model: https://schema.org/address @@ -72,41 +103,41 @@ Project: model: https://schema.org/Text type: Property axis: - description: Property. Strategic axis the project belongs to + description: Strategic axis the project belongs to type: string x-ngsi: type: Property challenges: - description: 'Property. Challenges to be faced by the project ' + description: 'Challenges to be faced by the project ' type: string x-ngsi: type: Property dataProvider: - description: A sequence of characters identifying the provider of the harmonised data entity. + description: A sequence of characters identifying the provider of the harmonised data entity type: string x-ngsi: type: Property dateCreated: - description: Entity creation timestamp. This will usually be allocated by the storage platform. + description: Entity creation timestamp. This will usually be allocated by the storage platform format: date-time type: string x-ngsi: type: Property dateModified: - description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform. + description: Timestamp of the last modification of the entity. This will usually be allocated by the storage platform format: date-time type: string x-ngsi: type: Property delegations: - description: Property. Delegations or internal departments the project belongs to. + description: Delegations or internal departments the project belongs to items: type: string type: array x-ngsi: type: Property delegationsInvolved: - description: Property. Delegations or internal departments involved in the project + description: Delegations or internal departments involved in the project items: type: string type: array @@ -118,20 +149,24 @@ Project: x-ngsi: type: Property id: - anyOf: &project_-_properties_-_owner_-_items_-_anyof - - description: Property. Identifier format of any NGSI entity + anyOf: + - description: Identifier format of any NGSI entity maxLength: 256 minLength: 1 pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ type: string - - description: Property. Identifier format of any NGSI entity + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity format: uri type: string + x-ngsi: + type: Property description: Unique identifier of the entity x-ngsi: type: Property interestGroups: - description: Property. Delegations or internal departments involved in the project + description: Delegations or internal departments involved in the project items: type: string type: array @@ -140,7 +175,7 @@ Project: location: description: 'Geojson reference to the item. It can be Point, LineString, Polygon, MultiPoint, MultiLineString or MultiPolygon' oneOf: - - description: GeoProperty. Geojson reference to the item. Point + - description: Geojson reference to the item. Point properties: bbox: items: @@ -161,7 +196,9 @@ Project: - coordinates title: GeoJSON Point type: object - - description: GeoProperty. Geojson reference to the item. LineString + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. LineString properties: bbox: items: @@ -185,7 +222,9 @@ Project: - coordinates title: GeoJSON LineString type: object - - description: GeoProperty. Geojson reference to the item. Polygon + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. Polygon properties: bbox: items: @@ -211,7 +250,9 @@ Project: - coordinates title: GeoJSON Polygon type: object - - description: GeoProperty. Geojson reference to the item. MultiPoint + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiPoint properties: bbox: items: @@ -234,7 +275,9 @@ Project: - coordinates title: GeoJSON MultiPoint type: object - - description: GeoProperty. Geojson reference to the item. MultiLineString + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString properties: bbox: items: @@ -260,7 +303,9 @@ Project: - coordinates title: GeoJSON MultiLineString type: object - - description: GeoProperty. Geojson reference to the item. MultiLineString + x-ngsi: + type: GeoProperty + - description: Geojson reference to the item. MultiLineString properties: bbox: items: @@ -288,33 +333,49 @@ Project: - coordinates title: GeoJSON MultiPolygon type: object + x-ngsi: + type: GeoProperty x-ngsi: type: GeoProperty modifications: - description: 'Property. Changes that the project has incorporated in a possible update ' + description: 'Changes that the project has incorporated in a possible update ' type: string x-ngsi: type: Property name: - description: The name of this item. + description: The name of this item type: string x-ngsi: type: Property observations: - description: Property. Free text about specific characteristics of the project + description: Free text about specific characteristics of the project type: string x-ngsi: type: Property owner: description: A List containing a JSON encoded sequence of characters referencing the unique Ids of the owner(s) items: - anyOf: *project_-_properties_-_owner_-_items_-_anyof - description: Property. Unique identifier of the entity + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property type: array x-ngsi: type: Property plan: - description: 'Property. Subtype of project. Enum:''EDS, PPE''' + description: 'Subtype of project. Enum:''EDS, PPE''' enum: - EDS - PPE @@ -322,17 +383,31 @@ Project: x-ngsi: type: Property refDevice: - description: Relationship. Device(s) used to obtain the measurement. + description: Device(s) used to obtain the measurement items: - anyOf: *project_-_properties_-_owner_-_items_-_anyof - description: Property. Unique identifier of the entity + anyOf: + - description: Identifier format of any NGSI entity + maxLength: 256 + minLength: 1 + pattern: ^[\w\-\.\{\}\$\+\*\[\]`|~^@!,:\\]+$ + type: string + x-ngsi: + type: Property + - description: Identifier format of any NGSI entity + format: uri + type: string + x-ngsi: + type: Property + description: Unique identifier of the entity + x-ngsi: + type: Property minItems: 1 type: array uniqueItems: true x-ngsi: type: Relationship sdg: - description: 'Property. Sustainable Development goal the project belongs to ' + description: 'Sustainable Development goal the project belongs to ' type: string x-ngsi: type: Property @@ -349,17 +424,17 @@ Project: x-ngsi: type: Property source: - description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object.' + description: 'A sequence of characters giving the original source of the entity data as a URL. Recommended to be the fully qualified domain name of the source provider, or the URL to the source object' type: string x-ngsi: type: Property strategicObjective: - description: 'Property. Strategic objective the project belongs to ' + description: 'Strategic objective the project belongs to ' type: string x-ngsi: type: Property type: - description: Property. It must be equal to Project + description: It must be equal to Project enum: - Project type: string