Child pages
  • Specifications

Medbiq_logo_rtm.gif

 

 

 

 

Entrustment Scale Specifications

 

 

 

 

 

 

 

 

 

Version: 0.1
Date: November 15, 2013
Author: Valerie Smothers
Author email: vsmothers@jhmi.edu

 


Version History

 

Version No.

Date

Changed By

Changes Made

0.1

 

 

Initial draft

 

 

 

 


MedBiquitous Consortium XML Public License and Terms of Use

 

MedBiquitous XML (including schemas, specifications, sample documents, Web services description files, and related items) is provided by the copyright holders under the following license. By obtaining, using, and or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.

The Consortium hereby grants a perpetual, non-exclusive, non-transferable, license to copy, use, display, perform, modify, make derivative works of, and develop the MedBiquitous XML for any use and without any fee or royalty, provided that you include the following on ALL copies of the MedBiquitous XML or portions thereof, including modifications, that you make.

  1. Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the following notice should be used: “Copyright © [date of XML release] MedBiquitous Consortium. All Rights Reserved. http://www.medbiq.org”
  2. Notice of any changes or modification to the MedBiquitous XML files.
  3. Notice that any user is bound by the terms of this license and reference to the full text of this license in a location viewable to users of the redistributed or derivative work.

 

In the event that the licensee modifies any part of the MedBiquitous XML, it will not then represent to the public, through any act or omission, that the resulting modification is an official specification of the MedBiquitous Consortium unless and until such modification is officially adopted.

THE CONSORTIUM MAKES NO WARRANTIES OR REPRESENTATIONS, EXPRESS OR IMPLIED, WITH RESPECT TO ANY COMPUTER CODE, INCLUDING SCHEMAS, SPECIFICATIONS, SAMPLE DOCUMENTS, WEB SERVICES DESCRIPTION FILES, AND RELATED ITEMS. WITHOUT LIMITING THE FOREGOING, THE CONSORTIUM DISCLAIMS ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE AND ANY WARRANTY, EXPRESS OR IMPLIED, AGAINST INFRINGEMENT BY THE MEDBIQUITOUS XML OF ANY THIRD PARTY PATENTS, TRADEMARKS, COPYRIGHTS OR OTHER RIGHTS.  THE LICENSEE AGREES THAT ALL COMPUTER CODES OR RELATED ITEMS PROVIDED SHALL BE ACCEPTED BY LICENSEE “AS IS”.  THUS, THE ENTIRE RISK OF NON-PERFORMANCE OF THE MEDBIQUITOUS XML RESTS WITH THE LICENSEE WHO SHALL BEAR ALL COSTS OF ANY SERVICE, REPAIR OR CORRECTION.

IN NO EVENT SHALL THE CONSORTIUM OR ITS MEMBERS BE LIABLE TO THE LICENSEE OR ANY OTHER USER FOR DAMAGES OF ANY NATURE, INCLUDING, WITHOUT LIMITATION, ANY GENERAL, DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, OR SPECIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF ANY USE OF MEDBIQUITOUS XML. 

LICENSEE SHALL INDEMNIFY THE CONSORTIUM AND EACH OF ITS MEMBERS FROM ANY LOSS, CLAIM, DAMAGE OR LIABILITY (INCLUDING, WITHOUT LIMITATION, PAYMENT OF ATTORNEYS’ FEES AND COURT COSTS) ARISING OUT OF MODIFICATION OR USE OF THE MEDBIQUITOUS XML OR ANY RELATED CONTENT OR MATERIAL BY LICENSEE.

LICENSEE SHALL NOT OBTAIN OR ATTEMPT TO OBTAIN ANY PATENTS, COPYRIGHTS OR OTHER PROPRIETARY RIGHTS WITH RESPECT TO THE MEDBIQUITOUS XML.

THIS LICENSE SHALL TERMINATE AUTOMATICALLY IF LICENSEE VIOLATES ANY OF ITS TERMS AND CONDITIONS.

The name and trademarks of the MedBiquitous Consortium and its members may NOT be used in advertising or publicity pertaining to MedBiquitous XML without specific, prior written permission. Title to copyright in MedBiquitous XML and any associated documentation will at all times remain with the copyright holders.

 

 



1          Acknowledgements

