Cómo agregar un servicio web externo

Para los servicios web REST:

URL

Si no suministró un WADL en el paso Descriptor, ingrese una URL de solicitud de muestra que contenga los parámetros de ruta (si existe alguno) y los parámetros de consulta que desea incluir en la solicitud. Por ejemplo:

http://example.com/rest/customers/{state}?age=31

Aquí existe un parámetro de ruta {state} y un parámetro de consulta age.

Si proporcionó un WADL en el paso Descriptor, el campo URL muestra el extremo basado en el WADL que proporcionó. No puede editar el extremo.

Recurso

Esta configuración únicamente está visible si proporcionó un WADL en el paso Descriptor. Seleccione el recurso de servicio de web que desea exponer en Spectrum Technology Platform.

Nota: Si desea exponer más de un recurso, debe definir un servicio web externo independiente para cada recurso.

Método

Seleccione el método HTTP a usar para la solicitud del servicio web externo.

Si proporcionó un WADL en el paso Descriptor, solo se enumeran los métodos HTTP que admite el servicio web externo.

Parámetros de ruta

La sección Parámetros de ruta enumera los parámetros que son parte de una ruta URL, si el servicio web externo utiliza parámetros de ruta. Por ejemplo, esta URL contiene el parámetro de ruta {state}:

http://example.com/rest/customers/{state}?age=31

Si proporcionó un WADL en el paso Descriptor, se enumeran los parámetros de ruta de los servicios web. Si no suministró un WADL en el paso Descriptor, se genera una lista de los parámetros de ruta en la URL de solicitud de muestra que proporcionó en el campo URL. Para agregar o eliminar un parámetro de ruta, agréguelo o elimínelo en la URL. Todo lo que figura en la URL rodeado entre llaves se interpreta como un parámetro de ruta.

Parámetros de consulta

En la sección Parámetros de consulta se enumeran los parámetros que aparecen después del signo “?” en la URL de la solicitud. Por ejemplo, esta URL contiene el parámetro de consulta age:

http://example.com/rest/customers/{state}?age=31

Si proporciona un WADL en el paso Descriptor, se enumeran los parámetros de consulta del servicio web. Si no proporcionó un WADL en el paso Descriptor, se genera una lista de los parámetros de consulta en la URL de solicitud de muestra que proporcionó en el campo URL. Para agregar o eliminar un parámetro de consulta, agréguelo o elimínelo en la URL.

Tabla 1. Configuración de los parámetros de ruta REST y los parámetros de consulta

Configuración	Descripción
Exponer	Marque la casilla en esta columna para que el parámetro esté disponible en la etapa Spectrum Technology Platform.
Solicitud	Esta columna enumera el nombre del parámetro que se utiliza en la solicitud del servicio web externo.
Entrada	Esta columna indica los nombres de campo de entrada como aparecen en un flujo. Puede dejar los mismos nombres que utiliza el servicio web de terceros, o puede cambiarlos situándose sobre el nombre y haciendo clic en el botón editar .
Valor predeterminado	Marque la casilla en esta columna si desea especificar un valor predeterminado para el campo. Ingrese el valor predeterminada en el campo que aparece después de marcar la casilla. Si desea proporcionar un valor predeterminado que no puede anularse en un flujo, marque la casilla en la columna Valor predeterminado y elimine la casilla correspondiente en la columna Solicitud. Esto oculta el campo en los flujos mientras se proporciona el valor predeterminado en la solicitud del servicio web externo. Esto puede resultar útil si tiene una clave de acceso que tiene que proporcionar en cada solicitud. Por ejemplo:

Para los servicios web SOAP:

URL

Este campo muestra el extremo basado en el WSDL que proporcionó en el paso Descriptor. No puede editar este cambio.

Operación

Seleccione el tipo de operación de servicio web que desea realizar.

Nota: Si desea exponer más de una operación, debe definir un servicio web externo independiente para cada operación.

Solicitud

En esta columna, seleccione los campos y opciones que desee que estén a través de Spectrum Technology Platform.

Entrada

Esta columna indica los nombres de campo de entrada como aparecen en un flujo. Puede dejar los mismos nombres que utiliza el servicio web de terceros, o puede cambiarlos situándose sobre el nombre y haciendo clic en el botón editar .

Valor predeterminado

Marque la casilla en esta columna si desea especificar un valor predeterminado para el campo. Ingrese el valor predeterminada en el campo que aparece después de marcar la casilla.

Si desea proporcionar un valor predeterminado que no puede anularse en un flujo, marque la casilla en la columna Valor predeterminado y elimine la casilla correspondiente en la columna Solicitud. Esto oculta el campo en los flujos mientras se proporciona el valor predeterminado en la solicitud del servicio web externo. Esto puede resultar útil si tiene una clave de acceso que tiene que proporcionar en cada solicitud. Por ejemplo:

Cargar esquema

Elija esta opción si tiene un esquema XML que define la estructura de los datos que enviará al servicio web en la operación POST o PUT. Después de seleccionar esta opción, navegue hasta el archivo de esquema.

Proporcionar muestra

Elija esta opción si tiene una muestra de los datos que desea enviar al servicio web en la operación POST o PUT. Después de seleccionar esta opción, puede ingresar la muestra manualmente o pegar la muestra en la ventana.

Después de indicar un esquema o muestra, marque la casilla junto a cada elemento de datos que desea que esté disponible en la fase de flujo.

A continuación se brindan algunos consejos para ingresar datos de muestra:

• No es necesario ingresar datos en todos los campos. Si se deja un campo vacío, se usará una cadena vacía para la vista previa.
• Si desea obtener una vista previa del efecto que se produce cuando se pasa un valor predeterminado o un valor nulo en un campo, haga clic en el ícono Desactivar junto al campo:
  
  Si ha definido un valor predeterminado para el campo en la ficha Solicitud, se utilizará el valor predeterminado. Si no ha definido un valor predeterminado, se utilizará un valor nulo.
• Puede ver la vista previa de varios registros a la vez. Para añadir un registro, haga clic en el botón Añadir .
• Puede importar los datos de prueba de un archivo. Para importar datos, haga clic en el botón Importar . Cabe destacar que:
  • La primera fila del archivo debe ser un registro de encabezado. Los nombres de campos en el encabezado deben coincidir con los nombres de campos requeridos por el servicio.
  • La cantidad máxima de registros que se puede importar es cinco.
  • Si el archivo utiliza un espacio como separador de campo, los valores de campo deben rodearse de comillas. A continuación se brinda un ejemplo de un archivo que utiliza un espacio como separador de campo:

    AddressLine1 AddressLine2 City StateProvince PostalCode
    "One Global View" "" "Troy" "NY" "12180"
    "3001 Summer St" "" "Stamford" "CT" "06926"
    "224 N Michigan Ave" "Suite 300" "Chicago" "IL" ""

• Para eliminar todos los registros, haga clic en el botón Eliminar en la parte superior del área de vista previa:
  
  
• Para eliminar un registro individual, pase el mouse sobre el nombre del registro de entrada (por ejemplo, “Registro de entrada 1”) y haga clic en el botón Eliminar junto al nombre del registro: