CSM Reachability - Cambios y Soluciones

Esta página cubre los cambios y correcciones proporcionados a CSM Reachability IPF Lanzamiento 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 el servicio 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 ConfiguracionesDelAgente.
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 Agente de Liquidación: 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 notificaciones a nivel de configuración:

 ipf.csm-reachability.should-send-notification.agent-clearing-settings-settings = false
 ipf.csm-reachability.should-send-notification.agent-settings-settings = false
 ipf.csm-reachability.should-send-notification.agent-settlement-settings-settings = false
 ipf.csm-reachability.should-send-notification.cs-agente-selección-configuración-ajustes = false
 ipf.csm-reachability.should-send-notification.generic-processing-settings-settings = false
 ipf.csm-reachability.should-send-notification.participant-settings = false
 ipf.csm-reachability.should-send-notification.party-entity-settings = false
 ipf.csm-reachability.should-send-notification.processing-entity-settings = false
 ipf.csm-reachability.should-send-notification.exclusion-list-settings = false
 ipf.csm-reachability.should-send-notification.iban-plus-settings = false
 ipf.csm-reachability.should-send-notification.iban-structure-settings = falso
 ipf.csm-reachability.should-send-notification.bicdir2018-settings = false

Estas notificaciones están desactivadas 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 la configuración del conector csm-reachability que se elimina:
- ipf.csm-reachability.settings-api.conector.entidad-de-procesamiento
- ipf.csm-reachability.settings-api.conector.entidad-de-partido
- ipf.csm-reachability.settings-api.conector.ajustes-de-procesamiento-genéricos
- ipf.csm-reachability.settings-api.conector.agente-configuración-de-limpieza
- ipf.csm-reachability.settings-api.connector.cs-agente-selección-configuraciones
- ipf.csm-reachability.settings-api.conector.ajustes-de-agente
- ipf.csm-reachability.settings-api.conector.ajustes-de-liquidación-del-agente
- ipf.csm-reachability.settings-api.conector.participante
- ipf.csm-reachability.settings-api.connector.participant-batch
- ipf.csm-reachability.settings-api.connector.participant-obtener-ids
- ipf.csm-reachability.settings-api.connector.exclusion-list
- ipf.csm-reachability.settings-api.connector.lista-de-exclusión-lote
- ipf.csm-reachability.settings-api.connector.exclusion-list-get-ids
- ipf.csm-reachability.settings-api.connector.get-all-iban-plus
- ipf.csm-reachability.settings-api.connector.get-all-iban-structure
- ipf.csm-reachability.settings-api.connector.get-batch-iban-structure
Esta configuración se utiliza en su lugar:

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

 conexión = 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}
 get-scheduled-settings = ${ipf.dps-api.default-connector}
 get-scheduled-setting = ${ipf.dps-api.default-connector}
 delete-scheduled-setting = ${ipf.dps-api.default-connector}
 update-scheduled-setting = ${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 realizarán. Tenga en cuenta que esto incluye el primer intento fallido.
 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 la gestión de ajustes APIs se utiliza:

 ipf.dps-api {
 http.client {
 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 configuraciones programadas y utiliza el Programador de Persistencia para su mantenimiento. Para configurar adecuadamente la persistencia scheduler es necesario 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 = falso

Ingesta de Datos

Cambiado

DPS v2 proporciona conectores y consultas directas, y en csm-reachability utilizamos esa implementación (csm-reachability custom la implementación es eliminada).
Para configurar adecuadamente la ingestión de archivos, 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 = "direct"

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

Las dos primeras 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 del cual el Directorio TIPS es válido.

CAMBIOS IMPORTANTES

Desde DPS v2 proporciona conectores y consultas directas listas para usar, la siguiente configuración de ingestión de datos de accesibilidad csm se elimina:
- 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.client {
 host = "localhost"
 endpoint-url = "/settings-objects/"
 puerto = 8080
 }
 }