ISCareTeam.Principal

Description

Returns True if the specified provider is to be the principal care team member for the team role specified above.

Syntax

object.Principal

Part Attribute Type Description
object Required
The object always implements the ISCareTeam interface

Return Value

bool

Example

Display Principal for the care team member.

Dim aPatient
Dim aCareTeamFilter
Dim aCareTeams, aCareTeam
Dim i
Dim aProvider
Dim aMessage

Set aPatient = Profile.SelectPatient
set aCareTeamFilter = Profile.CreateCareTeamFilter

aCareTeamFilter.Patient = aPatient.Id

set aCareTeams = Profile.LoadCareTeams(aCareTeamFilter)

aMessage = "Team Member Count = " & aCareTeams.Count & vbNewLine & vbNewLine 
for i = 0 to aCareTeams.Count - 1
  set aCareTeam = aCareTeams.Item(i)
  
  if aCareTeam.PersonId <= 0 then  
    aMessage = aMessage & "Provider: UNASSIGNED"
  else
    set aProvider = Profile.LoadProviderById(aCareTeam.PersonId)  
    aMessage = aMessage & "Provider: " & aProvider.FullName
  end if      
   
  aMessage = aMessage & vbNewLine &_
    "The provider is to be the principal care team member: " &_
    aCareTeam.Principal & vbNewLine & vbNewLine  
next 
Profile.MsgBox (aMessage)
Note: A Care Team may have several principals, but only one active member for each Team Role may be designated as the principal.

In Profile Client v8 on User Interface the Principal checkbox can be checked in Clinical > Care Team > Edit Care Team > General or Clinical > Medical Record > Care Team > Edit Care Team > General.

Version information

Added in v7.8.0