> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Eine Liste von Vorgängen abrufen

> Rufen Sie mit der ABBYY Vantage-API eine Liste aktiver oder abgeschlossener Vorgänge ab, um den Status der Manuellen Überprüfung zu verfolgen, Links zur manuellen Überprüfung abzurufen und Ergebnisdateien herunterzuladen.

export const VantageRegion = ({children}) => {
  const STORAGE_KEY = "abbyy.vantage.region";
  const REGIONS = [{
    code: "eu",
    label: "Europe"
  }, {
    code: "us",
    label: "North America"
  }, {
    code: "au",
    label: "Australia / Asia-Pacific"
  }];
  const [region, setRegion] = useState("eu");
  const [open, setOpen] = useState(false);
  const containerRef = useRef(null);
  const dropdownRef = useRef(null);
  function safeGetSavedRegion() {
    try {
      const saved = typeof window !== "undefined" ? window.localStorage.getItem(STORAGE_KEY) : null;
      const valid = new Set(REGIONS.map(r => r.code));
      return saved && valid.has(saved) ? saved : "eu";
    } catch {
      return "eu";
    }
  }
  function safeSetSavedRegion(code) {
    try {
      if (typeof window !== "undefined") {
        window.localStorage.setItem(STORAGE_KEY, code);
      }
    } catch {}
  }
  function dispatchRegionChanged(code) {
    try {
      if (typeof window !== "undefined") {
        window.dispatchEvent(new CustomEvent("abbyy:region-changed", {
          detail: {
            code
          }
        }));
      }
    } catch {}
  }
  function replaceRegionInString(text, currentRegion) {
    if (typeof text !== "string") return text;
    const hostRegex = /https:\/\/vantage-(eu|us|au)\.abbyy\.com/gi;
    const tokenRegex = /https:\/\/vantage-\[region\]\.abbyy\.com/gi;
    const bareHostRegex = /vantage-(eu|us|au)\.abbyy\.com/gi;
    const bareTokenRegex = /vantage-\[region\]\.abbyy\.com/gi;
    return text.replace(hostRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(tokenRegex, `https://vantage-${currentRegion}.abbyy.com`).replace(bareHostRegex, `vantage-${currentRegion}.abbyy.com`).replace(bareTokenRegex, `vantage-${currentRegion}.abbyy.com`);
  }
  useEffect(() => {
    setRegion(safeGetSavedRegion());
  }, []);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      const href = a.getAttribute("href");
      if (href) {
        const next = replaceRegionInString(href, region);
        if (next !== href) {
          a.setAttribute("href", next);
        }
      }
    });
    const walker = typeof document !== "undefined" ? document.createTreeWalker(root, NodeFilter.SHOW_TEXT, null) : null;
    if (walker) {
      const toUpdate = [];
      let node = walker.nextNode();
      while (node) {
        const updated = replaceRegionInString(node.nodeValue, region);
        if (updated !== node.nodeValue) {
          toUpdate.push([node, updated]);
        }
        node = walker.nextNode();
      }
      toUpdate.forEach(([textNode, value]) => {
        textNode.nodeValue = value;
      });
    }
  }, [region, children]);
  useEffect(() => {
    const root = containerRef.current;
    if (!root) return;
    const anchors = root.querySelectorAll("a[href]");
    anchors.forEach(a => {
      a.style.fontWeight = "600";
      a.style.textDecoration = "underline";
      a.style.textUnderlineOffset = "2px";
    });
  }, [region, children]);
  useEffect(() => {
    const onRegionChanged = evt => {
      const code = evt && evt.detail && evt.detail.code;
      if (!code || code === region) return;
      setRegion(code);
    };
    if (typeof window !== "undefined") {
      window.addEventListener("abbyy:region-changed", onRegionChanged);
    }
    return () => {
      if (typeof window !== "undefined") {
        window.removeEventListener("abbyy:region-changed", onRegionChanged);
      }
    };
  }, [region]);
  useEffect(() => {
    const onClickAway = e => {
      if (!dropdownRef.current) return;
      if (!dropdownRef.current.contains(e.target)) {
        setOpen(false);
      }
    };
    document.addEventListener("click", onClickAway, true);
    return () => document.removeEventListener("click", onClickAway, true);
  }, []);
  const onSelect = code => {
    setRegion(code);
    safeSetSavedRegion(code);
    dispatchRegionChanged(code);
    setOpen(false);
  };
  const current = REGIONS.find(r => r.code === region) || REGIONS[0];
  return <div className="not-prose">
      <div className="mb-4 inline-flex items-center gap-2" ref={dropdownRef}>
        <span className="text-sm text-zinc-950/80 dark:text-white/80">Tenant Region:</span>
        <div className="relative">
          <button type="button" aria-haspopup="listbox" aria-expanded={open ? "true" : "false"} onClick={() => setOpen(v => !v)} className="h-8 px-3 rounded-md bg-zinc-900/5 dark:bg-white/5 border border-zinc-950/20 dark:border-white/20 text-sm inline-flex items-center gap-2">
            <span className="text-zinc-950 dark:text-white">{current.label}</span>
            <svg width="8" height="24" viewBox="0 -9 3 24" className="transition-transform text-gray-400 overflow-visible dark:text-gray-600 ml-auto" style={{
    transform: open ? "rotate(270deg)" : "rotate(90deg)"
  }}>
              <path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round"></path>
            </svg>
          </button>
          {open ? <div role="listbox" className="absolute z-50 left-full top-0 ml-2 w-56 rounded-xl border border-zinc-950/20 dark:border-white/20 bg-white dark:bg-zinc-900 shadow-lg p-2">
              {REGIONS.map(r => {
    const selected = r.code === region;
    return <button key={r.code} type="button" role="option" aria-selected={selected ? "true" : "false"} onClick={() => onSelect(r.code)} className={"w-full flex items-center justify-between px-3 py-2 rounded-lg text-sm hover:bg-zinc-950/5 dark:hover:bg-white/10 text-zinc-950 dark:text-white" + (selected ? " font-medium" : "")}>
                    <span style={selected ? {
      color: "#ff2038"
    } : undefined}>{r.label}</span>
                    <span className={selected ? "ml-3" : "ml-3 invisible"} style={selected ? {
      color: "#ff2038"
    } : undefined}>✓</span>
                  </button>;
  })}
            </div> : null}
        </div>
      </div>
      <div ref={containerRef} className="prose dark:prose-invert max-w-none">{children}</div>
    </div>;
};

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](/de/vantage/documentation/runtime/skill-monitor/skill-monitor) verwenden, um erweiterte Filter anzuwenden.

