Skip to content

Commit 6d2bb1d

Browse files
committed
Updating links to the ETSI specification
1 parent ba26670 commit 6d2bb1d

11 files changed

Lines changed: 20 additions & 24 deletions

docs/crud-operations.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,7 @@ Once an `<entity-id>` is known within the context, individual data entities can
148148
`/v2/entities/<entity-id>` endpoint.
149149

150150
It is recommended that entity identifiers should be URNs following the
151-
[NGSI-LD specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf),
151+
[NGSI-LD specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf),
152152
therefore each `id` is a URN which follows a standard format: `urn:ngsi-ld:<entity-type>:<entity-id>`. This helps making
153153
every `id` in the context data unique.
154154

docs/custom-iot-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -416,7 +416,7 @@ not hold sufficient information.
416416
### Provisioning a Sensor
417417

418418
It is common good practice to use URNs following the NGSI-LD
419-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) when creating
419+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf) when creating
420420
entities. Furthermore it is easier to understand meaningful names when defining data attributes. These mappings can be
421421
defined by provisioning a device individually.
422422

docs/entity-relationships.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -282,7 +282,7 @@ curl -iX POST \
282282
```
283283

284284
In both cases we have encoded each entity `id` according to the NGSI-LD
285-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) - the proposal
285+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf) - the proposal
286286
is that each `id` is a URN follows a standard format: `urn:ngsi-ld:<entity-type>:<entity-id>`. This will mean that every
287287
`id` in the system will be unique.
288288

docs/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -279,7 +279,7 @@ In this case we only have one entity type - **Store**
279279
#### Entity IDs should be a URN following NGSI-LD guidelines
280280

281281
NGSI-LD has recently been published as a full ETSI
282-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf), the proposal is
282+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf), the proposal is
283283
that each `id` is a URN follows a standard format: `urn:ngsi-ld:<entity-type>:<entity-id>`. This will mean that every
284284
`id` in the system will be unique
285285

docs/iot-agent-json.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -454,7 +454,7 @@ however it has been included here for completeness.
454454
### Provisioning a Sensor
455455

456456
It is common good practice to use URNs following the NGSI-LD
457-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) when creating
457+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf) when creating
458458
entities. Furthermore it is easier to understand meaningful names when defining data attributes. These mappings can be
459459
defined by provisioning a device individually.
460460

docs/iot-agent.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -440,7 +440,7 @@ however it has been included here for completeness.
440440
### Provisioning a Sensor
441441

442442
It is common good practice to use URNs following the NGSI-LD
443-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) when creating
443+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf) when creating
444444
entities. Furthermore it is easier to understand meaningful names when defining data attributes. These mappings can be
445445
defined by provisioning a device individually.
446446

docs/iot-over-mqtt.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -476,7 +476,7 @@ curl -iX POST \
476476
### Provisioning a Sensor
477477

478478
It is common good practice to use URNs following the NGSI-LD
479-
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf) when creating
479+
[specification](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf) when creating
480480
entities. Furthermore it is easier to understand meaningful names when defining data attributes. These mappings can be
481481
defined by provisioning a device individually.
482482

docs/ld-subscriptions-registrations.md

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[![FIWARE Core Context Management](https://nexus.lab.fiware.org/repository/raw/public/badges/chapters/core.svg)](https://github.com/FIWARE/catalogue/blob/master/core/README.md)
2-
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf)
2+
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf)
33
[![JSON](https://img.shields.io/badge/JSON--LD-1.1-f06f38.svg)](https://w3c.github.io/json-ld-syntax/)
44

55
**Description:** This tutorial discusses the usage of subscriptions and registrations within NGSI-LD and highlights the
@@ -78,16 +78,16 @@ proxy has also been added. To visualize and interact with the Context we will ad
7878
Therefore, the architecture will consist of four elements:
7979

8080
- The [Orion Context Broker](https://fiware-orion.readthedocs.io/en/latest/) which will receive requests using
81-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json)
81+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json)
8282
- The underlying [MongoDB](https://www.mongodb.com/) database :
8383
- Used by the Orion Context Broker to hold context data information such as data entities, subscriptions and
8484
registrations
8585
- The **Context Provider NGSI** proxy which will:
8686
- receive requests using
87-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json#/)
87+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json#/)
8888
- makes requests to publicly available data sources using their own APIs in a proprietary format
8989
- returns context data back to the Orion Context Broker in
90-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json#/)
90+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json#/)
9191
format.
9292
- The **Stock Management Frontend** which will:
9393
- Display store information
@@ -391,10 +391,6 @@ curl -iX POST 'http://localhost:1026/ngsi-ld/v1/csourceRegistrations/' \
391391
}'
392392
```
393393

