UI ビルダー チュートリアル

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:10分
  • UI ビルダー の基本を使用して、「My チュートリアル」と呼ばれるページを作成する方法を学びます。

    始める前に

    必要なロール:ui_builder_admin

    この UI ビルダー チュートリアルでは、UI ビルダーページをビルドするために次のタスクを実行します。

    • UI ビルダー を起動します。
    • ワークスペースまたはカスタムポータルエクスペリエンスのページを作成します。ページの作成の詳細については、「UI ビルダー でのページの作成」を参照してください。
    • ページのレイアウトを 2 列に変更します。詳細については、「UI ビルダーページでコンポーネントを整理する」を参照してください。
    • 2 つのコンテナコンポーネントを追加してページをビルドします。
    • コンテンツツリーでコンテナコンポーネントの名前を変更します。
    • 最初のコンテナにヘッダーコンポーネントとボタンコンポーネントを追加します。データビジュアル化コンポーネントを 2 番目のコンテナに追加します。コンポーネントの詳細ついては、「コンポーネントを使用した UI ビルダー ページのカスタマイズ」を参照してください。
    • コンポーネントは次のように構成できます。
    • ページは頻繁に保存してください。
    • ページをプレビューして、ブラウザーでどのように表示されるかを確認します。

    手順

    1. 移動先 すべて > Now Experience フレームワーク > UI ビルダー.
      フィルターナビゲーターに直接「UI ビルダー」と入力することもできます。
      図 : 1. UI ビルダー の起動
      UI ビルダーを起動します。
    2. UI ビルダー ホームページから、作業するエクスペリエンスを選択します。
      作業対象のエクスペリエンスが一覧表示されない場合は、アドミニストレーターに連絡してエクスペリエンスへのアクセス権を取得するか、エクスペリエンスを作成します。詳細については、「UI ビルダー でユーザーがアプリケーションをどのように操作するかを構成する」を参照してください。
    3. ページを作成します。
      実行するタスク必要な操作
      ページの作成
      1. [ページとバリアント] セクションで [+] アイコンを選択します。

        エクスペリエンスビューページの [ページの作成] ボタン。

      2. [新規ページの作成] を選択します。

        ページタイプ選択モーダル。

      3. [代わりに最初から作成します] を選択します。

        [代わりに最初から作成します] ボタン。

      4. 新しいページの名前を入力します。名前は任意のもので構いません。この例では、「My tutorial page」と入力します。
      5. [パス] フィールドに、ページ名に基づいてパスが自動的に入力されます。この例では、パスは「my-tutorial-page」です。パスはページの URL です。このパスは任意に変更できますが、一意になっている必要があります。パスは小文字で、かつスペースを含めないようにする必要があります。[URL プレビュー] には、ページのパスが表示されます。

        「My tutorial page」というページを作成します。

      6. [続行] を選択します。
      7. (オプション) ページの URL にパラメーターを追加します。
      8. [よさそうです]を選択します。
      9. 新しいページバリアントの名前を入力します。名前は任意のもので構いません。この例では、「My first page variant」と入力できます。
      10. [対象者の追加] を選択して、ページバリアントの対象者を追加します。この例では、[アドミン] を選択します。
      11. [続行] を選択します。
      12. 次の画面で、[レスポンシブをビルド (Build responsive)] を選択します。
      13. [作成] を選択します。
      14. ページを作成すると、ページエディター画面が表示されます。URL 設定バリアント設定などの詳細設定を変更できます。このチュートリアルでは、これらの詳細オプションをスキップできます。詳細設定の変更の詳細については、「UI ビルダーページの作成:詳細設定」を参照してください。
      図 : 2. UI ビルダーページエディター
      チュートリアルで作成された新しいページを表示する UI ビルダーページエディター。
      お疲れさまでした。チュートリアルページが作成されました。このページにはコンテンツがありません。ページにコンポーネントを追加して機能をビルドします。コンポーネントはページの構成要素です。UI ビルダー には、ページに追加できる多くのコンポーネントが用意されています。コンポーネントは、ヘッダーのようにシンプルにすることも、 リストのように複雑にすることもできます。
    4. ページのレイアウトを 2 列レイアウトに変更します。
      レイアウトの詳細については、「UI ビルダーページでコンポーネントを整理する」を参照してください。
      実行するタスク必要な操作
      ページのレイアウトを 2 列に変更
      1. [コンテンツ] ツリーの [本文] レベルを選択して、ページをハイライト表示します。
      2. コンテンツツリーで [+ コンテンツを追加] を選択します。

        コンテンツツリーで [+ コンテンツを追加] を選択するポインター。

      3. 2 列レイアウトを選択します。

        ツールボックスの 2 列レイアウトを指す矢印。

      4. 2 列レイアウトが表示されます。

        ステージに表示されている 2 列レイアウト。

    5. ヘッダーコンポーネントと、ボタンコンポーネントを、左の列に追加します。
      実行するタスク必要な操作
      左列のコンテナへのヘッダーコンポーネントの追加 コンポーネントはさまざまな方法でページに追加できます。コンポーネントをページに追加する方法の詳細については、表 1 を参照してください。
      1. 左の列の中央にある [+] ボタンを選択します。
      2. 検索フィールドに「Heading」と入力します。
      3. ヘッダーコンポーネントを選択してコンテナに追加します。ヘッダーコンポーネントは、ページにテキストまたはタイトルを追加する方法です。
      4. 構成パネルのプリセットのリストで [なし] を選択します。

        列に見出しコンポーネントを追加する

      5. 構成パネルでコンポーネント名を選択すると、[コンポーネントラベル][コンポーネント ID] が表示されます。一意である限り、任意のものに変更できます。

        コンポーネントのラベルと ID を更新する。

      6. [適用] を選択します。
      7. ヘッダーコンポーネントを構成します。コンポーネント作成者は、コンポーネントの設定に必要となる適切なプロパティを公開するようにコンポーネントを構成します。
        • スタイルを [ヘッダー (プライマリ)] に設定します。スタイルは、フォント、太さ、色などのヘッダーテキストのクラスを変更します。たとえば、[ヘッダー (セカンダリ)] を選択すると、テキストが小さくなります。ヘッダーが 2 つあり、セカンダリのヘッダーをプライマリのヘッダーよりも小さくする場合は、異なるサイズのヘッダーが役に立ちます。
        • [ラベル] フィールドで、ヘッダーテキストとして「My Tutorial」と入力します。
        • [レベル] は 1 のままにします。

          [自分のチュートリアル] が追加されたコンポーネント構成タブの [見出しラベル] フィールド。

      ボタンコンポーネントを左列のコンテナに追加して構成する

      ボタンコンポーネントをページに追加します。テキストと外観を変更してボタンを構成します。次に、ボタンのイベントハンドラーを追加して、ボタンをクリックしたときの動作を変更します。イベントハンドラーは、ServiceNow® ホームページにリンクするボタンにアクションを追加します。ボタンをクリックすると、ServiceNow® ホームページがブラウザーの新しいタブで開きます。コンポーネントの構成の詳細については、「コンポーネント」を参照してください。

      1. 前のセクションで追加した見出しコンポーネントの下にある [+] を選択します。

        見出しの後にコンポーネントを追加する [+] アイコンを指す矢印。

      2. 検索フィールドに「Button」と入力します。
      3. リストでボタンコンポーネントを選択します。

        コンポーネントのページへの追加の詳細については、表 1 を参照してください。

      4. 構成パネルでコンポーネント名を選択すると、[コンポーネントラベル][コンポーネント ID] が表示されます。一意である限り、任意のものに変更できます。
      5. ボタンコンポーネントを次のように構成します。
        • [ラベル] フィールドに「Home Page」と入力してボタンの名前を変更します。
        • [サイズ] を [大] に変更します。
        • [アイコン] 検索フィールドに「home」と入力します。
        • [ホームアウトライン (Home Outline)] を選択します。

          [ホームページ] ボタンの構成。

      6. イベントハンドラーを追加して、ボタンに適用するアクションを構成します。
        • 構成パネルで [イベント] タブを選択します。
        • [クリックしたボタン] で、 [+ 新しいイベントハンドラーを追加] を選択します。

          [+ 追加] イベントハンドラーリンクを指している矢印

        • [継承されたイベントハンドラー] で、 [宛先へのリンク] を選択します。
        • [宛先を選択] をクリックします。
        • [宛先を選択] 画面で、[外部 URL] を選択します。
        • URL を入力します。このチュートリアルでは、「https://www.servicenow.com」と入力します。[OK] を選択します。
        • [追加] を選択します。

          ボタンコンポーネントの構成されたイベントハンドラー

          イベントハンドラーの詳細については、「UI ビルダーページでのアクションの管理 (高度な機能)」を参照してください。
      7. [保存] を選択します。作業時にはページを頻繁に保存することをお勧めします。
      8. [プレビュー] を選択します。
      9. それまでのステップで作成したボタンをテストします。
      ページのヘッダーボタンコンポーネントを追加して構成しました。

      見出しとボタンが構成された UI ビルダーページ。

    6. データビジュアル化コンポーネントをそのコンテナに追加します。
      データビジュアル化コンポーネントには、視覚的に表示するデータが含まれています。データビジュアル化コンポーネントのパラメーターを構成します。次に、それにデータリソースを追加します。
      実行するタスク必要な操作
      ビジュアル化コンポーネントを右列のコンテナに追加して構成する コンポーネントはさまざまな方法でページに追加できます。コンポーネントをページに追加する方法の詳細については、表 1 を参照してください。
      1. 右の列の中央にある [+] ボタンを選択します。
      2. [検索] フィールドに「データビジュアル化」と入力し、データビジュアル化コンポーネントが表示されたら、そのコンポーネントを選択してページに追加します。
      3. 構成パネルでコンポーネント名を選択すると、[コンポーネントラベル][コンポーネント ID] が表示されます。一意である限り、任意のものに変更できます。
      4. データ可視化コンポーネントにデータリソースを追加して、顧客アカウントデータを取り込みます。
        • データ可視化コンポーネントを選択し、[構成] タブを選択します。
        • [データソースを追加] を選択します。
        • 検索フィールドに「タスク [task]」と入力し、 UI ビルダー インスタンスで使用可能なタスクを探します。
        • [このソースを追加] を選択します。

          データビジュアル化コンポーネントへのデータソースの追加。

      5. [データ表示方法タイプ] ドロップダウンを選択し、[ダイヤル] を選択します。 データに最適なさまざまな可視化タイプを選択できます。
      6. 構成パネルで [ヘッダーと境界 (Header and border)] を選択します。
      7. [チャートタイトル] フィールドに「My Tasks」と入力します。

        [チャートタイトル] フィールドを指す矢印。

      データビジュアル化コンポーネントを右側の列に追加して構成しました。顧客アカウントデータを取り込むデータリソースも追加しました。
    7. 新しいページを最後に 1 回保存します。
      実行するタスク必要な操作
      ページの保存
      1. UI ビルダー の右端にある [保存] を選択します。
      2. ページを保存したので、エクスペリエンスでいつでもアクセスできます。
    8. ページをプレビューして、ブラウザーでどのように表示されるかを確認します。
      実行するタスク必要な操作
      ページのプレビュー
      1. UI ビルダー のヘッダーで、[プレビュー] を選択します。
      2. ページの左の列のヘッダーを確認します。
      3. [ホームページ] ボタンを選択します。ServiceNow® ホームページが別のブラウザーのタブで開きます。ブラウザータブを閉じて、プレビューページに戻ります。
      4. ページの右の列にある顧客アカウントデータのビジュアル化を確認します。
        図 : 3. チュートリアルページのプレビュー
        [プレビュー] を選択してチュートリアルページを表示します。
      おめでとうございます!UI ビルダー チュートリアルを完了しました。

    タスクの結果

    1. UI ビルダー にページを作成しました。
    2. ページのレイアウトを 2 列に変更します。
    3. 左側の列にヘッダーコンポーネントがタイトルとして追加されました。
      • ヘッダーのテキストを変更しました。
      • ヘッダーのラベルを変更しました。
    4. ヘッダーコンポーネントの下にボタンコンポーネントを追加しました。
      • ボタンが構成されました。
      • ボタンのイベントハンドラーを追加しました。
      • Web ページへのリンクを設定するイベントハンドラーを追加しました。ボタンをクリックすると、Web ページが開きます。
    5. 右側の列のラベルを変更しました。
    6. データビジュアル化コンポーネントを追加しました。
      • データビジュアル化コンポーネントを構成しました。
      • タスクデータを取り込むデータリソースを追加しました。
    7. 新しいページを保存しました。
    8. ページをプレビューします。