001package org.hl7.fhir.dstu3.model.codesystems;
002
003
004
005
006/*
007  Copyright (c) 2011+, HL7, Inc.
008  All rights reserved.
009  
010  Redistribution and use in source and binary forms, with or without modification, 
011  are permitted provided that the following conditions are met:
012  
013   * Redistributions of source code must retain the above copyright notice, this 
014     list of conditions and the following disclaimer.
015   * Redistributions in binary form must reproduce the above copyright notice, 
016     this list of conditions and the following disclaimer in the documentation 
017     and/or other materials provided with the distribution.
018   * Neither the name of HL7 nor the names of its contributors may be used to 
019     endorse or promote products derived from this software without specific 
020     prior written permission.
021  
022  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND 
023  ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
024  WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 
025  IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 
026  INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT 
027  NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 
028  PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 
029  WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
030  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 
031  POSSIBILITY OF SUCH DAMAGE.
032  
033*/
034
035// Generated on Sat, Mar 25, 2017 21:03-0400 for FHIR v3.0.0
036
037
038import org.hl7.fhir.exceptions.FHIRException;
039
040public enum V3ParticipationType {
041
042        /**
043         * Indicates that the target of the participation is involved in some manner in the act, but does not qualify how.
044         */
045        PART, 
046        /**
047         * 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.
048         */
049        _PARTICIPATIONANCILLARY, 
050        /**
051         * The practitioner who is responsible for admitting a patient to a patient encounter.
052         */
053        ADM, 
054        /**
055         * The practitioner that has responsibility for overseeing a patient's care during a patient encounter.
056         */
057        ATND, 
058        /**
059         * A person or organization who should be contacted for follow-up questions about the act in place of the author.
060         */
061        CALLBCK, 
062        /**
063         * An advisor participating in the service by performing evaluations and making recommendations.
064         */
065        CON, 
066        /**
067         * The practitioner who is responsible for the discharge of a patient from a patient encounter.
068         */
069        DIS, 
070        /**
071         * Only with Transportation services.  A person who escorts the patient.
072         */
073        ESC, 
074        /**
075         * A person having referred the subject of the service to the performer (referring physician).  Typically, a referring physician will receive a report.
076         */
077        REF, 
078        /**
079         * 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).
080         */
081        _PARTICIPATIONINFORMATIONGENERATOR, 
082        /**
083         * Definition: A party that originates the Act and therefore has responsibility for the information given in the Act and ownership of this Act.
084
085                        
086                           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. 
087
088                        Examples of such policies might include:
089
090                        
091                           
092                              The author and anyone they explicitly delegate may update the report;
093
094                           
095                           
096                              All administrators within the same clinic may cancel and reschedule appointments created by other administrators within that clinic;
097
098                           
099                        
100                        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.
101         */
102        AUT, 
103        /**
104         * 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.
105         */
106        INF, 
107        /**
108         * 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.
109         */
110        TRANS, 
111        /**
112         * 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.
113         */
114        ENT, 
115        /**
116         * 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.
117         */
118        WIT, 
119        /**
120         * 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.).
121         */
122        CST, 
123        /**
124         * Target participant  that is substantially present in the act  and which is directly involved in the action (includes consumed material, devices, etc.).
125         */
126        DIR, 
127        /**
128         * 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.
129
130                        
131                           Examples: A "plasma porcelain substance concentration" has analyte a Role with player substance Entity "porcelain".
132
133                        
134                           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".
135         */
136        ALY, 
137        /**
138         * In an obstetric service, the baby.
139         */
140        BBY, 
141        /**
142         * The catalyst of a chemical reaction, such as an enzyme or a platinum surface. In biochemical reactions, connects the enzyme with the molecular interaction
143         */
144        CAT, 
145        /**
146         * Participant material that is taken up, diminished, altered, or disappears in the act.
147         */
148        CSM, 
149        /**
150         * 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.
151         */
152        TPA, 
153        /**
154         * Participant used in performing the act without being substantially affected by the act (i.e. durable or inert with respect to that particular service).
155
156                        
157                           Examples: monitoring equipment, tools, but also access/drainage lines, prostheses, pace maker, etc.
158         */
159        DEV, 
160        /**
161         * 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.
162         */
163        NRD, 
164        /**
165         * 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.
166         */
167        RDV, 
168        /**
169         * 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.
170         */
171        DON, 
172        /**
173         * 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.
174         */
175        EXPAGNT, 
176        /**
177         * 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.
178         */
179        EXPART, 
180        /**
181         * Description: The entity playing the associated role is the target (contact) of exposure.
182         */
183        EXPTRGT, 
184        /**
185         * Description:The entity playing the associated role is the source of exposure.
186         */
187        EXSRC, 
188        /**
189         * 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).
190         */
191        PRD, 
192        /**
193         * The principle target on which the action happens.
194
195                        
196                           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). 
197
198                        
199                           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.
200         */
201        SBJ, 
202        /**
203         * The subject of non-clinical (e.g. laboratory) observation services is a specimen.
204         */
205        SPC, 
206        /**
207         * 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.
208         */
209        IND, 
210        /**
211         * 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.
212
213                        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.
214         */
215        BEN, 
216        /**
217         * 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.
218
219                        Constraint:  The use of this participation is limited to observations.
220         */
221        CAGNT, 
222        /**
223         * 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.
224         */
225        COV, 
226        /**
227         * 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
228
229                        
230                           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.
231         */
232        GUAR, 
233        /**
234         * Participant who posses an instrument such as a financial contract (insurance policy) usually based on some agreement with the author.
235         */
236        HLD, 
237        /**
238         * 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.
239         */
240        RCT, 
241        /**
242         * The person (or organization) who receives the product of an Act.
243         */
244        RCV, 
245        /**
246         * 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.
247         */
248        IRCP, 
249        /**
250         * 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).
251         */
252        NOT, 
253        /**
254         * 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.
255         */
256        PRCP, 
257        /**
258         * A participant (e.g. provider) who has referred the subject of an act (e.g. patient).
259
260                        Typically, a referred by participant will provide a report (e.g. referral).
261         */
262        REFB, 
263        /**
264         * The person who receives the patient
265         */
266        REFT, 
267        /**
268         * A secondary information recipient, who receives copies (e.g., a primary care provider receiving copies of results as ordered by specialist).
269         */
270        TRC, 
271        /**
272         * 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.)
273         */
274        LOC, 
275        /**
276         * The destination for services.  May be a static building (or room therein) or a movable facility (e.g., ship).
277         */
278        DST, 
279        /**
280         * A location where data about an Act was entered.
281         */
282        ELOC, 
283        /**
284         * The location of origin for services.  May be a static building (or room therein) or a movable facility (e.g., ship).
285         */
286        ORG, 
287        /**
288         * 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."
289         */
290        RML, 
291        /**
292         * For services, an intermediate location that specifies a path between origin an destination.
293         */
294        VIA, 
295        /**
296         * 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.
297
298                        
299                           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.
300
301                        
302                           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.
303         */
304        PRF, 
305        /**
306         * Distributes material used in or generated during the act.
307         */
308        DIST, 
309        /**
310         * The principal or primary performer of the act.
311         */
312        PPRF, 
313        /**
314         * A person assisting in an act through his substantial presence and involvement   This includes: assistants, technicians, associates, or whatever the job titles may be.
315         */
316        SPRF, 
317        /**
318         * 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.
319
320                        
321                           Example: A person who is the head of a biochemical laboratory; a sponsor for a policy or government program.
322         */
323        RESP, 
324        /**
325         * A person who verifies the correctness and appropriateness of the service (plan, order, event, etc.) and hence takes on accountability.
326         */
327        VRF, 
328        /**
329         * 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.
330         */
331        AUTHEN, 
332        /**
333         * 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.
334         */
335        LA, 
336        /**
337         * added to help the parsers
338         */
339        NULL;
340        public static V3ParticipationType fromCode(String codeString) throws FHIRException {
341            if (codeString == null || "".equals(codeString))
342                return null;
343        if ("PART".equals(codeString))
344          return PART;
345        if ("_ParticipationAncillary".equals(codeString))
346          return _PARTICIPATIONANCILLARY;
347        if ("ADM".equals(codeString))
348          return ADM;
349        if ("ATND".equals(codeString))
350          return ATND;
351        if ("CALLBCK".equals(codeString))
352          return CALLBCK;
353        if ("CON".equals(codeString))
354          return CON;
355        if ("DIS".equals(codeString))
356          return DIS;
357        if ("ESC".equals(codeString))
358          return ESC;
359        if ("REF".equals(codeString))
360          return REF;
361        if ("_ParticipationInformationGenerator".equals(codeString))
362          return _PARTICIPATIONINFORMATIONGENERATOR;
363        if ("AUT".equals(codeString))
364          return AUT;
365        if ("INF".equals(codeString))
366          return INF;
367        if ("TRANS".equals(codeString))
368          return TRANS;
369        if ("ENT".equals(codeString))
370          return ENT;
371        if ("WIT".equals(codeString))
372          return WIT;
373        if ("CST".equals(codeString))
374          return CST;
375        if ("DIR".equals(codeString))
376          return DIR;
377        if ("ALY".equals(codeString))
378          return ALY;
379        if ("BBY".equals(codeString))
380          return BBY;
381        if ("CAT".equals(codeString))
382          return CAT;
383        if ("CSM".equals(codeString))
384          return CSM;
385        if ("TPA".equals(codeString))
386          return TPA;
387        if ("DEV".equals(codeString))
388          return DEV;
389        if ("NRD".equals(codeString))
390          return NRD;
391        if ("RDV".equals(codeString))
392          return RDV;
393        if ("DON".equals(codeString))
394          return DON;
395        if ("EXPAGNT".equals(codeString))
396          return EXPAGNT;
397        if ("EXPART".equals(codeString))
398          return EXPART;
399        if ("EXPTRGT".equals(codeString))
400          return EXPTRGT;
401        if ("EXSRC".equals(codeString))
402          return EXSRC;
403        if ("PRD".equals(codeString))
404          return PRD;
405        if ("SBJ".equals(codeString))
406          return SBJ;
407        if ("SPC".equals(codeString))
408          return SPC;
409        if ("IND".equals(codeString))
410          return IND;
411        if ("BEN".equals(codeString))
412          return BEN;
413        if ("CAGNT".equals(codeString))
414          return CAGNT;
415        if ("COV".equals(codeString))
416          return COV;
417        if ("GUAR".equals(codeString))
418          return GUAR;
419        if ("HLD".equals(codeString))
420          return HLD;
421        if ("RCT".equals(codeString))
422          return RCT;
423        if ("RCV".equals(codeString))
424          return RCV;
425        if ("IRCP".equals(codeString))
426          return IRCP;
427        if ("NOT".equals(codeString))
428          return NOT;
429        if ("PRCP".equals(codeString))
430          return PRCP;
431        if ("REFB".equals(codeString))
432          return REFB;
433        if ("REFT".equals(codeString))
434          return REFT;
435        if ("TRC".equals(codeString))
436          return TRC;
437        if ("LOC".equals(codeString))
438          return LOC;
439        if ("DST".equals(codeString))
440          return DST;
441        if ("ELOC".equals(codeString))
442          return ELOC;
443        if ("ORG".equals(codeString))
444          return ORG;
445        if ("RML".equals(codeString))
446          return RML;
447        if ("VIA".equals(codeString))
448          return VIA;
449        if ("PRF".equals(codeString))
450          return PRF;
451        if ("DIST".equals(codeString))
452          return DIST;
453        if ("PPRF".equals(codeString))
454          return PPRF;
455        if ("SPRF".equals(codeString))
456          return SPRF;
457        if ("RESP".equals(codeString))
458          return RESP;
459        if ("VRF".equals(codeString))
460          return VRF;
461        if ("AUTHEN".equals(codeString))
462          return AUTHEN;
463        if ("LA".equals(codeString))
464          return LA;
465        throw new FHIRException("Unknown V3ParticipationType code '"+codeString+"'");
466        }
467        public String toCode() {
468          switch (this) {
469            case PART: return "PART";
470            case _PARTICIPATIONANCILLARY: return "_ParticipationAncillary";
471            case ADM: return "ADM";
472            case ATND: return "ATND";
473            case CALLBCK: return "CALLBCK";
474            case CON: return "CON";
475            case DIS: return "DIS";
476            case ESC: return "ESC";
477            case REF: return "REF";
478            case _PARTICIPATIONINFORMATIONGENERATOR: return "_ParticipationInformationGenerator";
479            case AUT: return "AUT";
480            case INF: return "INF";
481            case TRANS: return "TRANS";
482            case ENT: return "ENT";
483            case WIT: return "WIT";
484            case CST: return "CST";
485            case DIR: return "DIR";
486            case ALY: return "ALY";
487            case BBY: return "BBY";
488            case CAT: return "CAT";
489            case CSM: return "CSM";
490            case TPA: return "TPA";
491            case DEV: return "DEV";
492            case NRD: return "NRD";
493            case RDV: return "RDV";
494            case DON: return "DON";
495            case EXPAGNT: return "EXPAGNT";
496            case EXPART: return "EXPART";
497            case EXPTRGT: return "EXPTRGT";
498            case EXSRC: return "EXSRC";
499            case PRD: return "PRD";
500            case SBJ: return "SBJ";
501            case SPC: return "SPC";
502            case IND: return "IND";
503            case BEN: return "BEN";
504            case CAGNT: return "CAGNT";
505            case COV: return "COV";
506            case GUAR: return "GUAR";
507            case HLD: return "HLD";
508            case RCT: return "RCT";
509            case RCV: return "RCV";
510            case IRCP: return "IRCP";
511            case NOT: return "NOT";
512            case PRCP: return "PRCP";
513            case REFB: return "REFB";
514            case REFT: return "REFT";
515            case TRC: return "TRC";
516            case LOC: return "LOC";
517            case DST: return "DST";
518            case ELOC: return "ELOC";
519            case ORG: return "ORG";
520            case RML: return "RML";
521            case VIA: return "VIA";
522            case PRF: return "PRF";
523            case DIST: return "DIST";
524            case PPRF: return "PPRF";
525            case SPRF: return "SPRF";
526            case RESP: return "RESP";
527            case VRF: return "VRF";
528            case AUTHEN: return "AUTHEN";
529            case LA: return "LA";
530            case NULL: return null;
531            default: return "?";
532          }
533        }
534        public String getSystem() {
535          return "http://hl7.org/fhir/v3/ParticipationType";
536        }
537        public String getDefinition() {
538          switch (this) {
539            case PART: return "Indicates that the target of the participation is involved in some manner in the act, but does not qualify how.";
540            case _PARTICIPATIONANCILLARY: 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.";
541            case ADM: return "The practitioner who is responsible for admitting a patient to a patient encounter.";
542            case ATND: return "The practitioner that has responsibility for overseeing a patient's care during a patient encounter.";
543            case CALLBCK: return "A person or organization who should be contacted for follow-up questions about the act in place of the author.";
544            case CON: return "An advisor participating in the service by performing evaluations and making recommendations.";
545            case DIS: return "The practitioner who is responsible for the discharge of a patient from a patient encounter.";
546            case ESC: return "Only with Transportation services.  A person who escorts the patient.";
547            case REF: return "A person having referred the subject of the service to the performer (referring physician).  Typically, a referring physician will receive a report.";
548            case _PARTICIPATIONINFORMATIONGENERATOR: 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).";
549            case AUT: 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.";
550            case INF: 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.";
551            case TRANS: 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.";
552            case ENT: 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.";
553            case WIT: 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.";
554            case CST: 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.).";
555            case DIR: return "Target participant  that is substantially present in the act  and which is directly involved in the action (includes consumed material, devices, etc.).";
556            case ALY: 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\".";
557            case BBY: return "In an obstetric service, the baby.";
558            case CAT: 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";
559            case CSM: return "Participant material that is taken up, diminished, altered, or disappears in the act.";
560            case TPA: 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.";
561            case DEV: 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.";
562            case NRD: 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.";
563            case RDV: 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.";
564            case DON: 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.";
565            case EXPAGNT: 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.";
566            case EXPART: 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.";
567            case EXPTRGT: return "Description: The entity playing the associated role is the target (contact) of exposure.";
568            case EXSRC: return "Description:The entity playing the associated role is the source of exposure.";
569            case PRD: 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).";
570            case SBJ: 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.";
571            case SPC: return "The subject of non-clinical (e.g. laboratory) observation services is a specimen.";
572            case IND: 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.";
573            case BEN: 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.";
574            case CAGNT: 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.";
575            case COV: 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.";
576            case GUAR: 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.";
577            case HLD: return "Participant who posses an instrument such as a financial contract (insurance policy) usually based on some agreement with the author.";
578            case RCT: 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.";
579            case RCV: return "The person (or organization) who receives the product of an Act.";
580            case IRCP: 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.";
581            case NOT: 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).";
582            case PRCP: 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.";
583            case REFB: 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).";
584            case REFT: return "The person who receives the patient";
585            case TRC: return "A secondary information recipient, who receives copies (e.g., a primary care provider receiving copies of results as ordered by specialist).";
586            case LOC: 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.)";
587            case DST: return "The destination for services.  May be a static building (or room therein) or a movable facility (e.g., ship).";
588            case ELOC: return "A location where data about an Act was entered.";
589            case ORG: return "The location of origin for services.  May be a static building (or room therein) or a movable facility (e.g., ship).";
590            case RML: 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.\"";
591            case VIA: return "For services, an intermediate location that specifies a path between origin an destination.";
592            case PRF: 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.";
593            case DIST: return "Distributes material used in or generated during the act.";
594            case PPRF: return "The principal or primary performer of the act.";
595            case SPRF: 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.";
596            case RESP: 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.";
597            case VRF: return "A person who verifies the correctness and appropriateness of the service (plan, order, event, etc.) and hence takes on accountability.";
598            case AUTHEN: 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.";
599            case LA: 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.";
600            case NULL: return null;
601            default: return "?";
602          }
603        }
604        public String getDisplay() {
605          switch (this) {
606            case PART: return "Participation";
607            case _PARTICIPATIONANCILLARY: return "ParticipationAncillary";
608            case ADM: return "admitter";
609            case ATND: return "attender";
610            case CALLBCK: return "callback contact";
611            case CON: return "consultant";
612            case DIS: return "discharger";
613            case ESC: return "escort";
614            case REF: return "referrer";
615            case _PARTICIPATIONINFORMATIONGENERATOR: return "ParticipationInformationGenerator";
616            case AUT: return "author (originator)";
617            case INF: return "informant";
618            case TRANS: return "Transcriber";
619            case ENT: return "data entry person";
620            case WIT: return "witness";
621            case CST: return "custodian";
622            case DIR: return "direct target";
623            case ALY: return "analyte";
624            case BBY: return "baby";
625            case CAT: return "catalyst";
626            case CSM: return "consumable";
627            case TPA: return "therapeutic agent";
628            case DEV: return "device";
629            case NRD: return "non-reuseable device";
630            case RDV: return "reusable device";
631            case DON: return "donor";
632            case EXPAGNT: return "ExposureAgent";
633            case EXPART: return "ExposureParticipation";
634            case EXPTRGT: return "ExposureTarget";
635            case EXSRC: return "ExposureSource";
636            case PRD: return "product";
637            case SBJ: return "subject";
638            case SPC: return "specimen";
639            case IND: return "indirect target";
640            case BEN: return "beneficiary";
641            case CAGNT: return "causative agent";
642            case COV: return "coverage target";
643            case GUAR: return "guarantor party";
644            case HLD: return "holder";
645            case RCT: return "record target";
646            case RCV: return "receiver";
647            case IRCP: return "information recipient";
648            case NOT: return "ugent notification contact";
649            case PRCP: return "primary information recipient";
650            case REFB: return "Referred By";
651            case REFT: return "Referred to";
652            case TRC: return "tracker";
653            case LOC: return "location";
654            case DST: return "destination";
655            case ELOC: return "entry location";
656            case ORG: return "origin";
657            case RML: return "remote";
658            case VIA: return "via";
659            case PRF: return "performer";
660            case DIST: return "distributor";
661            case PPRF: return "primary performer";
662            case SPRF: return "secondary performer";
663            case RESP: return "responsible party";
664            case VRF: return "verifier";
665            case AUTHEN: return "authenticator";
666            case LA: return "legal authenticator";
667            case NULL: return null;
668            default: return "?";
669          }
670    }
671
672
673}