機械翻訳について

すべてのバッチ監査詳細のリスト

get

/capture/api/v1.1/audit/batches

この操作は、キャプチャでのバッチのすべての監査詳細のコレクションを返します。

バッチがキャプチャを通過すると、そのバッチに関連するイベントが発生します。 これらのイベントは、プロシージャで定義された処理のタイプによって異なりますが、通常はマイルストン・イベントまたはエラー・イベントです。 たとえば、バッチの作成はマイルストーン・イベントとみなすことができます。 処理の結果としてエラーが発生した場合は、エラー・イベントとみなされます。

qパラメータを使用して、このコレクションの結果をフィルタ処理できます。 orderByパラメータは、コレクションをソートするための手段を提供します。 totalResultsパラメータは、問合せに一致する結果の合計数を返します。 その他のパラメータlimitおよびoffsetは、結果のpagingに使用されます。

この操作では、expandパラメータもサポートされ、子リソース/コレクションをインラインに含めるために使用されます。 documentsの子コレクションがサポートされています。 使用した場合、レスポンスには、バッチ内のすべてのドキュメントに関連付けられたすべての「文書監査詳細」オブジェクトが含まれます。 また、runtimeの子リソースもサポートされています。 使用すると、バッチが現在取得にある場合、バッチはレスポンスでランタイム状態情報が返されます。

バッチ監査の詳細がない場合、またはフィルタリング基準と一致しない場合は、空のコレクションが返されます。

リクエスト

