このチュートリアルでは、FIWARE ユーザに、リンクト・データに基づいてシステムを設計および設計し、リンクト・データのコンテキストをプログラムで変更する方法を学習します。このチュートリアルは、同等の NGSI-v2 チュートリアルから得られた知識を拡張し、コンテキスト・データを取得および変更するために、NGSI-LD 対応 Node.js Express アプリケーションでコードを記述する方法をユーザが理解できるようにします。これにより、コマンドラインを使用して cUrl コマンドを呼び出す必要がなくなります。

このチュートリアルでは、主に Node.js で記述されたコードについて説明しますが、cUrl コマンドを実行することで結果の一部を確認できます。同じコマンドの Postman ドキュメントも利用できます。

⚠️ 注: このチュートリアルは、システムを NGSI-LD に切り替えたりアップグレードしたりする NGSI-v2 開発者向けに設計されています。リンクト・データシステムを最初から構築する場合、または NGSI-v2 にまだ慣れていない場合は、 NGSI-LD 開発者向けチュートリアルのドキュメントを参照することをお勧めします。

リンクト・データ・エンティティの操作¶

“This is the house that Jack built.

This is the malt that lay in the house that Jack built.

This is the rat that ate the malt
That lay in the house that Jack built.

This is the cat
That killed the rat that ate the malt
That lay in the house that Jack built.

This is the dog that chased the cat
That killed the rat that ate the malt
That lay in the house that Jack built.”

― This Is the House That Jack Built, Traditional English Nursery Rhyme

NGSI-LD は NGSI-v2 の進化形であるため、NSGI-LD に基づくスマート・ソリューションが、プログラムによるデータ・アクセスに関する以前の NGSI-v2 チュートリアルで概説したものと同じ基本シナリオをカバーする必要があることは驚くべきことではありません。

NGSI-LD リンクト・データは、Property 属性、または Relationship 属性のみとして定義されるデータ属性を制限することにより、コンテキスト・エンティティの構造をより高度に形式化します。これは、ある Relationship から別の Relationship に移動するときに、コンテキスト・データ・グラフをより確実にトラバースできることを意味します。システム内のすべてのコンテキスト・データ・エンティティは、コンテキスト・ファイルを参照することで正式に定義される JSON-LD データモデルによって定義され、このプログラム上の定義により、関連付けられたリンクト・エンティティが存在することが保証されます。

スーパーマーケットの3つの基本的なデータ・アクセス・シナリオを以下に定義します :

データの読み取り - たとえば、Building エンティティ urn:ngsi-ld:Building:store001 のすべてのデータを提供します
集計 - たとえば、Building urn:ngsi-ld:Building:store001 で販売されている Products エンティティを結合し、販売する商品を表示します
システム内のコンテキストを変更します - たとえば、製品の販売を行います :
- Product の価格で毎日の販売記録を更新します
- Shelf エンティティの numberOfItems を減らします
- 販売が発生したことを示す新しいトランザクション・ログ・レコードを作成します
- 10個未満のオブジェクトが販売されている場合、倉庫でアラートを発生させます
- など

さらに高度なシナリオについては、この後のチュートリアルで説明します。

在庫管理システム内のリンクト・データ・エンティティ¶

以前のチュートリアルで作成されたスーパーマーケットのデータが Context Broker にロードされます。エンティティ間のリレーションシップは、次のように定義されます:

Building, Product, Shelf, StockOrder エンティティは、デモアプリケーションのフロントエンドにデータを表示するために使用されます。

このチュートリアルの学習目標¶

このチュートリアルの目的は、一般的なデータ・アクセス・シナリオをカバーする一連の一般的なコード例を定義および議論することにより、コンテキスト・データのプログラムによるアクセスについて開発者の理解を向上させることです。この目的のために、単純な Node.js Express アプリケーションが作成されます。

ここでの意図は、Express でアプリケーションを作成する方法をユーザに教えることではありません - 実際、任意の言語を選択できます。これは、任意のサンプル・プログラミング言語を使用してコンテキストを変更し、ビジネス・ロジックの目標を達成する方法を示すためのものです。

明らかに、プログラミング言語の選択は、以下のコードを読むときのあなた自身のビジネスニーズに依存します。これを念頭に置いて、必要に応じて Node.js を独自のプログラミング言語に置き換えてください。

