メインコンテンツへスキップ
フォームは現在、早期アクセスで使用できます。Auth0のリリース段階については、「製品のリリース段階」を参照してください。
フォームを作成し終えたら、api.prompt.render()メソッドを使用してActionsで表示できます。 
// Example using the post-login trigger

exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(':form_id');
}

exports.onContinuePostLogin = async (event, api) => {
  // Add your logic after completing the form
}
form_id部分をフォームIDで置き換えます。IDは、フォームのURLに、ap_pUMG...のように表示されます。または、フォームエディターの ［Embed（組み込み）］ タブで選択してください。Actionsコードエディターでは、ビジネスロジックを定義して、フォーム表示のタイミングと方法を決定することができます。 
exports.onExecutePostLogin = async (event, api) => {

  // Only render the form if user is missing company_name metadata
  if (!event.user.user_metadata.company_name) {
    api.prompt.render(':form_id');
  }
}

exports.onContinuePostLogin = async (event, api) => {
  // Add your logic after completing the form
}
  • ユーザーをリダイレクトして、同じアクションでフォームを表示することはできません。両方使用する必要がある場合は、別のアクションの使用を検討してください。
  • アクションごとに1つのフォームしか表示できません。複数のフォームを表示する必要がある場合は、別のアクションでフォームを表示しなければなりません。

​
既存のフィールドと非表示のフィールドの値を入力する（クライアント側）

イベントオブジェクトとそのコンテキスト情報についての詳細は、「Actionsトリガー： post-login- eventオブジェクト」をお読みください。 既存のフィールドと非表示のフィールドの値を入力したい場合は、api.prompt.render()メソッドがfieldsプロパティを使用した第二引数をサポートしています。下記の例では、IDがfirst_nameのフィールドに、Janeという値が入力されます。 
exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(':form_id', {
    fields: {
      first_name: 'Jane',
    }
  });
}

exports.onContinuePostLogin = async (event, api) => {
  // Add your logic after completing the form
}
値を入力する際は、そのフィールドIDがノードやコンポーネントで使用できることを確認してください。使用できない場合、値は入力されません。
カスタムデータを、クライアント側に表示することなく注入する必要がある場合は、varsプロパティを使用することができます。

​
共有変数によるカスタムデータの注入（サーバー側）

下記の例では、123456789の値を使ってexternal_user_id変数を注入します。 
exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(':form_id', {
    vars: {
      external_user_id: '123456789',
    }
  });
}

exports.onContinuePostLogin = async (event, api) => {
  // Add your logic after completing the form
}
共有変数{{vars.*}}には、データタイプの制限はありません。共有変数{{vars.*}}は、常に自動的にマスクされます。{{fields.*}}変数を入力する場合と異なり、値の注入前に{{vars.*}}プロパティがフォームに存在している必要はありません。{{vars.*}} プロパティを使用して、フォームとそれにリンクされたフローで共有変数を参照できます。詳細については、「変数」を参照してください。
共有変数{{vars.*}}には、データタイプの制限はありません。共有変数{{vars.*}}は、常に自動的にマスクされます。{{fields.*}}変数を入力する場合と異なり、値の注入前に{{vars.*}}プロパティがフォームに存在している必要はありません。{{vars.*}} プロパティを使用して、フォームとそれにリンクされたフローで共有変数を参照できます。詳細については、「変数」を参照してください。

​
制約と制限

フォーム内で、収集されたフィールドと共有変数データは自動的に現在のアクションのresume関数のevent.promptで利用可能になります。
  • idプロパティはレンダリング対象のプロンプトIDを定義します。
  • fieldsオブジェクトにはすべてのフィールドと非表示のフィールドのデータがあります。
  • varsオブジェクトにはすべての共有変数データがあります。
accordion.expand_all/accordion.collapse_all 
{
  "id": "ap_fuVuFiiQWN3mTEujWTy966",
  "fields": {
    "first_name": "Jane",
    "company_name": "Okta"
  },
  "vars": {
    "external_crm_uuid": "f8f32e6f-2329-49bd-bf21-fa8b0bea2652",
    "api_hostname": "api.example.com"
  }
}
以下の例では、api.user.setUserMetadataにフォームから収集されたevent.prompt.fields.company_nameプロパティのあるuser_metadataのcompany_name属性が入力されます。 
exports.onExecutePostLogin = async (event, api) => {
  api.prompt.render(':form_id');
}

exports.onContinuePostLogin = async (event, api) => {
  api.user.setUserMetadata('company_name', event.prompt.fields.company_name);
}

​
制約と制限

  • ユーザーをリダイレクトして、同じアクションでフォームをレンダリングすることはできません。両方とも使用する必要がある場合は、別のアクションを検討してください。
  • 1つのアクションからは1つのフォームのみをレンダリングできます。複数のフォームをレンダリングしなければならない場合は、別のアクションを使用します。
  • 同じフォームを同じトリガーで複数回レンダリングすることはできません。 たとえば、1つのpost-loginトリガーに2つのアクションがある場合、両方のアクションで同じフォームはレンダリングできません。それぞれのアクションに別のフォームを作成する必要があります。
  • fieldsプロパティのサイズは24 KBが上限です。
  • api.prompt.render()メソッドは以下のトリガーで利用できます。
⌘I