The MedBiquitous Consortium wishes to acknowledge the help of  the MedBiquitous Educational Trajectory Working Group members, invited experts, and other individuals that contributed to the creation of this document, including:

 

  • Linda Lewin, M.D., University of Maryland, Co-Chair
  • Alan Schwartz, Ph.D., University of Illinois at Chicago, Co-Chair

 

  • Susan Albright, Tufts University
  • Michael Barbouche, Odeon Data
  • Linda Bell, RN, MSN, American Association of Critical-Care Nurses
  • Dana Bostrom, Association of American Medical Colleges
  • Rachel Brown, M.D., University of Missouri-Columbia School of Medicine
  • Diane Burkhart, Ph.D., American Osteopathic Association
  • Timothy Cain, Ph.D., Ohio State University
  • Carol Carraccio, M.D., American Board of Pediatrics
  • Kelly Caverzagie, University of Nebraska Medical Center
  • Christa Chaffinch , National Board of Medical Examiners
  • Brian Clare, One45 Software
  • Elaine Dannefer , Ph.D., Cleveland Clinic Lerner College of Medicine of Case Western Reserve
  • Jeroen Donkers, Ph.D., University of Maastricht
  • Mike Dugan, Federation of State Medical Boards
  • Robert Englander, Association of American Medical Colleges
  • Maria Esquela, Advanced Informatics
  • Bob Galbraith, M.D., National Board of Medical Examiners
  • Gwen Garrison, Association of American Medical Colleges
  • Maureen Garrity, UC Denver
  • Simon Grant, Ph.D., JISC
  • Hilary Haftel, University of Michigan
  • Patricia Hicks, University of Pennsylvania
  • Kimberly Hoffman, Ph.D., University of Missouri
  • William Iobst, M.D. American Board of Internal Medicine
  • Steve Kenney, American Osteopathic Association
  • John Jackson, University of Virginia
  • Chandler Mayfield, University of California, San Francisco School of Medicine  
  • Neil Mehta, MD., Cleveland Clinic Lerner College of Medicine of Case Western Reserve University
  • David Melamed, M.D., MyEvaluations.com
  • John Norcini, M.D., Foundation for the Advancement of International Medical Education and   Research
  • Patricia O'Sullivan, Ed.D. , University of California, San Francisco School of Medicine
  • Anita Pokorny,   Northeastern Ohio Universities Colleges of Medicine and Pharmacy
  • Vijay Rajput, MD., Cooper University Hospital
  • Sandhya Samavedam, Wright Center for Graduate Medical Education
  • Rosalyn Scott, Wright State University
  • Howard Silverman, University of Arizonia
  • C. Scott Smith, M.D., VA Medical Center, Boise Idaho
  • Kirk Smith, M.D., Ph.D., University of Texas Medical Branch at Galveston
  • Kevin Souza, University of California, San Francisco School of Medicine
  • Anderson Spickard, M.D., Vanderbilt School of Medicine
  • Andria Thomas, Ph.D., Medical College of Georgia
  • Linda Thomas-Hemak, The Wright Center for Graduate Medical Education
  • Hettie Till, University of Dundee
  • Janet Trial, University of Southern California
  • Loreen Troy, University of Illinois College of Medicine
  • Sandra Waters, Federation of State Medical Boards

 

Specification authors also received technical guidance from members of the MedBiquitous Technical Steering Committee.

  • Joel Farrell , IBM, Technical Steering Committee Chair
  • James Fiore, American Board of Surgery
  • Steve Kenney, American Osteopathic Association
  • Andrew Rabin, CECity
  • Dan Rehak, Learning Technologies Architect

 

 

 


2          Documentation Conventions

This document uses the following conventions:

Convention

Description

Bold Text

When used with an XML element name, indicates that the element contains sub-elements.

Italics

When used in an XML element description, an attribute of the XML element.

Monospaced type

Sample XML tags, code, schema, or portion thereof.

 

The document uses graphics generated by Altova XML Spy® software, which uses the following graphical conventions.

 

address-example_schemadiagram.png


3          Conformance

To conform to the Standard Name specification, an XML document shall:

  • TBD
  •  

 


4          Common Data Types

Most of the elements and attributes in MedBiquitous XML documents use the data types defined by the W3C XML schema definition. In some cases MedBiquitous creates its own datatypes as part of its best practices or to meet a specific requirement. Commonly used datatypes are described below and are defined in the common.xsd file found at http://ns.medbiq.org/common/v2/common.xsd .

4.1        Non-null string

Non-null string is a datatype derived from the XML string datatype.  Non-null string imposes a minimum length of one character on a string and ensures that required elements are complete.

 


5          Introduction

 

 


6          Other Standards, Specifications, or Schemas Referenced

 

This standard references:

  • test [i]
  • ANSI/MEDBIQ LO.10.1-2008, Healthcare Learning Object Metadata [ii]

 


7          Entrustment Scale Schema

The following sections explain the Entrustment Scale Schema grammar. Values in bold under XML Tags column indicate that the element has sub-elements.