在庫管理フロントエンド¶

デモ用のすべてのコード Node.js Express は、GitHub リポジトリ内の ngsi-ld フォルダ内にあります。在庫管理の例。アプリケーションは次の URL で実行されます :

http://localhost:3000/app/store/urn:ngsi-ld:Building:store001
http://localhost:3000/app/store/urn:ngsi-ld:Building:store002
http://localhost:3000/app/store/urn:ngsi-ld:Building:store003
http://localhost:3000/app/store/urn:ngsi-ld:Building:store004

ヒント さらに、コンテナ・ログを追跡するか、Web ブラウザで localhost:3000/app/monitor の情報を表示することで、最近のリクエストのステータスを自分で監視することもできます。

前提条件¶

Docker¶

物事を単純にするために、両方のコンポーネントが Docker を使用して実行されます。Docker は、さまざまコンポーネントをそれぞれの環境に分離することを可能にするコンテナ・テクノロジです。

Windows に Docker をインストールするには、こちらの指示に従ってください
Mac に Docker をインストールするには、こちらの指示に従ってください
Linux に Docker をインストールするには、こちらの手順に従ってください

Docker Compose は、マルチコンテナ Docker アプリケーションを定義して実行するためのツールです。 YAML ファイルを使用して、アプリケーションに必要なサービスを設定します。これは、すべてのコンテナ・サービスを単一のコマンドで起動できることを意味します。Docker Compose は、Docker for Windows および Docker for Mac の一部としてデフォルトでインストールされますが、Linux ユーザはこちらにある手順に従う必要があります。

Cygwin¶

簡単な bash スクリプトを使ってサービスを開始します。Windows ユーザは、Windows 上の Linux ディストリビューションに似たコマンドライン機能を提供するために cygwin をダウンロードするべきです。

アーキテクチャ¶

デモ・スーパーマーケット・アプリケーションは、準拠している Context Broker と NGSI-LD の呼び出しを送受信します。 NGSI-LD インターフェースは、Orion Context Broker の実験バージョンで利用できるため、デモ・アプリケーションは1つの FIWARE コンポーネントのみを使用します。

現在、Orion Context Broker は、オープンソース MongoDB テクノロジに依存して、保持しているコンテキスト・データの永続性を維持しています。外部ソースからコンテキスト・データをリクエストするために、シンプルな Context Provider NGSI proxy も追加されました。コンテキストを視覚化し、対話するために、簡単な Express アプリケーションを追加します。したがって、アーキテクチャは次の3つの要素で構成されます :

NGSI-LD を使ってリクエストを受け取る Orion Context Broker
基礎となる MongoDB データベース :
- データ・エンティティ、サブスクリプション、レジストレーションなどのコンテキスト・データ情報を保持するために Orion Context Broker によって使用されます
在庫管理フロントエンド は、次のことができます
- ストア情報を表示
- 各ストアで購入できる製品を表示
- ユーザが製品を "購入" して在庫数を減らすことを許可

要素間のすべての対話は HTTP リクエストによって開始されるため、エンティティはコンテナ化され、公開されたポートから実行できます。

Context Provider NGSI proxy に必要な設定情報は、関連する orion-ld.yml ファイルのサービス・セクションで確認できます :

tutorial:
    image: fiware/tutorials.context-provider
    hostname: context-provider
    container_name: fiware-tutorial
    networks:
        - default
    expose:
        - "3000"
    ports:
        - "3000:3000"
    environment:
        - "DEBUG=tutorial:*"
        - "WEB_APP_PORT=3000"
        - "NGSI_VERSION=ngsi-ld"
        - "CONTEXT_BROKER=http://orion:1026/ngsi-ld/v1"

tutorial コンテナは、次のような環境変数によって駆動されます :

キー	値	説明
DEBUG	`tutorial:*`	ロギングに使用されるデバッグ・フラグ
WEB_APP_PORT	`3000`	データを表示するために Context Provider NGSI proxy および Web アプリが使用するポート
CONTEXT_BROKER	`http://orion:1026/ngsi-ld/v1`	コンテキストを更新するために接続する Context Broker の URL

YAML ファイルで説明されている他の tutorial コンテナ設定値は、チュートリアルのこのセクションでは使用しません。

