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

> Selecciona y bloquea la tarea con mayor prioridad en los IDs de etapa indicados con el método GetTaskByStageId de la API de servicios web de ABBYY FlexiCapture y devuelve su ID.

<div id="what-it-does">
  ## Qué hace
</div>

Selecciona la tarea de mayor prioridad y la abre para procesarla. La tarea seleccionada queda bloqueada (es decir, otros usuarios no pueden abrirla).

<Warning>
  Es necesario abrir una tarea antes de realizar cualquier acción en ella.
</Warning>

<div id="definition">
  ## Definición
</div>

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

<div id="parameters">
  ## Parámetros
</div>

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

      <td>
        <p>
          <strong>Tipo</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>Descripción</strong>
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>El ID de la conexión con Application Server</p>
      </td>
    </tr>

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

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

      <td>
        <p>ID del proyecto</p>
      </td>
    </tr>

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

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

      <td>
        <p>Los ID de las etapas de las que se obtiene la tarea</p>
      </td>
    </tr>

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

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

      <td>
        <p>El indicador que determina entre qué tareas se debe seleccionar. Valores posibles:</p>

        <ul>
          <li>
            <strong>True</strong> - seleccionar solo tareas preprocesadas;
          </li>

          <li>
            <strong>False</strong> - seleccionar entre todas las tareas.
          </li>
        </ul>
      </td>
    </tr>

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

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

      <td>
        <p>El indicador que determina el conjunto de lotes disponibles. Valores posibles:</p>

        <ul>
          <li>
            <strong>True</strong> - solo están disponibles los lotes que pertenecen al usuario actual o a su grupo de usuarios;
          </li>

          <li>
            <strong>False</strong> - todos los lotes están disponibles.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="returned-value">
  ## Valor devuelto
</div>

| **Tipo** | **Descripción** |
| -------- | --------------- |
| int      | ID de tarea     |