orchestrator
latest
false
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。
Orchestrator ユーザー ガイド
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated 2024年10月30日

グリッドをバックグラウンドでエクスポートする

概要

Orchestrator のオブジェクトはそれぞれの専用ページでグリッドに表示されています。グリッドには、そのオブジェクトのステータスの説明に役立つさまざまな列が含まれています。

これらのグリッドをエクスポートしてデータのバッチを取得し、後でダッシュボードやレポートの作成に使用できます。エクスポートの操作はバックグラウンドで行われます。ダウンロードの準備ができると通知が届くので、エクスポートの完了を待たずに Orchestrator の操作を続けることができます。

ダウンロード形式は、データ分析を行いやすい .csv です。ダウンロード データには [マイ レポート] ページからアクセスできます。

エクスポートできる Orchestrator オブジェクト

グリッドをエクスポートできる Orchestrator オブジェクトは以下のとおりです。

  • テナント レベル
    • 監査ログ
    • Test Automation の監査ログ
  • フォルダー レベル
    • キューのトランザクション
    • ログ
    • ジョブ
注:

監査ログ、キュー トランザクション、ログ、ジョブのエクスポートは、テナントあたり 1 日あたり 100 件に制限されています。

この制限を超えると、テナントごとの 1 日あたりの制限に達したことを示す #4502 エラーが表示されます。

制限は 00:00 UTC にリセットされます。

エクスポートされたレポート

[エクスポート] ボタンをクリックすると、[マイ レポート] ページにグリッドのコピーが作成されます。エクスポートの開始時と、エクスポートの完了時、またはエクスポートが失敗した場合は、ポップアップが表示されます。

エクスポートが完了すると、データがエクスポートされたことを知らせるアラートが送信されます。アラート表示権限がある場合、レポートはブラウザーの既定のダウンロード場所に、バックグラウンドで自動的にダウンロードされます。ただし、[マイ レポート] ページにアクセスして好きな時にレポートをダウンロードすることもできます。

[マイ レポート] ページには、過去 168 時間 (7 日 x 24 時間) に作成したエクスポートのみが表示されます。168 時間を経過したエクスポートは完全に削除されます。たとえば、ある月の 1 日の 00:00 に作成されたエクスポートは、7 日の 23:59 まで利用できます。

エクスポートを確認するには、上部のナビゲーション バーにある [マイ レポート] アイコンをクリックします。



エクスポートで確認できるプロパティは以下のとおりです。

  • エクスポートの種類 - Orchestrator のオブジェクトを参照します。
  • [作成日時] - エクスポートを作成した相対時間のタイムスタンプです。
  • 作成日時 (絶対時間) - エクスポートが作成された時刻の正確なタイムスタンプです。絶対時間のタイムスタンプはテナントのタイム ゾーンで表示されます。トリガーの次回の実行時刻はトリガーのタイム ゾーンで表示さるため、テナントのタイム ゾーンと異なる場合があります。
  • 有効期限 - リストからエクスポートが削除される日付です。レポートは、示された日の 00:00 に削除されます。

    これは、レポートがエクスポートされた後にのみ表示されます。

  • サイズ - エクスポートのサイズです。これは、レポートがエクスポートされた後にのみ表示されます。
  • ステータス - エクスポート操作のステータスです。

    • 新規 - エクスポートが進行中です。
    • 完了 - エクスポートが完了しました。
    • 失敗 - エクスポートに失敗しました。これは、SQL のタイムアウトまたは低ストレージによって発生する可能性があります。手動でエクスポートをリトライする必要があります。

      エクスポートの解決に必要な計算時間は最大 15 分です。それを過ぎると、エクスポートは失敗します。エクスポートをリトライするには、あらかじめデータに追加のフィルターを適用してください。

      重要:

      大量のデータのエクスポートが失敗しないようにするには、次の手順を実行します。

      • 対応する Orchestrator オブジェクトの API エンドポイントを使用する必要があります。たとえば、監査ログをエクスポートするには /odata/AuditLogs/UiPath.Server.Configuration.OData.Export を使用します。
      • 生成されるエクスポートの量は、頻度および取得するデータの量の両方の観点で、テナントのパフォーマンスに影響が出る場合があります。パフォーマンスに影響が出る場合、オートメーションが影響を受けないよう、このような要求に対してはスロットルやブロックが行われる可能性があります。
      • エクスポートされるデータの量を減らすには、フィルターを適用します。