394-
> **Note** that `properties` is defined in the 1.1.1 NGSI-LD core context. In 1.3.1, it is due to be replaced with
395-
> two separate attributes - `propertyNames` and `relationshipNames` - this change has been made in order to offer
396-
> full GeoJSON-LD support. Your context broker may or may not support the updated core context
397-
398394
### Read Registration Details
399395

400396
Retrieving the registration details can be made by sending a GET request to the `/ngsi-ld/v1/csourceRegistrations/`

docs/linked-data.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[![FIWARE Core Context Management](https://nexus.lab.fiware.org/repository/raw/public/badges/chapters/core.svg)](https://github.com/FIWARE/catalogue/blob/master/core/README.md)
2-
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf)
2+
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf)
33
[![JSON LD](https://img.shields.io/badge/JSON--LD-1.1-f06f38.svg)](https://w3c.github.io/json-ld-syntax/)
44

55
**Description:** This tutorial introduces linked data concepts to the FIWARE Platform. The supermarket chain’s store
@@ -25,7 +25,7 @@ The tutorial uses [cUrl](https://ec.haxx.se/) commands throughout, but is also a
2525
The introduction to FIWARE [Getting Started tutorial](getting-started.md) introduced the
2626
[NGSI v2](https://fiware.github.io/specifications/OpenAPI/ngsiv2) interface that is commonly used to create and
2727
manipulate context data entities. An evolution of that interface has created a supplementary specification called
28-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json)
28+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json)
2929
as a mechanism to enhance context data entities through adding the concept of **linked data**. This tutorial will
3030
introduce the background of the ideas behind the new interface and compare and contrast how to create and manipulate
3131
data entities as linked data.
@@ -84,7 +84,7 @@ Click on the image above to watch a video describing the basic concepts behind J
8484
**NGSI-LD** is an evolution of the **NGSI v2** information model, which has been modified to improve support for linked
8585
data (entity relationships), property graphs and semantics (exploiting the capabilities offered by JSON-LD). This work
8686
has been conducted under the ETSI ISG CIM initiative and the updated specification has been branded as
87-
[NGSI-LD](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf). The main constructs
87+
[NGSI-LD](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf). The main constructs
8888
of NGSI-LD are: _Entity_, _Property_ and _Relationship_. NGSI-LD Entities (instances) can be the subject of Properties
8989
or Relationships. In terms of the traditional NGSI v2 data model, Properties can be seen as the combination of an
9090
attribute and its value. Relationships allow to establish associations between instances using linked data.
@@ -162,7 +162,7 @@ Currently, the Orion Context Broker relies on open source [MongoDB](https://www.
162162
persistence of the context data it holds. Therefore, the architecture will consist of two elements:
163163

164164
- The [Orion Context Broker](https://fiware-orion.readthedocs.io/en/latest/) which will receive requests using
165-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json)
165+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json)
166166
- The underlying [MongoDB](https://www.mongodb.com/) database :
167167
- Used by the Orion Context Broker to hold context data information such as data entities, subscriptions and
168168
registrations

docs/relationships-linked-data.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[![FIWARE Core Context Management](https://nexus.lab.fiware.org/repository/raw/public/badges/chapters/core.svg)](https://github.com/FIWARE/catalogue/blob/master/core/README.md)
2-
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.03.01_60/gs_cim009v010301p.pdf)
2+
[![NGSI LD](https://img.shields.io/badge/NGSI-LD-d6604d.svg)](https://www.etsi.org/deliver/etsi_gs/CIM/001_099/009/01.04.01_60/gs_cim009v010401p.pdf)
33
[![JSON LD](https://img.shields.io/badge/JSON--LD-1.1-f06f38.svg)](https://w3c.github.io/json-ld-syntax/)
44

55
**Description:** This tutorial discusses relationships between linked data entities and how the concepts of **JSON-LD**
@@ -263,7 +263,7 @@ Currently, the Orion Context Broker relies on open source [MongoDB](https://www.
263263
persistence of the context data it holds. Therefore, the architecture will consist of two elements:
264264

265265
- The [Orion Context Broker](https://fiware-orion.readthedocs.io/en/latest/) which will receive requests using
266-
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/spec/updated/full_api.json)
266+
[NGSI-LD](https://forge.etsi.org/swagger/ui/?url=https://forge.etsi.org/rep/NGSI-LD/NGSI-LD/raw/master/spec/updated/generated/full_api.json)
267267
- The underlying [MongoDB](https://www.mongodb.com/) database :
268268
- Used by the Orion Context Broker to hold context data information such as data entities, subscriptions and
269269
registrations

0 commit comments

Comments
 (0)