MongoDB および Orion Context Broker の構成情報は、以前のチュートリアルで説明されています

スタートアップ¶

すべてのサービスは、リポジトリ内で提供される services Bash スクリプトを実行して、コマンドラインから初期化できます。以下のようにコマンドを実行して、リポジトリのクローンを作成して必要なイメージを作成してください :

git clone https://github.com/FIWARE/tutorials.Working-with-Linked-Data.git
cd tutorials.Working-with-Linked-Data
git checkout NGSI-v2

./services orion

注: クリーンアップして最初からやり直す場合は、次のコマンドで実行できます :
./services stop

プログラムによるリンクト・データのアクセス¶

http://localhost:3000/app/store/urn:ngsi-ld:Building:store001 に移動して、動作中のスーパーマーケット・データ・アプリケーションを表示して操作します。

リンクト・データの読み取り¶

議論中のコードは、 Git リポジトリの ngsi-ld/store コントローラ内にあります。

ライブラリの初期化¶

通常どおり、HTTP アクセスのコードは、スーパーマーケット・アプリケーション自体のビジネス・ロジックから分離できます。下位レベルの呼び出しはライブラリ・ファイルに配置されているため、コードベースが簡素化されます。これは、示されているようにファイルのヘッダに含める必要があります。いくつかの定数も必要です - スーパーマーケット・データの場合、LinkHeader はデータモデル JSON-LD コンテキストの場所をhttps://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld として定義するために使用されます。

const ngsiLD = require("../../lib/ngsi-ld");

const LinkHeader =
    '<https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json">';

既知のストアの取得¶

この例では、特定の Store エンティティのコンテキスト・データを読み取り、結果を画面に表示します。エンティティ・データの読み取りは、ngsiLD.readEntity() メソッドを使用して実行できます。これにより、GET リクエストの URL が入力され、必要な HTTP 呼び出しが非同期的に行われます :

async function displayStore(req, res) {
    const store = await ngsiLD.readEntity(
        req.params.storeId,
        { options: "keyValues" },
        ngsiLD.setHeaders(req.session.access_token, LinkHeader)
    );

    return res.render("store", { title: store.name, store });
}

上記の関数はリクエストの一部としていくつかの標準 HTTP ヘッダも送信します - これらは setHeaders() 関数で定義されます。

NGSI-LD ベースのシステム内では、通常のデフォルトの HTTP ヘッダには、JSON-LD コンテキストを送信するための Link ヘッダと、リクエストを application/ld+json として識別するための Content-Type ヘッダが含まれます (注 NGSI-LD は JSON-LD のサブセットであるため、すべての NGSI-LD リクエストは有効な JSON_LD です)。OAuth2 セキュリティを有効にするために、 X-Auth-Token などの他の追加ヘッダを付加できます。

function setHeaders(accessToken, link, contentType) {
    const headers = {};
    if (accessToken) {
        headers["X-Auth-Token"] = accessToken;
    }
    if (link) {
        headers.Link = link;
    }
    if (contentType) {
        headers["Content-Type"] = contentType || "application/ld+json";
    }
    return headers;
}

lib/ngsi-ld.js ライブラリ・ファイル内で、BASE_PATH は Orion Context Broker の場所を定義し、データ・エンティティの読み取りは、適切なヘッダを渡す非同期 HTTP GET リクエストの単なるラッパーです。

const BASE_PATH = process.env.CONTEXT_BROKER || "http://localhost:1026/ngsi-ld/v1";

function readEntity(entityId, opts, headers = {}) {
    return request({
        qs: opts,
        url: BASE_PATH + "/entities/" + entityId,
        method: "GET",
        headers,
        json: true
    });
}

同等の cUrl ステートメントは以下のとおりです :

curl -G -X GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001/' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-d 'options=keyValues'

リンクト・データの集計と移動¶

営業時間に情報を表示するには、ストア内で見つかった製品に関する情報を見つける必要があります。データ・エンティティ・ダイアグラムから、次のことを確認できます。

Building エンティティは、関連する Shelf 情報を furniture Relationship 内に保持します
Shelf エンティティは、関連する Product 情報を stocks Relationship 内に保持します
製品は、Product エンティティ自体の Property 属性として name と price を保持します

したがって、displayTillInfo() メソッドのコードは次のステップで構成されます。

