Eine Liste von Vorgängen abrufen

Eine Liste aller aktiven oder abgeschlossenen Vorgänge kann verwendet werden, um:

Aktive Vorgänge zu verfolgen, die sich derzeit in der Phase der manuellen Überprüfung befinden.
Einen Link zur manuellen Überprüfung für aktive Vorgänge zu erhalten.
Die Ergebnisdateien abgeschlossener Vorgänge herunterzuladen.

Sie können eine Liste von Vorgängen mit ihren Kennungen mithilfe der Vantage-API abrufen. Sie können den Skill Monitor verwenden, um erweiterte Filter anzuwenden.

Liste der aktiven Vorgänge

Um eine Liste der aktiven Vorgänge zu erhalten, senden Sie eine GET-Anfrage an die Ressource transactions/active. Geben Sie im Anforderungstext die folgenden Parameter an:

Parameter	Beschreibung
StageType	Die Phase des Vorgangs. Mögliche Werte sind: - ManuaReview - CustomActivity - Automatic (alle Phasen, in denen der Benutzer nicht erforderlich ist, zum Beispiel beim Extrahieren von Feldern)
StageName	Der Name der konkreten Aktion (nur für die Phase ManualReview).
SkillId	Die Skill-ID. Wenn kein Wert angegeben wird, werden alle verfügbaren Skills berücksichtigt.
SkillVersion	Die Skill-Version. Wenn kein Wert angegeben wird, werden alle Versionen der verfügbaren Skills berücksichtigt.
StartDate	Die Erstellungszeit des frühesten Vorgangs (muss im UTC-Format angegeben werden).
EndDate	Die Erstellungszeit des letzten Vorgangs (muss im UTC-Format angegeben werden). Wenn dieser Wert nicht angegeben wird, wird stattdessen die aktuelle UTC-Zeit verwendet.
TransactionParameters	Die Liste der Vorgangsparameter, bestehend aus Zeichenkettenpaaren von Schlüssel und Wert. Diese Parameter liefern zusätzliche Informationen über den Benutzer (zum Beispiel den Kundennamen). Parameter müssen im folgenden Format angegeben werden: `TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}`
DocumentParameters	Die Liste der Dokumentparameter, bestehend aus Zeichenkettenpaaren von Schlüssel und Wert. Diese Parameter liefern zusätzliche Informationen zum Dokument (zum Beispiel den Dateinamen). Parameter müssen im folgenden Format angegeben werden: `DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}`
Offset	Der Paginierungs-Offset. Der Standardwert des Parameters ist 0.
Limit	Das Paginierungslimit. Der Parameter ist erforderlich. Der Standardwert des Parameters ist 0.

Beispielanforderung: Die Antwort auf eine Anfrage mit einer angegebenen Skill-ID wird eine JSON-Datei enthalten, die in etwa wie folgt aussieht:

{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review",
      "seqId": 13758,
      "transactionId": "56a50415-fe1d-4493-81ba-97ff07e3ffce",
      "createTimeUtc": "2023-09-11T13:53:30.633Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "skillId": "workspace.default.processing",
      "skillVersion": 18,
      "documentCount": 1
    }
  ],
  "totalItemCount": 7
}

Die Antwort auf eine Anfrage mit angegebener Phase und Aktion wird eine JSON-Datei mit allen aktiven Vorgängen enthalten, die in etwa wie folgt aussieht:

