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

# GetTask

> Wählen Sie mit der GetTask-Methode der ABBYY FlexiCapture Web Services API die Aufgabe mit der höchsten Priorität für einen Stufentyp aus und sperren Sie sie; dabei wird die Aufgabe-ID zurückgegeben.

<div id="what-it-does">
  ## Was es macht
</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).

<Note>
  Wenn keine geeignete Aufgabe vorhanden ist, wird „0“ zurückgegeben.
</Note>

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

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

```
int GetTask( int sessionId, int projectId, int stageType, bool onlyPreprocessedTask, 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>stageType</p>
      </td>

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

      <td>
        <p>
          Die ID des Stufentyps. Mögliche Werte finden Sie unter <a href="/de/flexi-capture/api/structures/t-processing-stage-type">ProcessingStage</a>.
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>Das Flag, das bestimmt, 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>Das Flag, das bestimmt, welche Batches verfügbar sind. Mögliche Werte:</p>

        <ul>
          <li>
            <strong>True</strong> - nur Batches, die dem aktuellen Benutzer oder seiner 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     | Aufgabe-ID       |