Está en la página 1de 3

Artículos: Lenguajes de Programación Dinámicos - Taller sobre Integra... http://www.oracle.

com/technetwork/es/articles/dsl/o67browser-09027...

Bienvenido Pedro
Cuenta Salir Ayuda País Comunidades Soy un ... Necesito... Search

Productos Soluciones Descargas Tienda Soporte Capacitación Socios Acerca de OTN

Oracle Technology Network Artículos Lenguajes de Programación Dinámicos

Taller sobre Integración de Aplicaciones
Por David Peake

Utilizar servicios Web con Oracle Application Express

Casi todos los sitios Web líderes, de Amazon y eBay a Facebook y Google, cuentan actualmente con una oferta de servicios Web. Los servicios Web
permiten que las aplicaciones interactúen entre sí mediante la Web en un entorno neutral en cuanto a la plataforma y de lenguaje independiente. En
un escenario típico de servicios Web, una aplicación de negocios envía una solicitud a un servicio en una determinada URL, utilizando HyperText
Transfer Protocol (HTTP). El servicio recibe la solicitud, la procesa y devuelve una respuesta.

Oracle Application Express ha soportado la integración de servicios Web en varias versiones, pero con Oracle Application Express 3.0, ese soporte
ha sido mejorado—por ejemplo, ahora se soportan los servicios Web de estilo documento. Oracle Application Express 3.0 también permite la
creación manual de referencias de servicios Web. Esta columna muestra cómo crear referencias de servicios Web manualmente, utilizando una de
las API de servicios Web de YouTube.

Fíjese que debe crear este ejemplo en su propia instancia de Oracle Application Express—el sitio apex.oracle.com no brinda soporte para las
llamadas de red externas, de manera que no puede utilizarse para este proyecto.

Generalidades

Oracle Application Express 3.0 ofrece dos enfoques para agregar servicios Web a una aplicación:
Generar referencias de servicios Web utilizando un wizard para crear automáticamente mensajes de solicitud Simple Object Access Protocol (SOAP)
válidos con parámetros de entrada, parámetros de salida y operaciones especificadas, sobre la base de Web Services Description Language
(WSDL).
Crear referencias de servicios Web manualmente. Primero, examine WSDL, y luego cree SOAP para la solicitud. En general, necesitará una
herramienta SOAP para ayudar a determinar SOAP, pero en esta aplicación de muestra, los detalles para las API XML-RPC son ofrecidos por el sitio
YouTube.

Ejemplo del Servicio Web Estilo XML-RPC de YouTube

YouTube ( www.youtube.com) ofrece acceso a varias áreas de su repositorio de video mediante una interface API abierta que permite integrar
fácilmente el contenido de YouTube en una aplicación. Las API de YouTube permiten obtener información sobre videos y obtener videos por nombre
o nombre de usuario. Para este proyecto de aplicaciones de muestra, usted obtendrá solo videos de música y los desplegará en un formato estilo
informe. Las API de servicios Web de YouTube están en formato Representational State Transfer (REST) y XML-RPC. Este ejemplo describe cómo
crear una aplicación Oracle Application Express que interactúe con la API de servicios Web XML-RPC de los videos de música YouTube.

Para utilizar las API de YouTube, usted debe tener una cuenta YouTube (es gratuita) y debe obtener un ID de desarrollador (también gratuito). Su ID
de desarrollador está incluido en el documento de solicitud XML-RPC y se envía con cada solicitud a la API. Para obtener su ID de desarrollador y
cuenta, visite www.youtube.com/dev.

El proyecto de aplicaciones de muestra consta de los siguientes pasos:

Paso 1: Crear una aplicación Oracle Application Express
Paso 2: Crear una referencia Web manual
Paso 3: Probar la referencia Web
Paso 4: Crear un proceso para asociarlo con el servicio Web
Paso 5: Extraer el documento XML incorporado
Paso 6: Crear un informe sobre la referencia Web manual
Paso 7: Perfeccionar el informe

Paso 1: Crear una aplicación. Antes de crear la referencia Web manual en el servicio Web XML-RPC de videos de música YouTube, debe crear
una aplicación en Oracle Application Express.