All the elements having sub-elements will be defined in separate sections. All elements without sub-elements will be defined within the appropriate element sections that use them.

7.1        EntrustmentScale

EntrustmentScale is the root element. It has subelements that define a scale that can be used for describing levels of entrustment used in awarding responsibility to individual learners.

Element Information

Element

Description

Required

Multiplicity

Datatype

EntrustmentScale

Defines a scale that can be used for describing levels of entrustment used in awarding responsibility to individual learners

Required

1

Container

lom

Lom contains subelements that define title, publisher, and other descriptive information about this entrustment scale. 

The lom element is defined in the Healthcare Learning Object Metadata standard defined by MedBiquitous. Please see the Healthcare Learning Object Metadata Specifications and Description document for more information on the sub-elements of lom. For information on which subelements of lom are required or recommended for Entrustment Scales, see section Lom Required and Recommended Elements.

Optional

0 or 1

Container

For more information, see  [ Healthcare LOM ] and [ LOM ].

EntrustmentLevel

EntrustmentLevel contains sub-elements that define a specific level of entrustment. See section EntrustmentLevel for more information.

Required

1 or more

Container

FewestResponsibilities

The score on this scale that indicates the entrustment level with the fewest responsibilities.

Required

1

Integer

MostResponsibilities

The score on this scale that indicates the entrustment level with the most responsibilities

Required

1

Integer

 

Example:

TBD

 

7.2        Lom Required and recommended Elements

Lom contains subelements that define title, publisher, and other descriptive information about this performance framework. 

lom

The table that follows indicates which elements of healthcare lom are required or recommended for use in the Performance Framework. Note that additional lom elements may be used.


lom Element Usage Information

Element

Description

Required

Multiplicity

Datatype

lom

lom contains subelements that define title, publisher, and other descriptive information about this entrustment scale. 

For more information on these elements, see [ LOM ] and [ Healthcare LOM ].

Required

1

Container

For more information on lom and its subelements, see  [ Healthcare LOM ] and [ LOM ].

general

A container for general metadata elements.

Required

1

Container

general:identifier

A container for identifier information.

Required

1 or more

Container

general:identifier:catalog

The cataloging system for the unique identifier. For entrustment scale, the catalog must be URI.

Note that organizations may include a catalog other than URI for use within local systems as long as a URI identifier is present in the XML document.

Required

1

Restricted. See Description for details.

general:identifier:entry

Defines a unique identifier for the entrustment scale. For entrustment scales, identifiers must be in the form of a URI.

Note that organizations may include an entry other than a URI for use within local systems as long as a URI identifier is present in the XML document.

Required

1

anyURI

general:title

Defines the title for this entrustment scale in one or more languages.

Required

1

LanguageString

general: description

A short description of the entrustment scale.

Recommended

0 or more

LanguageString

lifecycle

A container for elements relating to the lifecycle of the scale.

Recommended

0 or 1

Container

lifecycle: status

A container for elements describing the status of the entrustment scale.

Recommended

0 or 1

Container

lifecycle: status: source

The source of the vocabulary for status.  Use LOMv1.0.

Recommended

0 or 1

Restricted See Description for details.

lifecycle: status: value

The status of the entrustment scale. Valid values are: draft, final, revised, unavailable.  Use of draft and final values is recommended.

Recommended

0 or 1

Restricted. See Description for details.

lifecycle: contribute

A container for elements the people and organizations that have contributed to the entrustment scale.

Recommended

0 or 1

Container

lifecycle: contribute: role

A container for elements describing the publisher and other entities involved in the development of this scale. Use the role and entity elements within the lifecycle element to indicate the publisher of the entrustment scale. Role should have a value of publisher and be paired with an entity describing the publisher.

Recommended

0 or more

Container

lifecycle: contribute: role:source

The source of the vocabulary for role.  When describing the publisher, use LOMv1.0.

Recommended

0 or 1

Restricted. See Description for details.

lifecycle: contribute: role: value

The role being described.  To describe the publisher, value should be publisher.

Recommended

0 or 1

Restricted. See Description for details.

lifecycle: contribute: entity

Use the role and entity elements within the lifecycle element to indicate the publisher of the entrustment scale.  Entity includes a vcard reference to the publisher and should be paired with a role that has a value of publisher.

Recommended

0 or more

CharacterString in VCARD format. See [ LOM ] for details.

educational

A container element for elements related to the educational aspects of the scale.

Recommended

0 or 1

Container

educational: context

 

A container for elements describing the educational environment for which the scale is intended.

Recommended

0 or more

