DDCT XML Import Documentation Version 1 9/27/2017 Table of Contents Data Definitions ...................................................................................................................................................................... 3 Sample XML file ............................................................................................................................................................... 6 List of Codes ............................................................................................................................................................................ 7 UnitType .......................................................................................................................................................................... 7 OwnershipType ............................................................................................................................................................... 7 LocationType ................................................................................................................................................................... 7 TeachingStatus ................................................................................................................................................................ 7 OrganizationType ............................................................................................................................................................ 7 Subspecialty .................................................................................................................................................................... 8 Payer ............................................................................................................................................................................... 8 Certification ..................................................................................................................................................................... 8 Degree ........................................................................................................................................................................... 14 Question ........................................................................................................................................................................ 14 State .............................................................................................................................................................................. 24 Data Definitions Date Format All dates should be formatted as "YYYY-MM-DD". XML version Element The XML version element should be identical to the value in the current schema downloaded from www.anccmagnet.org. <?xml version="1.0" encoding="utf-8"?> Report Element The Report element is the wrapper for the entire XML file and defines the file as a report to the DDCT system. Embedded in the Report element are the following attributes: • xmlns:xsi – http://www.w3.org/2001/XMLSchema-instance • xmln:xsd – http://www.w3.org/2001/XMLSchema • VersionStamp – use the value listed in the current schema • xmlns – http://ancc.org/DDCT/Import Organization Element The Organization element provides details about the organization. Each report must have one and only one organization element. Embedded in the Organization element are the following attributes: Attribute Required Notes Name Y Max 200 characters Address N Max 200 characters City N Max 120 characters State N See list of States below PostalCode N Max 10 characters Country N Phone N Max 50 characters WebSite N Max 500 characters OwnershipType N See list of OwnershipTypes below LocationType N See list of LocationTypes below TeachingStatus N See list of TeachingStatus codes below OrganizationType N See list of OrganizationTypes below OtherOrganizationType N Max 100 characters Subspecialty N Units Element The Units element lists all hospital units which are included in the report. Within the Units element are individual Unit elements, which have embedded in them the attributes for Unit Type and Name. See below for the list of valid Unit Type values. <Units> <Unit Type="A" Name="Unit 1" /> <Unit Type="B" Name="Unit 2" /> </Units> GeneralInformation Element The GeneralInformation element contains details which appear on the General Information page of the report. Embedded in the GeneralInformation element are the following attributes: Attribute Required Data Limitations Year Y Integer DueDate Y Date CMSProviderNumber N Max 20 characters AHANumber N Max 20 characters CNODate Y Date when CNO started employment CNOHighestNursingDegree N See list of Degrees below CNOHighestNonNursingDegree N See list of Degrees below CNOHighestNonNursingDegreeSpecific N Max 100 characters CNONationalCertification N See list of Certifications below CNOAdvancedPracticeCertification N See list of Certifications below StaffedBeds Y Integer LicensedBeds Y Integer AverageDailyCensus Y Decimal ExpectedPrimaryPayer Y See list of Payers below AverageLengthOfStayForMedicare Y Decimal CaseMixIndexForMedicare Y Decimal AverageLengthOfStayForMedicareCaseMixAdjusted Y Decimal AverageLengthOfStayForAllPayers Y Decimal CaseMixIndexForAllPayers Y Decimal AverageLengthOfStayForAllPayersCaseMixAdjusted Y Decimal NumberOfDirectCareRNs Y Integer PercentBSNOfDirectCareRNs Y Decimal CollectiveBargaining Y Boolean CollectiveBargainingSpecific N Max 100 characters ContinuingEducationRequired Y Boolean AcceditedContinuingEducationProvider Y Boolean ApprovedContinuingEducationProvider Y Boolean CNO Element Within the GeneralInformation element is the CNO sub-element, which has embedded in it the following attributes, all of which are optional: • Name (max 200 characters) • Email (max 400 characters) • Phone (max 50 characters) MPD Element Within the GeneralInformation element is the MPD sub-element, which has embedded in it the following attributes, all of which are optional: • Name (max 200 characters) • Email (max 400 characters) • Phone (max 50 characters) ReportingPeriod Element Within the GeneralInformation element is the ReportingPeriod sub-element, which has embedded in it the following required attributes: • Start (start date of reporting period) • End (end date of reporting period) DemographicsMatrix Element The DemographicsMatrix element contains one "Answers" sub-element. All of the individual answer data points are contained within the Answers sub-element like so: <DemographicsMatrix> <Answers> <Answer…../> <Answer…../> </Answers> </DemographicsMatrix> Answer Element Each Answer element has embedded in it the following attributes: Attribute Required Data Limitations Question Y See list of Questions below Certification Only for certain questions. See list of Certifications below UnitName Y Name must match one of the Unit Names included in the Unit element Value Y Decimal Questions with Certification Required For questions where a certification is required, Answer should be formatted: <Answer Question="XX" Certification="XX" UnitName="XX" Value="XX" /> Unique Answer values Answers must contain a unique combination of Question ID, Hospital Unit, and Certification (if applicable). For example, this will generate an error, because the same Question and UnitName are used on more than one Answer: <Answer Question="Q76" UnitName="Unit 1" Value="5.88" /> <Answer Question="Q76" UnitName="Unit 1" Value="6.5" /> Sample XML file <?xml version="1.0" encoding="utf-8"?> <Report xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" VersionStamp="334F42A92C3504A3725E024FC86608E29A2D6A72" xmlns="http://ancc.org/DDCT/Import"> <Organization Name="Test Org Name" Address="123 Main St" City="Anytown" PostalCode="12345" Phone="123-456-7890" WebSite="www.anyurl.org" OwnershipType="NonProfit" LocationType="Urban" TeachingStatus="NonTeaching" OrganizationType="AcuteCare" Subspecialty="Oncology" /> <Units> <Unit Type="A" Name="Unit 1" /> <Unit Type="B" Name="Unit 2" /> </Units> <GeneralInformation Year="2018" DueDate="2018-01-01T00:00:00" CMSProviderNumber="99999" AHANumber="99999" CNODate="1997-01-01" CNOHighestNonNursingDegreeSpecific="" StaffedBeds="555" LicensedBeds="592" AverageDailyCensus="453" ExpectedPrimaryPayer="Medicare" AverageLengthOfStayForMedicare="5.4" CaseMixIndexForMedicare="2.11" AverageLengthOfStayForMedicareCaseMixAdjusted="2.55" AverageLengthOfStayForAllPayers="5.1" CaseMixIndexForAllPayers="2.02" AverageLengthOfStayForAllPayersCaseMixAdjusted="2.52" NumberOfDirectCareRNs="0" PercentBSNOfDirectCareRNs="0" CollectiveBargaining="false" CollectiveBargainingSpecific="" ContinuingEducationRequired="false" AcceditedContinuingEducationProvider="false" ApprovedContinuingEducationProvider="false"> <CNO Name="Jane Doe" Email="" Phone="" /> <MPD Name="John Doe" Email="" Phone="" /> <ReportingPeriod Start="2017-07-01" End="2018-06-30" /> </GeneralInformation> <DemographicsMatrix> <Answers> <Answer Question="Q1" UnitName="Unit 1" Value="28" /> <Answer Question="Q199" Certification = "C1" UnitName="Unit 1" Value="1" /> <Answer Question="Q76" UnitName="Unit 1" Value="5.88" /> <Answer Question="Q32" UnitName="Unit 1" Value="0.04" /> <Answer Question="Q85" Certification = "C1" UnitName="Unit 1" Value="10.33" /> <Answer Question="Q12" UnitName="Unit 1" Value="0" /> <Answer Question="Q55" Certification = "C2" UnitName="Unit 1" Value="0.5" /> <Answer Question="Q43" UnitName="Unit 1" Value="1" /> <Answer Question="Q1" UnitName="Unit 2" Value="26" /> <Answer Question="Q199" Certification = "C3" UnitName="Unit 2" Value="1" /> <Answer Question="Q76" UnitName="Unit 2" Value="3.08" /> <Answer Question="Q78" UnitName="Unit 2" Value="26.66" /> <Answer Question="Q35" UnitName="Unit 2" Value="6.41" /> <Answer Question="Q85" Certification = "C1" UnitName="Unit 2" Value="6.16" /> <Answer Question="Q12" UnitName="Unit 2" Value="0" /> <Answer Question="Q55" Certification = "C2" UnitName="Unit 2" Value="0.6" /> <Answer Question="Q40" UnitName="Unit 2" Value="2.