REST サービス・プロパティの受け渡し

関連：API テスト のみ

REST サービスの作成または編集では，URL プロパティやカスタム入出力プロパティの値をサービス・レベルまたはリソース・レベルで定義することにより，この値はサービスやリソース内にあるすべてのリソースとメソッドで利用可能になります。たとえば，REST サービスのすべてのリソースとメソッドが同じ URL プレフィックスを参照している場合，URL プロパティの値を REST サービスのレベルで定義すれば，すべてのリソースとメソッドに URL プロパティ値を渡すことができます。

また，カスタム入出力プロパティの名前と値を REST サービスのすべての階層レベルで定義すると，この入出力プロパティと値を各階層に渡すことができます。カスタム入出力プロパティの作成については，"カスタム・プロパティを定義する - 任意" を参照を参照してください。

サービス・レベルで定義したプロパティの例

URL プロパティの値を階層の上位レベルで定義した後，そのサービスに含まれるリソースとメソッドの URL プロパティ値に，その他の相対プロパティ値を追加で定義できます。定義した相対 URL 値は，上位レベルから取得した URL プロパティ値と連結されて，下位レベルにあるすべての階層に渡されます。たとえば，サービス・レベルで URL プロパティ値を定義する場合，選択したリソースまたはメソッドに相対 URL パスを追加することができます。サービス・レベルで渡された URL プロパティ値に，リソースまたはメソッドのレベルで追加した相対 URL プロパティ値が連結されます。

リソースやメソッドのレベルなど，階層の下位レベルで相対 URL プロパティ値を追加する場合には，連結後の URL が有効であることを確認する必要があります。たとえば，リソース・レベルの URL プロパティ値として http:// を定義した場合，メソッドのレベルで追加する相対 URL プロパティ値には http:// プレフィックスを指定しないでください。

メソッド・レベルで定義したプロパティの例

このように定義したプロパティとカスタム入出力プロパティは，REST サービスのプロトタイプ・テンプレートとなるので，キャンバスにメソッドのアクティビティを追加すれば，URL プロパティの値やカスタム入出力プロパティの値を編集できます。