パッケージメタデータ

パッケージメタデータは、パッケージレベルで定義されたテキスト（文字列）値の辞書です。 これは公開時にSBSARに含まれており、Pythonスクリプトで使用することを目的とした汎用ストレージです。

Designerインターフェイスを使用したメタデータの表示と編集

Pythonプラグインを開発している場合、テストやデバッグの目的でメタデータを手動で編集することがあります。 次の方法で実現できます。

公開されたSBSARファイルのメタデータ

状況によっては、一致するパブリッシュされたSBSARのパッケージで定義したメタデータを取得する必要がある場合があります。 以下では、メタデータがアーカイブにどのように変形および保存されるか、およびそこからメタデータを利用する適切な方法について説明します。

メタデータは、JSON形式に従って/assemblies/content/0000/metadata.jsonという名前のファイルに保存されます（パスは.sbsarアーカイブのルートからの相対パスです）。

通常の（文字列）メタデータはそのまま保存されます。例：「key」:「stringValue」、1行につき1つ。 繰り返しますが、さまざまなキーの元の順序は保持されず、実装が定義されます。 通常のPythonのディクットのように、プロセスの中の順序に決して頼らないでください！

URLメタデータの目的は、ユーザーとプラグインが.sbsarアーカイブに外部ファイルを含めることができるようにすることであるため、これらは特定の変換の対象となります。最初に、保存されたURLに一致するリソースのファイルが、実装で定義された場所（通常は、このファイルのみを含む番号付きのサブフォルダー）のアーカイブにコピーされます。 ポイントは、名前の競合を避けることです)。 ファイルは元の名前を保持します（リソースの名前はこの時点で破棄されます）。 次に、 metadata.jsonの元のURLの代わりに、 metadata.jsonに関連するアーカイブ内のコピーされたファイルへのパスが書き込まれます。

前のセクションで作成したサンプルパッケージを（いくつかの出力を持つグラフを少なくとも1つ作成した後で）書き出すと、次のアーカイブコンテンツが表示されます。

myPackage.sbsar

|-- assemblies

        |-- content

            |-- 0000

                |-- New_Graph.sbsasm

                |-- New_Graph.xml

                |-- metadata.json

                |-- resources

                    |-- 0

                        |-- TEXT.txt

metadata.jsonの内容は次のとおりです。

{

    "myResource": "resources/0/TEXT.txt",

    "myText": "This is a text"

}

現時点では、アーカイブに保存されているメタデータとリソースにアクセスするための特定のツールは提供されていません。 推奨される方法は、選択したLZMAデコーダーでアーカイブを開き、通常のJSONパーサーでmetadata.jsonを解析することです（キーや値の文字列に装飾的な文字が含まれている場合は、JSON形式にエスケープされます）。