ポータルプレイブックウィジェット

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：4分

    • ポータルプレイブックウィジェットを探索します。

    ウィジェットについて

    プレイブックウィジェットは、アドミニストレーターがプレイブックイベントの送信先を指定できる iFrame です。iFrame の URL は、UI ビルダー プレイブックポータルページです。ウィジェットは、プレイブックがセッションストレージ API を介してリッスンしているイベントを処理するため、サービスポータル 内のモーダルでレコードやリストを開くなど、ポータルでアクションを実行するタイミングを認識します。

    すぐに利用可能なコンポーネントは、サービスポータル ユーザーに必要なあらゆる プレイブックエクスペリエンス に合わせてビルドされています。すぐに利用可能な UI ビルダー プレイブックポータルページ、サービスポータル プレイブックウィジェット、またはプレイブックコンテンツアイテムを直接編集することはお勧めしません。すぐに利用可能なコンポーネントを変更すると、技術的な問題が発生する可能性があります。

    たとえば、プレイブックページのインスタンスで機能する UXF クライアントアクションが必要な場合は、代わりにプレイブックウィジェットをクローンすることをお勧めします。

    注:
    代わりに独自のウィジェットをクローンまたは作成する方法の詳細については、「Developing custom widgets」を参照してください。

    プレイブックサービスポータルウィジェットのクローン作成

    移動先 すべて > サービスポータル > ウィジェット プレイ ブック ウィジェットを見つけます
    注:
    プレイブックウィジェットをクローンする場合は、すべてのすぐに利用可能なアクションと構成プロパティがクローンされたウィジェットにコピーされていることを確認してください。
    表 : 1. フォームフィールド
    フィールド 説明
    名前 クローンされたウィジェットの名前を入力します。
    ID ウィジェット ID は、デフォルトでウィジェット名に基づいて自動的に作成されますが、任意の名前に変更できます。
    説明 ウィジェットの詳細を示すオプションの説明を追加します。
    アプリケーション ウィジェットを実行するアプリケーションスコープを選択します。[グローバル] を選択すると、任意のアプリケーションスコープで プレイブック を実行できます。詳細については、「アプリケーションスコープ」を参照してください。
    公開 ウィジェットが公開されている場合に選択します。オフにすると、ウィジェットはプライベートになり、snc_internal または snc_external ロールを持つ認証済みユーザーのみがウィジェットを表示できます。
    ロール ウィジェットへのアクセスを特定のロールに制限します。
    本文 HTML テンプレート Angular JS の双方向バインディングを利用して、コントローラー変数をマークアップにバインドします。
    危険:
    高度なコーディング知識があり、AngularJS とプラットフォーム API をしっかりと理解している場合にのみ、HTML テンプレートを変更してください。
    iFrame URL は、 UI ビルダー ページの URL です。HTML テンプレートフィールドの詳細については、「」および「」を参照してください。
    警告:
    クローンされたウィジェットの iFrame URL が、すぐに利用可能なウィジェットの iFrame URL と異なることを確認してください。
    CSS ウィジェット CSS を構成します。実際のウィジェットで CSS を構成すると、そのウィジェットのすべてのインスタンスに影響します。CSS フィールドの詳細については、「」および「」を参照してください。
    サーバースクリプト サーバー側のロジックをスクリプト化します。これは主に、サーバー側の API を介して Glide プラットフォームとやり取りする場合に役立ちます。
    危険:
    サーバースクリプトには、ServiceNow API を使用してレコードデータを操作する知識が必要です。
    [サーバースクリプト] フィールドの詳細については、「」 および「 」を参照してください。
    クライアントコントローラー Angular では、HTML テンプレートに Angular 固有の要素と属性が含まれています。モデルとクライアントコントローラーからの情報をテンプレートと組み合わせて、ブラウザでユーザーに表示される動的ビューをレンダリングします。ディレクティブのスコープにあるコントローラへの参照の識別子名
    危険:
    クライアントスクリプトには、ServiceNow API および AngularJS の両方を使用してクライアント コントローラーを作成する知識が必要です。
    controllerAs HTML テンプレートは、基本バインディングに controllerAs 構文を使用します。
    リンク リンク機能を使用して、DOM を直接操作します。
    危険:
    リンク機能には、AngularJS の知識が必要です。
    [リンク] フィールドの詳細については、「」および「」を参照してください。
    プレビューあり チェックボックスをオンにすると、ウィジェットエディターでウィジェットのプレビューが有効になります。
    デモデータ ウィジェットエディターでウィジェットをプレビューするときにデータを提供する。
    データテーブル データソースとして使用するテーブルを選択します。
    フィールド インスタンスオプションとして表示するフィールドを選択します。
    オプションスキーマ サービスポータル管理者がウィジェットを構成できるようにします。[オプションスキーマ] フィールドの詳細については、「」および「Widget option schema」を参照してください。
    ドキュメント サービスポータル ドキュメントリンクを選択します。

    UI ビルダー プレイブックエクスペリエンスポータルページ構成とイベントプロパティにエラーがないか確認します (例：メンテナンスユーザーとして [レコードを開く] イベントを無効にしている)。