データをデバイスにダウンロードするには、目的のレポートの [ダウンロード] ボタンをクリックします。この操作では、デバイスの既定のダウンロード場所が使用されます。レポートがアーカイブとしてダウンロードされます。アーカイブには、グリッドでフィルター処理されたデータの .csv ファイルが含まれます。
注:

エクスポートをデバイスにダウンロードするには、ストレージ ドメインを許可リストに追加する必要があります。詳細はこちらをご覧ください。

.zip ファイルと .csv ファイルの名前は、以下の命名規則に従います。

エクスポートされるオブジェクトの種類

ファイルの命名規則をダウンロードする

キューのトランザクション

{queue-name}-items-{export-date}-{export-timestamp}-{export-id}

キュー名に無効な文字 (\ / : * ? " < > |) が含まれている場合、_ に置換されます。

監査ログ

audit-logs-{export-date}-{export-timestamp}-{export-id}

ログ

robot-logs-{export-date}-{export-timestamp}-{export-id}

ジョブ

jobs-{job_folder_key}-{export-date}-{export-timestamp}-{export-id}

場所:

  • {queue_name} - エクスポートされるキュー アイテムを含むキューの名前です。
  • {job_folder_key} - ジョブ グリッドがエクスポートされるフォルダーの ID です。

  • {export_date} - エクスポートが作成された日付です。形式は yyyy-MM-dd です。
  • {export_timestamp} - エクスポートが作成された時刻です。形式は HH-mm-ss-fff です。
  • {export-id} - エクスポートの ID です。
たとえば、監査ログ グリッドのエクスポート ダウンロード ファイルの名前は、audit-logs-2023-01-27-12-29-40-843-24.zip のようになります。
重要:

エクスポートされるレポートの時刻の列は、テナントのタイムゾーンで表されます。

API エクスポートに関する重要な考慮事項

  • エクスポートの API では $select$top$skip$orderBy, and $count はキーワードとしてサポートされていないため、使用を避けることを強くお勧めします。代わりに適切なフィルターを使用してください。
  • レポートのエントリは、Id (すなわち $orderBy=Id) でのみ並べ替えられます。$orderBy キーワードで使用した他のパラメーターは無視されます。
  • $filter= 構造を使用してフィルター処理すると、テーブルで利用可能としてマークされているフィールドのみが許可されます。
  • 以下の表に示すように、サポートされていないフィールドを使用すると、400 エラーが返されます。

API を使用してキューのトランザクションをエクスポートする際にサポートされるフィールド

以下の表に、API を使用してキューのトランザクションをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。

API フィールド

エクスポートされたレポートの対応する列

フィルター処理可能

QueueDefinitionId

N/A

利用可能

Status

Status

利用可能

ReviewStatus

リビジョン

利用可能

Reference

参照

利用可能

ProcessingExceptionType

Exception

利用可能

DueDate

N/A

利用できません。

DueDateAbs

処理期限 (絶対時間)

利用できません。

Priority

優先度

利用可能

RobotName

Robot

利用できません。

DeferDate

N/A

利用できません。

DeferDateAbs

延期 (絶対時間)

利用できません。

StartProcessing

N/A

利用可能

StartProcessingAbs

開始時刻 (絶対時間)

利用できません。

EndProcessing

N/A

利用可能

EndProcessingAbs

終了時刻 (絶対時間)

利用できません。

SecondsInPreviousAttempts

トランザクション実行時間

利用できません。

AncestorId

前回の試行 ID

利用できません。

AncestorUniqueKey

AncestorUniqueKey

利用できません。

RetryNumber

リトライ回数

利用できません。

ManualAncestorId

手動の親 ID

利用できません。

ManualAncestorUniqueKey

ManualAncestorUniqueKey

利用できません。

ManualRetryNumber

手動リトライ回数

利用できません。

UniqueKey

UniqueKey

利用できません。

SpecificData

固有データ

利用できません。

Key

キー

利用できません。

ReviewerName

レビュー担当者名

利用できません。

ProcessingExceptionReason

例外の理由

利用できません。

Output

出力

利用できません。

RobotId

N/A

利用可能

ReviewerUserId

N/A

利用可能

Analytics

分析データ

利用できません。

CreationTime

N/A

利用可能

CreationTimeAbs

作成時刻 (絶対時間)

利用できません。

Progress進行状況

利用できません。

Id

ID

利用可能

監査ログの API エクスポートでサポートされるフィールド

以下の表に、API を使用して監査ログをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。

API フィールド

エクスポートされたレポートの対応する列

フィルター処理可能

Parameter

N/A

利用可能

DisplayName

N/A

利用可能

Action

操作

利用可能

Component

コンポーネント

利用可能

UserId

N/A

利用可能

ExecutionTime

N/A

利用可能

OperationText

操作

利用できません。

ExecutionTimeAbs

時刻 (絶対時間)

利用できません。

ServiceName

N/A

利用できません。

MethodName

N/A

利用できません。

EntityId

N/A

利用できません。

UserType

N/A

利用できません。

UserIsDeleted

N/A

利用できません。

ExternalClientId

N/A

利用できません。

UserName

ユーザー (User)

利用できません。

ロボット ログの API エクスポートでサポートされるフィールド

以下の表に、API を使用してロボット ログをエクスポートすることで生成されるレポートで利用可能なフィールドと、そのフィールドをフィルター処理できるかどうかを示します。

API フィールド

エクスポートされたレポートの対応する列

フィルター処理可能

JobKey

N/A

利用可能

TimeStamp

時刻 (絶対時間)

利用可能

Level

レベル

利用可能

ProcessName

プロセス

利用可能

HostMachineName

ホスト名

利用可能

WindowsIdentity

ホスト ID

利用可能

Message

メッセージ

利用可能

RawMessage

N/A

利用できません。

RobotName

ロボット名

利用可能

MachineId

N/A

利用できません。

MachineKey

N/A

利用可能

RuntimeType

N/A

利用できません。

ジョブの API エクスポートでサポートされるフィールド

API フィールド

エクスポートされたレポートの対応する列

フィルター処理可能

CreationTime

N/A

利用可能

SourceType

N/A

利用可能

State

ステート

利用可能

SpecificPriorityValue

優先度

利用可能

HostMachineName

ホスト名

利用可能

LocalSystemAccount

ホスト ID

利用可能

MachineName

マシン

利用できません。

Key

キー

利用できません。

JobPriority

N/A

利用できません。

ReleaseName

プロセス

利用できません。

RobotName

Robot

利用できません。

MachineScope

N/A

利用できません。

EnvironmentName

環境

利用できません。

Type

ジョブの種類

利用できません。

RuntimeType

ランタイムの種類/ライセンス

利用できません。

StartTime

N/A

利用可能

StartTimeAbs

開始時刻 (絶対時間)

利用できません。

EndTime

N/A

利用可能

EndTimeAbs

終了時刻 (絶対時間)

利用できません。

ProcessType

N/A

利用できません。

Source

ソース

利用できません。

CreationTimeAbs

作成時刻 (絶対時間)

利用できません。

ServerlessJobType

N/A

利用できません。

StartingScheduleId

N/A

利用可能

Release

N/A

利用できません。

Machine

N/A

利用できません。

Robot

N/A

利用できません。

アラートをエクスポートする

適切な権限があれば、作成したすべてのエクスポートは [アラート] ページに記録されます。完了したエクスポートは重要度 Info でログ記録され、失敗したエクスポートは重要度 Error でログ記録されます。

既定では、完了または失敗したエクスポートに関するアラート メールが届きます。アラートの配信を停止するには、[アラートの設定] ページに移動して [エクスポート] オプションの選択を解除します。

詳しくはこちらをご覧ください。

このページは役に立ちましたか?

サポートを受ける
RPA について学ぶ - オートメーション コース
UiPath コミュニティ フォーラム
Uipath Logo White
信頼とセキュリティ
© 2005-2024 UiPath. All rights reserved.