Context Broker に 既知のストア内の棚を見つけるようにリクエストします
結果を id パラメータにして、棚から在庫のある製品を取得しまするために、 Context Broker に2回目のリクエストを行います
結果を id パラメータにして、選択した棚の製品詳細を取得するために、 Context Broker に3番目のリクエストを行います

データベースの結合に慣れているユーザにとっては、このような一連のリクエストを強制されるのは奇妙に思えるかもしれませんが、大規模な分散セットアップではスケーラビリティの問題/懸念があるため必要です。 NGSI-LD では Direct join リクエストはできません。

既知のストア内の棚を検索¶

既知の Building エンティティの furniture 属性にアクセスするには、attrs パラメータを使用して keyValues リクエストを作成します。

const building = await ngsiLD.readEntity(
    req.params.storeId,
    {
        options: "keyValues",
        attrs: "furniture"
    },
    ngsiLD.setHeaders(req.session.access_token, LinkHeader)
);

同等の cUrl ステートメントは以下のとおりです :

curl -G -X GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store001/' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-d 'options=keyValues' \
-d 'attrs=furniture' \

レスポンスは、さらに操作できる furniture 属性を含む JSON オブジェクトです。

棚から在庫品を取得¶

一連の Shelf エンティティを取得するには、ngsiLD.listEntities() 関数が呼び出され、id パラメータを使用してフィルタ処理されます。id は、上記のリクエストから取得したカンマ区切りのリストです。

let productsList = await ngsiLD.listEntities(
    {
        type: "Shelf",
        options: "keyValues",
        attrs: "stocks,numberOfItems",
        id: building.furniture.join(",")
    },
    ngsiLD.setHeaders(req.session.access_token, LinkHeader)
);

listEntities() は lib/ngsi-ld.js ライブラリ・ファイル内の別の関数です。

function listEntities(opts, headers = {}) {
    return request({
        qs: opts,
        url: BASE_PATH + "/entities",
        method: "GET",
        headers,
        json: true
    });
}

同等の cUrl ステートメントは以下のとおりです :

curl -G -X GET 'http://localhost:1026/ngsi-ld/v1/entities/' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d 'type=Shelf' \
-d 'options=keyValues' \
-d 'attrs=stocks,numberOfItems' \
-d 'id=urn:ngsi-ld:Shelf:unit001,urn:ngsi-ld:Shelf:unit002,urn:ngsi-ld:Shelf:unit003'

レスポンスは、Shelf エンティティの JSON 配列であり、さらに操作できる stocks 属性として含まれています。以下のコードは、後で使用するために IDs を抽出します。

const stockedProducts = [];

productsList = _.groupBy(productsList, (e) => {
    return e.stocks;
});
_.forEach(productsList, (value, key) => {
    stockedProducts.push(key);
});

選択したシェルフの製品詳細を取得¶

一連の Product エンティティを取得するために、ngsiLD.listEntities() 関数が再度呼び出され、id パラメータを使用してフィルタ処理されます。id は、上記のリクエストから取得したカンマ区切りのリストです。

let productsInStore = await ngsiLD.listEntities(
    {
        type: "Product",
        options: "keyValues",
        attrs: "name,price",
        id: stockedProducts.join(",")
    },
    headers
);

同等の cUrl ステートメントは以下のとおりです :

curl -G -X GET 'http://localhost:1026/ngsi-ld/v1/entities/' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d 'type=Product' \
-d 'options=keyValues' \
-d 'attrs=name,price' \
-d 'id=urn:ngsi-ld:Product:001,urn:ngsi-ld:Product:003,urn:ngsi-ld:Product:004'

レスポンスは、Product エンティティの JSON 配列で、画面に表示されます。

リンクト・データの更新¶

商品を在庫している棚を探す¶

一連の Shelf エンティティを取得するには、 ngsiLD.listEntities() 関数が呼び出されます。修正する前に現在のコンテキストを取得することが重要です。そのため、q パラメータは、正しい製品を含む正しいストアからシェルフを取得するためにのみ使用されます。このリクエストは、Shelf データモデルが Building と Product の両方で relationships を保持するように設計されているためにのみ可能です。

const shelf = await ngsiLD.listEntities(
    {
        type: "Shelf",
        options: "keyValues",
        attrs: "stocks,numberOfItems",
        q: 'numberOfItems>0;locatedIn=="' + req.body.storeId + '";stocks=="' + req.body.productId + '"',
        limit: 1
    },
    headers
);

