CSM Reachability - Cambios y Soluciones

Esta página cubre los cambios y correcciones proporcionados a CSM Reachability Liberación de IPF 2025.2.0

CSM Reachability API

Nuevo

Nuevos atributos de solicitud para determine-processing-entity punto final - deriveDirectParticipant y csmAgentId.
Cuando deriveDirectParticipant se establece en verdadero, el CSM Reachability service buscará un participante directo asociado con el identificador de entidad proporcionado antes de utilizar el identificador del participante directo derivado para derivar la Entidad de Procesamiento. El valor predeterminado es falso.

CSM Reachability

Nuevo

Nuevo campo buscable agentParticipantCsmAgentId para Configuración De Agente.
Nuevo atributo de configuración que se utiliza para la generación de todos API puntos finales para una configuración particular. También se utilizan en la construcción index-config.<tipo-de-configuración> que se describirá a continuación.
- Entidad de Procesamiento: SETTING_TYPE = "processingentity".
- Entidad de Parte: TIPO_DE_CONFIGURACIÓN = "partyentity".
- Configuración de Procesamiento Genérico: TIPO_DE_CONFIGURACIÓN = "genericprocessingsettings".
- Configuración de Aclaración de Agentes: TIPO_DE_CONFIGURACIÓN = "agentclearingsettings".
- Configuración de Selección de Agentes de Cs: TIPO_DE_CONFIGURACIÓN = "csagentselectionsettings".
- Configuración del Agente: TIPO_DE_CONFIGURACIÓN = "agentsettings".
- Configuración de Liquidación de Agentes: TIPO_DE_CONFIGURACIÓN = "agentsettlementsettings".
- Configuración del Participante: TIPO_DE_CONFIGURACIÓN = "participante".
- Configuración de la Lista de Exclusión: TIPO_DE_CONFIGURACIÓN = "exclusionlist".
- Configuración de IbanPlus: TIPO_DE_CONFIGURACIÓN = "ibanplus"
- Configuración de IbanStructure: TIPO_DE_CONFIGURACIÓN = ibanstructure
- Bic Dir2018 Configuraciones: TIPO_DE_CONFIGURACIÓN = "bicdir2018"
DPS v2 permite que los índices sean configurados a través de HOCON config. Todos los índices existentes para cada configuración se añaden a través de nuevos parámetros de configuración:
- ipf.dps.mongodb.index-config.processingentity
- ipf.dps.mongodb.index-config.partyentity
- ipf.dps.mongodb.index-config.genericprocessingsettings
- ipf.dps.mongodb.index-config.agentclearingsetting
- ipf.dps.mongodb.index-config.csagentselectionsetting
- ipf.dps.mongodb.index-config.agentsettingsettings
- ipf.dps.mongodb.index-config.agentsettlementsettings
- ipf.dps.mongodb.index-config.participant
- ipf.dps.mongodb.index-config.exclusionlist
- ipf.dps.mongodb.index-config.ibanplus
- ipf.dps.mongodb.index-config.ibanstructure
- ipf.dps.mongodb.index-config.bicdir2018
Los índices pueden ser añadidos a través de estas propiedades. Solo tenga en cuenta que los campos que están bajo la configuración de carga útil deben ser definidos como ["values.payload.fields"]. Ejemplo de creación de índice:

ipf.dps.mongodb.index-config.agentsettlementsettings.index-3 = ["values.payload.agentUnique Id:ASC"]

Nuevas propiedades para habilitar notifications en el nivel de configuración:

 ipf.csm-reachability.should-enviar-notificación.agente-configuración-limpieza-configuración = falso
 ipf.csm-reachability.should-enviar-notificación.configuración-agente-configuración = false
 ipf.csm-reachability.should-enviar-notificación.agente-configuración-de-liquidación-configuración = falso
 ipf.csm-reachability.should-enviar-notificación.cs-agente-selección-configuraciones-ajustes = falso
 ipf.csm-reachability.should-enviar-notificación.ajustes-de-procesamiento-genéricos-ajustes = falso
 ipf.csm-reachability.should-enviar-notificación.ajustes-participante = false
 ipf.csm-reachability.should-enviar-notificación.entidad-partido-configuraciones = false
 ipf.csm-reachability.should-enviar-notificación.configuración-entidad-procesamiento = false
 ipf.csm-reachability.should-enviar-notificación.configuración-lista-exclusión = falso
 ipf.csm-reachability.should-enviar-notificación.iban-plus-configuración = false
 ipf.csm-reachability.should-enviar-notificación.estructura-iban-ajustes = false
 ipf.csm-reachability.should-enviar-notificación.bicdir2018-configuración = falso

