001package org.hl7.fhir.r4.model.codesystems;
002
003/*
004  Copyright (c) 2011+, HL7, Inc.
005  All rights reserved.
006  
007  Redistribution and use in source and binary forms, with or without modification, 
008  are permitted provided that the following conditions are met:
009  
010   * Redistributions of source code must retain the above copyright notice, this 
011     list of conditions and the following disclaimer.
012   * Redistributions in binary form must reproduce the above copyright notice, 
013     this list of conditions and the following disclaimer in the documentation 
014     and/or other materials provided with the distribution.
015   * Neither the name of HL7 nor the names of its contributors may be used to 
016     endorse or promote products derived from this software without specific 
017     prior written permission.
018  
019  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
020  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
021  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
022  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
023  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
024  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
025  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
026  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
027  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
028  POSSIBILITY OF SUCH DAMAGE.
029  
030*/
031
032// Generated on Wed, Jan 30, 2019 16:19-0500 for FHIR v4.0.0
033
034import org.hl7.fhir.exceptions.FHIRException;
035
036public enum V3ParticipationType {
037
038  /**
039   * Indicates that the target of the participation is involved in some manner in
040   * the act, but does not qualify how.
041   */
042  PART,
043  /**
044   * Participations related, but not primary to an act. The Referring, Admitting,
045   * and Discharging practitioners must be the same person as those authoring the
046   * ControlAct event for their respective trigger events.
047   */
048  _PARTICIPATIONANCILLARY,
049  /**
050   * The practitioner who is responsible for admitting a patient to a patient
051   * encounter.
052   */
053  ADM,
054  /**
055   * The practitioner that has responsibility for overseeing a patient's care
056   * during a patient encounter.
057   */
058  ATND,
059  /**
060   * A person or organization who should be contacted for follow-up questions
061   * about the act in place of the author.
062   */
063  CALLBCK,
064  /**
065   * An advisor participating in the service by performing evaluations and making
066   * recommendations.
067   */
068  CON,
069  /**
070   * The practitioner who is responsible for the discharge of a patient from a
071   * patient encounter.
072   */
073  DIS,
074  /**
075   * Only with Transportation services. A person who escorts the patient.
076   */
077  ESC,
078  /**
079   * A person having referred the subject of the service to the performer
080   * (referring physician). Typically, a referring physician will receive a
081   * report.
082   */
083  REF,
084  /**
085   * Parties that may or should contribute or have contributed information to the
086   * Act. Such information includes information leading to the decision to perform
087   * the Act and how to perform the Act (e.g., consultant), information that the
088   * Act itself seeks to reveal (e.g., informant of clinical history), or
089   * information about what Act was performed (e.g., informant witness).
090   */
091  _PARTICIPATIONINFORMATIONGENERATOR,
092  /**
093   * Definition: A party that originates the Act and therefore has responsibility
094   * for the information given in the Act and ownership of this Act.
095   * 
096   * 
097   * Example: the report writer, the person writing the act definition, the
098   * guideline author, the placer of an order, the EKG cart (device) creating a
099   * report etc. Every Act should have an author. Authorship is regardless of mood
100   * always actual authorship.
101   * 
102   * Examples of such policies might include:
103   * 
104   * 
105   * 
106   * The author and anyone they explicitly delegate may update the report;
107   * 
108   * 
109   * 
110   * All administrators within the same clinic may cancel and reschedule
111   * appointments created by other administrators within that clinic;
112   * 
113   * 
114   * 
115   * A party that is neither an author nor a party who is extended authorship
116   * maintenance rights by policy, may only amend, reverse, override, replace, or
117   * follow up in other ways on this Act, whereby the Act remains intact and is
118   * linked to another Act authored by that other party.
119   */
120  AUT,
121  /**
122   * A source of reported information (e.g., a next of kin who answers questions
123   * about the patient's history). For history questions, the patient is logically
124   * an informant, yet the informant of history questions is implicitly the
125   * subject.
126   */
127  INF,
128  /**
129   * An entity entering the data into the originating system. The data entry
130   * entity is collected optionally for internal quality control purposes. This
131   * includes the transcriptionist for dictated text transcribed into electronic
132   * form.
133   */
134  TRANS,
135  /**
136   * A person entering the data into the originating system. The data entry person
137   * is collected optionally for internal quality control purposes. This includes
138   * the transcriptionist for dictated text.
139   */
140  ENT,
141  /**
142   * Only with service events. A person witnessing the action happening without
143   * doing anything. A witness is not necessarily aware, much less approves of
144   * anything stated in the service event. Example for a witness is students
145   * watching an operation or an advanced directive witness.
146   */
147  WIT,
148  /**
149   * An entity (person, organization or device) that is in charge of maintaining
150   * the information of this act (e.g., who maintains the report or the master
151   * service catalog item, etc.).
152   */
153  CST,
154  /**
155   * Target participant that is substantially present in the act and which is
156   * directly involved in the action (includes consumed material, devices, etc.).
157   */
158  DIR,
159  /**
160   * The target of an Observation action. Links an observation to a Role whose
161   * player is the substance or most specific component entity (material,
162   * micro-organism, etc.) being measured within the subject.
163   * 
164   * 
165   * Examples: A "plasma porcelain substance concentration" has analyte a Role
166   * with player substance Entity "porcelain".
167   * 
168   * 
169   * UsageNotes: The Role that this participation connects to may be any Role
170   * whose player is that substance measured. Very often, the scoper may indicate
171   * the system in which the component is being measured. E.g., for "plasma
172   * porcelain" the scoper could be "Plasma".
173   */
174  ALY,
175  /**
176   * In an obstetric service, the baby.
177   */
178  BBY,
179  /**
180   * The catalyst of a chemical reaction, such as an enzyme or a platinum surface.
181   * In biochemical reactions, connects the enzyme with the molecular interaction
182   */
183  CAT,
184  /**
185   * Participant material that is taken up, diminished, altered, or disappears in
186   * the act.
187   */
188  CSM,
189  /**
190   * Something incorporated in the subject of a therapy service to achieve a
191   * physiologic effect (e.g., heal, relieve, provoke a condition, etc.) on the
192   * subject. In an administration service the therapeutic agent is a consumable,
193   * in a preparation or dispense service, it is a product. Thus, consumable or
194   * product must be specified in accordance with the kind of service.
195   */
196  TPA,
197  /**
198   * Participant used in performing the act without being substantially affected
199   * by the act (i.e. durable or inert with respect to that particular service).
200   * 
201   * 
202   * Examples: monitoring equipment, tools, but also access/drainage lines,
203   * prostheses, pace maker, etc.
204   */
205  DEV,
206  /**
207   * A device that changes ownership due to the service, e.g., a pacemaker, a
208   * prosthesis, an insulin injection equipment (pen), etc. Such material may need
209   * to be restocked after he service.
210   */
211  NRD,
212  /**
213   * A device that does not change ownership due to the service, i.e., a surgical
214   * instrument or tool or an endoscope. The distinction between reuseable and
215   * non-reuseable must be made in order to know whether material must be
216   * re-stocked.
217   */
218  RDV,
219  /**
220   * In some organ transplantation services and rarely in transfusion services a
221   * donor will be a target participant in the service. However, in most cases
222   * transplantation is decomposed in three services: explantation, transport, and
223   * implantation. The identity of the donor (recipient) is often irrelevant for
224   * the explantation (implantation) service.
225   */
226  DON,
227  /**
228   * Description: The entity playing the associated role is the physical
229   * (including energy), chemical or biological substance that is participating in
230   * the exposure. For example in communicable diseases, the associated playing
231   * entity is the disease causing pathogen.
232   */
233  EXPAGNT,
234  /**
235   * Description:Direct participation in an exposure act where it is unknown that
236   * the participant is the source or subject of the exposure. If the participant
237   * is known to be the contact of an exposure then the SBJ participation type
238   * should be used. If the participant is known to be the source then the EXSRC
239   * participation type should be used.
240   */
241  EXPART,
242  /**
243   * Description: The entity playing the associated role is the target (contact)
244   * of exposure.
245   */
246  EXPTRGT,
247  /**
248   * Description:The entity playing the associated role is the source of exposure.
249   */
250  EXSRC,
251  /**
252   * Participant material that is brought forth (produced) in the act (e.g.,
253   * specimen in a specimen collection, access or drainage in a placement service,
254   * medication package in a dispense service). It does not matter whether the
255   * material produced had existence prior to the service, or whether it is
256   * created in the service (e.g., in supply services the product is taken from a
257   * stock).
258   */
259  PRD,
260  /**
261   * The principle target on which the action happens.
262   * 
263   * 
264   * Examples: The patient in physical examination, a specimen in a lab
265   * observation. May also be a patient's family member (teaching) or a device or
266   * room (cleaning, disinfecting, housekeeping).
267   * 
268   * 
269   * UsageNotes: Not all direct targets are subjects. Consumables and devices used
270   * as tools for an act are not subjects. However, a device may be a subject of a
271   * maintenance action.
272   */
273  SBJ,
274  /**
275   * The subject of non-clinical (e.g. laboratory) observation services is a
276   * specimen.
277   */
278  SPC,
279  /**
280   * Target that is not substantially present in the act and which is not directly
281   * affected by the act, but which will be a focus of the record or documentation
282   * of the act.
283   */
284  IND,
285  /**
286   * Target on behalf of whom the service happens, but that is not necessarily
287   * present in the service. Can occur together with direct target to indicate
288   * that a target is both, as in the case where the patient is the indirect
289   * beneficiary of a service rendered to a family member, e.g. counseling or
290   * given home care instructions. This concept includes a participant, such as a
291   * covered party, who derives benefits from a service act covered by a coverage
292   * act.
293   * 
294   * Note that the semantic role of the intended recipient who benefits from the
295   * happening denoted by the verb in the clause. Thus, a patient who has no
296   * coverage under a policy or program may be a beneficiary of a health service
297   * while not being the beneficiary of coverage for that service.
298   */
299  BEN,
300  /**
301   * Definition: A factor, such as a microorganism, chemical substance, or form of
302   * radiation, whose presence, excessive presence, or (in deficiency diseases)
303   * relative absence is essential, in whole or in part, for the occurrence of a
304   * condition.
305   * 
306   * Constraint: The use of this participation is limited to observations.
307   */
308  CAGNT,
309  /**
310   * The target participation for an individual in a health care coverage act in
311   * which the target role is either the policy holder of the coverage, or a
312   * covered party under the coverage.
313   */
314  COV,
315  /**
316   * The target person or organization contractually recognized by the issuer as a
317   * participant who has assumed fiscal responsibility for another personaTMs
318   * financial obligations by guaranteeing to pay for amounts owed to a particular
319   * account
320   * 
321   * 
322   * Example:The subscriber of the patientaTMs health insurance policy signs a
323   * contract with the provider to be fiscally responsible for the patient billing
324   * account balance amount owed.
325   */
326  GUAR,
327  /**
328   * Participant who posses an instrument such as a financial contract (insurance
329   * policy) usually based on some agreement with the author.
330   */
331  HLD,
332  /**
333   * The record target indicates whose medical record holds the documentation of
334   * this act. This is especially important when the subject of a service is not
335   * the patient himself.
336   */
337  RCT,
338  /**
339   * The person (or organization) who receives the product of an Act.
340   */
341  RCV,
342  /**
343   * A party, who may or should receive or who has recieved the Act or subsequent
344   * or derivative information of that Act. Information recipient is inert, i.e.,
345   * independent of mood." Rationale: this is a generalization of a too diverse
346   * family that the definition can't be any more specific, and the concept is
347   * abstract so one of the specializations should be used.
348   */
349  IRCP,
350  /**
351   * An information recipient to notify for urgent matters about this Act. (e.g.,
352   * in a laboratory order, critical results are being called by phone right away,
353   * this is the contact to call; or for an inpatient encounter, a next of kin to
354   * notify when the patient becomes critically ill).
355   */
356  NOT,
357  /**
358   * Information recipient to whom an act statement is primarily directed. E.g., a
359   * primary care provider receiving a discharge letter from a hospitalist, a
360   * health department receiving information on a suspected case of infectious
361   * disease. Multiple of these participations may exist on the same act without
362   * requiring that recipients be ranked as primary vs. secondary.
363   */
364  PRCP,
365  /**
366   * A participant (e.g. provider) who has referred the subject of an act (e.g.
367   * patient).
368   * 
369   * Typically, a referred by participant will provide a report (e.g. referral).
370   */
371  REFB,
372  /**
373   * The person who receives the patient
374   */
375  REFT,
376  /**
377   * A secondary information recipient, who receives copies (e.g., a primary care
378   * provider receiving copies of results as ordered by specialist).
379   */
380  TRC,
381  /**
382   * The facility where the service is done. May be a static building (or room
383   * therein) or a moving location (e.g., ambulance, helicopter, aircraft, train,
384   * truck, ship, etc.)
385   */
386  LOC,
387  /**
388   * The destination for services. May be a static building (or room therein) or a
389   * movable facility (e.g., ship).
390   */
391  DST,
392  /**
393   * A location where data about an Act was entered.
394   */
395  ELOC,
396  /**
397   * The location of origin for services. May be a static building (or room
398   * therein) or a movable facility (e.g., ship).
399   */
400  ORG,
401  /**
402   * Some services take place at multiple concurrent locations (e.g.,
403   * telemedicine, telephone consultation). The location where the principal
404   * performing actor is located is taken as the primary location (LOC) while the
405   * other location(s) are considered "remote."
406   */
407  RML,
408  /**
409   * For services, an intermediate location that specifies a path between origin
410   * an destination.
411   */
412  VIA,
413  /**
414   * Definition: A person, non-person living subject, organization or device that
415   * who actually and principally carries out the action. Device should only be
416   * assigned as a performer in circumstances where the device is performing
417   * independent of human intervention. Need not be the principal responsible
418   * actor.
419   * 
420   * 
421   * Exampe: A surgery resident operating under supervision of attending surgeon,
422   * a search and rescue dog locating survivors, an electronic laboratory analyzer
423   * or the laboratory discipline requested to perform a laboratory test. The
424   * performer may also be the patient in self-care, e.g. fingerstick blood sugar.
425   * The traditional order filler is a performer. This information should
426   * accompany every service event.
427   * 
428   * 
429   * Note: that existing HL7 designs assign an organization as the playing entity
430   * of the Role that is the performer. These designs should be revised in
431   * subsequent releases to make this the scooping entity for the role involved.
432   */
433  PRF,
434  /**
435   * Distributes material used in or generated during the act.
436   */
437  DIST,
438  /**
439   * The principal or primary performer of the act.
440   */
441  PPRF,
442  /**
443   * A person assisting in an act through his substantial presence and involvement
444   * This includes: assistants, technicians, associates, or whatever the job
445   * titles may be.
446   */
447  SPRF,
448  /**
449   * The person or organization that has primary responsibility for the act. The
450   * responsible party is not necessarily present in an action, but is accountable
451   * for the action through the power to delegate, and the duty to review actions
452   * with the performing actor after the fact. This responsibility may be ethical,
453   * legal, contractual, fiscal, or fiduciary in nature.
454   * 
455   * 
456   * Example: A person who is the head of a biochemical laboratory; a sponsor for
457   * a policy or government program.
458   */
459  RESP,
460  /**
461   * A person who verifies the correctness and appropriateness of the service
462   * (plan, order, event, etc.) and hence takes on accountability.
463   */
464  VRF,
465  /**
466   * A verifier who attests to the accuracy of an act, but who does not have
467   * privileges to legally authenticate the act. An example would be a resident
468   * physician who sees a patient and dictates a note, then later signs it. Their
469   * signature constitutes an authentication.
470   */
471  AUTHEN,
472  /**
473   * A verifier who legally authenticates the accuracy of an act. An example would
474   * be a staff physician who sees a patient and dictates a note, then later signs
475   * it. Their signature constitutes a legal authentication.
476   */
477  LA,
478  /**
479   * added to help the parsers
480   */
481  NULL;
482
483  public static V3ParticipationType fromCode(String codeString) throws FHIRException {
484    if (codeString == null || "".equals(codeString))
485      return null;
486    if ("PART".equals(codeString))
487      return PART;
488    if ("_ParticipationAncillary".equals(codeString))
489      return _PARTICIPATIONANCILLARY;
490    if ("ADM".equals(codeString))
491      return ADM;
492    if ("ATND".equals(codeString))
493      return ATND;
494    if ("CALLBCK".equals(codeString))
495      return CALLBCK;
496    if ("CON".equals(codeString))
497      return CON;
498    if ("DIS".equals(codeString))
499      return DIS;
500    if ("ESC".equals(codeString))
501      return ESC;
502    if ("REF".equals(codeString))
503      return REF;
504    if ("_ParticipationInformationGenerator".equals(codeString))
505      return _PARTICIPATIONINFORMATIONGENERATOR;
506    if ("AUT".equals(codeString))
507      return AUT;
508    if ("INF".equals(codeString))
509      return INF;
510    if ("TRANS".equals(codeString))
511      return TRANS;
512    if ("ENT".equals(codeString))
513      return ENT;
514    if ("WIT".equals(codeString))
515      return WIT;
516    if ("CST".equals(codeString))
517      return CST;
518    if ("DIR".equals(codeString))
519      return DIR;
520    if ("ALY".equals(codeString))
521      return ALY;
522    if ("BBY".equals(codeString))
523      return BBY;
524    if ("CAT".equals(codeString))
525      return CAT;
526    if ("CSM".equals(codeString))
527      return CSM;
528    if ("TPA".equals(codeString))
529      return TPA;
530    if ("DEV".equals(codeString))
531      return DEV;
532    if ("NRD".equals(codeString))
533      return NRD;
534    if ("RDV".equals(codeString))
535      return RDV;
536    if ("DON".equals(codeString))
537      return DON;
538    if ("EXPAGNT".equals(codeString))
539      return EXPAGNT;
540    if ("EXPART".equals(codeString))
541      return EXPART;
542    if ("EXPTRGT".equals(codeString))
543      return EXPTRGT;
544    if ("EXSRC".equals(codeString))
545      return EXSRC;
546    if ("PRD".equals(codeString))
547      return PRD;
548    if ("SBJ".equals(codeString))
549      return SBJ;
550    if ("SPC".equals(codeString))
551      return SPC;
552    if ("IND".equals(codeString))
553      return IND;
554    if ("BEN".equals(codeString))
555      return BEN;
556    if ("CAGNT".equals(codeString))
557      return CAGNT;
558    if ("COV".equals(codeString))
559      return COV;
560    if ("GUAR".equals(codeString))
561      return GUAR;
562    if ("HLD".equals(codeString))
563      return HLD;
564    if ("RCT".equals(codeString))
565      return RCT;
566    if ("RCV".equals(codeString))
567      return RCV;
568    if ("IRCP".equals(codeString))
569      return IRCP;
570    if ("NOT".equals(codeString))
571      return NOT;
572    if ("PRCP".equals(codeString))
573      return PRCP;
574    if ("REFB".equals(codeString))
575      return REFB;
576    if ("REFT".equals(codeString))
577      return REFT;
578    if ("TRC".equals(codeString))
579      return TRC;
580    if ("LOC".equals(codeString))
581      return LOC;
582    if ("DST".equals(codeString))
583      return DST;
584    if ("ELOC".equals(codeString))
585      return ELOC;
586    if ("ORG".equals(codeString))
587      return ORG;
588    if ("RML".equals(codeString))
589      return RML;
590    if ("VIA".equals(codeString))
591      return VIA;
592    if ("PRF".equals(codeString))
593      return PRF;
594    if ("DIST".equals(codeString))
595      return DIST;
596    if ("PPRF".equals(codeString))
597      return PPRF;
598    if ("SPRF".equals(codeString))
599      return SPRF;
600    if ("RESP".equals(codeString))
601      return RESP;
602    if ("VRF".equals(codeString))
603      return VRF;
604    if ("AUTHEN".equals(codeString))
605      return AUTHEN;
606    if ("LA".equals(codeString))
607      return LA;
608    throw new FHIRException("Unknown V3ParticipationType code '" + codeString + "'");
609  }
610
611  public String toCode() {
612    switch (this) {
613    case PART:
614      return "PART";
615    case _PARTICIPATIONANCILLARY:
616      return "_ParticipationAncillary";
617    case ADM:
618      return "ADM";
619    case ATND:
620      return "ATND";
621    case CALLBCK:
622      return "CALLBCK";
623    case CON:
624      return "CON";
625    case DIS:
626      return "DIS";
627    case ESC:
628      return "ESC";
629    case REF:
630      return "REF";
631    case _PARTICIPATIONINFORMATIONGENERATOR:
632      return "_ParticipationInformationGenerator";
633    case AUT:
634      return "AUT";
635    case INF:
636      return "INF";
637    case TRANS:
638      return "TRANS";
639    case ENT:
640      return "ENT";
641    case WIT:
642      return "WIT";
643    case CST:
644      return "CST";
645    case DIR:
646      return "DIR";
647    case ALY:
648      return "ALY";
649    case BBY:
650      return "BBY";
651    case CAT:
652      return "CAT";
653    case CSM:
654      return "CSM";
655    case TPA:
656      return "TPA";
657    case DEV:
658      return "DEV";
659    case NRD:
660      return "NRD";
661    case RDV:
662      return "RDV";
663    case DON:
664      return "DON";
665    case EXPAGNT:
666      return "EXPAGNT";
667    case EXPART:
668      return "EXPART";
669    case EXPTRGT:
670      return "EXPTRGT";
671    case EXSRC:
672      return "EXSRC";
673    case PRD:
674      return "PRD";
675    case SBJ:
676      return "SBJ";
677    case SPC:
678      return "SPC";
679    case IND:
680      return "IND";
681    case BEN:
682      return "BEN";
683    case CAGNT:
684      return "CAGNT";
685    case COV:
686      return "COV";
687    case GUAR:
688      return "GUAR";
689    case HLD:
690      return "HLD";
691    case RCT:
692      return "RCT";
693    case RCV:
694      return "RCV";
695    case IRCP:
696      return "IRCP";
697    case NOT:
698      return "NOT";
699    case PRCP:
700      return "PRCP";
701    case REFB:
702      return "REFB";
703    case REFT:
704      return "REFT";
705    case TRC:
706      return "TRC";
707    case LOC:
708      return "LOC";
709    case DST:
710      return "DST";
711    case ELOC:
712      return "ELOC";
713    case ORG:
714      return "ORG";
715    case RML:
716      return "RML";
717    case VIA:
718      return "VIA";
719    case PRF:
720      return "PRF";
721    case DIST:
722      return "DIST";
723    case PPRF:
724      return "PPRF";
725    case SPRF:
726      return "SPRF";
727    case RESP:
728      return "RESP";
729    case VRF:
730      return "VRF";
731    case AUTHEN:
732      return "AUTHEN";
733    case LA:
734      return "LA";
735    case NULL:
736      return null;
737    default:
738      return "?";
739    }
740  }
741
742  public String getSystem() {
743    return "http://terminology.hl7.org/CodeSystem/v3-ParticipationType";
744  }
745
746  public String getDefinition() {
747    switch (this) {
748    case PART:
749      return "Indicates that the target of the participation is involved in some manner in the act, but does not qualify how.";
750    case _PARTICIPATIONANCILLARY:
751      return "Participations related, but not primary to an act. The Referring, Admitting, and Discharging practitioners must be the same person as those authoring the ControlAct event for their respective trigger events.";
752    case ADM:
753      return "The practitioner who is responsible for admitting a patient to a patient encounter.";
754    case ATND:
755      return "The practitioner that has responsibility for overseeing a patient's care during a patient encounter.";
756    case CALLBCK:
757      return "A person or organization who should be contacted for follow-up questions about the act in place of the author.";
758    case CON:
759      return "An advisor participating in the service by performing evaluations and making recommendations.";
760    case DIS:
761      return "The practitioner who is responsible for the discharge of a patient from a patient encounter.";
762    case ESC:
763      return "Only with Transportation services.  A person who escorts the patient.";
764    case REF:
765      return "A person having referred the subject of the service to the performer (referring physician).  Typically, a referring physician will receive a report.";
766    case _PARTICIPATIONINFORMATIONGENERATOR:
767      return "Parties that may or should contribute or have contributed information to the Act. Such information includes information leading to the decision to perform the Act and how to perform the Act (e.g., consultant), information that the Act itself seeks to reveal (e.g., informant of clinical history), or information about what Act was performed (e.g., informant witness).";
768    case AUT:
769      return "Definition: A party that originates the Act and therefore has responsibility for the information given in the Act and ownership of this Act.\r\n\n                        \n                           Example: the report writer, the person writing the act definition, the guideline author, the placer of an order, the EKG cart (device) creating a report etc. Every Act should have an author. Authorship is regardless of mood always actual authorship. \r\n\n                        Examples of such policies might include:\r\n\n                        \n                           \n                              The author and anyone they explicitly delegate may update the report;\r\n\n                           \n                           \n                              All administrators within the same clinic may cancel and reschedule appointments created by other administrators within that clinic;\r\n\n                           \n                        \n                        A party that is neither an author nor a party who is extended authorship maintenance rights by policy, may only amend, reverse, override, replace, or follow up in other ways on this Act, whereby the Act remains intact and is linked to another Act authored by that other party.";
770    case INF:
771      return "A source of reported information (e.g., a next of kin who answers questions about the patient's history).  For history questions, the patient is logically an informant, yet the informant of history questions is implicitly the subject.";
772    case TRANS:
773      return "An entity entering the data into the originating system. The data entry entity is collected optionally for internal quality control purposes. This includes the transcriptionist for dictated text transcribed into electronic form.";
774    case ENT:
775      return "A person entering the data into the originating system.  The data entry person is collected optionally for internal quality control purposes.  This includes the transcriptionist for dictated text.";
776    case WIT:
777      return "Only with service events.  A person witnessing the action happening without doing anything.  A witness is not necessarily aware, much less approves of anything stated in the service event.  Example for a witness is students watching an operation or an advanced directive witness.";
778    case CST:
779      return "An entity (person, organization or device) that is in charge of maintaining the information of this act (e.g., who maintains the report or the master service catalog item, etc.).";
780    case DIR:
781      return "Target participant  that is substantially present in the act  and which is directly involved in the action (includes consumed material, devices, etc.).";
782    case ALY:
783      return "The target of an Observation action. Links an observation to a Role whose player is the substance or most specific component entity (material, micro-organism, etc.) being measured within the subject.\r\n\n                        \n                           Examples: A \"plasma porcelain substance concentration\" has analyte a Role with player substance Entity \"porcelain\".\r\n\n                        \n                           UsageNotes: The Role that this participation connects to may be any Role whose player is that substance measured. Very often, the scoper may indicate the system in which the component is being measured. E.g., for \"plasma porcelain\" the scoper could be \"Plasma\".";
784    case BBY:
785      return "In an obstetric service, the baby.";
786    case CAT:
787      return "The catalyst of a chemical reaction, such as an enzyme or a platinum surface. In biochemical reactions, connects the enzyme with the molecular interaction";
788    case CSM:
789      return "Participant material that is taken up, diminished, altered, or disappears in the act.";
790    case TPA:
791      return "Something incorporated in the subject of a therapy service to achieve a physiologic effect (e.g., heal, relieve, provoke a condition, etc.) on the subject.  In an administration service the therapeutic agent is a consumable, in a preparation or dispense service, it is a product.  Thus, consumable or product must be specified in accordance with the kind of service.";
792    case DEV:
793      return "Participant used in performing the act without being substantially affected by the act (i.e. durable or inert with respect to that particular service).\r\n\n                        \n                           Examples: monitoring equipment, tools, but also access/drainage lines, prostheses, pace maker, etc.";
794    case NRD:
795      return "A device that changes ownership due to the service, e.g., a pacemaker, a prosthesis, an insulin injection equipment (pen), etc.  Such material may need to be restocked after he service.";
796    case RDV:
797      return "A device that does not change ownership due to the service, i.e., a surgical instrument or tool or an endoscope.  The distinction between reuseable and non-reuseable must be made in order to know whether material must be re-stocked.";
798    case DON:
799      return "In some organ transplantation services and rarely in transfusion services a donor will be a target participant in the service.  However, in most cases transplantation is decomposed in three services: explantation, transport, and implantation.  The identity of the donor (recipient) is often irrelevant for the explantation (implantation) service.";
800    case EXPAGNT:
801      return "Description: The entity playing the associated role is the physical (including energy), chemical or biological substance that is participating in the exposure.  For example in communicable diseases, the associated playing entity is the disease causing pathogen.";
802    case EXPART:
803      return "Description:Direct participation in an exposure act where it is unknown that the participant is the source or subject of the exposure.  If the participant is known to be the contact of an exposure then the SBJ participation type should be used.  If the participant is known to be the source then the EXSRC participation type should be used.";
804    case EXPTRGT:
805      return "Description: The entity playing the associated role is the target (contact) of exposure.";
806    case EXSRC:
807      return "Description:The entity playing the associated role is the source of exposure.";
808    case PRD:
809      return "Participant material that is brought forth (produced) in the act (e.g., specimen in a specimen collection, access or drainage in a placement service, medication package in a dispense service). It does not matter whether the material produced had existence prior to the service, or whether it is created in the service (e.g., in supply services the product is taken from a stock).";
810    case SBJ:
811      return "The principle target on which the action happens.\r\n\n                        \n                           Examples: The patient in physical examination, a specimen in a lab observation. May also be a patient's family member (teaching) or a device or room (cleaning, disinfecting, housekeeping). \r\n\n                        \n                           UsageNotes: Not all direct targets are subjects. Consumables and devices used as tools for an act are not subjects. However, a device may be a subject of a maintenance action.";
812    case SPC:
813      return "The subject of non-clinical (e.g. laboratory) observation services is a specimen.";
814    case IND:
815      return "Target that is not substantially present in the act and which is not directly affected by the act, but which will be a focus of the record or documentation of the act.";
816    case BEN:
817      return "Target on behalf of whom the service happens, but that is not necessarily present in the service.  Can occur together with direct target to indicate that a target is both, as in the case where the patient is the indirect beneficiary of a service rendered to a family member, e.g. counseling or given home care instructions.  This concept includes a participant, such as a covered party, who derives benefits from a service act covered by a coverage act.\r\n\n                        Note that the semantic role of the intended recipient who benefits from the happening denoted by the verb in the clause.  Thus, a patient who has no coverage under a policy or program may be a beneficiary of a health service while not being the beneficiary of coverage for that service.";
818    case CAGNT:
819      return "Definition: A factor, such as a microorganism, chemical substance, or form of radiation, whose presence, excessive presence, or (in deficiency diseases) relative absence is essential, in whole or in part, for the occurrence of a condition.\r\n\n                        Constraint:  The use of this participation is limited to observations.";
820    case COV:
821      return "The target participation for an individual in a health care coverage act in which the target role is either the policy holder of the coverage, or a covered party under the coverage.";
822    case GUAR:
823      return "The target person or organization contractually recognized by the issuer as a participant who has assumed fiscal responsibility for another personaTMs financial obligations by guaranteeing to pay for amounts owed to a particular account\r\n\n                        \n                           Example:The subscriber of the patientaTMs health insurance policy signs a contract with the provider to be fiscally responsible for the patient billing account balance amount owed.";
824    case HLD:
825      return "Participant who posses an instrument such as a financial contract (insurance policy) usually based on some agreement with the author.";
826    case RCT:
827      return "The record target indicates whose medical record holds the documentation of this act.  This is especially important when the subject of a service is not the patient himself.";
828    case RCV:
829      return "The person (or organization) who receives the product of an Act.";
830    case IRCP:
831      return "A party, who may or should receive or who has recieved the Act or subsequent or derivative information of that Act. Information recipient is inert, i.e., independent of mood.\" Rationale: this is a generalization of a too diverse family that the definition can't be any more specific, and the concept is abstract so one of the specializations should be used.";
832    case NOT:
833      return "An information recipient to notify for urgent matters about this Act. (e.g., in a laboratory order, critical results are being called by phone right away, this is the contact to call; or for an inpatient encounter, a next of kin to notify when the patient becomes critically ill).";
834    case PRCP:
835      return "Information recipient to whom an act statement is primarily directed. E.g., a primary care provider receiving a discharge letter from a hospitalist, a health department receiving information on a suspected case of infectious disease. Multiple of these participations may exist on the same act without requiring that recipients be ranked as primary vs. secondary.";
836    case REFB:
837      return "A participant (e.g. provider) who has referred the subject of an act (e.g. patient).\r\n\n                        Typically, a referred by participant will provide a report (e.g. referral).";
838    case REFT:
839      return "The person who receives the patient";
840    case TRC:
841      return "A secondary information recipient, who receives copies (e.g., a primary care provider receiving copies of results as ordered by specialist).";
842    case LOC:
843      return "The facility where the service is done.  May be a static building (or room therein) or a moving location (e.g., ambulance, helicopter, aircraft, train, truck, ship, etc.)";
844    case DST:
845      return "The destination for services.  May be a static building (or room therein) or a movable facility (e.g., ship).";
846    case ELOC:
847      return "A location where data about an Act was entered.";
848    case ORG:
849      return "The location of origin for services.  May be a static building (or room therein) or a movable facility (e.g., ship).";
850    case RML:
851      return "Some services take place at multiple concurrent locations (e.g., telemedicine, telephone consultation).  The location where the principal performing actor is located is taken as the primary location (LOC) while the other location(s) are considered \"remote.\"";
852    case VIA:
853      return "For services, an intermediate location that specifies a path between origin an destination.";
854    case PRF:
855      return "Definition: A person, non-person living subject, organization or device that who actually and principally carries out the action. Device should only be assigned as a performer in circumstances where the device is performing independent of human intervention.  Need not be the principal responsible actor.\r\n\n                        \n                           Exampe: A surgery resident operating under supervision of attending surgeon, a search and rescue dog locating survivors, an electronic laboratory analyzer or the laboratory discipline requested to perform a laboratory test. The performer may also be the patient in self-care, e.g. fingerstick blood sugar. The traditional order filler is a performer. This information should accompany every service event.\r\n\n                        \n                           Note: that existing HL7 designs assign an organization as the playing entity of the Role that is the performer.  These designs should be revised in subsequent releases to make this the scooping entity for the role involved.";
856    case DIST:
857      return "Distributes material used in or generated during the act.";
858    case PPRF:
859      return "The principal or primary performer of the act.";
860    case SPRF:
861      return "A person assisting in an act through his substantial presence and involvement   This includes: assistants, technicians, associates, or whatever the job titles may be.";
862    case RESP:
863      return "The person or organization that has primary responsibility for the act.  The responsible party is not necessarily present in an action, but is accountable for the action through the power to delegate, and the duty to review actions with the performing actor after the fact.  This responsibility may be ethical, legal, contractual, fiscal, or fiduciary in nature.\r\n\n                        \n                           Example: A person who is the head of a biochemical laboratory; a sponsor for a policy or government program.";
864    case VRF:
865      return "A person who verifies the correctness and appropriateness of the service (plan, order, event, etc.) and hence takes on accountability.";
866    case AUTHEN:
867      return "A verifier who attests to the accuracy of an act, but who does not have privileges to legally authenticate the act. An example would be a resident physician who sees a patient and dictates a note, then later signs it. Their signature constitutes an authentication.";
868    case LA:
869      return "A verifier who legally authenticates the accuracy of an act. An example would be a staff physician who sees a patient and dictates a note, then later signs it. Their signature constitutes a legal authentication.";
870    case NULL:
871      return null;
872    default:
873      return "?";
874    }
875  }
876
877  public String getDisplay() {
878    switch (this) {
879    case PART:
880      return "Participation";
881    case _PARTICIPATIONANCILLARY:
882      return "ParticipationAncillary";
883    case ADM:
884      return "admitter";
885    case ATND:
886      return "attender";
887    case CALLBCK:
888      return "callback contact";
889    case CON:
890      return "consultant";
891    case DIS:
892      return "discharger";
893    case ESC:
894      return "escort";
895    case REF:
896      return "referrer";
897    case _PARTICIPATIONINFORMATIONGENERATOR:
898      return "ParticipationInformationGenerator";
899    case AUT:
900      return "author (originator)";
901    case INF:
902      return "informant";
903    case TRANS:
904      return "Transcriber";
905    case ENT:
906      return "data entry person";
907    case WIT:
908      return "witness";
909    case CST:
910      return "custodian";
911    case DIR:
912      return "direct target";
913    case ALY:
914      return "analyte";
915    case BBY:
916      return "baby";
917    case CAT:
918      return "catalyst";
919    case CSM:
920      return "consumable";
921    case TPA:
922      return "therapeutic agent";
923    case DEV:
924      return "device";
925    case NRD:
926      return "non-reuseable device";
927    case RDV:
928      return "reusable device";
929    case DON:
930      return "donor";
931    case EXPAGNT:
932      return "ExposureAgent";
933    case EXPART:
934      return "ExposureParticipation";
935    case EXPTRGT:
936      return "ExposureTarget";
937    case EXSRC:
938      return "ExposureSource";
939    case PRD:
940      return "product";
941    case SBJ:
942      return "subject";
943    case SPC:
944      return "specimen";
945    case IND:
946      return "indirect target";
947    case BEN:
948      return "beneficiary";
949    case CAGNT:
950      return "causative agent";
951    case COV:
952      return "coverage target";
953    case GUAR:
954      return "guarantor party";
955    case HLD:
956      return "holder";
957    case RCT:
958      return "record target";
959    case RCV:
960      return "receiver";
961    case IRCP:
962      return "information recipient";
963    case NOT:
964      return "ugent notification contact";
965    case PRCP:
966      return "primary information recipient";
967    case REFB:
968      return "Referred By";
969    case REFT:
970      return "Referred to";
971    case TRC:
972      return "tracker";
973    case LOC:
974      return "location";
975    case DST:
976      return "destination";
977    case ELOC:
978      return "entry location";
979    case ORG:
980      return "origin";
981    case RML:
982      return "remote";
983    case VIA:
984      return "via";
985    case PRF:
986      return "performer";
987    case DIST:
988      return "distributor";
989    case PPRF:
990      return "primary performer";
991    case SPRF:
992      return "secondary performer";
993    case RESP:
994      return "responsible party";
995    case VRF:
996      return "verifier";
997    case AUTHEN:
998      return "authenticator";
999    case LA:
1000      return "legal authenticator";
1001    case NULL:
1002      return null;
1003    default:
1004      return "?";
1005    }
1006  }
1007
1008}