同等の cUrl ステートメントは以下のとおりです :

curl -G -X GET 'http://localhost:1026/ngsi-ld/v1/entities/' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d 'type=Shelf' \
-d 'options=keyValues' \
-d 'q=numberOfItems%3E0;locatedIn==%22urn:ngsi-ld:Building:store001%22;stocks==%22urn:ngsi-ld:Product:001%22'

棚の状態を更新¶

エンティティを更新するには、前のリクエストで返された Shelf の id を使用して PATCH リクエストを作成します。

const count = shelf[0].numberOfItems - 1;
await ngsiLD.updateAttribute(
    shelf[0].id,
    { numberOfItems: { type: "Property", value: count } },
    ngsiLD.setHeaders(req.session.access_token, LinkHeader)
);

非同期 PATCH リクエストは、lib/ngsi-ld.js ライブラリファイル内の updateAttribute() 関数にあります。

function updateAttribute(entityId, body, headers = {}) {
    return request({
        url: BASE_PATH + "/entities/" + entityId + "/attrs",
        method: "PATCH",
        body,
        headers,
        json: true
    });
}

同等の cUrl ステートメントは以下のとおりです :

curl -X PATCH 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Shelf:unit001/attrs' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"' \
-H 'Content-Type: application/json' \
-d '{ "numberOfItems": { "type": "Property", "value": 10 } }'

リンクト・データを使用した相互運用性¶

リンクト・データの概念を NGSI に導入したことにより、これまでのところ、すべての Context Broker のリクエストの複雑さがわずかに増加しており、追加の利点はまだ実証されていません。リンクされたデータの背後にある考え方は、データの相互運用性を改善し、データ・サイロを取り除くことです。

このデモンストレーションとして、異なるスキーマを使用している別のコンテキスト・プロバイダからのコンテキスト・データ・エンティティを組み込むことを想像してください。日本のコンテキスト・プロバイダは、name, category, location などを使用するのではなく、漢字に基づいたデータ属性を使用しています。

Core NGSI-LD の @context は、name = https://uri.etsi.org/ngsi-ld/name を定義します。同様に、 名前 = https://uri.etsi.org/ngsi-ld/name を定義でき、属性名と列挙値の代替マッピングを導入します。

2つのシステムがデータ交換用の一意の URI の共通システムに同意できる場合、それらのドメイン内でこれらの値をローカルで自由に再解釈できます。

代替スキーマを使用したエンティティの作成¶

代替の日本語 JSON-LD @context ファイルが作成され、外部サーバに公開されました。このファイルは、 https://fiware.github.io/tutorials.Step-by-Step/japanese-context.jsonld にあります。チュートリアル内で使用されるすべての属性名の代替データ・マッピングを見つけることができます。

注: 比較のために、標準のチュートリアル JSON-LD @context ファイルはこちらにあります。: https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld

1 リクエスト:¶

データ・エンティティを作成する際、日本語の JSON-LD @context にマッピングされたすべての URI の短縮名は、リクエストのペイロードで自由に使用できます。

以下の例からわかるように、属性名と列挙値 (ビル = Building など）を全体で使用できます。 NGSI-LD 仕様では、NGSI-LD API で定義された属性 (つまり、core @context) を使用して属性を定義することが義務付けられています。したがって、id, type, Property などのリクエストの要素は変更されませんが、以下で説明するように、これは回避できます。

日本のコンテキスト・プロバイダは、以下のリクエストを使用して新しい Building を作成できます。Link ヘッダは、属性名と列挙の完全な URI を提供する日本語の JSON-LD @context ファイルを指します。

curl -L -X POST 'http://localhost:1026/ngsi-ld/v1/entities/' \
-H 'Content-Type: application/ld+json' \
--data-raw '{
    "id": "urn:ngsi-ld:Building:store005",
    "type": "ビル",
    "カテゴリー": {"type": "Property", "value": ["コマーシャル"]},
    "住所": {
        "type": "Property",
        "value": {
            "streetAddress": "Eisenacher Straße 98",
            "addressRegion": "Berlin",
            "addressLocality": "Marzahn",
            "postalCode": "12685"
        }
    },
    "場所": {
        "type": "GeoProperty",
        "value": {"type": "Point","coordinates": [13.5646, 52.5435]}
    },
    "名前": {"type": "Property","value": "Yuusui-en"},
    "@context":"https://fiware.github.io/tutorials.Step-by-Step/japanese-context.jsonld"
}'