1.Ingrese a su espacio de trabajo Oracle Application Express.
2.Seleccione Crear Aplicación en el menú de Creación de Aplicaciones para lanzar el wizard Crear Aplicación.
3.Ingrese un nombre para la aplicación, como SimpleVideoService.
4.Haga click en Siguiente para continuar. Aparece la opción Agregar Página.
5.Seleccione el estilo de página en blanco, y agregue una página en blanco a la aplicación. Deje los valores por defecto, y haga click en
Siguiente para transitar el wizard y terminar de crear la aplicación.

Si su instancia Oracle Application Express requiere un servidor proxy para llegar a las páginas en internet, usted debe definir el servidor proxy en
Definición de Aplicaciones (Shared Components -> Application -> Definition).

Paso 2: Crear una referencia Web manual. Para crear una referencia Web manual, ingrese la URL en el servicio Web y defina el documento a
enviar. Los resultados se almacenarán en un grupo, que definirá en los pasos de abajo. Para crear una referencia Web manual:

1.Haga click en Componentes Compartidos.
2.Haga click en Referencias de Servicios Web.
3.Haga click en Crear. Se inicia el wizard Crear Referencia de Servicios Web, y despliega el mensaje "¿Quiere buscar un registro UDDI para
encontrar el WSDL?"
4.Seleccione No, y haga click en Siguiente. Aparecen los campos para credenciales de autenticación y ubicación WSDL. Ignórelos.
5.En la región Tareas en la sección derecha de la página, haga click en Crear Referencia de Servicios Web Manualmente para abrir una
página de propiedades de Crear/Editar Servicio Web, con regiones para el nombre del servicio Web, descripción del servicio, definición
SOAP y respuesta SOAP. Ingrese los detalles que se muestran en la Lista 1.

Lista de Código 1: Propiedades de servicios Web.
Name: YouTube Music Videos
URL: http://www.youtube.com/api2_xmlrpc
SOAP Envelope:

<?xml version='1.0'?>
<methodCall>
<methodName>youtube.videos.list_by_category_and_tag</methodName>
<params>
<param><value><struct>
<member>
<name>dev_id</name>
<value><string>YOUR_DEV_ID</string></value>
</member>
<member>
<name>category_id</name>
<value><int>10</int></value>
</member>
<member>
<name>tag</name>
<value><string></string></value>

1 de 3 31/03/2017 15:44

