> ## 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.

# GetTaskByStageIdExt

> Die Methode GetTaskByStageIdExt in der ABBYY FlexiCapture Web Services API wählt anhand von Stufen-IDs die Aufgabe mit der höchsten Priorität aus und öffnet sie zur Verarbeitung.

<div id="what-it-does">
  ## Funktion
</div>

Wählt die Aufgabe mit der höchsten Priorität aus und öffnet sie zur Verarbeitung. Die ausgewählte Aufgabe wird gesperrt, was bedeutet, dass sie nicht von anderen Benutzern geöffnet werden kann. Die verfügbaren Batches können eingeschränkt werden.

<Info>
  Eine Aufgabe muss geöffnet werden, bevor darauf Aktionen ausgeführt werden können.
</Info>

<div id="definition">
  ## Definition
</div>

```csharp theme={null}
int GetTaskByStageIdExt(int sessionId, int projectId, int[] stageIds, bool onlyPreprocessedTask, bool onlyPrivateBatches);
```

<div id="parameters">
  ## Parameter
</div>

| Name                   | Typ     | Beschreibung                                                                                                                                                                                    |
| ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sessionId`            | `int`   | Die ID der Verbindung zum Application Server.                                                                                                                                                   |
| `projectId`            | `int`   | Project ID.                                                                                                                                                                                     |
| `stageIds`             | `int[]` | Die IDs der Verarbeitungsstufen, aus denen Aufgaben abgerufen werden.                                                                                                                           |
| `stageID_count`        | `int`   | Die Anzahl der Verarbeitungsstufen.                                                                                                                                                             |
| `onlyPreprocessedTask` | `bool`  | Ein Flag, das festlegt, aus welchen Aufgaben ausgewählt wird. `True` wählt nur vorverarbeitete Aufgaben aus. `False` wählt aus allen Aufgaben aus.                                              |
| `onlyPrivateBatches`   | `bool`  | Ein Flag, das die verfügbaren Batches festlegt. `True` macht nur Batches verfügbar, die dem aktuellen Benutzer bzw. der aktuellen Benutzergruppe gehören. `False` macht alle Batches verfügbar. |

<div id="returned-value">
  ## Rückgabewert
</div>

| Typ   | Beschreibung |
| ----- | ------------ |
| `int` | Aufgaben-ID. |