Estos notifications están deshabilitados por defecto para cada una de estas configuraciones.

CAMBIOS IMPORTANTES

Los módulos de configuración del repositorio se eliminan de CSM Reachability proyecto. Toda la configuración está ahora bajo la configuración de módulos de dominio.
Los siguientes módulos han sido eliminados:
- setting-processingentity-repository
- setting-partyentity-repository
- setting-genericprocessingsettings-repository
- setting-agentclearingsettings-repository
- setting-csagentselectionsettings-repository
- setting-agentsettings-repository
- setting-agentsettlementsettings-repository
- setting-participant-repository
- setting-ibanplus-repository
- setting-exclusionlist-repository
- setting-ibanstructure-repository
- setting-bicvalidationfilehandling-repository
Desde DPS v2 proporciona conectores y consultas directas listas para usar, siguiendo csm- La configuración del conector de alcanzabilidad ha sido eliminada:
- ipf.csm-configuración.dealcance-api.conector.entidad-de-procesamiento
- ipf.csm-configuración.dealcance-api.conector.entidad-de-partido
- ipf.csm-configuración.dealcance-api.conector.ajustes-de-procesamiento-genérico
- ipf.csm-configuración.dealcance-api.conector.ajustes-de-liquidación-de-agentes
- ipf.csm-configuración.dealcance-api.conector.cs-agente-selección-configuraciones
- ipf.csm-configuración.dealcance-api.conector.configuración-del-agente
- ipf.csm-configuración.dealcance-api.conector.agente-configuración-de-liquidación
- ipf.csm-configuración.dealcance-api.conector.participante
- ipf.csm-configuración.dealcance-api.conector.participante-lote
- ipf.csm-configuración.dealcance-api.connector.participant-get-ids
- ipf.csm-configuración.dealcance-api.connector.lista-de-exclusión
- ipf.csm-configuración.dealcance-api.connector.exclusion-list-batch
- ipf.csm-configuración.dealcance-api.connector.exclusion-list-get-ids
- ipf.csm-configuración.dealcance-api.connector.get-all-iban-plus
- ipf.csm-configuración.dealcance-api.connector.get-all-iban-structure
- ipf.csm-alcance.configuraciones-api.connector.get-batch-iban-structure
Esta configuración se utiliza en su lugar:

ipf.dps-api{
 http.cliente {
 host = "localhost"
 endpoint-url = "/settings-objects/"
 puerto = 8080
 }
 http.cliente = ${? settings-api.http.client}

 connection =http
 connection = ${? settings-api.connection}
 conector {
 search-setting = ${ipf.dps-api.default-connector}
 search-ids-setting = ${ipf.dps-api.default-connector}
 search-request-setting = ${ipf.dps-api.default-connector}
 delete-setting = ${ipf.dps-api.default-connector}
 obtener-scheduled-configuración = ${ipf.dps-api.default-connector}
 obtener-scheduled-configuración = ${ipf.dps-api.default-connector}
 eliminar-scheduled-configuración = ${ipf.dps-api.default-connector}
 actualizar-scheduled-configuración = ${ipf.dps-api.default-connector}
 create-setting = ${ipf.dps-api.default-connector}
 update-setting = ${ipf.dps-api.default-connector}
 get-setting = ${ipf.dps-api.default-connector}
 setting-schemas = ${ipf.dps-api.default-connector}
 history-settings = ${ipf.dps-api.default-connector}
 approve-settings = ${ipf.dps-api.default-connector}
 get-approvals-setting = ${ipf.dps-api.default-connector}
 get-approval-setting = ${ipf.dps-api.default-connector}
 reject-setting = ${ipf.dps-api.default-connector}
 }

 default-connector {
 resiliency-settings {
 # Determina el número máximo de reintentos que se pueden realizar. Tenga en cuenta que esto incluye el primero failed intento.
 max-attempts = 2
 # Reintente si HTTP el código de error está en la lista
 códigos-de-estado-reintentables = [500, 503]
 # Determina el número mínimo de llamadas (dentro de un período de ventana deslizante) que deben realizarse antes de que el interruptor de circuito pueda calcular la tasa de error para determinar la salud del transporte.
 minimum-number-of-calls = 10
 }
 resiliency-settings = ${? csm-reachability-api.resiliency-settings}
 }
}

