ジョブオプション (コネクタ)

ジョブオプションについて

ジョブタブでは、ジョブオプションメニューから既存のジョブに対してさまざまなアクションを実行できます。例:

• ジョブ名、データマッピング、フィルタ条件などのジョブ詳細の編集
• ジョブのコピーおよび削除
• ジョブの監視と通知の追加
• ジョブ概要および変更ログの表示
• 実行中のジョブの終了
• ジョブの変更ログおよび概要の表示

利用可能なジョブオプション

ジョブオプションにアクセスするには、ジョブ名の横にあるメニューをクリックします。次のオプションが利用可能です。

• データの取得: スケジュールされたジョブのデータを手動で取得します。
• 名前および説明: ジョブの名前と説明を編集します。
• データマッピング: ジョブに使用されるデータマッピングを編集します。詳細については、データマッピングを参照してください。
• データフィルタ: ジョブのコネクタフィルタおよびレコード制限を編集します。
• データソースフィルタ: ジョブのデータソースフィルタを編集します。
• 重複処理: 重複伝票の処理方法を決定します。詳細については、重複処理を参照してください。
• 最終実行統計: ジョブの最終実行に関する統計を表示します。詳細については、ジョブ実行統計の表示を参照してください。
• データの代入と編集：インポートされたデータの機密情報を自動的に非表示にしたり、置き換えるためのルールを作成します。詳細については、データの代入と編集を参照してください。
• 概要: ジョブで処理されたデータに関する情報を提供するジョブサマリを表示します。詳細については、ジョブサマリの表示を参照してください。
• 変更ログ: このジョブに対して行われたすべての編集のログを表示します。詳細については、ジョブ変更ログを参照してください。
• 通知設定: ジョブ参照者にいつ通知するかを選択します。詳細については、ジョブ通知を参照してください。
• Start/Stop Watching Job ：ジョブが失敗またはタイムアウトした場合に通知を受信します。詳細については、ジョブのウォッチを参照してください。
• 参照者の管理: ジョブの参照者として他のユーザを割り当てます。詳細については、ジョブのウォッチを参照してください。
• 重複ジョブ: ジョブをコピーします。詳細については、ジョブのコピー & 削除を参照してください。
• ジョブ削除: ジョブを削除します。詳細については、ジョブのコピー & 削除を参照してください。
• 実行スケジュール: スケジュール済ジョブの場合は、ジョブのスケジュールを編集します。詳細については、ジョブスケジュールを参照してください。
• パスとファイルマスクの更新: このオプションは、ファイル受信コネクタでのみ使用できます。ジョブの作成後、パスとファイルマスクを更新できます。
• サンプル設定の更新: このオプションは、ファイル受信コネクタなどのサンプルファイルをアップロードできるコネクタでのみ使用できます。フィールドマッピングを更新した後、このオプションを使用して新しいサンプルファイルをアップロードすることができます。
• 復号化および圧縮の更新: このオプションは、ファイル受信コネクタなどの解読と圧縮が可能なコネクタでのみ使用できます。
• 保持設定を更新：XM Discoverで処理されたファイルの処理方法を変更します。このオプションは、ファイル受信コネクタおよび組織階層受信コネクタでのみ使用できます。詳細については、ジョブの編集を参照してください。
• クエリ設定: 特定の受信コネクタのクエリ設定を変更することができます。

一括アクション

一括アクションメニューでは、以下のオプションを使用できます。これらのオプションは、単一のジョブではなく、ページに表示されるすべてのジョブに適用される点を除き、標準のジョブオプションと同様に機能します。ジョブをフィルタリングして、ページに表示されるジョブを変更することができます。

• データの取得: 複数のスケジュール済みジョブのデータを手動で取得します。詳細については、データの取得を参照してください。
• ジョブサマリのエクスポート: ジョブのサマリをダウンロードします。
• ジョブ監視: 複数のジョブの監視を一度に開始し、失敗したジョブがある場合に通知を受け取ります。詳細については、ジョブの監視を参照してください。
• ジョブのウォッチを停止: ジョブの監視を停止すると、失敗した場合は通知されなくなります。詳細については、ジョブの監視を参照してください。
• 削除ジョブ: 複数のジョブを一度に削除します。詳細については、ジョブの削除を参照してください。
• データマッピング更新: 同じソースからの複数のジョブのデータマッピング設定を更新します。詳細については、データマッピングを参照してください。
• 参照者の追加: ジョブウォッチャ一覧からユーザを追加および削除します。これにより、ジョブの失敗やタイムアウトが発生した場合に通知を受信するユーザを制御できます。詳細については、ジョブの監視を参照してください。
• データマッパーのダウンロード：プロジェクトとジョブのデータマッパーをダウンロードし、自動生成された唯一の正しい情報源を使用してソース間マッピングを確認します。出力はデータマッパスプレッドシートです。詳細については、データマッパレポートを参照してください。

ヒント：一括アクションを実行すると、アクションの影響を受けるジョブの数を確認するポップアップウィンドウが表示されます。ウィンドウに表示される番号を入力して、アクションを確認します。