この例では、名前とアドレスは単純な文字列として提供されていることに注意してください - JSON-LD は国際化を可能にするために @lang 定義をサポートしますが、これはここでは説明しない高度なトピックです。

デフォルトのスキーマを使用したエンティティの読み取り¶

Context Broker 内では、属性と列挙を参照するために完全な URI が使用されます。異なる属性の短縮名を使用しますが、日本語の JSON-LD @context ファイルは、Building エンティティに使用される完全な URI に関する標準のチュートリアル・コンテキストに同意します。事実上、同じデータモデルを使用しています。

したがって、日本語データモデルを使用して作成された、新しい Building をリクエストし、標準の tutorial JSON-LD @context で指定された短縮名を使用して返すことができます。これは、Link ヘッダは、tutorial JSON-LD の@context ファイルを指しています。

2 リクエスト:¶

curl -L -X GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store005' \
-H 'Content-Type: application/json' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"'

レスポンス:¶

レスポンスは、標準の属性名 (name や location など) である、通常の Building エンティティであり、Building category の標準列挙 (standard enumeration) も返します。

{
    "@context": "https://fiware.github.io/tutorials.Step-by-Step/tutorials-context.jsonld",
    "id": "urn:ngsi-ld:Building:store005",
    "type": "Building",
    "address": {
        "type": "Property",
        "value": {
            "streetAddress": "Eisenacher Straße 98",
            "addressRegion": "Berlin",
            "addressLocality": "Marzahn",
            "postalCode": "12685"
        }
    },
    "location": {
        "type": "GeoProperty",
        "value": { "type": "Point", "coordinates": [13.5646, 52.5435] }
    },
    "name": { "type": "Property", "value": "Yuusui-en" },
    "category": { "type": "Property", "value": "commercial" }
}

これは、スーパーマーケット・アプリケーションが、基礎となるコードベースを変更せずに新しいビルディングを表示できることを意味します。データは相互運用可能です。

http://localhost:3000/app/store/urn:ngsi-ld:Building:store005 に移動して、新しい Building を表示できることを示します :

代替スキーマを使用したエンティティの読み取り¶

1つの例外を除き、NGSI-LD の @context ファイル内に定義された階層はありません。したがって、定義された @context は、既存の Building エンティティを読み取り、日本語の @context を適用できます。使用する @context は、Link ヘッダで提供されます。

3 リクエスト:¶

curl -L -X GET 'http://localhost:1026/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store003' \
-H 'Content-Type: application/json' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/japanese-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"'

レスポンス:¶

レスポンスはミックスされています - いくつかの例外を除き、japanese-context.jsonld で定義された属性名と列挙を使用します。NGSI-LD は JSON-lD ではありません。コア・コンテキスト (Core Context) は常に、Link ヘッダで受信されたコンテキストの後に適用されます。name と location は予約済みの属性名であるため、デフォルトのコア・コンテキストを使用して提供されます。

{
    "@context": "https://fiware.github.io/tutorials.Step-by-Step/japanese-context.jsonld",
    "id": "urn:ngsi-ld:Building:store003",
    "type": "ビル",
    "家具": {
        "type": "Relationship",
        "object": ["urn:ngsi-ld:Shelf:unit006", "urn:ngsi-ld:Shelf:unit007", "urn:ngsi-ld:Shelf:unit008"]
    },
    "住所": {
        "type": "Property",
        "value": {
            "streetAddress": "Mühlenstrasse 10",
            "addressRegion": "Berlin",
            "addressLocality": "Friedrichshain",
            "postalCode": "10243"
        },
        "検証済み": { "type": "Property", "value": false }
    },
    "name": { "type": "Property", "value": "East Side Galleria" },
    "カテゴリー": { "type": "Property", "value": "コマーシャル" },
    "location": {
        "type": "GeoProperty",
        "value": { "type": "Point", "coordinates": [13.4447, 52.5031] }
    }
}

エンティティ展開/圧縮 (Expansion/Compaction) の適用¶

