ODS - Cambios y Soluciones

Esta página cubre los cambios y correcciones proporcionados a ODS IPF Lanzamiento 2025.2.0

ODS

Nuevo

  • Versionado de PDS Objetos

    • Agregado pdsObjectId, versión y metadatos a PDS cargas útiles y entradas.

    • Enlaces añadidos a ambos el PDS historia y el yo ODS ID de objeto URL para el PDS objeto que se busca utilizando cualquiera de los PDS V2 API’s.

    • A new Akka Cluster Singleton puede ser habilitado para ejecutar una tarea de mantenimiento recurrente que enriquece el pdsObjectId campo para PDS objetos persistidos antes de la versión IPF 2025.2.0. Cuando está habilitado, legado PDS las entradas de la base de datos serán migradas gradualmente, permitiendo ODS Inquiry para buscarlos utilizando su pdsObjectId valor. Esta tarea se aplica a PDS objetos que actualmente no tienen un valor para el pdsObjectId campo.

  • Cambios de Configuración:

    • Para habilitar la tarea de limpieza recurrente que enriquece el pdsObjectId esto debe establecerse en verdadero, el valor predeterminado es falso.

      • ods.housekeeping.pds-object-id-enrichment.enabled

    • Para controlar el número máximo de PDS objetos que se enriquecerán en una única ejecución, el valor predeterminado es 1000.

      • ods.housekeeping.pds-object-id-enrichment.limit

  • Tarea de mantenimiento del campo de búsqueda de CSM

    • Una tarea de mantenimiento que enriquece el Resumen CSM campo de búsqueda para resúmenes persistidos antes de la versión IPF 2025.1.0.

    • Vea el Resumen de Enriquecimiento Csm documentación.

Cambiado

  • Versionado de PDS Objetos

    Cambiado /api/v2/all/pds-objects/{name} a /api/v2/all/pds-objects/{odsObjectId} para alinearse con otros datos de procesamiento API’s, este es un CAMBIO DRÁSTICO.

    • Cambiado /api/v2/all/pds-objects/{name}/historia a /api/v2/todos/objetos-pds/{pdsObjectId}/historia, esto se mantuvo compatible hacia atrás como pdsObjectId está compuesto por el unitOfWorkId y el nombre del tipo.

    • Obsoleto getLatestByUnitOfWorkIdAndName y getHistoryByUnitOfWorkIdAndName, a favor de getByOdsObjectId y getHistoryByPdsObjectId

    • Obsoleto GetPdsObjectRequest a favor de GetPdsRequest que solo se basa en el odsObjectId en lugar de un {unitOfWorkId} y un nombre de tipo.

    • Obsoleto GetHistoryRequest a favor de GetPdsHistoryRequest que solo se basa en el pdsObjectId en lugar de un {unitOfWorkId} y un nombre de tipo (pdsObjectId está compuesto por el {unitOfWorkId} y el nombre del tipo, por lo que es equivalente).

  • Cambio de Ruta de Configuración para la Tarea de Enriquecimiento de Identidad

    • Ruta de configuración para Resumen de Enriquecimiento de Identidad la tarea de limpieza se ha actualizado desde ods.persistence.housekeeping.summary.identity-enrichment to ods.housekeeping.summary-identity-enrichment.

    • Para mantener la compatibilidad hacia atrás, el enriquecedor de identidad aún admite las rutas de configuración más antiguas. Si se especifican tanto las rutas de configuración nuevas como las antiguas, la nueva ruta tendrá prioridad.

    • La tabla a continuación enumera todas las claves de configuración afectadas y sus correspondientes nuevos valores.

Configuración anterior Nueva configuración

ods.persistencia.mantenimiento.resumen.enriquecimiento-de-identidad.habilitado

ods.housekeeping.summary-identity-enrichment.enabled

ods.persistencia.mantenimiento.resumen.enriquecimiento-de-identidad.retraso-inicial

ods.housekeeping.summary-identity-enrichment.initial-delay

ods.persistencia.mantenimiento.resumen.enriquecimiento-de-identidad.frecuencia

ods.housekeeping.summary-identity-enrichment.frequency

ods.persistencia.mantenimiento.resumen.enriquecimiento-de-identidad.reiniciar-configuraciones.minimo-retroceso

ods.housekeeping.summary-identity-enrichment.restart-settings.min-backoff

ods.persistencia.mantenimiento.resumen.enriquecimiento-de-identidad.reiniciar-configuraciones.max-retraso

ods.housekeeping.summary-identity-enrichment.restart-settings.max-backoff

ods.persistence.housekeeping.summary.identity-enrichment.restart-settings.jitter-factor

ods.housekeeping.summary-identity-enrichment.restart-settings.jitter-factor

  • Reformatear transactionData in ODS detalles API(/api/v2/views/details/{unitOfWorkId})

    `transactionData`el campo ahora devuelve un objeto vacío y está en desuso.

    • Nuevo campo mds agregado al esquema de detalles, que devuelve todos los últimos mdsObjects para un unitOfWorkId, agrupados por MDS tipo de objeto.

  • Haga ODS versión de datos agnóstica

    • CSM y PaymentType PDS Los tipos ahora son configurables para métricas, pero también tienen una configuración predeterminada si se utiliza IPF y no tipos específicos del cliente.

    • Los valores de PDS para métricas ahora se extraen a través de la configuración utilizando JsonPointer la notación, se ha mantenido compatible hacia atrás para la notación de puntos.

      • Para migrar de la notación de puntos a JsonPointer notación, deberá reemplazar todos los puntos . con barras diagonales / y añada una barra inclinada / al comienzo de su camino, esto es porque JsonPointer requiere una barra inclinada inicial para indicar la raíz de la ruta. Aquí hay un ejemplo a continuación:

Antes:

ipf.business-metrics-processor.payment-metrics {
    currency {
      pds-type = SomeClientSpecificPdsType
      path = "details.paymentAmount.currency"
    }
}

Después:

ipf.business-metrics-processor.payment-metrics {
    currency {
      pds-type = SomeClientSpecificPdsType
      path = "/details/paymentAmount/currency"
    }
}

Fijo

  • Ahora existe la posibilidad de emitir OdsIngestionFailed(evento del sistema) en ods cuando falla la ingestión. Se requiere configurar lo explicado en la documentación de ods. PAY-13828

  • Ahora existe la posibilidad de emitir ArchiveBundlingFailed(suceso del sistema) en el archivo cuando falla al agrupar. Se requiere configurar lo explicado en la documentación de archivo. PAY-13828