Deje el área de mensajes en blanco. y haga click en Siguiente. seleccione RPC.oracle.Haga click en Crear.1).Ingrese 20 en el campo Secuencia. La API de Videos de Música YouTube devuelve una cadena (una respuesta XML-RPC) que contiene un documento XML autónomo con escape con el resultado de la llamada de la API: la lista de videos de música. 5. ingrese los siguientes nombres: title author rating_avg 2 de 3 31/03/2017 15:44 . end loop. 4. cree un reporte utilizando el wizard "Crear Reporte en un Servicio Web Manual". 5. 7. (En el paso 5.Artículos: Lenguajes de Programación Dinámicos . seleccione Videos de Música de YouTube. con escape.Haga click en Probar. 6. (Cuando el XML no está fugado.Haga click en el ícono más (+) en la sección Procesos de Presentación de Página. Para desplegar el resultado de la referencia de servicios Web.Ingrese Call YouTube Music Video Service en el campo Nombre.Deje el área de mensajes en blanco.Haga click en Crear Proceso. y haga click en Siguiente. y haga click en Siguiente.Seleccione PL/SQL de la lista Tipo de Condición. Para probar la referencia Web manual que creó para la lista de videos de música de YouTube. 2.Seleccione Reporte en el grupo que contiene el resultado del servicio Web. y haga click en Siguiente.Navegue hasta la definición de la página 1. 4. El proceso también actualiza el grupo utilizado para almacenar la respuesta con el valor del documento extraído. begin for c1 in (select clob001 from apex_collections where collection_name = 'YOUTUBE_MUSIC_VIDEOS' ) loop l_clob := c1. y luego haga click en Ir.) Usted quiere que la aplicación reporte sobre este resultado. y haga click en Siguiente. y haga click en Siguiente. Aparece el componente en una tabla justo debajo de la fila de selección.convert(l_xml. 7.clob001. 4. 6. 2.. l_xml xmltype. Aparece el componente de Videos de Música YouTube en la página de Referencias de Servicios Web. 3.. Paso 6: Cree un informe sobre la referencia Web manual.Ingrese el código de la Lista 2 en el área de texto Ingresar Proceso de Página PL/SQL.Haga click en el componente de Videos de Música YouTube para seleccionarlo para su prueba (en el próximo paso).Seleccione PL/SQL de la lista Categoría del Proceso. debe tener seleccionado el componente en la página de Referencias de Servicios Web: 1. Para Nombres de Parámetro. 7. Ahora que ya ha creado la referencia de servicio Web. 8. Para este paso. 5. Paso 5: Extraiga el documento XML. Para el estilo SOAP. 3. Paso 3: Pruebe la referencia Web. Para crear un proceso que extraiga el documento XML: 1. El documento XML incorporado contiene la información sobre los videos de música.Taller sobre Integra. y haga click en Siguiente. el resultado es el mismo como respuesta a una llamada REST. l_xml := xmltype.extract('/methodResponse/params/param/value/ string/text()').Haga click en el ícono más (+) en la región Procesos de Presentación de Página.update_member_attribute( p_collection_name => 'YOUTUBE_MUSIC_VIDEOS'. Aparecen varios campos de ingreso para definir el estilo SOAP y el formato del mensaje. l_val := dbms_xmlgen.com/technetwork/es/articles/dsl/o67browser-09027. debe proporcionar información sobre la estructura del documento de respuesta XML.Haga click en el ícono más (+) en el área Regiones de la Presentación de Página. y haga click en Siguiente. y haga click en Siguiente. exit. 3. Para crear un reporte de un servicio Web manual: 1. una cadena que contiene un documento XML autónomo. Complete los campos de la siguiente manera: De la lista Referencia de Servicios Web.Seleccione los Videos de Música de YouTube desde la lista de Referencia de Servicios Web.Seleccione Detalles de la lista Ver. p_seq => '1'. para que se despliegue adecuadamente en un informe).Ingrese Music Videos en el campo Título.Seleccione Creado Manualmente de la Referencia Web y haga click en Siguiente.getclobval(). l_val clob. 3. entonces ahora cree un proceso que extraiga el documento y elimine el escape del XML.Haga click en Crear Proceso.Seleccione Reporte en la lista Tipo de Región.Haga click en el ícono Probar al lado de la referencia Videos de Música YouTube. 2. verá cómo hacer para que el contenido esté sin escape.. y haga click en Siguiente. end.Ingrese Extract Embedded Document en el campo Nombre.createxml(l_clob). http://www. p_clob_value => l_val ). Para Ruta de Nodo Resultante.Seleccione Servicios Web para la categoría del proceso. Aparece una página de Respuesta y SOAP Envelope. y haga click en Siguiente. Paso 4: Crear un proceso para asociarlo con el servicio Web. La sección de respuesta despliega la respuesta XML-RPC. 2. apex_collection. Deje el Espacio de Nombre del Mensaje en blanco. Para crear el proceso que invoca la referencia Web: 1. 4. p_clob_number => '1'. </member> <member> <name>per_page</name> <value><int>5</int></value> </member> </struct></value></param> </params> </methodCall> Store Response in Collection: YOUTUBE_MUSIC_VIDEOS 6. debe invocarla desde su aplicación. Lista de Código 2: Código PL/SQL que procesa el XML declare l_clob clob. ingrese /video_list/video.Vea la respuesta en el área Texto Resultante..

Artículos: Lenguajes de Programación Dinámicos .Taller sobre Integra.Haga click en Aplicar Cambios.com) es gerente principal de productos en la división de Tecnologías de Servidor de Oracle..peake@oracle. 7. La Figura 1 muestra un resultado de muestra. David Peake ( david.oracle.Haga click en Aplicar Cambios.Haga click en el ícono Mover Arriba en la fila de la columna thumbnail_url hasta que aparezca directamente después de la columna título. Trabaja con Oracle desde 1993. http://www. Ejecute la página para ver sus mejoras.Desmarque el casillero Mostrar en la fila de la columna url. Facilita la creación de aplicaciones basadas en Servicios Web estilo XML-RPC como la API de Videos de Música de YouTube.com/technetwork/es/articles/dsl/o67browser-09027.. 9.. 3 de 3 31/03/2017 15:44 . description url thumbnail_url 6.. 8. al soportar el consumo de servicios Web. Conclusión Oracle Application Express permite crear aplicaciones que se integran con otras aplicaciones en otras plataformas.