Servicio web de llamada a WS

La tarea del Servicio web de llamada a WS llama a un servicio web externo para procesar los pasos fuera de la ruta de tareas de Content Collector. Puede llamar a un servicio web externo, por ejemplo, para recuperar los datos de orígenes externos o para desencadenar acciones específicas.

El servicio web al que la tarea del Servicio web de llamada a WS tarea llama debe cumplir con los principios REST (Representational State Transferencia) y debe utilizar el formato JSON (JavaScript Object Notation) para la entrada y salida. El servicio web puede escribirse en cualquier lenguaje de programación o cliente que pueda procesar una solicitud HTTP o HTTPS. La tarea del Servicio web de llamada a WS envía cada llamada como una solicitud HTTP POST.
Importante: Cuando incluye llamadas a servicios web externos en la ruta de tareas recuerde que el rendimiento de los respectivos servicios web afecta al rendimiento de la ruta de tareas.

Resumen de la tarea

Tabla 1. Resumen de la tarea Servicio web de llamada a WS
Característica Valor
Nombre de tarea Servicio web de llamada a WS
Objetivo principal Llamar a un servicio web externo con datos de entrada específicos y almacenar la respuesta como metadatos
¿Con qué conectores de origen se utiliza? Conector de correo electrónico, Conector de origen del sistema de archivos, Conector IBM® Connections, Conector de SharePoint, Conector SMTP
¿Con qué conectores de destino se utiliza? Cualquier conector de destino
¿Cuándo se necesita? Opcional en cualquier ruta de tareas
Ubicación en la ruta de tareas Puede aparecer varias veces y en cualquier lugar de la ruta de tareas
¿Qué metadatos genera? Estado de tarea
Opciones de configuración

Valores de conexión

Proporcione la siguiente información:
  • Un URL válido para el servicio web al que se llama, con el formato http://nombre servidor:puerto/vía de acceso.

    Utilice el nombre de servidor completo. La dirección debe empezar por http:// o https:// y puede necesitar un número de puerto.

    Consejo: Utilice conexiones HTTPS para la comunicación segura entre Content Collector y el servicio web externo.
  • El ID de usuario y la contraseña de la cuenta de usuario que utiliza Content Collector para llamar al servicio web.

Opcionalmente, puede cambiar el valor de tiempo de espera del servicio web. Este valor se especifica en milisegundos y determina cuánto tiempo espera la tarea a que el servicio web devuelva un resultado. Si se supera el tiempo de espera especificado, el estado de la tarea del Servicio web de llamada a WS se establece en no satisfactorio. El valor predeterminado de tiempo de espera es de 1 segundo (1000 milisegundos).

Los códigos de estado HTTP distintos de 200 se consideran errores. El estado de la tarea también se establece en no satisfactorio. La respuesta HTTP se graba en la propiedad de metadatos Resultado de la tarea.

Correlación de los metadatos de la respuesta

Seleccione el origen de metadatos que se ha de llenar con los datos que devuelve el servicio web. El origen de los metadatos puede ser un origen de metadatos del sistema o un origen de metadatos definido por el usuario. El servicio web devuelve una estructura JSON que contiene el resultado para cada entidad.
Importante: Cuando configure la tarea Servicio web de llamada a WS, seleccione el origen de metadatos que se ha de rellenar por su nombre de visualización. Sin embargo, la correlación real se realiza utilizando los identificadores exclusivos del origen de metadatos y las propiedades de los metadatos. Para obtener el ID exclusivo de un origen de metadatos concreto o la propiedad, vaya a Metadatos y Listas en el Gestor de configuración y seleccione el tipo de metadatos que desea comprobar:
Metadatos definidos por el usuario
Seleccione un origen de metadatos. El campo ID de la sección General muestra el ID exclusivo para el origen de metadatos. Los ID de propiedad se visualizan en la lista Propiedades de metadatos.
Metadatos del sistema
Para ver los ID de todos los orígenes de metadatos instalados o de propiedades específicas, pulse el botón Mostrar/ocultar ID respectivo.

Parámetros de entrada

Especifique cualquier parámetro de entrada adicional para el servicio web. Los nombres de propiedades y los tipos de datos que especifique aquí deben coincidir con los nombres y tipos de datos que espera el servicio web.
Consejo: Cuando define la expresión para asignarle un valor de propiedad, tenga en cuenta que las propiedades de metadatos específicas pueden no estar disponibles en este punto de la ruta de tareas. Para evitar errores debidos a que faltan metadatos, configure una expresión avanzada para la correlación de propiedades. Crear una expresión que utilice la función TestMetadataReference() función para probar si existe la propiedad y proporcione un valor predeterminado si la propiedad no está disponible.