Preguntas frecuentes

¿Cómo solicitar adecuación de los datos en ambientes preproductivos? arrow2-down
¿Qué debo hacer para reusar las APIs de MDM en producción? arrow2-down

Debe solicitar la capacidad a través del formulario de reuso. Una vez se recibamos la solicitud te enviaremos un correo solicitando la siguiente información:

  • Confirmación funcional de cada una de las API (validación del uso de los campos en la API): acá debes confirmar que se validaron los campos (mencionar los campos) y que se están obteniendo de forma correcta (imagen con la evidencia, donde se observe la respuesta con los campos requeridos).
  • Plan de pruebas en ambientes previos (DEV, QA): es necesario que nos compartas tu Plan de Pruebas en VSTS tanto DEV como QA. Así como el resultado de pruebas de estrés o carga, en caso de no haberlas realizado, compártenos el motivo porque el que no se hicieron.
¿Qué debo hacer para reusar las APIs de MDM en ambientes preproductivos? arrow2-down

Dado que MDM es el maestro de clientes para el banco y que contiene información sensible, confidencial y que puede impactar varios procesos, tenemos unos pasos exclusivos para los reúsos de nuestros productos APIs: solicitar la aprobación de la GSIC.

 

Para conocer nuestro proceso de reúso puedes ingresar al Portal Funcional de MDM (debes estar conectado a la VPN)

  • Ten en cuenta que MDM tiene alta demanda de reúso por sprint, por lo que la reserva de capacidad que se realiza se hace por sprint y por ambiente, es decir, en un sprint solo atendemos un ambiente (DEV, QA, PDN). Por lo tanto, si requieres pasar a otro ambiente en el siguiente sprint o continuar con el apoyo debes diligenciar el formulario de reúso .
  • Las solicitudes se reciben hasta el viernes antes del inicio del sprint, dado que el lunes se analizamos la capacidad del equipo.
  • Si el consumidor no requiere la capacidad solicitada en el sprint, nos debe informar mediante correo para poder asignar esa capacidad a otro consumidor que se encuentre en espera.
¿Cómo puedo conocer la descripción de un valor? arrow2-down

Las APIs de MDM devuelven los valores de catálogos en formato MDM (APIC10) por lo tanto, si requieres la descripción para mostrarlo en la experiencia (Ejemplo: La API le retorna ROLNEG_01 y el consumidor requiere saber la descripción) contamos con servicios batch y online para consultar los catálogos y sus descripciones.

 

Por lo tanto:

  • Si requieres consultar una descripción de un catálogo puntual (1 a 1) puede hacer uso del API de catálogos maestros “Reference Data Management - Master Catalogue”. Ejemplo: requiere consultar a que equivale el ROLNEG_01 para un cliente.
  • Si requieres consultar todos los valores de catálogos de MDM o todos los valores de un catálogo (Ejemplo: requiere consultar la descripción de todos los códigos CIIU) debe hacer uso del servicio batch de catálogos del back de MDM (PKG_CATALOGOS).
  • Si requieres consultar la descripción de Países, Departamentos y Ciudades debes hacer uso del servicio batch de Catálogo Geográfico del back de MDM (PKG_CATALOGOS_GEOGRAFICOS.
¿Cómo puedo ampliar la información de la documentación funcional del portal de APIs? arrow2-down

Es común que los consumidores conozcan los nombres funcionales de los campos, pero cuando van al DO o a la documentación no identifican la API que contiene el campo.

 

En MDM contamos con un portal funcional para que los consumidores puedan revisar en que API se encuentra el campo que requieren, para posteriormente solicitar la asesoría con el Analista SOA y mapearlo al API y al nombre técnico.

¿Cómo definir una regla para saber si es cliente banco, Nequi o BALM? arrow2-down

En este caso la definición de la regla depende del proceso, por lo que te recomendamos que solicites una asesoría con la GSIC en caso de que tengas dudas. Con ellos podrás revisar el proceso y definir cuál sería el criterio de selección. La asesoría debe solicitarse a través del siguiente formulario de teams: Portal de Asesorías GSIC.

  • Proceso Impactado: Administrar información de clientes
    Tipo de Asesoría: Asesoría Funcional de MDM
¿Cómo modificar los catálogos de MDM o crear nuevos valores en ellos? arrow2-down

Los catálogos de MDM son los que se tienen en los maestros de clientes, por lo tanto, no se pueden modificar directamente en MDM. Los catálogos maestros en todas las fuentes maestras de clientes son administrados por la GSIC, por lo tanto, para solicitar un cambio debes radicar una solicitud de asesoría a la GSIC: Portal de Asesorías GSIC.

  • Proceso Impactado: Administrar parámetros de clientes
  • Tipo de Asesoría: Solución de Inquietudes
¿Una API de Customer Contact me puede retornar múltiples valores? arrow2-down

Sí. Un cliente puede tener varias direcciones.

  • Una Persona Natural puede tener dos direcciones, la de residencia y la laboral (una de ellas marcada como principal).
  • Una Persona Jurídica puede tener n direcciones, la dirección de la sede principal y n direcciones de las sedes alternas (una de ellas marcada como dirección principal).

Cuando el API te retorne más de un registro, la recomendación es que tomes la dirección que se encuentre marcada como principal ("addressType": "MARCAC_XXDEFAULT"), sin embargo, si tienes dudas de la regla a definir puedes solicitar asesoría con la GSIC para que se revise el proceso y se defina cual sería el criterio de selección. La asesoría debe solicitarse a través del siguiente formulario de teams: Portal de Asesorías GSIC.

  • Proceso Impactado: Administrar información de clientes
  • Tipo de Asesoría: Asesoría Funcional de MDM
¿Cómo validar valores actuales, incluir nuevos o cambiar descripciones? arrow2-down

Estos temas son validados por el área funcional o administradores de los datos de MDM, por lo tanto, debes solicitar la asesoría con la GSIC en el siguiente formulario de teams: Portal de Asesorías GSIC.

  • Proceso Impactado: Administrar información de clientes
  • Tipo de Asesoría: Asesoría Funcional de MDM