message.getHL7RepetitionCount

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

Signature: message.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

// assumes `message` is an HL7 message model object, like:
//    MSH|^~\&|SendingApp|SendingFacility|ReceivingApp|ReceivingFacility|202311071230||ADT^A01|123456|P|2.3
//    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 = message.getHL7RepetitionCount('/PID-13'); // expected: 3