Propiedad ipf.csm-reachability.settings-api.http.client se elimina y la siguiente configuración para gestionar el setting management API s se utiliza:

 ipf.dps-api{
 http.cliente {
 host = "localhost"
 endpoint-url = "/settings-objects/"
 puerto = 8080
 }
 }

En cada creación de configuración,DPS v2 consulta el settings-approvals colección para verificar si esa configuración ya ha sido creada y está a la espera de aprobación. Así que, esto settings-approvals se debe crear la colección.
DPS v2 introduce scheduled configuraciones y usos Persistencia Scheduler para su mantenimiento. Con el fin de configurar adecuadamente la persistencia scheduler hay una necesidad de crear dos nuevas colecciones y sus índices.
La siguiente configuración debe ser añadida a su base de datos (ejemplo cosmos-schema.yaml):

- name: settings-approvals
  shard_key: _id
  throughput: 10000
  additional_indexes:
    - keys:
        - entityId
      unique: false-keys:
        - resolvedStatus
      unique: false-keys:
        - entityCollection
      unique: false-keys:
        - lastUpdatedAt
      unique: false-name: jobSpecification
  throughput: 400
  default_ttl_seconds: 3600 # should be tied to deleteTime
  additional_indexes:
    - keys:
        - deleteTime
      unique: false-keys:
        - _id.jobSpecificationId
        - _id.lastUpdated
      unique: false-name: jobExecutionStatus
  throughput: 400
  default_ttl_seconds: 3600 # should be tied to deleteTime
  additional_indexes:
    - keys:
        - deleteTime
      unique: false-keys:
        - _id.jobSpecificationId
        - _id.lastUpdated
      unique: false

Los clientes que utilizan Cosmos deben desactivar la creación automática de índices configurando la siguiente propiedad:

 ipf.mongodb.create-indexes = false

Ingesta de Datos

Cambiado

DPS v2 proporciona conectores y consultas directas, y en csm-alcanzabilidad utilizamos esa implementación (csm-alcanzabilidad custom se elimina la implementación).
Para configurar la ingestión de archivos correctamente, necesitamos establecer las siguientes propiedades:

 # opciones posibles ['directo' | 'conector'], el valor predeterminado es 'directo' de DpsClientDirectAutoConfiguration y DpsClientConnectorAutoConfiguration respectivamente
 ipf.dps-api.client-type = "direct"
 # opciones posibles ['directo' | 'http'], el valor predeterminado es 'directo' de ApiDirectQueryConfiguration y CsmSettingsApiConnectorConfiguration respectivamente
 ipf.csm-reachability.settings-api.connection = "directo"

 # opciones posibles ['directo' | 'http'], el valor predeterminado es 'directo' de GenericFileConverterConfiguration
 ipf.csm-reachability.settings-api.file-handling.connection = "directo"

Las primeras dos propiedades deben coincidir (directo-directo o connector-http) para configurar adecuadamente consultas directas o la implementación de conectores desde DPS v2.

Fijo

La convención de nomenclatura de archivos para la ingestión de archivos TIPS es fija, el formato es TIPSXXXTTTTYYYYMMDD.
- TTTT es el tipo, es decir, FULL para la versión completa y DLTA para la versión delta. XXX es la moneda relacionada con los registros incluidos en el directorio; YYYYMMDD especifica el año, mes y día a partir de los cuales el Directorio TIPS es válido.

CAMBIOS IMPORTANTES

Desde DPS v2 proporciona conectores y consultas directas listas para usar, siguiendo csm La configuración de ingesta de datos de alcanzabilidad ha sido eliminada:
- ipf.csm-reachability.settings-api.connector.settings-api-rr
- ipf.csm-reachability.settings-api.http.client
Esta configuración se utiliza en su lugar:

 ipf.dps-api{
 http.cliente {
 host = "localhost"
 endpoint-url = "/settings-objects/"
 puerto = 8080
 }
 }