サポートされているメディア・タイプ
問合せパラメータ
  • expandパラメータは、レスポンスとともに子リソース/コレクションをインラインで取得するオプションを提供します。 属性名のカンマ区切りリストまたはallを受け入れます。 展開がall (小文字のall)として指定されている場合、リクエストされたバッチ監査詳細のすべての子リソース/コレクションが展開されます。

    拡張パラメータに未定義の子リソースが含まれている場合、リクエスト操作ではエラーが発生します。 使用可能な子リソース/コレクションは次のとおりです:

    • runtime
    • documents

    : ?expand=runtime
    このバッチ監査詳細のruntimeオブジェクト(ある場合)を展開します。

    : ?expand=documents
    このバッチ監査詳細のdocumentsのコレクション(ある場合)を展開します。

  • limitパラメータは負でない整数を受け入れ、結果のバッチ監査詳細コレクションのサイズを制御するために使用されます。

    デフォルト値: 50
  • localeパラメータは、監査イベントのメッセージに使用される言語翻訳を指定するために使用されます。 値は、RFC 4647で定義されている標準言語タグの形式である必要があります。

    これを指定しない場合、デフォルトの言語設定ロケールが使用されます。

  • offsetパラメータは、負でない整数を受け入れ、問合せのバッチ監査詳細コレクションの開始索引を制御するために使用されます。

    デフォルト値: 0
  • orderByパラメータは、バッチ監査詳細コレクションの結果の順序(昇順/降順)を制御するために使用されます。 バッチ監査詳細コレクションのデフォルト・ソート順序はlastEventDate降順であるため、このパラメータはオプションです。

    このパラメータは属性名を受け入れ、ユーザーが結果をソートするコロン(:)で区切ることができます(昇順/降順)。 ソート順が指定されていない場合は、昇順でソートされます。 ノート : ascは昇順、descは降順を表します。 複数のソート順をセミコロン(;)で区切ることができます。 たとえば、orderBy={attributeName1}:{asc/desc};{attributeName2}:{asc/desc}です。 また、複数のorderBy問合せパラメータが存在し、問合せ文字列パラメータ順序に適用されることもあります。

    orderByでは、バッチ監査詳細の次の属性のみがサポートされています:

    • id
    • name
    • createdDate
    • lastEventDate

    runtime子リソースの属性(runtime.statusruntime.priorityなど)もサポートされています。 ただし、runtimeオブジェクトを(allまたはruntime値を使用して)expandパラメータに含める必要があり、履歴バッチには影響しません。 runtime属性runtime.stateおよびruntime.lock.step.typeはサポートされていません。

    例:

    • ?orderBy=id
    • ?orderBy=name;lastEventDate:asc
    • ?orderBy=name&orderBy=lastEventDate:desc
    • ?orderBy=createdDate:asc
    • ?orderBy=createdDate:asc;runtime.priority
  • qパラメータは、バッチ監査詳細の属性値と一致する問合せ式条件を受け入れ、コレクションで結果をフィルタリングするために使用されます。 パラメータの値は、{attribute name} {condition operator} {attribute value}という形式の単純な式にすることも、論理演算子でグループ化して結合することもできます。

    次の条件演算子がサポートされています:

    • eq - 次と等しい
    • ne - 次と等しくない
    • lt - 次より小さい
    • gt - 次より大きい
    • le - 次以下
    • ge - 次以上

    文字列属性とともに使用できるのは条件演算子eqおよびneのみで、文字列属性は引用符で囲む必要があります(")。 同様に、ブール・データ型では、条件演算子eqおよびneのみを使用できます。 すべての条件演算子は、他の属性データ型とともに使用できます。

    日付/時間属性の値は、RFC 3339によって制御される「ISO-8601日時」形式の文字列として表される必要があります。 たとえば、"2021-04-12"または"2021-04-15T04:27:15-06:00"です。 値が文字列形式の場合でも、ltgtなど、数値型の演算子がサポートされます。

    条件式は、andまたはorの論理演算子で結合できます。 また、カッコ()を使用してグループ化することもできます。 たとえば: (({expression})および({expression}) これにより、より複雑なフィルタが生成されます。

    複数のq問合せパラメータがサポートされ、and論理演算子が示されます。

    q式では、バッチ監査詳細の次の属性のみがサポートされています:

    • id
    • name
    • createdDate
    • lastEventDate

    runtime子リソースの属性もサポートされます(runtime.stateruntime.priorityです)。 ただし、runtimeオブジェクトを(allまたはruntime値を使用して)expandパラメータに含める必要があり、履歴バッチには影響しません。

    例:

    • ?q=(id eq "636") or (id eq "637")
    • ?q=(runtime.status eq "Assigned Total" and createdDate ge "2021-05-01")
    • ?q=(runtime.priority gt 2)&q=(createdDate ge "2021-05-01")
    • ?q=(lastEventDate ge "2021-05-26")
  • totalResultsパラメータはブール・フラグを受け入れます。 trueとして指定した場合、返される結果には、問合せ内のバッチ監査詳細の合計数が含まれます。

    デフォルト値: false
トップに戻る

レスポンス

サポートされているメディア・タイプ

200レスポンス

すべてのバッチ監査詳細のリスト。

本文()
ルート・スキーマ : バッチ監査詳細収集
型: object
タイトル: Batch Audit Detail Collection

これは、「バッチ監査詳細」オブジェクトのコレクションを表します。

Show Source
  • 現在のレスポンスのレコードの合計数。

  • 取得するページがさらにあるかどうかを示すインジケータ。

  • items

    「バッチ監査詳細」オブジェクトの配列。

    これは、orderByで指定された順序、またはorderByが使用されていない場合はupdatedDateで降順にソートされます。

  • サーバーで使用される実際のページ・サイズ。 これは、クライアント・リクエストと同じでない場合があります。

  • 特異リソースが返される実際のインデックス。

  • クライアント・リクエストを満たす行の合計数(ページング・パラメータを除く)。

ネストされたスキーマ: items
型: array

「バッチ監査詳細」オブジェクトの配列。

これは、orderByで指定された順序、またはorderByが使用されていない場合はupdatedDateで降順にソートされます。

Show Source
  • Batch Audit Detail
    タイトル: Batch Audit Detail

    取得の「バッチ監査詳細」は、特定のバッチに対して発生した一連のイベントです。 これらは、バッチの作成、バッチの処理、バッチの削除などのイベントです。

    「バッチ監査詳細」には、関連する「文書監査詳細」オブジェクトも含まれており、このオブジェクトは、特定のバッチのドキュメントに対するイベントを表します。

ネストされたスキーマ : バッチ監査詳細
型: object
タイトル: Batch Audit Detail

取得の「バッチ監査詳細」は、特定のバッチに対して発生した一連のイベントです。 これらは、バッチの作成、バッチの処理、バッチの削除などのイベントです。

「バッチ監査詳細」には、関連する「文書監査詳細」オブジェクトも含まれており、このオブジェクトは、特定のバッチのドキュメントに対するイベントを表します。

Show Source
  • これは、バッチが作成された時期を識別します。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

  • events

    この配列には、このバッチに関連するすべての個別イベントがeventDateの昇順で格納されます。

  • バッチの一意識別子。

  • これにより、このバッチで最後に発生したイベントの日時が識別されます。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

  • links
  • バッチに指定された名前。

    取得でバッチを作成する場合、名前は定義済のプレフィクスと連番になります。 たとえば、inv_4781です

  • runtime

    バッチが現在キャプチャ・システムの一部である場合、このオブジェクトには現在のランタイム情報が含まれます。 ただし、バッチがコミットされている場合、または取得システムから削除されている場合は、ランタイム情報はありません。

ネストされたスキーマ : events
型: array

この配列には、このバッチに関連するすべての個別イベントがeventDateの昇順で格納されます。

Show Source
  • Audit Event
    タイトル: Audit Event

    これは、トラッキングされたキャプチャ内で発生した特定のアクションを表します。

ネストされたスキーマ: runtime
型: object

バッチが現在キャプチャ・システムの一部である場合、このオブジェクトには現在のランタイム情報が含まれます。 ただし、バッチがコミットされている場合、または取得システムから削除されている場合は、ランタイム情報はありません。

Show Source
  • createdBy

    バッチを作成したユーザー。

  • これは、バッチが作成された時期を識別します。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

  • バッチの現在のエラー・メッセージ(存在する場合)。

    バッチがERROR stateにある場合、バッチ処理に失敗した理由を示すエラー・メッセージが表示されます。 このメッセージは、バッチ処理が再エンターされるまで残ります。

  • lock

    batchlockedの場合(ユーザーがバッチを作成/編集する場合、またはキャプチャが現在バッチを処理している場合)、このオブジェクトにはロックに関する情報が含まれます。 バッチのstateは、このオブジェクトが存在するかどうかを決定します。

  • バッチに関連付けられたユーザー指定の一般ノート。

  • 最小値: 0
    最大値: 10
    デフォルト値: 0

    ユーザーがバッチの優先度を指定しました。

    この値は、ユーザーの注意のためにバッチを優先するために使用されます。 クライアントで表示するバッチをフィルタおよびソートするために使用されます。

  • デフォルト値: READY

    バッチの現在の状態。

    • READY - バッチの標準保存状態。 クライアントによってロックできます。
    • LOCKED - バッチは、ドキュメントの追加/削除やメタデータ・フィールド値の設定など、編集のためにクライアントによってロックされます。
    • ERROR - 処理中にエラーが発生しました。 処理エラーを修正するために、編集のためにクライアントによってロックできます。
    • PROCESSING - 取得は現在バッチを処理しています。 バッチは、取得プロシージャで定義されたジョブのいずれかにあります。
  • バッチに割り当てられた現在のステータス。

    ステータス値はプロシージャで定義され、バッチ作成時および処理ジョブ間の遷移時に割り当てることができます。

  • updatedBy

    バッチを更新した最後のユーザー。 これはキャプチャ・システムです。

  • これにより、バッチの最終更新日時が識別されます。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

ネストされたスキーマ : 監査イベント
型: object
タイトル: Audit Event

これは、トラッキングされたキャプチャ内で発生した特定のアクションを表します。

Show Source
  • イベントの簡単な説明。通常はverb (CREATED, UPDATED, PROCESSEDなど)です。

  • イベントの相関識別子。 この値は一意ではないことに注意してください。

    イベントによって、他のイベントが発生する可能性があります。 この識別子は、バッチとドキュメント間で、イベント間の原因関係を表します。

  • イベントに関する詳細情報。

  • eventBy

    イベントをトリグ/一時停止したユーザー。

    これは、イベントが取得のユーザーによってトリガーされた場合にのみ存在します。 イベントがキャプチャによってトリガーされる場合には表示されません。

  • これは、イベントの発生日時を識別します。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

  • messageの生成に使用されたlocale 値は、RFC 4647で定義されている標準言語タグの形式になります。

  • イベントを記述する単純なメッセージ。

  • 詳細messageの生成に使用されるメッセージ・パターンに関連する一意のキー。

  • messageProperties

    イベントの属性であり、メッセージの生成に使用される個々のプロパティ・キーと値の配列。 配列の順序は、メッセージ・パターンの引数索引の順序によって決まります。

    特定のキーおよび値は、イベントのtypeに依存します。 また、イベント・タイプでは、単純なキー/バリューのペアのみより複雑なオブジェクト定義が可能です。 次に例を示します。

    コミット済イベントのドキュメント

    [
        { "documentId": "58be0662-a758-491a-9eed-cc6f56124acf" },
        { "documentTitle": "Sales Invoice [58be0662-a758-491a-9eed-cc6f56124acf]" },
        { "repositoryName": "Plumbing Invoice Type" },
        { "assetType": "Plumbing Invoice Type" }
    ]
    

    電子メール・イベント

    [
        { "emailFromName": "Joe Smith" },
        { "emailFromAddress": "joe.smith@someplace.com" },
        { "emailSubject": "Sales Invoice" }
    ]
    
  • イベントの種類の一意の識別子。

ネストされたスキーマ : eventBy
型: object

イベントをトリグ/一時停止したユーザー。

これは、イベントが取得のユーザーによってトリガーされた場合にのみ存在します。 イベントがキャプチャによってトリガーされる場合には表示されません。

すべてに一致
Show Source
  • 「ユーザー情報」
    タイトル: User Information

    このオブジェクトには、取得の指定ユーザーに関する情報が含まれます。

    モデルは、このオブジェクトを使用して、ユーザーと他のオブジェクトの関係を示します。 たとえば、APIのモデルでは、ユーザー・オブジェクトである属性updatedByを定義できます。 これは、そのユーザーが最後に更新されたことを示します。

ネストされたスキーマ : messageProperties
型: array

イベントの属性であり、メッセージの生成に使用される個々のプロパティ・キーと値の配列。 配列の順序は、メッセージ・パターンの引数索引の順序によって決まります。

特定のキーおよび値は、イベントのtypeに依存します。 また、イベント・タイプでは、単純なキー/バリューのペアのみより複雑なオブジェクト定義が可能です。 次に例を示します。

コミット済イベントのドキュメント

[
    { "documentId": "58be0662-a758-491a-9eed-cc6f56124acf" },
    { "documentTitle": "Sales Invoice [58be0662-a758-491a-9eed-cc6f56124acf]" },
    { "repositoryName": "Plumbing Invoice Type" },
    { "assetType": "Plumbing Invoice Type" }
]

電子メール・イベント

[
    { "emailFromName": "Joe Smith" },
    { "emailFromAddress": "joe.smith@someplace.com" },
    { "emailSubject": "Sales Invoice" }
]
Show Source
  • Any Object
    タイトル: Any Object

    これは任意の種類のオブジェクトを表します。 オブジェクトに定義されたスキーマがある場合とない場合があります。

    これは、Content Capture REST APIの一部で使用され、異なる可能性があるか、設計時に認識されません。

ネストされたスキーマ : ユーザー情報
型: object
タイトル: User Information

このオブジェクトには、取得の指定ユーザーに関する情報が含まれます。

モデルは、このオブジェクトを使用して、ユーザーと他のオブジェクトの関係を示します。 たとえば、APIのモデルでは、ユーザー・オブジェクトである属性updatedByを定義できます。 これは、そのユーザーが最後に更新されたことを示します。

Show Source
ネストされたスキーマ : 任意オブジェクト
型: object
タイトル: Any Object

これは任意の種類のオブジェクトを表します。 オブジェクトに定義されたスキーマがある場合とない場合があります。

これは、Content Capture REST APIの一部で使用され、異なる可能性があるか、設計時に認識されません。

ネストされたスキーマ : createdBy
型: object

バッチを作成したユーザー。

すべてに一致
Show Source
  • 「ユーザー情報」
    タイトル: User Information

    このオブジェクトには、取得の指定ユーザーに関する情報が含まれます。

    モデルは、このオブジェクトを使用して、ユーザーと他のオブジェクトの関係を示します。 たとえば、APIのモデルでは、ユーザー・オブジェクトである属性updatedByを定義できます。 これは、そのユーザーが最後に更新されたことを示します。

ネストされたスキーマ : lock
型: object

batchlockedの場合(ユーザーがバッチを作成/編集する場合、またはキャプチャが現在バッチを処理している場合)、このオブジェクトにはロックに関する情報が含まれます。 バッチのstateは、このオブジェクトが存在するかどうかを決定します。

Show Source
  • lockedBy

    取得クライアント・インスタンス内でbatchlockedの場合、この属性にはバッチをlockedするユーザーが含まれます。

  • これは、バッチがいつロックされたかを識別します。 「ISO-8601日時」形式(yyyy-MM-dd'T'HH:mm:ss.SSSZ) UTCの日付/時間は、RFC 3339によって管理されます。

  • procedure

    取得が現在バッチを処理している場合、このオブジェクトにはバッチ処理を制御するプロシージャが含まれます。

  • step

    取得が現在バッチを処理している場合、このオブジェクトには、バッチが進行中の現在の処理ステップが含まれます。

  • 取得クライアント・インスタンス内のbatchlockedの場合、この属性には、キャプチャ・クライアント・インスタンスがバッチをlockedするコンピュータ名が含まれます。

ネストされたスキーマ : updatedBy
型: object

バッチを更新した最後のユーザー。 これはキャプチャ・システムです。

すべてに一致
Show Source
  • 「ユーザー情報」
    タイトル: User Information

    このオブジェクトには、取得の指定ユーザーに関する情報が含まれます。

    モデルは、このオブジェクトを使用して、ユーザーと他のオブジェクトの関係を示します。 たとえば、APIのモデルでは、ユーザー・オブジェクトである属性updatedByを定義できます。 これは、そのユーザーが最後に更新されたことを示します。

ネストされたスキーマ : lockedBy
型: object

取得クライアント・インスタンス内でbatchlockedの場合、この属性にはバッチをlockedするユーザーが含まれます。

すべてに一致
Show Source
  • 「ユーザー情報」
    タイトル: User Information

    このオブジェクトには、取得の指定ユーザーに関する情報が含まれます。

    モデルは、このオブジェクトを使用して、ユーザーと他のオブジェクトの関係を示します。 たとえば、APIのモデルでは、ユーザー・オブジェクトである属性updatedByを定義できます。 これは、そのユーザーが最後に更新されたことを示します。

ネストされたスキーマ : procedure
型: object

取得が現在バッチを処理している場合、このオブジェクトにはバッチ処理を制御するプロシージャが含まれます。

すべてに一致
Show Source
ネストされたスキーマ : step
型: object

取得が現在バッチを処理している場合、このオブジェクトには、バッチが進行中の現在の処理ステップが含まれます。

すべてに一致
Show Source
ネストされたスキーマ : プロシージャの取得
型: object
タイトル: Capture Procedure

取得プロシージャでは、フローのメタデータおよび進捗ステップを定義します。

Show Source
ネストされたスキーマ : プロシージャ・ステップ
型: object
タイトル: Procedure Step

プロシージャ・フロー内のステップ。

Show Source
  • プロシージャ内のステップの一意の識別子。

  • 作成時にステップに指定された名前。 たとえば、処理ジョブまたはコミット・プロファイルの名前。

  • ステップのタイプ。 次に例を示します: 外部プロセッサ, TIFF換算プロセッサ, アセット参照プロセッサ, etc.

400レスポンス

不正リクエスト

情報が欠落しているか無効であるため(入力フィールドでの検証エラー、必須値の欠落など)、リクエストを処理できませんでした。 レスポンスは「エラーの詳細」オブジェクトになります。

500レスポンス

内部サーバー・エラー

サーバーで予期しない状態が発生し、リクエストを処理できませんでした。 レスポンスは「エラーの詳細」オブジェクトになります。

トップに戻る