カスタム Playbook アクティビティ UI の作成

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む8読むのに数分
  • Playbook アクティビティのカスタムアクティビティ UI を構築します。

    独自のアクティビティ UI UI ビルダー を作成して、Playbook アクティビティのデフォルトのユーザーエクスペリエンスを上書きします。 UI ビルダー カスタムアクティビティ UI を構築および更新するためのローコード環境を提供します。複数の UI ビルダー コンポーネントを 1 つの Playbook アクティビティに結合できます。 UI ビルダー は、カスタマイズ可能なテンプレートとしてすぐに利用可能なアクティビティ UI を使用します。

    Playbook Experience 内のアクティビティのユーザーエクスペリエンスをカスタマイズするために使用します UI ビルダー 。では UI ビルダー、次の操作を実行できます。
    • カードのシェルを含む空の UI テンプレートから新しいアクティビティを構築します。
    • カードのシェル内のコンテンツを含む既存の UI テンプレートから新しいアクティビティを構築します。
    • Playbook アクティビティエクスペリエンスプロパティをデータバインディングを使用してコンポーネントにマッピングします。
    • どのアクティビティ UI をどのアクティビティで使用するかを指定するためのルールを定義します。
    • 基礎となるプロセスの実行時に、アクティビティエクスペリエンスプロパティへのリアルタイムの変更を反映します。

    Playbook のカスタムアクティビティ UI の作成

    Playbook アクティビティのカスタムアクティビティ UI を内に UI ビルダー 作成します。

    始める前に

    必要なロール:Playbook 管理者

    手順

    1. 移動先 すべて > Playbook Experience > アクティビティ UI.
    2. [新規] を選択します。
    3. フォームのフィールドに入力します。
      表 : 1. Playbook アクティビティ UI フォーム
      フィールド 説明
      名前 アクティビティ UI の名前。
      Playbook Experience アクティビティ UI を使用する Playbook Experience を選択します。[グローバル Playbook Experience] を選択して、アクティビティ UI をすべての Playbook Experience で利用できるようにします。
      エクスペリエンスタイプ アクティビティ UI に適用するエクスペリエンスタイプを選択します。エクスペリエンスタイプの詳細については、「 エクスペリエンスタイプ」を参照してください。
      UI テンプレート アクティビティ UI 用にクローンを作成する UI テンプレートを選択します。UI テンプレートが選択されていない場合は、 空の テンプレートが適用されます。アクティビティ UI のエクスペリエンスタイプとは異なるエクスペリエンスタイプの UI テンプレートを選択した場合は、追加の変更がないと完全な互換性がない場合があります。
    4. [送信] を選択します。
    5. 作成したアクティビティ UI をリストから選択します。
    6. [Playbook アクティビティの上書き] テーブルで [新規] を選択します。
      新規 を選択して、アクティビティの上書きを作成します。
    7. アクティビティ上書きフォームに入力して、アクティビティ UI がデフォルトアクティビティ UI を上書きするタイミングを指定します。
      詳細については、「Playbook アクティビティの上書きのセットアップ」を参照してください。
    8. [Edit in UI Builder (UI ビルダーで編集)] を選択します。
      UI Builder でアクティビティ UI を編集します。

    タスクの結果

    UI ビルダー 新しいタブで開き、アクティビティ UI が表示されます。を使用して UI ビルダーカスタムアクティビティの UI を変更します。詳細については、「UI Builder」を参照してください。

    UI Builder アクティビティの UI エディター。

    でのアクティビティ UI の構成 UI ビルダー

    アクティビティ UI UI ビルダー は、次の方法でカスタマイズできます。

    での UI テンプレートの使用 UI ビルダー

    アクティビティ UI は、カスタムアクティビティ UI の作成時に選択した UI テンプレートとして UI Builder で開きます。各 UI テンプレートには、内で UI ビルダーカスタマイズできる事前構成済みのコンポーネントが含まれています。たとえば、デフォルトのアクティビティ UI には、次のサポートが含まれています。
    • リッチテキストの説明
    • レコードフィールドの積み重ねラベル値ペア
    • チェックリスト ([チェックリストの表示] エクスペリエンスプロパティが選択されていることが条件)
    • フォーム
    • 添付ファイル
    • フッター
    UI Builder のデフォルトのアクティビティ UI テンプレート。
    UI テンプレートを選択しなかった場合は、 UI ビルダー カードの外殻を含む空の Playbook カードが表示されます。空のテンプレートを含むすべてのテンプレートには、次のものが含まれます。
    • アクティビティラベル
    • アクティビティ進捗状況
    • SLA タイマー
    • フッター
    • 宣言アクション
    UI Builder の空のアクティビティ UI テンプレート。

    すぐに利用可能なアクティビティ UI

    Playbook には、次のアクティビティ UI が含まれています。

    デフォルト
    デフォルトのアクティビティ UI テンプレート
    リスト
    リストアクティビティ UI テンプレート
    ナレッジ
    ナレッジアクティビティ UI テンプレート
    レコードジェネレータ
    レコードジェネレーターアクティビティ UI テンプレート

    アクティビティ UI にコンテンツを追加する

    [コンテンツ] パネルには、アクティビティ UI のコンポーネントが表示されます。すべてのアクティビティ UI には、アクティビティ UI 全体をラップする最も外側のコンポーネントとして Playbook カードコンポーネントが含まれています。

    どの Playbook カードスロットにもコンポーネントを追加できます。
    Playbook カードスロット 説明
    コンテンツ Playbook カードに表示する一般的なコンテンツを追加します。
    フォーム フォームスロットは Playbook フォームコンポーネント用に予約されています。フォームが大きすぎて Playbook カード内に収まらない場合、フォームがモーダルに表示される
    フォームの下 フォームの下に表示するコンテンツを追加します。
    フッター カードフッターに表示するコンテンツを追加します。

    アクティビティ UI へのデータのバインド

    UI ビルダー データバインディングを使用して、Playbook Experience プロパティをアクティビティ UI にバインドします。これらの Playbook Experience データリソースは、アクティビティ UI のコンポーネントにデータを動的に公開します。

    各アクティビティ UI には、によって実行 プレイブック時にアクティビティに渡されるエクスペリエンスプロパティのコレクションを定義するエクスペリエンスタイプがあります。たとえば、レコードエクスペリエンスタイプには、Playbook アクティビティに表示されるフォームを決定するフォームビューエクスペリエンスプロパティが含まれています。

    データバインディングは、 の構成UI ビルダーパネルの [構成] タブにあります。UI Builder コンポーネントにバインドされた Playbook Experience プロパティ。

    たとえば、このリッチテキストコンポーネントの HTML プロパティは、説明エクスペリエンスプロパティにバインドされます。データバインディングは、 @context.props.experienceProperties.description.value という形式を取ります。説明エクスペリエンスプロパティが変更されると、このコンポーネントはその新しい値を反映して更新されます。

    UI ビルダー 入力するとオートコンプリート値が提供され、適切なエクスペリエンスプロパティにガイドされます。アクティビティ UI に選択したエクスペリエンスタイプに合わせてオートコンプリートされるエクスペリエンスプロパティ UI ビルダー 。エクスペリエンスプロパティがエクスペリエンスタイプに追加されている場合は、自動的に表示されます。

    experienceProperties に加えて、@context.props オブジェクトには、activityState や parentTable など、バインドできるその他の有用なデータが含まれています。「@context.props」と入力して、使用可能なものを確認します。

    のデータ UI ビルダーバインディングの詳細については、「 UI Builder のデータリソース」を参照してください。

    内のカスタムアクティビティ UI をプレビュー UI ビルダー

    UI ビルダーカスタムアクティビティ UI をプレビューします。サンプルデータを提供して、実行中の Playbook でコンポーネントがどのように表示されるかをプレビューできます。

    始める前に

    必要なロール:Playbook 管理者またはアクティビティ作成者

    このタスクについて

    で作成したアクティビティ UI を UI ビルダープレビューします。サンプルデータを変更して、実行中の Playbook でアクティビティがどのように表示されるかをプレビューします。このタスクの構成パネルで行った変更は、実行時のアクティビティ UI には影響しません。これは、 内の UI ビルダープレビューにのみ影響します。各エクスペリエンスプロパティの実行時のデフォルト値は、エクスペリエンスプロパティの作成時に設定されます。

    手順

    1. 移動先 すべて > Playbook Experience > アクティビティ UI.
    2. プレビューするアクティビティ UI を選択します。
    3. [Edit in UI Builder (UI ビルダーで編集)] を選択します。
    4. コンテンツ パネルで [本文 ] を選択します。
      本文には、デモデータでカスタマイズできる値が含まれています。
    5. 構成パネルで [構成] タブを選択します。
      [構成] タブには、アクティビティをプレビューするためにカスタマイズできるプロパティが表示されます。
    6. [エクスペリエンスのプロパティ] フィールドで [編集] を選択します。
      エクスペリエンスプロパティは、実行時に提供されるコンテンツ プレイブック を定義します。提供されたサンプルデータを変更して、アクティビティ UI をプレビューできます。このデータをカスタマイズしても、実行中の Playbook でのアクティビティ UI の表示内容には影響しません。
    7. エクスペリエンスプロパティ JSON を編集します。
    8. [適用] を選択します。
      エクスペリエンスのプロパティをカスタマイズし、 でUI ビルダーアクティビティをプレビューします。
    9. [ 構成 ] タブの他のプロパティを変更して、アクティビティ UI をカスタマイズできます。

      たとえば、 activityState を変更して、保留中または完了状態のアクティビティをプレビューできます。さまざまなアクティビティステータスをプレビューするには、以下を使用します。 UI ビルダー

    10. [Save (保存)] を選択します。

    タスクの結果

    [UI ビルダー構成] タブで行った変更が表示されます。