<div id="list-of-active-transactions">
  ### Liste der aktiven Vorgänge
</div>

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.<br />Mögliche Werte sind:<br />- ManuaReview<br />- CustomActivity<br />- 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.<br />Wenn kein Wert angegeben wird, werden alle verfügbaren Skills berücksichtigt.                                                                                                                                                                                                                                                                                   |
| SkillVersion          | Die Skill-Version.<br />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).<br />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).<br />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).<br />Parameter müssen im folgenden Format angegeben werden: `DocumentParameters={“key”: “string_1”,”value”:”string”}&DocumentParameters={“key”: “string_2”,”value”:”string”}`             |
| Offset                | Der Paginierungs-Offset.<br />Der Standardwert des Parameters ist **0**.                                                                                                                                                                                                                                                                                                           |
| Limit                 | Das Paginierungslimit. Der Parameter ist erforderlich.<br />Der Standardwert des Parameters ist **0**.                                                                                                                                                                                                                                                                             |

Beispielanforderung:

<VantageRegion>
  ```shell theme={null}
  curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/active"
  -H "Authorization: Bearer token"
  ```
</VantageRegion>

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

```json expandable theme={null}
{
  "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:

```json expandable theme={null}
{
  "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:

<VantageRegion>
  ```shell theme={null}
  curl -X GET "https://vantage-eu.abbyy.com/api/publicapi/v1/transactions/transaction-id" \
    -H "Authorization: Bearer token"
  ```
</VantageRegion>

Die Antwort enthält in etwa folgenden Code:

<VantageRegion>
  ```json theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "status": "Processing",
    "manualReviewLink": "https://vantage-eu.abbyy.com/api/publicapi/v1/verify?documentIds=9838448d-72ae-4e9a-b071-2bb16f732e46",
    "sourceFiles": [
      {
        "id": "7b2eed6f-3fdd-43b9-a178-7211d0a8d5bb",
        "name": "Invoice07.JPG"
      }
    ]
  }
  ```
</VantageRegion>

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](/de/vantage/developer/integrating-manual-review).

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

<div id="list-of-completed-transactions">
  ### Liste der abgeschlossenen Vorgänge
</div>

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.<br />Mögliche Werte sind:<br />- Processed<br />- Canceled<br />- Failed                                                                                                                                                                                                                                                               |
| SkillId               | Die Skill-Kennung.<br />Wenn kein Wert angegeben ist, werden alle verfügbaren Skills berücksichtigt.                                                                                                                                                                                                                                                            |
| SkillVersion          | Die Skill-Version.<br />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).<br />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).<br />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).<br />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.<br />Der Standardwert des Parameters ist **0**.                                                                                                                                                                                                                                                                                        |
| Limit                 | Das Paginierungslimit. Der Parameter ist erforderlich.<br />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:

```json expandable theme={null}
{
  "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
}
```