{
  "items": [
    {
      "stage": "ManualReview",
      "stageName": "Review2",
      "seqId": 13852,
      "transactionId": "e646754e-d854-4b21-af91-58cb63ead7a6",
      "createTimeUtc": "2023-09-11T14:04:37.97Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 2
}

Sie können auch einen Link zum Manual-Review-Client für aktuell aktive Vorgänge abrufen. Senden Sie dazu eine GET-Anfrage an die Ressource transactions/<transaction_id> mit dem Vorgangsbezeichner in der Anforderungs-URI. Beispielanfrage: Die Antwort enthält in etwa folgenden Code: Der Schlüssel manualReviewLink enthält einen Link zur Weboberfläche des Manual-Review-Clients sowie ein Vantage-Zugriffstoken, falls eine Manuelle Überprüfung erforderlich ist. Dieser Link und das Token können verwendet werden, um die Klassifizierungs- und Feldextraktionsergebnisse eines bestimmten Vorgangs zu überprüfen und zu korrigieren. Der bereitgestellte Link ist 168 Stunden lang gültig. Danach sollte ein neuer Link erstellt und für einen weiteren Zeitraum von 168 Stunden mit derselben Methode abgerufen werden. Weitere Informationen finden Sie unter Integration der manuellen Überprüfung.

Benutzer, die über diesen Link autorisiert wurden, können keine anderen Dokumente oder Vorgänge anzeigen oder ändern.

Liste der abgeschlossenen Vorgänge

Um eine Liste der abgeschlossenen Vorgänge abzurufen, senden Sie eine GET-Anfrage an die Ressource transactions/completed. Geben Sie im Request-Body die Parameter an:

Parameter	Beschreibung
TransactionStatus	Der Status des Vorgangs. Mögliche Werte sind: - Processed - Canceled - Failed
SkillId	Die Skill-Kennung. Wenn kein Wert angegeben ist, werden alle verfügbaren Skills berücksichtigt.
SkillVersion	Die Skill-Version. Wenn kein Wert angegeben ist, werden alle Versionen der verfügbaren Skills berücksichtigt.
StartDate	Die Erstellungszeit des frühesten Vorgangs (muss im UTC-Format angegeben werden).
EndDate	Die Erstellungszeit des letzten Vorgangs (muss im UTC-Format angegeben werden). Wenn dieser Wert nicht angegeben ist, wird stattdessen die aktuelle UTC-Zeit verwendet.
TransactionParameters	Die Liste der Vorgangsparameter, bestehend aus Schlüssel-Wert-Paaren vom Typ string. Diese Parameter liefern zusätzliche Benutzerinformationen (z. B. den Kundennamen). Die Parameter müssen im folgenden Format angegeben werden: `TransactionParameters={“key”: “string_1”,”value”:”string”}&TransactionParameters={“key”: “string_2”,”value”:”string”}`
DocumentParameters	Die Liste der Dokumentparameter, bestehend aus Schlüssel-Wert-Paaren vom Typ string. Diese Parameter liefern zusätzliche Dokumentinformationen (z. B. den Dateinamen). Die Parameter müssen im folgenden Format angegeben werden: `DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}`
Offset	Der Paginierungs-Offset. Der Standardwert des Parameters ist 0.
Limit	Das Paginierungslimit. Der Parameter ist erforderlich. Der Standardwert des Parameters ist 0.

Die Antwort enthält eine JSON-Datei mit allen abgeschlossenen Vorgängen und einer Anzahl verarbeiteter Seiten, ähnlich wie im folgenden Beispiel:

{
  "items": [
    {
      "status": "FinishedSuccessfully",
      "pageCount": 1,
      "seqId": 13705,
      "transactionId": "fc9920fe-f788-47f8-9972-b767493faed9",
      "createTimeUtc": "2023-09-11T13:47:50.273Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "App",
          "value": "PublicAPI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "string",
          "value": "string"
        },
        {
          "isReadOnly": true,
          "key": "Index",
          "value": "0"
        },
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "BillofLading_1.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "PublicAPI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 29842,
      "transactionId": "c0dd3e08-f295-4c6c-b919-31eaa67817cc",
      "createTimeUtc": "2023-09-12T19:28:01.27Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36254,
      "transactionId": "8391871e-abf5-41bc-8a66-1059418a3843",
      "createTimeUtc": "2023-09-13T08:53:41.9Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed _1_.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36632,
      "transactionId": "7f7cd557-a03e-42e3-a454-e7981e8e9fc0",
      "createTimeUtc": "2023-09-13T09:35:27.48Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    },
    {
      "status": "FinishedSuccessfully",
      "pageCount": 2,
      "seqId": 36663,
      "transactionId": "c9b3cd4d-d90f-48be-adc2-99985ece4e11",
      "createTimeUtc": "2023-09-13T09:38:29.573Z",
      "transactionParameters": [
        {
          "isReadOnly": true,
          "key": "App",
          "value": "VantageUI"
        }
      ],
      "fileParameters": [
        {
          "isReadOnly": true,
          "key": "SourceFileName",
          "value": "Invoice _ 1213123123 _2__signed_signed _1__signed.pdf"
        },
        {
          "isReadOnly": true,
          "key": "SourceType",
          "value": "VantageUI"
        }
      ],
      "documentCount": 1
    }
  ],
  "totalItemCount": 5
}

​Liste der aktiven Vorgänge

​Liste der abgeschlossenen Vorgänge

Liste der aktiven Vorgänge

Liste der abgeschlossenen Vorgänge