データの取得

スケジュールされたジョブのデータを手動で取得して、保留中のデータを即時にインポートすることができます。

1. データをインポートするジョブの横にあるデータ取得を選択します。
   
   ヒント：［一括アクション］メニューから複数のジョブのデータを一度に取得できます。
2. 重複伝票の処理方法を選択します。
   
   • 既存の伝票の重複を拒否し、新規伝票の新規レコードを登録します。これがデフォルトオプションです。重複伝票が見つかった場合、その伝票は拒否されます。重複しない伝票は新規レコードとして処理されます。
   • 既存文書の構造化属性の更新および新規文書の新規レコードの登録: 重複文書が見つかると、以下の処理が行われます。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 既存の完全一致フィールドは更新されません。
     • 新しい直接入力フィールドは追加されません。
     • 重複しない伝票は新規レコードとして処理されます。
   • 既存の伝票の構造化属性を更新し、新規伝票のレコードを登録しない: 重複伝票が見つかった場合、以下が発生します。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 既存の完全一致フィールドは更新されません。
     • 新しい直接入力フィールドは追加されません。
     • 重複していない伝票は拒否されます。
   • 既存のレコードの構造化属性を更新し、追加の逐語的フィールドを追加し、新しいレコードを作成する：重複文書が見つかると、次のようになる：
     • 重複しない伝票は新規レコードとして処理されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい逐語的フィールドが現在の文書に追加される。
     • 既存の完全一致フィールドは更新されません。
     Qtip:このオプションが正しく機能するためには、ジョブのデータマッピングで既存の逐語的フィールドのマッピングを解除する必要があります。
3. OK をクリックします。

ジョブの編集

以下のオプションを使用して、ジョブ設定のさまざまな部分を編集することができます。

• 名前および説明: ジョブの名前と説明を変更します。新しいジョブ名およびジョブ内容説明を入力します。
  
  ヒント：このオプションは、過去の実行を更新しません。新規登録された実行のみに、新しい名称とテキストが設定されます。データを再処理して履歴ジョブ実行を更新するには、ジョブ名と説明を更新した後でデータ取得を選択します。
• 保持設定の更新：このオプションは、受信ファイルと組織階層インバウンドファイルでのみ使用できます。このオプションを使用して、XM Discover が処理済みデータに保持される期間を変更してから削除できます。XM Discoverによって処理されたファイルが削除されるまでの保持期間を選択するには、1～365の間の値を入力します。
  
  ヒント：ファイルが保持されている場合、ファイルのタイプに応じて、SFTPサーバー上の次の場所のいずれかに移動します：files-location-folder/archive/job-specific-subfolder/bad/job-specificサブフォルダ。

重複処理

XM Discoverでは、重複した文書を認識し、設定に基づいて処理することができます。ドキュメントは自然な ID フィールドで識別されます。2 つのドキュメントの Natural ID 値が同じ場合、それらは重複と見なされます。

1. 重複検出を設定するジョブの横にある重複処理を選択します。
   
2. 重複伝票の処理方法を選択します。
   
   • 既存の伝票の重複を拒否し、新規伝票の新規レコードを登録します。これがデフォルトオプションです。重複伝票が見つかった場合、その伝票は拒否されます。重複しない伝票は新規レコードとして処理されます。
   • 既存文書の構造化属性の更新および新規文書の新規レコードの登録: 重複文書が見つかると、以下の処理が行われます。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 既存の完全一致フィールドは更新されません。
     • 新しい直接入力フィールドは追加されません。
     • 重複しない伝票は新規レコードとして処理されます
   • 既存の伝票の構造化属性を更新し、新規伝票の新規レコードを登録しない: 重複伝票が見つかった場合、以下が発生します。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 既存の完全一致フィールドは更新されません。
     • 新しい直接入力フィールドは追加されません。
     • 重複していない伝票は拒否されます。
   • 既存のレコードの構造化属性を更新し、追加の逐語的フィールドを追加し、新しいレコードを作成する：重複文書が見つかると、次のようになる：
     • 重複しない伝票は新規レコードとして処理されます。
     • 新しい構造化属性が現在の文書に追加されます。
     • 現在の構造化属性は、空でない値で更新されます。
     • 新しい逐語的フィールドが現在の文書に追加される。
     • 既存の完全一致フィールドは更新されません。
     Qtip:このオプションはインクリメンタルランにはお勧めしません。この機能を使用するには、検索プロセスを開始する前に、他の逐語フィールドにデータが入力されていないことを確認してください。既存の逐語訳フィールドにデータが入力されている場合、新しいデータを取得するには、ジョブのデータマッピングで既存の逐語訳のマッピングを解除する必要があります。検索プロセスが完了したら、他の逐語タイプを再マッピングすることができる。
3. OK をクリックします。

ジョブの監視

ジョブが失敗した場合やタイムアウトした場合に通知されるジョブを監視できます。ジョブを監視するには、ジョブオプションメニューからウォッチジョブ開始を選択します。すでにジョブを監視しており、通知を受信する必要がなくなった場合は、代わりにジョブの監視の停止を選択することができます。

