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

# Actividad Vantage Scope

> La actividad Vantage Scope transmite la configuración de conexión de ABBYY Vantage, la configuración del proxy y la configuración del cliente de API pública a las actividades anidadas del conector de UiPath.

**Vantage Scope** es el contenedor dentro del que deben encontrarse todas las demás actividades del conector de UiPath — Use Skill, Get Results y Map Fields se ejecutan anidadas dentro de un Scope. El Scope contiene las credenciales, la configuración del proxy y la configuración del cliente de API pública que comparten las actividades anidadas, por lo que la configuración de la conexión se realiza una sola vez por flujo de trabajo.

<Warning>
  La actividad Vantage Scope le permite configurar la autenticación mediante Resource Owner Password Credentials Flow y Client Credentials Flow. Si configura un proveedor de identidad externo en Vantage, el único flujo de autenticación que funcionará será Client Credentials Flow.
</Warning>

Para obtener más información, consulte:

<CardGroup cols={3}>
  <Card title="Proveedor de identidad externo" icon="user-shield" href="/es/vantage/documentation/tenant-admin/tenant-management/external-identity-provider">
    Configure el inicio de sesión único mediante un proveedor de identidad OAuth 2.0 o SAML 2.0 para su tenant de Vantage.
  </Card>

  <Card title="cliente de API pública" icon="key" href="/es/vantage/documentation/tenant-admin/tenant-management/configure-client">
    Cree y configure un cliente de API pública para autenticarse en la Vantage API.
  </Card>

  <Card title="Autenticación" icon="shield-check" href="/es/vantage/developer/authentication/authentication">
    Elija un flujo de OAuth 2.0 y obtenga un token de acceso.
  </Card>
</CardGroup>

<div id="activity-properties">
  ## Propiedades de la actividad
</div>

<div id="connection-settings">
  ### Configuración de conexión
</div>

| Propiedad                         | Tipo                                  | Descripción                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------------- | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tipo de concesión de autorización | `IEnumerable<AuthorizationGrantType>` | El tipo de concesión que se utiliza para la autorización: `ResourceOwnerPassword` o `ClientCredentials`.                                                                                                                                                                                                                                                                                          |
| Contraseña                        | `String`                              | La contraseña utilizada para conectarse a ABBYY Vantage.                                                                                                                                                                                                                                                                                                                                          |
| Contraseña segura                 | `SecureString`                        | La contraseña segura utilizada para conectarse a ABBYY Vantage.                                                                                                                                                                                                                                                                                                                                   |
| URL del servidor                  | `String`                              | La dirección del servidor de ABBYY Vantage.                                                                                                                                                                                                                                                                                                                                                       |
| Tenant                            | `String`                              | El nombre del tenant de ABBYY Vantage o el identificador del tenant. Esta propiedad solo es necesaria si el usuario cuyas credenciales se utilizan para conectarse al servidor de ABBYY Vantage está registrado en varios tenants (más de uno) en el servidor. El nombre del tenant puede encontrarse en la página de inicio de sesión de Vantage en el navegador cuando introduce su contraseña. |
| Nombre de usuario                 | `String`                              | La dirección de correo electrónico del usuario utilizada para conectarse a ABBYY Vantage.                                                                                                                                                                                                                                                                                                         |

<div id="proxy-settings-optional">
  ### Configuración del proxy (opcional)
</div>

| Propiedad         | Tipo           | Descripción                                                        |
| ----------------- | -------------- | ------------------------------------------------------------------ |
| Habilitar proxy   | `Boolean`      | Permite usar un servidor proxy para enrutar solicitudes HTTP.      |
| URL del servidor  | `String`       | La dirección del servidor proxy (p. ej., `http://127.0.0.1:8080`). |
| Nombre de usuario | `String`       | El nombre de usuario que se usa para conectarse al servidor proxy. |
| Contraseña        | `String`       | La contraseña que se usa para conectarse al servidor proxy.        |
| Contraseña segura | `SecureString` | La contraseña segura que se usa para conectarse al servidor proxy. |

<div id="public-api-client-settings-optional">
  ### Configuración del cliente de API pública (opcional)
</div>

| Propiedad                 | Tipo           | Descripción                                                  |
| ------------------------- | -------------- | ------------------------------------------------------------ |
| ID de cliente             | `String`       | Identificador de la aplicación de Vantage.                   |
| Secreto de cliente        | `String`       | Clave segura de la aplicación de Vantage.                    |
| Secreto de cliente seguro | `SecureString` | Clave segura de la aplicación de Vantage como cadena segura. |

<div id="manage-credentials">
  ### Administrar credenciales
</div>

La contraseña del usuario de Vantage, la contraseña del proxy y el secreto de cliente en la configuración del cliente pueden establecerse en la actividad Scope, ya sea en un parámetro de cadena o en el parámetro correspondiente de tipo `SecureString`.

Una contraseña de tipo `String` se almacena como texto sin formato en el archivo de proyecto XAML y no es segura. Se recomienda usar una contraseña `String` solo al configurar las actividades **Use Skill** y **Map Fields** para obtener una lista de skills, o para depurar el proceso de UiPath. Una vez que el proceso esté completamente configurado:

