Extension Puntos
SEPA DD 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 ha 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 en 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 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 del 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 pacs002s2) 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:sepadd-csm-api:extension-point-client.adoc[aquí].
Configuración
Property Grouping: ipf.csm.sepa-dd.extension-point
| Key | Description | Default Value |
|---|---|---|
ipf.csm.sepa-dd.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 |
|
ipf.csm.sepa-dd.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 |
|
ipf.csm.sepa-dd.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 |
|
Property Grouping: ipf.csm.sepa-dd.extension-point.jms
| Key | Description | Default Value |
|---|---|---|
ipf.csm.sepa-dd.extension-point.jms.consumer-window-size |
|
|
ipf.csm.sepa-dd.extension-point.jms.failover-timeout |
|
|
ipf.csm.sepa-dd.extension-point.jms.request.queue |
Queue to send extension point requests |
|
ipf.csm.sepa-dd.extension-point.jms.response.queue |
Queue to receive extension point responses |
|
Property Grouping: ipf.csm.sepa-dd.extension-point.kafka
| Key | Description | Default Value |
|---|---|---|
ipf.csm.sepa-dd.extension-point.kafka.consumer.kafka-clients.group.id |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.restart-settings.max-backoff |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.restart-settings.max-restarts |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.restart-settings.max-restarts-within |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.restart-settings.min-backoff |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.restart-settings.random-factor |
|
|
ipf.csm.sepa-dd.extension-point.kafka.consumer.topic |
Topic to receive extension point responses |
|
ipf.csm.sepa-dd.extension-point.kafka.producer.kafka-clients.client.id |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.restart-settings.max-backoff |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.restart-settings.max-restarts |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.restart-settings.max-restarts-within |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.restart-settings.min-backoff |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.restart-settings.random-factor |
|
|
ipf.csm.sepa-dd.extension-point.kafka.producer.topic |
Topic to send extension point requests |
|