ジョブウォッチャの管理

ほかのユーザーをジョブの参照者として割り当てることができます。

1. ジョブオプションメニューで、ウォッチャの管理を選択します。
   
2. プラス記号 (+) をクリックします。
   
3. ジョブが失敗したかタイムアウトした場合に通知するユーザの電子メールアドレスを入力します。
   
   ヒント：新たに追加されたユーザーの横には「新しい参照者」ラベルが表示され、既存のユーザーの横には「既存の参照者」ラベルが表示されます。
4. プラス記号 (+) をクリックして参照者を追加したり、マイナス記号 ( – ) をクリックして参照者を削除したりすることができます。
5. ［保存］をクリックします。

ジョブ通知

ジョブ参照者を追加した後、いつ参照者に通知するかを指定できます。通知設定を管理するには、ジョブオプションメニューから通知設定を選択します。

以下の通知タイプを使用することができます。

• プロジェクトにゼロのレコードがロードされたときに通知: ジョブによって少なくとも 1 つのファイルが処理されるものの、プロジェクトにレコードがロードされない場合に、通知を受信します。
  ヒント：重複するドキュメントがスキップされても、通知は送信されません。
• 連続した欠損値が見つかった場合に通知: すべてのドキュメントで Null 値を持つマッピング済みフィールドがジョブで見つかった場合に通知を受信します。
• ジョブの実行失敗時に通知: ​​ジョブが失敗または終了した場合は通知を受信します。
• ジョブ実行が部分的に成功した場合に通知: ジョブが部分的にのみ成功した場合に通知を受信します。これは、たとえば、ジョブで特定のファイルの解凍または解読に失敗した場合に発生することがあります。
• ファイルに誤ったヘッダーが含まれている場合に通知: ジョブで不適切なヘッダーを含むファイルが少なくとも 1 つ見つかった場合に通知を受信します。
  ヒント：このオプションは、ExcelまたはCSV形式を使用するファイルコネクタージョブでのみ使用できます。
• ファイルに不正な JSON 対話構造が含まれている場合に通知: デジタルインタラクションの Qualtrics Conversational Format と一致しない JSON ファイルがジョブで少なくとも 1 つ見つかった場合に通知を受信するか、トランスクリプトを呼び出します。
  ヒント：このオプションは、JSON形式で会話データをインポートするときにファイルコネクタージョブにのみ表示されます。
• 処理するファイルが見つからない場合に通知: ジョブで処理対象のファイルが見つからず、ジョブが失敗すると通知を受信します。このチェックボックスを選択しないと、ジョブが成功し、ジョブウォッチャは通知を受信しません。
  ヒント：このオプションは、ファイルコネクタージョブにのみ適用されます。
• ジョブがタイムアウトで終了した場合に通知: ジョブのレコードのロードおよびタイムアウトに時間がかかった場合に通知を受信します。
• このジョブが失敗した場合にサポートに通知します：有効にすると、S3、Files、Postgresコネクタのジョブが正常に完了しなかった場合に、XM Discoverサポートチームに通知が届きます。これらのコネクタから失敗したジョブの情報が統合された1つのサポートチケットが、毎日サポートチームに送信されます。

コピー中; ジョブの削除(&A)

ジョブをコピーして、新しいジョブの設定を迅速に複製したり、不要になったジョブを削除したりすることができます。

ジョブのコピー

ジョブをコピーするには、ジョブオプションメニューでジョブの複製を選択します。新しくコピーされたジョブには、元のジョブと同じ名前が付けられ、”コピー” がその名前に追加されます。

ジョブの削除

ジョブを削除するには、ジョブオプションメニューでジョブ削除を選択します。

必要に応じて、削除されたジョブをリサイクルビンで復元することができます。詳細については、「ジョブの削除」(&A) を参照してください。

ジョブの終了

現在実行中のジョブを停止することができます。

1. 終了するジョブの横にあるジョブオプションメニューをクリックします。
   
   ヒント：実行中のジョブのステータスは［進行中］です。
2. 現在の実行を終了をクリックします。
3. はいをクリックします。
   

ジョブを終了すると、残りのレコードの取得が停止され、そのステータスが “失敗” に設定されます。

ジョブ変更ログ

ジョブオプションメニューから変更ログを選択して、ジョブで実行されたすべてのアクションに関する情報を含むテーブルを表示します。この表には次のものが含まれます

• 設定: ジョブに対して実行される編集 (ジョブ詳細の変更、ジョブの削除、参照者の追加など)。
• 更新者: 処理を実行したユーザーの電子メールアドレス。
• 更新日時: 処理が実行された日時。

ジョブサマリの表示

ジョブ概要を表示して、そのジョブによって処理されたデータをレビューすることができます。これは、データフィールドをXM Discoverにインポートする方法を確認する場合に特に役立ちます。概要を表示するには、ジョブオプションメニューでサマリを選択するか、ジョブ名をクリックします。