camt.057.001.06 mapper

The camt.057 mappers are a pair of inbound and outbound mappers.

camt.057 inbound mapper

This mapper maps the NtfctnToRcv messages to ISF messages. The default mapper name is Camt057ToISFMapper.

camt.057 outbound mapper

This mapper maps the ISF messages to NtfctnToRcv messages. The default mapper name is ISFToCamt057Mapper.

For example, the default Message From Target2 channel is configured with a CONFIG=HVP_MAP_CFG_MSG_FROM_TARGET2 parameter. When a camt.057.001.06 message is received, the mapper searches the value table to find the <msgTypeCfg> entry to use for the message. It searches for a value table entry that meets the following conditions.

• The category is HVP_MAP_CFG_MSG_FROM_TARGET2.
• The <msgTypeCfg> entry has a <type> child element with the value of camt.057.*.

The default <msgTypeCfg> entry for HVP_MAP_CFG_MSG_FROM_TARGET2 is shown in the following example.

<msgTypeCfg>
   <class>CAMT057</class>
   <subType>HVP_FROM_CSM_GEN_NOTIF_TO_RCV</subType>
   <extendedCfg>
      <name>MASTER_FLAG</name>
      <value>Y</value>
   </extendedCfg>
   <extendedCfg>
      <name>MAP_FOR_HVP</name>
      <value>Y</value>
   </extendedCfg>
   <pt>
      <class>CAMT057</class>
      <subType>HVP_FROM_CSM_GEN_NOTIF_TO_RCV</subType>
   </pt>
   <mapName>Camt057ToISFMapper</mapName>
   <type>camt.057.*</type>
</msgTypeCfg>

The following table shows the default configuration parameters for channels that use the camt.057 inbound mapper.

The following elements can have data present either at the notification level or the item level, and these elements follow a common rule:

• Debtor
• DebtorAgent
• IntermediaryAgent
• AccountOwner
• AccountServicer
• ExpectedValueDate
• Account
• RelatedAccount

During inbound mapping, priority is given to the data at item level over notification level. Data is always checked for at the item level first. If data is present at the item level, then data at the notification level (if present), is ignored. The data is checked at the notification level when data is not available at the item level.

The inbound mapper handles the datetime elements by using the following rules.

• If a time zone offset is included in the datetime value, the datetime value is mapped to ISF with the UTC time zone.
• If a time zone offset is not included in a datetime value, the following rules are used.
  • If the time zone is configured in the Channel table, the input datetime value is recognized in the format of the channel time zone. It is mapped to ISF with the UTC time zone.
  • If the time zone is not configured in the Channel table, the input datetime value is recognized in the format of the local time zone where the mapper is running. The input datetime is mapped to ISF with the UTC time zone.

For example, the default Message To Target2 channel is configured with a CONFIG=HVP_MAP_CFG_MSG_TO_TARGET2 parameter. When an ISF message is received, the mapper searches the value table to find the <msgTypeCfg> entry to use for the message. It searches for a value table entry that meets the following conditions.

• The category is one of the following values.
  • The value from the Environment.PMP.Variables.Rules.*[1].MAP_CONFIG parameter, if the parameter is available.
  • HVP_MAP_CFG_MSG_TO_TARGET2 is used when the Environment.PMP.Variables.Rules.*[1].MAP_CONFIG parameter is not available.
• The <msgTypeCfg> entry has a <subType> child element with a value that is the same as the ISF business concept.

The default <msgTypeCfg> entry for HVP_MAP_CFG_MSG_TO_TARGET2 is shown in the following example.

<msgTypeCfg>
   <class>CAMT057</class>
   <subType>HVP_TO_CSM_GEN_NOTIF_TO_RCV</subType>
   <extendedCfg>
      <name>MASTER_FLAG</name>
      <value>N</value>
   </extendedCfg>
   <extendedCfg>
      <name>MAP_FOR_HVP</name>
      <value>Y</value>
   </extendedCfg>
   <pt>
      <class>CAMT057</class>
      <subType>HVP_TO_CSM_GEN_NOTIF_TO_RCV</subType>
   </pt>
   <mapName>ISFToCamt057Mapper</mapName>
   <type>camt.057.001.06</type>
</msgTypeCfg>

The following table shows the values from the <msgTypeCfg> entry that are used as configuration parameters by the outbound mapper.

The following table shows the default configuration parameters for the channels that use the camt.057 outbound mapper.

The outbound mapper must refer to a mapper configuration, which is a common configuration for the following group of elements. This configuration determines whether to populate the data for these elements at the notification level or the item level.

• Debtor
• DebtorAgent
• IntermediaryAgent
• AccountOwner
• AccountServicer
• ExpectedValueDate
• Account
• RelatedAccount

If any of the subsequent transactions have a different value, then the map fails, as values must be the same if the configuration populated the data at the notification level.

The following table describes the rules and their configuration values.

The outbound mapper handles the datetime elements by using the following rules.

• If the time zone is configured in the Channel table, the input datetime value is mapped from the UTC time zone to the format of the channel time zone.
• If the time zone is not configured in the Channel table, the local time zone where the mapper is running is used. The input datetime value is mapped from the UTC time zone to the format of the local time zone.

The outbound mapper uses the TS_INCLUDE_OFFSET channel parameter to control whether the time zone offset is included in the output datetime values.

• If TS_INCLUDE_OFFSET is set to Y, the time zone offset is included in the output datetime values.
• If TS_INCLUDE_OFFSET is set to N or not configured, the time zone offset is not included in the output datetime values.