Extension Puntos

SEPA CT PASO2 CSM Service proporciona dos extension puntos para permitir que los clientes invoquen un procesamiento específico del cliente a nivel de mensaje. Un extension se proporciona un punto tanto para el procesamiento de mensajes 'Desde el Esquema' como 'Hasta el Esquema'. Cuando está habilitado, un mensaje se coloca en una cola o tema (JMS or Kafka se admiten) y las respuestas se procesan desde un tema/cola de respuestas. Para obtener detalles adicionales sobre temas/colas, consulte la sección de configuración.

Tanto 'Desde Esquema' como 'Hasta Esquema’extension los puntos pueden configurarse para que se agoten en caso de no recibir respuesta. Esto se tratará como un REJECT respuesta.

Desde el esquema Extension Punto

El Esquema Desde Extension el punto se encuentra a nivel de mensaje al procesar archivos del esquema. Después de que se haya procesado un archivo,Debulked y el principal SEPA CSM el flujo comienza a procesar los componentes, cada vez que se accede a un nuevo mensaje, el Extension se invocará el punto. Se pasará una referencia al componente más alto del mensaje (es decir, Encabezado de Grupo) a la implementación del cliente configurada. Este componente puede ser accedido directamente desde el component store, así como cualquier componente hijo que se encuentre debajo de él. Depende del cliente realizar cualquier preprocesamiento adicional que desee sobre estos componentes (por ejemplo, contabilidad, verificación de sanciones, validaciones de suma de verificación o conteo) antes de que las transacciones individuales sean procesadas a través del CSM y hacia los flujos implementados del Cliente en espera.

El Extension El punto esperará una respuesta del código externo, esta respuesta será simplemente una indicación de Éxito o Fracaso. El rendimiento y la latencia del código ejecutado durante esta etapa son responsabilidad del Cliente, el SEPA CSM no asume ninguna responsabilidad ni obligación por cualquier impacto en su funcionamiento general.

Si el Extension puntos devuelve una indicación de que el procesamiento fue un éxito, los componentes subyacentes dentro del mensaje serán procesados por el CSM como de costumbre.

Si el Extension puntos devuelve una indicación de que hubo un fallo, el procesamiento de los componentes subyacentes dentro del mensaje actual será omitido. Además de esto, un system event de nivel ERROR se eleva. Se convierte en responsabilidad del Cliente manejar el procesamiento necesario para el mensaje omitido (que permanece accesible en el Component store).

A Esquema Extension Punto

Un esquema An To Extension punto puede ser triggered durante la producción de la Bulk archivo. Una vez que cada mini-bulk ha sido finalizado y el mensaje relacionado está listo para ser añadido al archivo de salida, el Extension punto será triggered. Se pasará una referencia al componente final más alto del mensaje (es decir, Encabezado de Grupo) al código externo proporcionado por el Cliente. A partir de esta referencia, se puede acceder al componente en sí y a cualquier componente hijo subyacente, y se puede realizar el procesamiento (es decir, Contabilidad). El procesamiento ejecutado por un extension el punto tendrá un impacto en el rendimiento del CSM para producir el archivo de salida final, esto debe tenerse en cuenta al configurar los tiempos de búfer entre Bulks el cierre y el final de cada LAC, de modo que los archivos se entreguen al esquema dentro del LAC previsto. A diferencia de 'Desde el Esquema’Extension puntos, el procesamiento del mensaje 'no' se ve afectado si el extension punto indica que hubo una falla. Sin embargo, un system event de nivel ERROR se eleva. El mensaje en cuestión seguirá incluido en el archivo, es responsabilidad del cliente manejar cualquier procesamiento de excepciones necesario.

Events

Para más información sobre events criado en el SEPA scheme pack:SEPA System Events

API `ExtensionPointRequest`transmite el contenido en bruto del nivel de mensaje (por ejemplo, contenido pacs008) con Id de Componente y Componente Marker-para consultar opcionalmente el component store para recuperar más información sobre el mensaje, por ejemplo, contar el número de transacciones hijas

También contiene la dirección del mensaje que se está validando (TO_SCHEME o FROM_SCHEME)

`ExtensionPointResponse`indica el éxito o el fracaso del procesamiento.

El Extension Punto API La especificación está disponible aquí: API de Punto de Extensión

Cliente

Extension La documentación del cliente de Point puede encontrarse xref:sepact-csm-api:extension-point-client.adoc[aquí].

Configuración

Property Grouping: ipf.csm.sepa-ct.extension-point

Key Description Default Value

ipf.csm.sepa-ct.extension-point.enabled

When enabled sendToScheme/receiveFromScheme payment messages will be forwarded for extension processing. A rejection response will prevent processing of transactions in the message

false

ipf.csm.sepa-ct.extension-point.timeout.receive-from-scheme

When timeout has elapsed then an event will be raised to indicate that the receive from scheme extension point call has failed

"5s"

ipf.csm.sepa-ct.extension-point.timeout.send-to-scheme

When timeout has elapsed then an event will be raised to indicate that the send to scheme extension point call has failed

"5s"

Property Grouping: ipf.csm.sepa-ct.extension-point.jms

Key Description Default Value

ipf.csm.sepa-ct.extension-point.jms.consumer-window-size

0

ipf.csm.sepa-ct.extension-point.jms.failover-timeout

5000

ipf.csm.sepa-ct.extension-point.jms.request.queue

Queue to send extension point requests

"SEPA_EXTENSION_POINT_REQUEST"

ipf.csm.sepa-ct.extension-point.jms.response.queue

Queue to receive extension point responses

"SEPA_EXTENSION_POINT_RESPONSE"

Property Grouping: ipf.csm.sepa-ct.extension-point.kafka

Key Description Default Value

ipf.csm.sepa-ct.extension-point.kafka.consumer.kafka-clients.group.id

"csm-extension-point-group"

ipf.csm.sepa-ct.extension-point.kafka.consumer.restart-settings.max-backoff

"5s"

ipf.csm.sepa-ct.extension-point.kafka.consumer.restart-settings.max-restarts

5

ipf.csm.sepa-ct.extension-point.kafka.consumer.restart-settings.max-restarts-within

"10m"

ipf.csm.sepa-ct.extension-point.kafka.consumer.restart-settings.min-backoff

"1s"

ipf.csm.sepa-ct.extension-point.kafka.consumer.restart-settings.random-factor

0.25

ipf.csm.sepa-ct.extension-point.kafka.consumer.topic

Topic to receive extension point responses

"SEPA_EXTENSION_POINT_RESPONSE"

ipf.csm.sepa-ct.extension-point.kafka.producer.kafka-clients.client.id

"sepa-csm-extension-point-client"

ipf.csm.sepa-ct.extension-point.kafka.producer.restart-settings.max-backoff

"5s"

ipf.csm.sepa-ct.extension-point.kafka.producer.restart-settings.max-restarts

5

ipf.csm.sepa-ct.extension-point.kafka.producer.restart-settings.max-restarts-within

"10m"

ipf.csm.sepa-ct.extension-point.kafka.producer.restart-settings.min-backoff

"1s"

ipf.csm.sepa-ct.extension-point.kafka.producer.restart-settings.random-factor

0.25

ipf.csm.sepa-ct.extension-point.kafka.producer.topic

Topic to send extension point requests

"SEPA_EXTENSION_POINT_REQUEST"