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

# GetTaskByStageId

> Wählt und sperrt mit der Methode GetTaskByStageId der ABBYY FlexiCapture Web Services API die Aufgabe mit der höchsten Priorität für die angegebenen Stufen-IDs und gibt deren ID zurück.

<div id="what-it-does">
  ## Was es tut
</div>

Wählt die Aufgabe mit der höchsten Priorität aus und öffnet sie zur Bearbeitung. Die ausgewählte Aufgabe wird gesperrt (d. h., sie kann nicht von anderen Benutzern geöffnet werden).

<Warning>
  Eine Aufgabe muss geöffnet sein, bevor Aktionen für sie ausgeführt werden können.
</Warning>

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

```
int GetTaskByStageId( int sessionId, int projectId, int[] stageIds, bool onlyPreprocessedTasks, bool onlyPrivateBatches );
```

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

<table width="100%">
  <tbody>
    <tr>
      <td>
        <p>
          <strong>Name</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Typ</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Beschreibung</strong>
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>sessionId</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Die ID der Verbindung zum Application Server</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>projectId</p>
      </td>

      <td>
        <p>int</p>
      </td>

      <td>
        <p>Projekt-ID</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>stageIds</p>
      </td>

      <td>
        <p>int\[]</p>
      </td>

      <td>
        <p>Die IDs der Stufen, aus denen Aufgaben abgerufen werden sollen</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>onlyPreprocessedTask</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Dieses Flag legt fest, aus welchen Aufgaben ausgewählt wird. Mögliche Werte:</p>

        <ul>
          <li>
            <strong>True</strong> - nur vorverarbeitete Aufgaben auswählen;
          </li>

          <li>
            <strong>False</strong> - aus allen Aufgaben auswählen.
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p>onlyPrivateBatches</p>
      </td>

      <td>
        <p>bool</p>
      </td>

      <td>
        <p>Dieses Flag legt fest, welche Batches verfügbar sind. Mögliche Werte:</p>

        <ul>
          <li>
            <strong>True</strong> - nur Batches, die dem aktuellen Benutzer oder der aktuellen Benutzergruppe gehören, sind verfügbar;
          </li>

          <li>
            <strong>False</strong> - alle Batches sind verfügbar.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

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

| **Typ** | **Beschreibung** |
| ------- | ---------------- |
| int     | Aufgaben-ID      |