Container

educational: context:source

The source of the vocabulary for educational context.  To use the MedBiquitous vocabulary, use HEALTHCARE_LOMv1.

Recommended

0 or 1

Restricted. See Description for details.

educational:context:value

The educational context for which the framework is intended. Use a term from the following MedBiquitous vocabulary (described in HealthcareLOM):

  • patient education
  • caregiver education
  • primary education
  • secondary education
  • vocational training
  • undergraduate education
  • undergraduate professional education
  • graduate professional education
  • continuing professional development

Recommended

0 or 1

Restricted. See Description for details.

rights

A container element for information on copyright and other restrictions.

Recommended

0 or 1

Container

rights: copyrightAndOtherRestrictions

 

A container for elements indicating whether or not copyright or other restrictions exist on the entrustment scale.

Recommended

0 or 1

Container

rights: copyrightAndOtherRestrictions:source

The source of the vocabulary used to describe copyright and other restrictions. To use the lom vocabulary, use LOMv1.0.

Recommended

0 or 1

Restricted. See Description for details.

rights: copyrightAndOtherRestrictions:value

Indicates whether or not copyright and other restrictions exist. Valid values are yes and no.

Recommended

0 or 1

Restricted. See Description for details.

rights: description

 

The description element within rights provides a brief description of the copyright or other constraints on the entrustment scale. The description may include a link to a license.

Recommended

0 or 1

LanguageString

healthcareMetadata

A container element for healthcare related metadata.

Recommended

0 or 1

Container

healthcareMetadata:healthcareEducation

A container element for healthcare education related metadata.

Recommended

0 or 1

Container

healthcareMetadata:healthcareEducation targetAudience

A container element for information  about the target audience for whom this framework is intended.

Recommended

0 or 1

Container

healthcareMetadata: healthcareEducation:targetAudience: profession

 

The health profession for which this performance framework is intended.

Recommended

0 or 1

LanguageString

 

< lom:lom >

    < lom:general >

< lom:identifier >

< lom:catalog > URI </ lom:catalog >

< lom:entry > http://www.example.com/maastricht </ lom:entry >

</ lom:identifier >

< lom:description >

< lom:string > This scale describes the entrustment levels used at My Fictitious Medical Center training programs. </ lom:string >

</ lom:description >

    </ lom:general >

    < lom:lifeCycle >

< lom:status >

< lom:source > LOMv1.0 </ lom:source >

< lom:value > final </ lom:value >

</ lom:status >

< lom:contribute >

< lom:role >

< lom:source > LOMv1.0 </ lom:source >

< lom:value > publisher </ lom:value >

</ lom:role >

< lom:entity > BEGIN:VCARD\nFN:My Fictitious Medical CenterEND:VCARD </ lom:entity >

</ lom:contribute >

    </ lom:lifeCycle >

  </ lom:lom >


7.3        EntrustmentLevel

EntrustmentLevel contains subelements that define a single level of entrustment in a larger scale of entrustment levels.

 

Element Information

Element

Description

Required

Multiplicity

Datatype

EntrustmentLevel

EntrustmentLevel contains sub-elements that define a specific level of entrustment.

Required

1 or more

Container

DisplayOrder

A positive integer indicating the order of display for this entrustment level in relation to other entrustment levels in the scale.

Required

1

Integer

Score

An integer indicating a score associated with this entrustment level.

Required

1

Integer

Title

A title for this entrustment level. For example, Entrusted to perform under heavy supervision.

Required

1

NonNullString

Description

A description of the entrustment level.

Optional

0 or 1

NonNullString

 

Example:

TBD

 


8          Sample XML Document

 

TO BE COMPLETED

 

 


9          References

 

Healthcare LOM
ANSI/MEDBIQ LO.10.1-2008, Healthcare Learning Object Metadata, MedBiquitous Website. http://www.medbiq.org/std_specs/standards/index.html#HCLOM . Accessed May 9, 2013.

LOM
"IEEE Standard for Learning Technology-Extensible Markup Language (XML) Schema Definition Language Binding for Learning Object Metadata," IEEE Std 1484.12.3-2005 , vol., no., pp.0_1-46, 2005
doi: 10.1109/IEEESTD.2005.97889
URL:   http://ieeexplore.ieee.org/stamp/stamp.jsp?tp=&arnumber=1532505&isnumber=32693

 


[i] La la la

[ii] ANSI/MEDBIQ LO.10.1-2008, Healthcare Learning Object Metadata (Healthcare LOM). MedBiquitous Website.  http://www.medbiq.org/std_specs/standards/index.html#HCLOM . Accessed June 1, 2011.