source.getHL7RepetitionCount

Use when: You want to read values from the original incoming message before any mapping changes. If you need the modified message during mapping, use message.getHL7RepetitionCount.

Signature: source.getHL7RepetitionCount(nodePath, instance*)

Returns: Integer count - the count of repetitions in the field for the nodePath array

Finds the count of repetitions in the field that matches nodePath.

Note

This method only applies to HL7 formatted messages.

Parameters

Type	Name	Description	Default
String	nodePath	the node path (HPath)
Integer	instance*	(optional) the segment instance to return. Use 1 for the first instance.	1

Example

// Given an HL7 source message with repeating phone numbers in PID-13.
/* source:
'MSH|^~\\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|202311071230||ADT^A01|123456|P|2.3\r' +
'PID|1||123456^^^&1.2.3.4&ISO||Doe^Jane||19850515|F|||123 Elm St^^Somecity^ST^12345||' +
'(555)123-4567^PRN^PH^^^555^1234567~' +
'(555)987-6543^WPN^PH^^^555^9876543~' +
'(555)111-2222^ORN^PH^^^555^1112222'
*/

// Retrieve the number of repetitions for the PID-13 field.
var phoneRepetitionCount = source.getHL7RepetitionCount('/PID-13'); // expected: 3