This shows you the differences between two versions of the page.
es:webservice_adaptor [2024/12/11 09:36] montse [Parámetros de configuración del Adaptador REST] |
es:webservice_adaptor [2025/04/04 11:48] (current) ale |
||
---|---|---|---|
Line 25: | Line 25: | ||
* **deleteRest(resource, headers)** | * **deleteRest(resource, headers)** | ||
- | * Descripción: Permite configurar una petición HTTP de tipo Delete. | + | * Descripción: permite configurar una petición HTTP de tipo Delete. |
- | * Recurso: Indica el recurso dentro del EndPoint en el que se realizará la solicitud. | + | * Recurso: indica el recurso dentro del EndPoint en el que se realizará la solicitud. |
- | * Cabeceras: Indica las cabeceras que deben añadirse a la solicitud. | + | * Cabeceras: indica las cabeceras que deben añadirse a la solicitud. |
- | * Charset: Para elegir el charset que queremos utilizar. | + | * Charset: para elegir el charset que queremos utilizar. |
- | * Cuerpo: Indica el contenido del parámetro. | + | * Cuerpo: indica el contenido del parámetro. |
* **getALLJSONElementValueByTagname** | * **getALLJSONElementValueByTagname** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de algún elemento, utilizando elTagName para identificarlo. Devuelve todos los elementos. El resultado se presenta con los valores separados por el carácter |, en el campo Mensaje / Resultado / Valor. | + | * Descripción: si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de algún elemento, utilizando elTagName para identificarlo. Devuelve todos los elementos. El resultado se presenta con los valores separados por el carácter |, en el campo Mensaje / Resultado / Valor. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * JSonTagName: Expresión de nombre de etiqueta utilizada para identificar el elemento. | + | * JSonTagName: expresión de nombre de etiqueta utilizada para identificar el elemento. |
* **getALLXMLElementValueByTagName(StepResponse, ElementTag)** | * **getALLXMLElementValueByTagName(StepResponse, ElementTag)** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es XML, esta función permite recuperar todos los valores de los elementos, utilizando el TagName para identificarlo. En lugar de devolver sólo un elemento (el primero), este FP devuelve una lista de todos los elementos. | + | * Descripción: si el contenido de la respuesta a una petición es XML, esta función permite recuperar todos los valores de los elementos, utilizando el TagName para identificarlo. En lugar de devolver sólo un elemento (el primero), este FP devuelve una lista de todos los elementos. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
* ElementTag: XML´s etiqueta utilizada para identificar el elemento. | * ElementTag: XML´s etiqueta utilizada para identificar el elemento. | ||
* **getCookieValue(StepResponse, Cookie)** | * **getCookieValue(StepResponse, Cookie)** | ||
- | * Descripción: Recuperar el valor de la cookie indicada. | + | * Descripción: recuperar el valor de la cookie indicada. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * Cookie: Indica el nombre de Cookie´s a recuperar. | + | * Cookie: indica el nombre de Cookie´s a recuperar. |
- | * **getElementsCountByJsonPath(JsonPath, ResponseName)**: Devuelve el número de elementos que tienen el mismo JsonPath. | + | * **getElementsCountByJsonPath(JsonPath, ResponseName)**: devuelve el número de elementos que tienen el mismo JsonPath. |
- | * JsonPath: El JsonPath a buscar. | + | * JsonPath: el JsonPath a buscar. |
- | * ResponseName: El nombre con el que se generó la respuesta HTTP. | + | * ResponseName: el nombre con el que se generó la respuesta HTTP. |
- | * **getElementsCountByTagName(tagName, ResponseName)**: Devuelve el número de elementos que tienen el mismo nombre de tag. | + | * **getElementsCountByTagName(tagName, ResponseName)**: devuelve el número de elementos que tienen el mismo nombre de tag. |
- | * tagName: El nombre de tag a buscar. | + | * tagName: el nombre de tag a buscar. |
- | * ResponseName: El nombre con el que se generó la respuesta HTTP. | + | * ResponseName: el nombre con el que se generó la respuesta HTTP. |
- | * **getElementsValueByJsonPath(JsonPath, ResponseName)**: Devuelve todos los elementos que tienen el mismo JsonPath. | + | * **getElementsValueByJsonPath(JsonPath, ResponseName)**: devuelve todos los elementos que tienen el mismo JsonPath. |
- | * JsonPath: El JsonPath a buscar. | + | * JsonPath: el JsonPath a buscar. |
- | * ResponseName: El nombre con el que se generó la respuesta HTTP. | + | * ResponseName: el nombre con el que se generó la respuesta HTTP. |
* **getHeaderValue(StepResponse, Header)** | * **getHeaderValue(StepResponse, Header)** | ||
- | * Descripción: Permite obtener el valor de una cabecera recibida en una respuesta HTTP. | + | * Descripción: permite obtener el valor de una cabecera recibida en una respuesta HTTP. |
- | * ResponseName: Indique el nombre con el que se generó la respuesta Http. | + | * ResponseName: indique el nombre con el que se generó la respuesta Http. |
- | * Cabecera: El nombre de la cabecera de la que desea extraer el valor. | + | * Cabecera: el nombre de la cabecera de la que desea extraer el valor. |
* **getHTMLElementValueByXpath()** | * **getHTMLElementValueByXpath()** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es HTML esta función permite recuperar el valor de un elemento empleando para identificar este, una expresión Xpath | + | * Descripción: si el contenido de la respuesta a una petición es HTML esta función permite recuperar el valor de un elemento empleando para identificar este, una expresión Xpath |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * XPathExp: Expresión XPath utilizada para identificar el elemento. | + | * XPathExp: expresión XPath utilizada para identificar el elemento. |
* **getJSONElementValueByJsonPath(StepResponse, JSonPathExp)** | * **getJSONElementValueByJsonPath(StepResponse, JSonPathExp)** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de un elemento, utilizando el nombre de JsonPath para identificarlo. Si hay más de un elemento, devuelve el primero. | + | * Descripción: si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de un elemento, utilizando el nombre de JsonPath para identificarlo. Si hay más de un elemento, devuelve el primero. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * JSonPathExp: Expresión de JSonPath utilizada para identificar el elemento. | + | * JSonPathExp: expresión de JSonPath utilizada para identificar el elemento. |
* **getJSONElementValueByTagName(StepResponse, TagnameExp)** | * **getJSONElementValueByTagName(StepResponse, TagnameExp)** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de un elemento, utilizando el TagName para identificarlo. Si hay más de un elemento, devuelve el primero. El resultado se presenta con los valores separados por el carácter |, en el campo Mensaje / Resultado / Valor. | + | * Descripción: si el contenido de la respuesta a una petición es JSON, esta función permite recuperar el valor de un elemento, utilizando el TagName para identificarlo. Si hay más de un elemento, devuelve el primero. El resultado se presenta con los valores separados por el carácter |, en el campo Mensaje / Resultado / Valor. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * JSonTagName: Expresión TTagname utilizada para identificar el elemento. | + | * JSonTagName: expresión Tagname utilizada para identificar el elemento. |
- | * **getResponseBody**: | + | * **getResponseBody**: este método se encarga de recuperar el cuerpo (body) de una respuesta HTTP previamente almacenada, si no se encuentra la respuesta o si ocurre un error, lanza una excepción ExecutorException. |
* **getResponseStatus(StepResponse)** | * **getResponseStatus(StepResponse)** | ||
- | * Descripción: Permite recuperar el código de estado Http de la respuesta. | + | * Descripción: permite recuperar el código de estado Http de la respuesta. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * **getResponseTime**: Retorna el tiempo empleado en milisegundos en recibir la respuesta a una solicitud. Para identificar la respuesta recibe un parámetro con el nombre de la variable HttpResponse de la que queremos obtener la información. | + | * **getResponseTime**: retorna el tiempo empleado en milisegundos en recibir la respuesta a una solicitud. Para identificar la respuesta recibe un parámetro con el nombre de la variable HttpResponse de la que queremos obtener la información. |
* **getRest(resource, headers, parameters)** | * **getRest(resource, headers, parameters)** | ||
- | * Descripción: Permite configurar una petición HTTP del tipo Get. | + | * Descripción: permite configurar una petición HTTP del tipo Get. |
- | * Recurso: Indica el recurso dentro del EndPoint en el que se realizará la solicitud. | + | * Recurso: indica el recurso dentro del EndPoint en el que se realizará la solicitud. |
- | * Cabeceras: Indica las cabeceras que deben añadirse a la solicitud. | + | * Cabeceras: indica las cabeceras que deben añadirse a la solicitud. |
- | * Parámetros: Indica los parámetros que deben añadirse a la URL de la incidencia. | + | * Parámetros: indica los parámetros que deben añadirse a la URL de la incidencia. |
- | * Charset: Para elegir el charset que queremos utilizar. | + | * Charset: para elegir el charset que queremos utilizar. |
* **getXMLElementValueByTagName(StepResponse, ElementTag)** | * **getXMLElementValueByTagName(StepResponse, ElementTag)** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es XML, esta función permite recuperar el valor de un elemento, utilizando la etiqueta it´s para identificarlo. Si hay más de un elemento, devuelve el primero. | + | * Descripción: si el contenido de la respuesta a una petición es XML, esta función permite recuperar el valor de un elemento, utilizando la etiqueta it´s para identificarlo. Si hay más de un elemento, devuelve el primero. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
* ElementTag: XML´s etiqueta utilizada para identificar el elemento. | * ElementTag: XML´s etiqueta utilizada para identificar el elemento. | ||
* **getXMLElementValueByXPath(StepResponse, XPathExp)** | * **getXMLElementValueByXPath(StepResponse, XPathExp)** | ||
- | * Descripción: Si el contenido de la respuesta a una petición es XML, esta función permite recuperar el valor de un elemento, usando para identificar este, una expresión XPath. Además permite buscar valores en respuestas con un tipo de contendio XHTML. | + | * Descripción: si el contenido de la respuesta a una petición es XML, esta función permite recuperar el valor de un elemento, usando para identificar este, una expresión XPath. Además permite buscar valores en respuestas con un tipo de contenido XHTML. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * XPathExp: Expresión XPath utilizada para identificar el elemento. | + | * XPathExp: expresión XPath utilizada para identificar el elemento. |
* **patchRest(resource, headers, content-type, body)** | * **patchRest(resource, headers, content-type, body)** | ||
- | * Descripción: Le permite configurar una petición HTTP de tipo Patch. | + | * Descripción: le permite configurar una petición HTTP de tipo Patch. |
- | * Recurso: Indica el recurso dentro del EndPoint en el que se realizará la solicitud. | + | * Recurso: indica el recurso dentro del EndPoint en el que se realizará la solicitud. |
- | * Cabeceras: Indica las cabeceras que deben añadirse a la solicitud. | + | * Cabeceras: indica las cabeceras que deben añadirse a la solicitud. |
- | * Tipo de contenido: Cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. | + | * Tipo de contenido: cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. |
- | * Cuerpo: Contenido de la solicitud Http. | + | * Cuerpo: contenido de la solicitud Http. |
* **postRest(resource, headers, content-type, body)** | * **postRest(resource, headers, content-type, body)** | ||
- | * Descripción: Le permite configurar una petición HTTP de tipo Post. | + | * Descripción: le permite configurar una petición HTTP de tipo Post. |
- | * Recurso: Indica el recurso dentro del EndPoint en el que se realizará la solicitud. | + | * Recurso: indica el recurso dentro del EndPoint en el que se realizará la solicitud. |
- | * Cabeceras: Indica las cabeceras que deben añadirse a la solicitud. | + | * Cabeceras: indica las cabeceras que deben añadirse a la solicitud. |
- | * Tipo de contenido: Cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. | + | * Tipo de contenido: cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. |
- | * Cuerpo: Contenido de la solicitud Http. | + | * Cuerpo: contenido de la solicitud Http. |
* **putRest(resource, headers, content-type, body)** | * **putRest(resource, headers, content-type, body)** | ||
- | * Descripción: Permite configurar una petición HTTP de tipo Put. | + | * Descripción: permite configurar una petición HTTP de tipo Put. |
- | * Recurso: Indica el recurso dentro del EndPoint en el que se realizará la solicitud. | + | * Recurso: indica el recurso dentro del EndPoint en el que se realizará la solicitud. |
- | * Cabeceras: Indica las cabeceras que deben añadirse a la solicitud. | + | * Cabeceras: indica las cabeceras que deben añadirse a la solicitud. |
- | * Tipo de contenido: Cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. | + | * Tipo de contenido: cabecera estándar HTTP que indica el tipo de contenido que se agrega al cuerpo de la solicitud. |
- | * Cuerpo: Contenido de la solicitud Http. | + | * Cuerpo: contenido de la solicitud Http. |
* **responseBodyContainsText(responseName, searchValue)** | * **responseBodyContainsText(responseName, searchValue)** | ||
- | * Descripción: Buscar en el campo cuerpo de la respuesta (stepResponse), si hay alguna coincidencia con el texto del parámetro searchValue. Rendimiento verdadero si es afirmativo. | + | * Descripción: buscar en el campo cuerpo de la respuesta (stepResponse), si hay alguna coincidencia con el texto del parámetro searchValue. Rendimiento verdadero si es afirmativo. |
- | * ResponseName: Indica el nombre con el que se generó la respuesta Http. | + | * ResponseName: indica el nombre con el que se generó la respuesta Http. |
- | * SearchValue: Texto a buscar dentro del cuerpo de la respuesta. | + | * SearchValue: texto a buscar dentro del cuerpo de la respuesta. |
* **setBasicAuthentication(user, password)** | * **setBasicAuthentication(user, password)** | ||
- | * Descripción: Permite configurar el esquema de autenticación de las peticiones que se envían al EndPoint como BasicAuthentication. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. | + | * Descripción: permite configurar el esquema de autenticación de las peticiones que se envían al EndPoint como BasicAuthentication. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. |
- | * Usuario: Código de usuario utilizado como credencial. | + | * Usuario: código de usuario utilizado como credencial. |
- | * Password: Contraseña para presentar como credencial. | + | * Password: contraseña para presentar como credencial. |
* **setBearerTokenAuthentication(token)** | * **setBearerTokenAuthentication(token)** | ||
- | * Descripción: Permite configurar el esquema de autenticación de las peticiones que se envían al endpoint como Esquema de Autenticación de Portador de Ficha. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. | + | * Descripción: permite configurar el esquema de autenticación de las peticiones que se envían al endpoint como Esquema de Autenticación de Portador de Ficha. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. |
- | * Token: Valor de Token que se presentará como credencial. | + | * Token: valor de Token que se presentará como credencial. |
* **setDigestAuthentication(user, password, realm, nonce, algorithm, Qoq, NonceCount, ClientNonce, Opaque)** | * **setDigestAuthentication(user, password, realm, nonce, algorithm, Qoq, NonceCount, ClientNonce, Opaque)** | ||
- | * Descripción: Permite configurar el esquema de autenticación de las peticiones que se envían al endpoint como Digest Authentication Schema. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. | + | * Descripción: permite configurar el esquema de autenticación de las peticiones que se envían al endpoint como Digest Authentication Schema. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. |
- | * Usuario: Nombre de usuario utilizado como credencial. | + | * Usuario: nombre de usuario utilizado como credencial. |
- | * Password: Contraseña para presentar como credencial. | + | * Password: contraseña para presentar como credencial. |
- | * Campo: Dominio de seguridad en el que debe realizarse la validación de seguridad. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * Campo: dominio de seguridad en el que debe realizarse la validación de seguridad. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * Nonce: Nonce devuelto por el servidor. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * Nonce: nonce devuelto por el servidor. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * Algoritmo: Algoritmo utilizado para el cifrado. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * Algoritmo: algoritmo utilizado para el cifrado. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * Qoq: Calidad del código de protección. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * Qoq: calidad del código de protección. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * NonceCount: NonceCount asociado a la solicitud. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * NonceCount: nonceCount asociado a la solicitud. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * ClienteNonce: Nonce generado por el cliente. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. | + | * ClienteNonce: nonce generado por el cliente. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos de la respuesta al desafío. |
- | * Opaque: Opaque devuelto por el servidor. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos. | + | * Opaque: opaque devuelto por el servidor. Es opcional, si no se conoce, el adaptador intentará realizar la validación con los datos obtenidos. |
* **setNoneAuthentication()** | * **setNoneAuthentication()** | ||
- | * Descripción: Permite configurar el método de autenticación de las peticiones que se envían al EndPoint como peticiones sin esquema de autenticación. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. | + | * Descripción: permite configurar el método de autenticación de las peticiones que se envían al EndPoint como peticiones sin esquema de autenticación. Sobrescribe la configuración de seguridad realizada en la configuración del adaptador. |
Line 159: | Line 159: | ||
====Base URL==== | ====Base URL==== | ||
Sería la parte de la URL que es común a todas las peticiones o peticiones sobre ese servicio web, de forma que el usuario no tenga que introducirla en cada mensaje que configure como servicio de petición. | Sería la parte de la URL que es común a todas las peticiones o peticiones sobre ese servicio web, de forma que el usuario no tenga que introducirla en cada mensaje que configure como servicio de petición. | ||
+ | |||
Line 174: | Line 175: | ||
Seguimos enumerando los tipos de autenticación, haciendo una breve descripción de los mismos y pensando en los parámetros que podríamos necesitar. | Seguimos enumerando los tipos de autenticación, haciendo una breve descripción de los mismos y pensando en los parámetros que podríamos necesitar. | ||
- | * **No Authorization (None Auth):** Si el usuario selecciona este método no es necesario autenticarse para utilizar el servicio. | + | * **No Authorization (None Auth):** si el usuario selecciona este método no es necesario autenticarse para utilizar el servicio. |
- | * **Basic Authorization (Basic Auth):** El método más simple solo requiere de los parámetros usuario y password. https://en.wikipedia.org/wiki/Basic_access_authentication | + | * **Basic Authorization (Basic Auth):** el método más simple solo requiere de los parámetros usuario y password. https://en.wikipedia.org/wiki/Basic_access_authentication |
- | * **Digest Authorization (Digest Auth):** Este método es un poco más complicado porque la clave está encriptada y el usuario, en la herramienta postman cuando selecciona este tipo de autenticación, solicita los siguientes parámetros:\\ \\ | + | * **Digest Authorization (Digest Auth):** este método es un poco más complicado porque la clave está encriptada y el usuario, en la herramienta Postman cuando selecciona este tipo de autenticación, solicita los siguientes parámetros:\\ \\ |
* User | * User | ||
* Password\\ \\ Y como opcional (se utilizan valores por defecto si el usuario no los proporciona) lo siguiente:\\ \\ | * Password\\ \\ Y como opcional (se utilizan valores por defecto si el usuario no los proporciona) lo siguiente:\\ \\ | ||
- | * Realm: Dominio de seguridad contra el que autenticarse. | + | * Realm: dominio de seguridad contra el que autenticarse. |
- | * Algoritmo: Algoritmo de encriptación. MD5 o MD5-sess. | + | * Algoritmo: algoritmo de encriptación. MD5 o MD5-sess. |
- | * Nonce: Código que el servidor emite en la respuesta cuando una petición no está autorizada. Es único por sesión y debe ser incluido en las siguientes solicitudes. | + | * Nonce: código que el servidor emite en la respuesta cuando una petición no está autorizada. Es único por sesión y debe ser incluido en las siguientes solicitudes. |
- | * Qop: Calidad de protección, los valores posibles son auth (más común) o auth-int (autorización con integridad) creo que menos soportados y utilizados. | + | * Qop: calidad de protección, los valores posibles son auth (más común) o auth-int (autorización con integridad) creo que menos soportados y utilizados. |
- | * Nonce Count: Número de peticiones realizadas al servidor con la misma unidad, su obligación depende del valor asignado a Qop. | + | * Nonce Count: número de peticiones realizadas al servidor con la misma unidad, su obligación depende del valor asignado a Qop. |
- | * Opaque: Es un valor devuelto por el servidor en la primera respuesta no autorizada, y debe ser añadido sin modificar todas las peticiones posteriores al servidor. https://en.wikipedia.org/wiki/Digest_access_authentication | + | * Opaque: es un valor devuelto por el servidor en la primera respuesta no autorizada, y debe ser añadido sin modificar todas las peticiones posteriores al servidor. https://en.wikipedia.org/wiki/Digest_access_authentication |
- | * ** OAuth 1.0: ** Este método, Autorización abierta, es más moderno para crear un primer estándar relacionado con la autenticación. OAuth 2.0 se utiliza más pero podríamos encontrar un servicio que lo utilice. En Postman se solicitan los siguientes parámetros: | + | * ** OAuth 1.0: ** este método, Autorización abierta, es más moderno para crear un primer estándar relacionado con la autenticación. OAuth 2.0 se utiliza más pero podríamos encontrar un servicio que lo utilice. En Postman se solicitan los siguientes parámetros: |
- | * ConsumerKey: Un valor utilizado por el consumidor del servicio para identificarse con él. | + | * ConsumerKey: un valor utilizado por el consumidor del servicio para identificarse con él. |
- | * ConsumerSecret: Token utilizado por el consumidor para validar su propiedad de la ConsumerKey. | + | * ConsumerSecret: token utilizado por el consumidor para validar su propiedad de la ConsumerKey. |
- | * Access Token: Ficha de acceso. | + | * Access Token: ficha de acceso. |
- | * Token Secret: Otra clave para asegurar la propiedad del token de acceso.\\ \\ Y como parámetros opcionales (valores por defecto si el usuario no entra):\\ \\ | + | * Token Secret: otra clave para asegurar la propiedad del token de acceso.\\ \\ Y como parámetros opcionales (valores por defecto si el usuario no entra):\\ \\ |
- | * Signature Method: El método de firma utilizado por el consumidor para firmar las solicitudes. | + | * Signature Method: el método de firma utilizado por el consumidor para firmar las solicitudes. |
- | * Timestamp: Se añade una marca de tiempo a la solicitud. | + | * Timestamp: se añade una marca de tiempo a la solicitud. |
- | * Nonce: La cadena aleatoria generada por el cliente, se añadirá a todas las peticiones. | + | * Nonce: la cadena aleatoria generada por el cliente, se añadirá a todas las peticiones. |
- | * Realm: Indica el dominio de seguridad que realiza la autenticación. https://es.wikipedia.org/wiki/OAuth | + | * Realm: indica el dominio de seguridad que realiza la autenticación. https://es.wikipedia.org/wiki/OAuth |
- | * ** OAuth 2.0: ** La evolución de OAuth 1.0, es el estándar más soportado por las grandes empresas de Internet, Google, Facebook, Twitter, etc., no siendo un experto, creo que es una autenticación de dos pasos. Postman sólo pide el parámetro:\\ | + | * ** OAuth 2.0: ** la evolución de OAuth 1.0, es el estándar más soportado por las grandes empresas de Internet, Google, Facebook, Twitter, etc., no siendo un experto, creo que es una autenticación de dos pasos. Postman sólo pide el parámetro:\\ |
* Ficha de acceso. Código de acceso al servicio.\\ Pero en la opción de solicitar una petición de token de acceso los datos se autentican contra el servicio que le va a dar el código de acceso para esa operación. Además de estos métodos, en Postman aparecen otros métodos de autenticación como por ejemplo: | * Ficha de acceso. Código de acceso al servicio.\\ Pero en la opción de solicitar una petición de token de acceso los datos se autentican contra el servicio que le va a dar el código de acceso para esa operación. Además de estos métodos, en Postman aparecen otros métodos de autenticación como por ejemplo: | ||
* Ficha al portador. https://swagger.io/docs/specification/authentication/bearer-authentication/\\ | * Ficha al portador. https://swagger.io/docs/specification/authentication/bearer-authentication/\\ | ||
Line 229: | Line 230: | ||
* httpResponse = post (UrlBase, Resource, List Headers, Content Type, Data). | * httpResponse = post (UrlBase, Resource, List Headers, Content Type, Data). | ||
* En este caso, los datos podrían estar representados en un archivo Json o XML que el usuario debería poder subir a la aplicación o cortar y pegar en algún editor, como en el caso de las Consultas o el código Javascript. | * En este caso, los datos podrían estar representados en un archivo Json o XML que el usuario debería poder subir a la aplicación o cortar y pegar en algún editor, como en el caso de las Consultas o el código Javascript. | ||
- | * En el caso de utilizar formularios, los tipos X-WWW-FORM-URLENCODED o FORM-DATA los requisitos cambian y el usuario debe proporcionarnos una serie de parámetros en forma de valor clave. | + | * En el caso de utilizar formularios, los tipos X-WWW-FORM-URLENCODED o FORM-DATA los requisitos cambian y el usuario debe proporcionarnos una serie de parámetros en forma de valor clave. Así como en algunos casos adjuntar archivos a la solicitud. |
- | * Así como en algunos casos adjuntar archivos a la solicitud. | + | |
* Ejemplo = http://www.mkyong.com/java/how-to-send-http-request-getpost-in-java/ With two different libraries. | * Ejemplo = http://www.mkyong.com/java/how-to-send-http-request-getpost-in-java/ With two different libraries. | ||
Line 251: | Line 251: | ||
Las funciones anteriores tienen por objeto validar la respuesta obtenida por la solicitud, pero aún no hemos proporcionado al usuario funciones que le permitan recuperar la información contenida en la respuesta.\\ \\ | Las funciones anteriores tienen por objeto validar la respuesta obtenida por la solicitud, pero aún no hemos proporcionado al usuario funciones que le permitan recuperar la información contenida en la respuesta.\\ \\ | ||
Como hemos indicado anteriormente, algunas de estas funciones podrían serlo:\\ | Como hemos indicado anteriormente, algunas de estas funciones podrían serlo:\\ | ||
- | * Integer Code = GetStatusCode (httpResponse). | + | * **Integer Code** = GetStatusCode (httpResponse). |
* Devuelve el código de retorno como una variable del diagrama. | * Devuelve el código de retorno como una variable del diagrama. | ||
- | * Integer timeMilis = GetResponseTime (httpResponse). | + | * **Integer timeMilis** = GetResponseTime (httpResponse). |
* Devuelve el tiempo empleado en procesar la solicitud. | * Devuelve el tiempo empleado en procesar la solicitud. | ||
- | * String headerValue = GetHeaderValue (httpResponse, String HeaderKey). | + | * **String headerValue** = GetHeaderValue (httpResponse, String HeaderKey). |
* Devuelve el valor contenido en la cabecera indicada por el parámetro HeaderKey. | * Devuelve el valor contenido en la cabecera indicada por el parámetro HeaderKey. | ||
- | * String propertyValues = GetXPathPropertyValue (httpResponse, String XPathExp); | + | * **String propertyValues** = GetXPathPropertyValue (httpResponse, String XPathExp); |
* Esta función devolvería el valor o lista de valores contenidos en los elementos de respuesta que se machetean con la expresión Xpath introducida como parámetro. Si hay varios elementos en el documento que cumplen la condición, todos los valores separados por algún carácter se concatenan. Sólo se aplica cuando la respuesta está en formato XML. | * Esta función devolvería el valor o lista de valores contenidos en los elementos de respuesta que se machetean con la expresión Xpath introducida como parámetro. Si hay varios elementos en el documento que cumplen la condición, todos los valores separados por algún carácter se concatenan. Sólo se aplica cuando la respuesta está en formato XML. | ||
- | * String propertyValues = GetJSonPathPropertyValue (httpResponse, String JSonPathExp); | + | * **String propertyValues** = GetJSonPathPropertyValue (httpResponse, String JSonPathExp); |
* Similar a la función anterior pero utilizando el estándar JSonPath para navegar por los datos de respuesta. Sólo se aplica a las respuestas de tipo JSon. En principio desarrollaremos más funciones de este tipo que permitan recuperar los datos de la respuesta e introducirlos como variables en el flujo de ejecución del diagrama, en caso de que quieran ser utilizados como valores de entrada a otros mensajes en el diagrama.\\ \\ | * Similar a la función anterior pero utilizando el estándar JSonPath para navegar por los datos de respuesta. Sólo se aplica a las respuestas de tipo JSon. En principio desarrollaremos más funciones de este tipo que permitan recuperar los datos de la respuesta e introducirlos como variables en el flujo de ejecución del diagrama, en caso de que quieran ser utilizados como valores de entrada a otros mensajes en el diagrama.\\ \\ | ||
Line 308: | Line 308: | ||
===Vista de objeto=== | ===Vista de objeto=== | ||
- | {{:Rest mapping assistant_eng_11.png?nolink&8000|}} | + | {{ :es:rest_mapping_assistant_eng_11vista_de_objeto.png?direct&8000 |}} |
Desde esta vista es posible seleccionar el objeto con el que queremos trabajar. Sólo se pueden seleccionar los objetos asignados con el adaptador WebService. | Desde esta vista es posible seleccionar el objeto con el que queremos trabajar. Sólo se pueden seleccionar los objetos asignados con el adaptador WebService. | ||
Line 345: | Line 345: | ||
Ejecuta la aserción asociada al mensaje seleccionado. | Ejecuta la aserción asociada al mensaje seleccionado. | ||
- | {{:Rest mapping assistant_eng_6.png?nolink&8000|}} | + | {{ :es:rest_mapping_assistant_eng_6check_assertion.png?direct&8000 |}} |
El resultado de la afirmación se presenta en la pestaña "Parámetros de salida". | El resultado de la afirmación se presenta en la pestaña "Parámetros de salida". |