Conexión OData¶

Introducción¶

Una conexión OData, creada mediante el conector OData, establece acceso a OData extremos. Una vez configurada una conexión, puede crear instancias de actividades OData asociadas con esa conexión para usarlas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o Editar una Conexión OData¶

Se crea una nueva conexión OData utilizando el conector OData desde una de estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La página Conexiones globales (vea Crear un extremo global en Conexiones globales).

Se puede editar una conexión OData existente desde estas ubicaciones:

• La pestaña extremos y conectores del proyecto de la paleta de componentes de diseño (consulte paleta de componentes de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).
• La página Conexiones globales (vea Editar un extremo global en Conexiones globales).

Configurar una Conexión OData¶

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión OData.

• Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión OData y no debe contener barras diagonales (/) o dos puntos (:). Este nombre también se utiliza para identificar el extremo de OData, que hace referencia tanto a una conexión específica como a sus actividades.

• URL de metadatos de OData: Ingrese el extremo de OData $metadata URL.

• Autenticación: Seleccione el método de autenticación, uno de Sin autenticación, Autenticación básica o OAuth2:

  • Sin autenticación: El acceso al extremo de OData es anónimo sin autorización.

  • Autenticación básica: Amplía las opciones de configuración adicionales donde especifica un nombre de usuario y una contraseña para usar en la autorización básica:

    

    • Nombre de usuario: Ingrese un nombre de usuario válido.

    • Contraseña: Ingrese una contraseña válida.

  • OAuth2: Amplía opciones adicionales para configurar OAuth 2.0:

    

    • Tipos de concesión: Seleccione Credenciales de cliente o Concesión de contraseña como el tipo de concesión para la autenticación OAuth. Credenciales de cliente está seleccionado de manera predeterminada, pero los usuarios pueden especificar un Nombre de usuario y una Contraseña adicionales si se selecciona Concesión de contraseña.

    • Extremo del token OAuth: Ingrese el extremo del token OAuth.

    • ID de cliente: Ingrese el ID de cliente.

    • Secreto del cliente: Ingrese el secreto del cliente.

    • Nombre de usuario: Ingrese un nombre de usuario válido. Visible solo si el Tipo de concesión está configurado en Concesión de contraseña.

    • Contraseña: Ingrese una contraseña válida. Visible solo si el Tipo de concesión está configurado en Concesión de contraseña.

    • Alcance: Ingrese el alcance.

    • Tipo de token: Ingrese el tipo de token.

    • Autenticación del cliente: Seleccione el método por el cual se envía la autenticación del cliente en la solicitud. La autenticación se puede enviar como Enviar como encabezado de autenticación básica o Enviar credenciales del cliente en el cuerpo.

• Propiedades HTTP avanzadas: Defina los encabezados HTTP para la conexión. El protocolo OData acepta encabezados HTTP estándar definidos en Rfc 2616 (artículo 14) así como cualquier encabezado personalizado específico del extremo. Haga clic en el ícono Agregar para agregar un encabezado a la tabla a continuación e ingresar un par clave-valor para cada parámetro de solicitud.

  Para guardar la fila, haga clic en el ícono de envío en la columna más a la derecha.

  Para editar o eliminar una sola fila, pase el cursor sobre la columna más a la derecha y use el ícono de edición o eliminar icono .

  Para eliminar todas las filas, haga clic en Borrar todo.

  Nota

  Se deben configurar encabezados personalizados en el extremo para que este los acepte como parte de esta solicitud. Si está utilizando Microsoft Azure para administrar su extremo de OData, consulte la documentación de Microsoft sobre Encabezados personalizados en Acceso a Extremos que requieren autenticación.

  Importante

  Los campos de la tabla Propiedades HTTP avanzadas muestran el ícono de variable solo en modo de edición. Para que los valores de las variables de estos campos se completen en tiempo de ejecución, la versión del agente debe ser al menos 10.75 / 11.13.

• Prueba: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, los agentes del grupo de agentes asociado con el ambiente actual descargan la última versión del conector. Este conector admite la suspensión de la descarga de la última versión del conector mediante la política de la organización Deshabilitar actualización automática del conector.

• Guardar cambios: Haga clic para guardar y cerrar la configuración de conexión.

• Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le solicitará que confirme que desea descartar los cambios.

• Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje te pedirá que confirmes que deseas eliminar la conexión.

Próximos Pasos¶

Después de crear una conexión OData, coloque un tipo de actividad en el tela de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones del menú de una conexión y sus tipos de actividad desde el panel de proyecto y la paleta de componentes de diseño. Para obtener más información, consulte Menús de acciones en Conceptos básicos del conector.

Están disponibles estos tipos de actividades:

• Consulta: Consulta datos de objetos desde un extremo de OData y está destinado a usarse como fuente en una operación.

• Actualizar: Actualiza los datos del objeto en un extremo de OData y está destinado a usarse como destino en una operación.

• Insertar: Inserta datos de objeto en un extremo de OData y está destinado a ser utilizado como destino en una operación.

• Borrar: Elimina datos de objetos de un extremo de OData y está destinado a usarse como destino en una operación.