Microsoft。Solutions.BladeInvokeControl UI element

BladeInvokeControlユーザーインターフェース(UI)要素はフォームビューからAzureポータルブレードを開き、そのブレードから返されるデータを保存します。 フォームにより豊かなピッカーや、すでに存在するポータルブレードの設定体験が必要な場合に使います。

BladeInvokeControl テンプレート仕様ポータルフォームのフォームビューでサポートされています。 ターゲットブレードはAzureポータルのランタイムで利用可能で、提供されたパラメータで呼び出されることをサポートしなければなりません。

UIサンプル

BladeInvokeControlにはUIがありません。 openBladeStatusがアクティブ状態に評価されると、bladeReferenceに名前のブレードが開きます。

Schema

{
  "name": "skuPicker",
  "type": "Microsoft.Solutions.BladeInvokeControl",
  "openBladeStatus": "[steps('specs').openSkuPicker]",
  "defaultValue": {
    "selectedSku": "Standard"
  },
  "transforms": {
    "sku": "selectedSku"
  },
  "bladeReference": {
    "name": "SkuPickerBlade",
    "extension": "Contoso_Azure_Service",
    "parameters": {
      "subscriptionId": "[steps('basics').resourceScope.subscription.subscriptionId]",
      "location": "[steps('basics').resourceScope.location.name]"
    }
  }
}

サンプル出力

コントロールの出力は、呼び出しされたブレードによって返されたオブジェクトです。

{
  "selectedSku": "Standard"
}

スキーマの例にある transforms の性質を用いることで、変換された値は [steps('specs').skuPicker.transformed.sku]で参照できます。

Remarks

• openBladeStatusプロパティはブレードが開くタイミングを制御する式です。
• bladeReferenceプロパティはブレード名文字列またはオブジェクトでいられます。 オブジェクトの場合、 name は開くポータルブレードであり、 extension ブレードを持つポータルエクステンションを特定し、 parameters がターゲットブレードに渡されます。
• bladeReference.parametersの形状はFormビュースキーマではなく、ターゲットブレードによって定義されます。
• defaultValue プロパティは省略可能です。 ブレードがデータを返す前に制御出力を初期化します。
• transforms プロパティは省略可能です。 各キーは、返されたブレードデータからプロパティパスを使って投影値を生成します。
• 呼び出しされたブレードはフォームが使用できるデータを返さなければなりません。 参照は [steps('specs').skuPicker.selectedSku]のような表現で値を返しました。

次のステップ

• フォームビュー要素
• テンプレート仕様のためのポータルフォームを作成する