ISLetter.LinkEncounter

Description

This function links the encounter to the letter of the selected patient.

Syntax

object.LinkEncounter aEncounter

Part Attribute Type Description
object Required
The object always implements the ISLetter interface
aEncounter In, Required
The encounter linked to the letter

Example

Link the encounter to the letter of the selected patient and display its ID.

sub main
  Dim aPatient
  Dim aLetters, aLetter
  Dim aEncounters, aEncounter 
  Dim aMessage

  Set aPatient = Profile.SelectPatient
  set aLetters = aPatient.GetLetters (1) ' slcfWordRTF
  
  aMessage = "INITIAL STATE:" & GetLinkedEncountersInfo(aLetters)

  set aEncounters = aPatient.Encounters.Last5Years 
  for each aLetter in aLetters 
    for each aEncounter in aEncounters
      aLetter.LinkEncounter aEncounter
    next
  next

  aMessage = aMessage & vbNewLine & vbNewLine &_ 
    "LETTERS AFTER ENCOUNTERS LINKING:" & GetLinkedEncountersInfo(aLetters) & vbNewLine

  Profile.MsgBox(aMessage)
end sub

function GetLinkedEncountersInfo(aLetters)
  Dim aEncounters, aEncounter
  Dim aInfo
  Dim aLetter
  
  for each aLetter in aLetters
    aInfo = aInfo & vbNewLine & "Letter ID: " & aLetter.ID
    set aEncounters = aLetter.LinkedEncounters
    if aEncounters.Count > 0 then aInfo = aInfo & vbNewLine & "  Encounter IDs: "   
    for each aEncounter in aEncounters
      aInfo = aInfo & aEncounter.Id & ", "
    next
  next
  GetLinkedEncountersInfo = aInfo
end function 
Note: This function throws exception when the link between the objects already exists.

In Profile Client v8 on User Interface CDO Forms can be linked in Clinical > Medical Record > Documents > Open saved document > Attachments > Encounters or in Organisation > Work Centre > Communication > Letters > Open saved document > Attachments > Encounters.

See also

Version information

Added in v8.4.59