Legacy special-character decoding

This private operation replaces a legacy placeholder token in a connection string returned by the DBConnectionAPI with the ASCII control character it represents, before the string is cached or returned to the caller.

Field	Value
Operation ID	OP-DBC-08
Trigger	Called internally by Retrieve with retry on a successful, non-empty HTTP response
Inputs	Raw connection string returned by the DBConnectionAPI
Outputs	Decoded connection string
Primary components	ConnectionClient.HandleLegacyConnectionString (private)
Entry point	src/SAIF.NetCore.DbConnectionClient/SAIF.NetCore.DBConnectionClient/SAIF.NetCore.DBConnectionClient/ConnectionClient.cs

Steps

1. Replace every literal occurrence of ZSPECIALCHAR in the returned string with (char)7 (ASCII BEL) (BR-DBC-12).

Process flow

flowchart TD
    Start([HandleLegacyConnectionString called]) --> Replace[Replace ZSPECIALCHAR tokens with char 7 BEL]
    Replace --> Done([Return decoded string])

Failure and edge-case behavior

• A connection string with no ZSPECIALCHAR tokens passes through unchanged.

Related documentation

• Operations and processes
• Business rules

Sources

• src/SAIF.NetCore.DbConnectionClient/SAIF.NetCore.DBConnectionClient/SAIF.NetCore.DBConnectionClient/ConnectionClient.cs