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

> Sélectionne et verrouille la tâche de plus haute priorité pour les ID d’étape spécifiés à l’aide de la méthode GetTaskByStageId de l’API Web Services ABBYY FlexiCapture, puis renvoie son ID.

<div id="what-it-does">
  ## Ce qu’elle fait
</div>

Sélectionne la tâche ayant la priorité la plus élevée et l’ouvre pour traitement. La tâche sélectionnée est verrouillée (c’est-à-dire qu’elle ne peut pas être ouverte par d’autres utilisateurs).

<Warning>
  Une tâche doit être ouverte avant que des actions puissent être effectuées sur celle-ci.
</Warning>

<div id="definition">
  ## Définition
</div>

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

<div id="parameters">
  ## Paramètres
</div>

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

      <td>
        <p>
          <strong>Type</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Description</strong>
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>ID de la connexion à l’Application Server</p>
      </td>
    </tr>

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

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

      <td>
        <p>ID du projet</p>
      </td>
    </tr>

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

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

      <td>
        <p>ID des étapes à partir desquelles récupérer une tâche</p>
      </td>
    </tr>

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

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

      <td>
        <p>L’indicateur qui détermine parmi quelles tâches effectuer la sélection. Valeurs possibles :</p>

        <ul>
          <li>
            <strong>True</strong> - sélectionner uniquement les tâches prétraitées ;
          </li>

          <li>
            <strong>False</strong> - sélectionner parmi toutes les tâches.
          </li>
        </ul>
      </td>
    </tr>

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

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

      <td>
        <p>L’indicateur qui détermine l’ensemble des lots disponibles. Valeurs possibles :</p>

        <ul>
          <li>
            <strong>True</strong> - seuls les lots appartenant à l’utilisateur actuel ou à son groupe sont disponibles ;
          </li>

          <li>
            <strong>False</strong> - tous les lots sont disponibles.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="returned-value">
  ## Valeur renvoyée
</div>

| **Type** | **Description** |
| -------- | --------------- |
| int      | ID de la tâche  |