* Si usa Resource Owner Password Credentials Flow, quite la propiedad **contraseña** de la actividad Vantage Scope y configure la propiedad **contraseña segura**.
* Si usa Client Credentials Flow, quite la propiedad **secreto de cliente** de la actividad Vantage Scope y configure la propiedad **secreto de cliente seguro**.

Recomendamos almacenar las credenciales en [assets de UiPath Orchestrator](https://docs.uipath.com/orchestrator/docs/about-assets). Use la actividad **Get Credential** para recuperar la contraseña de Orchestrator y pasarla a la actividad Vantage Scope mediante una variable.

<Warning>
  Debe usarse el mismo tipo de contraseña para la Configuración de conexión, la Configuración del proxy y la Configuración del cliente.
</Warning>

<div id="configure-the-vantage-public-api-client">
  ### Configurar el cliente de Vantage Public API
</div>

Cuando cree un cliente en ABBYY Vantage, configure lo siguiente en la sección **OAuth 2.0 Flows Settings** de la configuración del cliente, según el tipo de concesión que utilice:

| Flujo de autorización                    | Configuración del cliente OAuth 2.0 que debe habilitarse                                                                                                             |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Resource Owner Password Credentials Flow | **Allow Resource Owner Password Credentials Flow**                                                                                                                   |
| Client Credentials Flow                  | **Allow issuing refresh tokens to refresh access tokens**, **Allow client credentials flow**, además de los roles necesarios seleccionados mediante **Manage Roles** |

<Warning>
  Si selecciona uno o varios roles asociados a skills mediante **Manage Roles**, seleccione también las skills permitidas para esos roles.
</Warning>

Para obtener más información sobre los roles de ABBYY Vantage, consulte [Control de acceso basado en roles](/es/vantage/documentation/tenant-admin/tenant-management/role-based-access).

<div id="fill-in-the-activity-fields">
  ### Complete los campos de la actividad
</div>

<Note>
  Si todas las propiedades de la Configuración del cliente de Vantage Public API están vacías, se usa el cliente predeterminado de ABBYY Vantage.
</Note>

<Tabs>
  <Tab title="Resource Owner Password Credentials Flow">
    Campos que deben completarse para este flujo:

    <Frame>
      <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/scope-ropc.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=22e34d947174db96d438b1fa57c1cac5" alt="Campos de la actividad Vantage Scope para Resource Owner Password Credentials Flow" width="1038" height="1006" data-path="images/vantage/developer/connectors/uipath/scope-ropc.jpg" />
    </Frame>
  </Tab>

  <Tab title="Client Credentials Flow">
    Campos que deben completarse para este flujo:

    <Frame>
      <img src="https://mintcdn.com/abbyy/Km9nwnkPeY8_wARd/images/vantage/developer/connectors/uipath/scope-cc.jpg?fit=max&auto=format&n=Km9nwnkPeY8_wARd&q=85&s=7bd045b77f4c7f3629a27e86cf32ee6b" alt="Campos de la actividad Vantage Scope para Client Credentials Flow" width="1044" height="1030" data-path="images/vantage/developer/connectors/uipath/scope-cc.jpg" />
    </Frame>
  </Tab>
</Tabs>

<div id="configure-proxy-settings">
  ## Configurar el proxy
</div>

Puede configurar las solicitudes del conector en tiempo de ejecución para que pasen por un servidor proxy. Se admiten los siguientes tipos de autenticación de proxy: Basic, NTLM, autenticación por IP y proxy transparente.

Para usar un proxy, seleccione la actividad **Vantage Scope**. En el grupo de propiedades **Configuración del proxy (opcional)**, establezca el valor de la propiedad **Habilitar proxy** en `"true"` y, a continuación, especifique la dirección de su servidor proxy en la propiedad **URL del servidor**.

<Tabs>
  <Tab title="Autenticación Basic">
    Si usa autenticación Basic, en las propiedades **Nombre de usuario** y **Contraseña / Contraseña segura**, especifique las credenciales de conexión del proxy.
  </Tab>

  <Tab title="Autenticación NTLM">
    Si usa autenticación NTLM, los campos **Nombre de usuario** y **Contraseña** son opcionales. Si los campos **Nombre de usuario** y **Contraseña** están vacíos, se usarán las credenciales del usuario con el que se está ejecutando el proceso de UiPath.
  </Tab>
</Tabs>

<div id="related-topics">
  ## Temas relacionados
</div>

<CardGroup cols={3}>
  <Card title="Actividad Use Skill" icon="play" href="/es/vantage/connectors/uipath/activities/use-skill">
    Crear una transacción de ABBYY Vantage para procesar un documento con una skill.
  </Card>

  <Card title="Actividad Get Results" icon="circle-down" href="/es/vantage/connectors/uipath/activities/get-results">
    Recuperar los resultados del procesamiento de ABBYY Vantage.
  </Card>

  <Card title="Actividad Map Fields" icon="arrow-right-arrow-left" href="/es/vantage/connectors/uipath/activities/map-fields">
    Guardar los valores extraídos de los campos en variables de UiPath.
  </Card>
</CardGroup>
