WireCloud では、すべてのアプリケーション・マッシュアップ・コンポーネントは メタデータ情報を提供する config.xml ファイルを提供する必要があります。 さらに、すべてのコンポーネントは以下の情報を提供する必要があります。

• vendor : マッシャブル・アプリケーション・コンポーネントのベンダー/ ディストリビュータのID。"/" 文字を含めることはできません
• name : マッシャブル・アプリケーション・コンポーネントの名前。 "/" 文字 を含めることはできません
• version : マッシャブル・アプリケーション・コンポーネントの現在の バージョン。ドットで区切られた数字の開始シーケンスを定義する必要が あります。さらに、ゼロは単独でしか使用できません。たとえば、0.1は 有効ですが03.2は無効です 。リリース番号に続いて、プレリリース・タグを 付けることができます。プレリリース・タグは、一連の文字です。a (アルファ), b (ベータ) または rc (リリース候補)の後に、数字が続きます。 プレリリース・タグを使用すると、バージョンは追加されたバージョンよりも 古いものと見なされます。つまり、リビジョン2.4はリビジョン2.4rc1よりも 新しいです。リビジョン2.4rc1は2.4b1または2.4a1よりも新しいです

これらのツリー属性 (vendor, name and version) はリソースを一意に識別します。 そのため、WireCloud リソースのコレクション (ウィジェット、マッシュアップ、 オペレータなど) にそのような識別子を繰り返すことはできません。これらの属性に 加えて、すべてのリソースは、オプションで、以下の属性を提供できます。

• title : マッシャブル・アプリケーション・コンポーネントのユーザ・ インターフェースで使われる名前。たとえば、マッシャブル・アプリケーション・ コンポーネントを一覧表示するときに使用されます。このフィールドは翻訳可能 であるため、マッシャブル・アプリケーション・コンポーネントを一意に識別する ためには使用されません。このフィールドは、ワークスペースに追加された ウィジェットのデフォルトのタイトルとしても使用されます。

• authors : コンマで区切られた開発者のリスト。例えば :

  Álvaro Arranz, Aitor Magan
  

  E メールや URL を入力することもできます :

  Barney Rubble <b@rubble.com> (http://barnyrubble.tumblr.com/)
  

• contributors : コンマで区切られた貢献者のリスト。 authors フィールドと同じ形式

• email : サポートを受けるための E メールアドレス
• license : マッシャブル・アプリケーション・コンポーネントに関連付けられている ライセンスの名前
• description : マッシャブル・アプリケーション・コンポーネントの簡単な説明文
• longdescription : マッシャブル・アプリケーション・コンポーネントを記述する マークダウン・ファイルへの相対パス
• changelog : 各バージョンでマッシャブル・アプリケーション・コンポーネントに 加えられた変更を詳述したマークダウン・ファイルへの相対パス
• image : カタログ用のマッシャブル・アプリケーション・コンポーネントイメージの 絶対 URL またはテンプレートの相対 URL。(170×80ピクセル)
• smartphone : スマートフォンで使用する画像。(59×60ピクセル)
• doc : マッシャブル・アプリケーション・コンポーネントのドキュメントの 絶対 URL またはテンプレートの相対 URL

XML を使用して記述されたマッシャブル・アプリケーション・コンポーネントは、 開発したいコンポーネントに応じて widget または operator と呼ばれるルート要素 に http://wirecloud.conwet.fi.upm.es/ns/macdescription/1 名前空間を使用する べきです。このルート要素には、リソースを識別する3つの属性 (vendor, name and version) が必要です。さらに、これは先に説明したように、 リソースに関するすべての基本情報を引き継ぐことになる別の要素 details を含むべきです。

XML フォーマットに加えて、ウィジェットとオペレータのディスクリプション (config.xml ファイル) は次の RDF 記法のうちの1つを使って書くこともできます : n3, turtle または rdf/xml。これらの RDF 表記法は、通常、WireCloud が提供する XML 表記法よりも複雑で、config.xml に追加のメタデータを追加したい場合には より適しています。WireCloud は、RDF を使用する他のシステムにコンポーネントの メタデータをエクスポートするために、この構文を使用します。 ただし、これはユーザからは見えません)。

できるだけ XML 表記を使用することをお勧めします。

RDF ヘッダを追加したら、次のステップは作成したいコンポーネントに応じて必要な ノードを追加することです : 作成したいコンポーネントによって、 wire:Operator または wire:Widget です。これがルート・ノードになるため、 ウィジェットまたはオペレータに関連付けられているすべてのメタデータは このノードの子孫になります。

リソースに関する基本情報は、次のノードを使用して追加する必要があります :

• vendor: udsl-core:hasProvider
• name: dcterms:title
• version: usdl-core:versionInfo
• description: dcterms:description
• title: wire:displayName
• author: dcterms:creator
• email: vcard:addr
• image: wire:hasImageUri
• smartphoneimage: wire:hasiPhoneImageUri
• doc: foaf:page

他の RDF フォーマットも使用できます (例 : n3) :

!n3
<http://wirecloud.conwet.fi.upm.es/ns/widget#CoNWeT/entity-service/2.3.2> a wire:Operator ;
dcterms:creator [ a foaf:Person ;
    foaf:name "example" ] ;
dcterms:description "This operator permits us gather information about several entities (Lamp posts, AMMSs and Regulators) from any NGSI service." ;
dcterms:title "entity-service" ;
wire:displayName "Entity Service" ;
wire:hasImageUri <images/catalogue.png> ;
usdl:hasProvider [ a gr:BusinessEntity ;
    foaf:name "CoNWeT" ] ;
usdl:versionInfo "2.3.2" ;
vcard:addr [ a vcard:Work ;
    vcard:email "example@example.com" ] ;
foaf:page <docs/display/wirecloud> .

ウィジェットとオペレータはよく似ていますが、同じではありません。オペレータには ビューがないため、両者には違いがあります。つまり、オペレータのディスクリプション は初期 HTML ドキュメントをエントリ・ポイントとして使用しません。代わりに、 オペレータは、それらの記述子ファイルで javascript ファイルのリストを定義します。

オペレータ

オペレータの JS ファイルを RDF に設定するには、要素 usdl:utilizedResource を 設定し、各ファイルのインデックスを設定する必要があります。 これを行うには、次の例に従うことができます :

!n3
<http://wirecloud.conwet.fi.upm.es/ns/widget#CoNWeT/entity-service/2.3.2> a wire:Operator ;
    usdl:utilizedResource <js/main.js> ;
    ...

<js/main.js> a usdl:Resource ;
    wire:index "0" .

XML のような他の RDF フォーマットを使うこともできます :

!xml
<usdl:utilizedResource>
    <usdl:Resource rdf:about="js/main.js">
        <wire:index>0</wire:index>
    </usdl:Resource>
</usdl:utilizedResource>

以下のチュートリアルでは、ウィジェットまたはオペレータを作成するためのガイドを します。これらのチュートリアルは config.xml ファイルに追加できる他の設定を 含みます。しかし、これらのドキュメントの構造を理解するための最良の方法は いくつかの例を見ることです。

github にはウィジェットやオペレータがいくつかあります :

• FIWARE Live Demo で使用されるいくつかのウィジェット :

  https://github.com/wirecloud-fiware/live-demo-macs

• いくつかの一般的なウィジェットとオペレータ :

  https://github.com/Wirecloud

• さらに、FIWARE に関連するウィジェットやオペレータもあります :

  https://github.com/wirecloud-fiware