フィールドを変換

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • 一連のルールと条件を使用して、フィールドのコンテンツを変換します。

    始める前に

    必要なロール:admin または normalizer

    手順

    1. 変換レコードを作成します。
    2. 1 つ以上の関連する変換レコードを作成します。
    3. 変換をテストします。
    4. データジョブを実行します。

    次のタスク

    変換前の元の (生の) 入力値も表示する場合は、生のフィールドを作成してこの値を保存します。

    変換レコードを作成する

    変換レコードの作成は、フィールドの変換の最初のステップです。

    手順

    1. フィールド正規化プラグインを有効にします。
    2. 移動先 フィールド正規化 > 構成 > 変換.
    3. [新規] をクリックします。
    4. 変換レコードを作成します。
      表 : 1. 変換レコードのフィールド
      フィールド 説明
      名前 この変換レコードの一意の名前。この値は参照専用で、どの処理にも使用されません。
      テーブル 変換するフィールドを含む ServiceNow テーブルを選択します。フィールド変換を設定するときは、テーブルの階層を理解することが重要です。たとえば、コンピュータ [cmdb_ci_computer] テーブルのフィールドの変換を構成する場合、そのフィールドはすべてのワークステーションマシン、Windows サーバー、Linux サーバー、および UNIX サーバーに対して変換されます。
      フィールド 変換するフィールドを選択します。表示されるリストには、選択したテーブルからの変換可能なフィールドタイプ (整数と文字列) のみが含まれています。
      注:
      変換プロセスを開始する sys_user レコードの日付形式は、「yyyy-MM-dd」のデフォルト形式に設定する必要があります。その他の日付形式では、変換中にエラーが発生します。この問題は、日付/時刻タイプの TO TARGET フィールドを変換する場合にのみ発生します。ターゲットフィールドタイプが文字列タイプの場合、または日付フィールドのフィールドマッピングが変換プロセスと同じ日付形式に変更された場合、この問題は発生しません。
      モード 利用可能な 3 つのモードは、[オフ][テスト]、および [アクティブ] です。デフォルトでは、すべての変換レコードはテストモードで作成されます。変換を完全にテストするまで、モードを変更しないでください。テストが完了したら、モードを [アクティブ] に変更します。この変換を無効にするには、モードを [オフ] に切り替えます。
      正規化クエリ このレコードによって変換されたフィールド値をこのフィールドに関連するすべてのクエリに適用するには、このチェックボックスをオンにします。生の (元の) フィールド値で発行されたクエリは、変換値を使用するように編集されます。
      生データフィールド フィールド値が正規化されたフォームに元の (正規化されていない) 入力値を表示するために使用するフィールドを選択します。選択項目をドロップダウンリストに表示するには、選択したテーブルのフォームにカスタムフィールドを追加します。生データのフィールドを追加する手順については、「生データフィールドを作成する」を参照してください。
    5. [送信] をクリックします。

      [変換][データジョブ] 関連リストがフォームに表示されます。

    1 つ以上の関連する変換レコードを作成します。

    関連する各変換レコードは、値の先頭に文字を追加したり、ある文字列を別の文字列に置き換えたりするなど、特定の変換タイプを実行します。優先される出力フィールド値を生成するために、複数の関連する変換レコードを作成する必要がある場合があります。

    手順

    1. [変換] レコードで、[変換] 関連リストを選択します。
    2. [新規] をクリックします。

      変換タイプの選択リストが表示され、選択したフィールドタイプに適した変換のみが表示されます。

      図 : 1. 変換タイプ
      変換タイプ
    3. 変換タイプを選択し、適切なパラメーターを指定します。
    4. この変換の順序番号を選択します。
      注:
      変換の条件は、割り当てられた順序番号に従って実行されます。
    5. 条件が true と評価された場合にこの変換による処理を停止するには、[最終] チェックボックスをオンにします。
    6. [大文字と小文字を区別] チェックボックスをオンにすると、条件ステートメントで大文字と小文字の区別が強制されます。

      次の変換の例では、アサイン先グループが ITSM Engineering である場合に、インシデント番号の先頭にある INC を文字列 ENG に置き換えます。

      図 : 2. 変換レコード
      変換レコード
    7. [送信] をクリックします。

      新しい変換が変換レコードの関連リストに表示されます。

      変換が作成されると、変換アプリケーションデータジョブも作成されます。このデータジョブは、この変換をデータベース全体の適切なレコードに適用します。テストが完了するまでこのジョブを実行しないようにする必要があります。

    8. オプション: 出力値が目的の基準を満たすまで、手順 2 〜 8 を繰り返します。

    変換のテスト

    データベース内の既存のレコードに変換を適用する前に、変換によってフィールド値が期待どおりに変更されることを確認してください。

    このタスクについて

    注:
    テストレコードを作成するには、ユーザーが normalization_tester ロールを持っている必要があります。

    新しい変換レコードはデフォルトで [テスト] モードで開かれるので、管理者は、変換をデータベース内の既存のレコードに適用する前に十分にテストすることができます。テストモードでは、[開始] コントロールを [変換アプリケーション] データジョブで使用することはできません。既存のデータに変換をコミットする前に変換をテストするには、以下の 2 つの方法があります。

    手順

    • テストレコードを手動で作成または更新します。

      テストモードでは、normalization_tester ロールを持つユーザーによって作成または更新されたレコードのみが変換されます。normalizer ロールと normalization_tester ロールを同じユーザーに付与するか、別々のユーザーに付与します。

    • テスト変換ユーティリティを使用して生の値を入力し、結果の変換された値を確認します。

      この機能により、正規化テスターは、レコードを開いたり更新したりすることなく、フィールド値をその場で変換できます。このユーティリティは、このフィールドに構成されたすべての変換をテストします。

      1. 変換レコードを開きます。
      2. [変換をテスト] 関連リンクをクリックします。

        フィールド値をテストするためのダイアログボックスが表示されます。

      3. 変換する値を [生データ] フィールドに入力します。
        [生データ] フィールド
      4. [OK] をクリックします。

        プラットフォームによって、[変換されたデータ] フィールドの生の値が変換されます。

        [変換されたデータ] フィールド
      5. 新しい生データを入力して、他の変換をテストします。
      6. [キャンセル] をクリックしてテストを終了します。
      7. テストが完了したら、[モード][アクティブ] に変更し、データジョブを実行します。