JSON-LD 内には、ローカル属性名を適用および変更するための標準メカニズムがあります。 Cotext Broker からのレスポンスは、常に有効な NGSI-LD になります。NGSI-LD は JSON-LD の構造化されたサブセットであるため、JSON として受信したデータを使用するためにさらに変更を加えることができます。

Core NGSI-LD context をオーバーライドする必要がある場合、レスポンスに追加の展開/圧縮操作を適用して、ローカルで使用するために完全に変換された方法でデータを取得できます。

この作業を行うための JSON-LD ライブラリがすでに存在します。

const coreContext = require("./jsonld-context/ngsi-ld.json");
const japaneseContext = require("./jsonld-context/japanese.json");
function translateRequest(req, res) {
    request({
        url: BASE_PATH + req.path,
        method: req.method,
        headers: req.headers,
        qs: req.query,
        json: true
    })
        .then(async function (cbResponse) {
            cbResponse["@context"] = coreContext;
            const expanded = await jsonld.expand(cbResponse);
            const compacted = await jsonld.compact(expanded, japaneseContext);
            delete compacted["@context"];
            return res.send(compacted);
        })
        .catch(function(err) {
            return res.send(err);
        });
}

4 リクエスト:¶

リクエストを Context Broker に転送してから展開/圧縮操作を適用する /japanese エンドポイントが作成されました。

curl -L -X GET 'http://localhost:3000/japanese/ngsi-ld/v1/entities/urn:ngsi-ld:Building:store005' \
-H 'Accept: application/json' \
-H 'Link: <https://fiware.github.io/tutorials.Step-by-Step/japanese-context.jsonld>; rel="http://www.w3.org/ns/json-ld#context"; type="application/ld+json"'

レスポンス:¶

展開/圧縮の操作後のレスポンスは、優先属性名 (the preferred attribute names) のすべてを使用するデータです。これは有効な NGSI-LD ではなくなりましたが、受信したシステムがこの形式のデータをリクエストする場合に役立ちます。

Context Broker にデータを送信する前に、逆の展開/圧縮操作を使用して、この JSON を有効な NGSI-LD ペイロードに変換できることに注意してください。

{
    "識別子": "urn:ngsi-ld:Building:store005",
    "タイプ": "ビル",
    "カテゴリー": { "タイプ": "プロパティ", "値": "コマーシャル" },
    "住所": {
        "タイプ": "プロパティ",
        "値": {
            "addressLocality": "Marzahn",
            "addressRegion": "Berlin",
            "postalCode": "12685",
            "streetAddress": "Eisenacher Straße 98"
        }
    },
    "場所": {
        "タイプ": "ジオプロパティ",
        "値": { "タイプ": "Point", "座標": [13.5646, 52.5435] }
    },
    "名前": { "タイプ": "プロパティ", "値": "Yuusui-en" }
}

Video: JSON-LD 圧縮と展開 (Compaction & Expansion)¶

上の画像をクリックして、@context と相互運用性に関するビデオ JSON-LD の圧縮と展開をご覧ください。

リンクト・データ・エンティティの操作¶

在庫管理システム内のリンクト・データ・エンティティ¶

このチュートリアルの学習目標¶

在庫管理フロントエンド¶

前提条件¶

Docker¶

Cygwin¶

アーキテクチャ¶

スタートアップ¶

プログラムによるリンクト・データのアクセス¶

リンクト・データの読み取り¶

ライブラリの初期化¶

既知のストアの取得¶

リンクト・データの集計と移動¶

既知のストア内の棚を検索¶

棚から在庫品を取得¶

選択したシェルフの製品詳細を取得¶

リンクト・データの更新¶

商品を在庫している棚を探す¶

棚の状態を更新¶

リンクト・データを使用した相互運用性¶

代替スキーマを使用したエンティティの作成¶

1 リクエスト:¶

デフォルトのスキーマを使用したエンティティの読み取り¶

2 リクエスト:¶

レスポンス:¶

代替スキーマを使用したエンティティの読み取り¶

3 リクエスト:¶

レスポンス:¶

エンティティ展開/圧縮 (Expansion/Compaction) の適用¶

4 リクエスト:¶

レスポンス:¶

Video: JSON-LD 圧縮と展開 (Compaction & Expansion)¶

License¶