Skip to Content

esta es la version en español del blog Analysis of the SCP Microservices for Location Data

Muchas industrias y procesos de negocios necesitan mantener direcciones correctas (entre otros datos). En muchos casos, esto no es lo que encontramos en nuestros sistemas. Es una batalla constante entre vendedores y compradores para mantener esto. No me refiero a que parte de la dirección este deletreada correctamente si no que toda la direccion debe estar bien, por ejemplo, la calle, ciudad, estado, pais, codigo postal, alomejor latitud y longitud, y en ciertos casos la extension del codigo postal – aunque a veces es muy enfadoso poder saber cual es.

Como consumidor, me agrada la idea de que antes de acabar una order en linea, el sistema del vendedor verifique mi dirección a la otra de la compra. Si, me refiero a cuado hay un prompt y dice, te referiste a esta direccion: XXXX, XXXX, XXXX-XXXX? muchas de las veces, solo acepto el prompt de la opción que fue sugerida, porque no se cual sea la extension del codigo postal, por ejemplo. En mi caso, la opción sugerida por el sistema simpre se ve correcta. Alguna vez te has preguntado como las direcciones son verificadas?

 

Antes de saber que el SCP ofrecia este servicio (solo ha estado disponible unos meses desde Marzo, 2017) lo que creo que esta muy padre, yo habia usado otros servicios como el que ofrece UPS y también el servicio de verificacion de direcciones del correo de los EUA (USPS) – si ellos tambien ofrecen un API para este caso. Quiza nuestra amiga desarrolladora puede mostrar uno de ellos en sus sessiones de API de los viernes.

 

En este blog, voy a analizar el servicio DMQ microservice. Asegurate de que tu servicio este activo si no esta.

el enlace Application URL abajo es de mucha ayuda pues muestra los diferentes URLs que estan disponibles en este servicio. Favor de leer la documentación para más detalles.

 

Honestamenete, al pricipio que lei el titulo no estaba seguro de que significaba, asi que después de leerlo un par de veces ya me di cuenta de lo que en verdad era. La primera vez pense que era un servicio para ayudar a mantener los datos, pero luego me di cuenta que era para datos de localización. Este servicio ofrece formas de correr direcciones y verificarlas, también ofrece servicios de traducción de direccion a latitud/longitud y viceversa. También date cuenta que tiene limites de cuantas veces puedes llamar este servicio. (todos los apis usualmente tienen limites de llamada) aqui puedes leer acerca de estos limites.

Te has de preguntar, que gano al usar este servicio? pues mucho! primero que nada, como ya lo mencioné, los negocios y consumidores quieren asegurarse de que las direcciones proporcionadas sean correctas para que los productos y servicios sean entregados/servidos al lugar correcto. Un beneficio grandisimo para la parte de IT, es que no hay que hace otra conneción con librerias externas. Desde el punto de vista de la plataforma SCP, es un servicio autónomo e independiente que se puede consumir por si solo (no ocupa nada mas).

*asuegurate de leer acerca del servicio – contacta a SAP para mas detalles y tambien para los usuarios técnicos, asegurate de proporcionar el rol correcto (DQMMICRO_POWERUSER) para poder usar este servicio.

 

Hay mucha información bastante relevante acerca del servicio dentro de su documentación de la cual no re-escribiré aqui pero les recomiendo que le echen un ojo.Lo que si quiero recalcar e informarles es que hay muy buenos usos que el servicio ofrece.

SIEMPRE, Siempre, siempre … trata de comprender lo que es un servicio( o servicio web o micro-servicio o como le quieras llamar) Hace un tiempo atrás lei en algun lugar que los servicios se pueden definir y recordar con las iniciales en inglés, ABC.

  • Address (Direcció) – donde se encuentra (URL)
  • Binding (protocolo) – como lo consumo
  • Contract (contrato)  – que es lo que espera el servicio y que es lo que espero yo como consumidor.

para la cuenta gratis (trial account), esta es la dirección “A” ya sea que la recuerdes o la grabes como bookmark

https://dqmmicrou23133c2f-.hanatrial.ondemand.com/dq/

para ver los settings de las cuentas productivas, puedes usar el enlace siguiente: https://help.sap.com/viewer/d95546360fea44988eb614718ff7e959/Cloud/en-US/68904115d138486aaa2e09eae46e78b1.html

y para un listado de las opciones, veelas aqui:

por ejemplo:

para ver la lista de paises:

https://dqmmicrou23133c2f-.hanatrial.ondemand.com/dq/refData/country

 

para ver la lista de estados:

https://dqmmicrou23133c2f-.hanatrial.ondemand.com/dq/refData/region

 

el “B” para este servicio es https, pero en otras tecnologias pudiera ser diferente, (en tecnologias anterires puede usar soap.xml, namedpipes, msmq) es simplemente una forma de especificar como va a ser accesible (modo de transporte)

la “C” el contrato depende de la operación que se llevara acabo. Dependiendo de la operación ciertos parametros tendran que ser pasados y ciertas propiedades serán regresadas. en la pagina de los endpoints puedes ver el listado de opciones

 

como puedo testear el servicio?

  1. Usando herramientas del browser como POSTMAN (google extension)
  2. Fiddler (herramenta gratis de telerik)
  3. en tu browser

aqui muestro mi ejemplo usando POSTMAN – Request GET para obtener la lista de paises

 

y para la operación POST, aqui van algunas opciones. tendras que pasar credenciales para poder user el servicio (Basic en el trial y/o OAuth en el de producción)

si recientemente activaste el servicio, pudiera ser que el rol de tu usuario no haya refrescado todavia – yo tuve que esperar 5-10 minutos.

  1. Obtener informacion (reverse geocpode) de la ciudad de donde nací en México (pase latitud y longitud)

 

2) la calle donde viví y crecí no esta en el sistema – como recuerdo la casa no tenia número – muy bien por no mentir SAP 🙂

3) la dirección de la escuela a la cual acudí (Colegio Modelo A.C.)

 

algo que no esta especificado en el ABC pero que es siempre muy agradable que tener son los códigos de errores. Recuerda que tus interfaces deben ser suficiente simples para que los usuarios puedan usarlas y también es un principio de las aplicaciones Fiori.

Adicionalmente, y señalado en la documentación, este servicio está disponible para integrarse con otros productos de SAP, por ejemplo: S/4HANA, CRM, ERP, Master Data Governance y SAP Data Services. Mi punto de vista de este blog solo cubre el servicio y como consumirse como servicio web.

 

De antemano, muchisimas Gracias por leer este blog. Favor de compartir sus comentarios, dudad y/o preguntas acerca de este servicio.

To report this post you need to login first.

Be the first to leave a comment

You must be Logged on to comment or reply to a post.

Leave a Reply