DD0007 - Invalid content was found starting with element 'Description', false positive?

CodeListItem

I think this is an error in the Define-XML v.2.1 specification. It states that there are 3 possible child elements, in the order:
- Decode (with TranslatedText),
- Alias
- Description
When I however look into the XML-Schema, I do not see "Description" defined as a child element of CodeListItem.
I was also a bit surprised, as usually, "Description" is the first child element, and I do not see a use case for a description on CodeListItem, as that should essentialyl be in Decode/TranslatedText.

Best is always to first validate against the XML-Schema anyway.

Lex, can you comment?

Lex

on December 7, 2023

CodeListItem Description

In Define-XML v2.1 the Description element was added as a child element for both the CodeList/EnumeratedItem element and the CodeList/CodeListItem element as there was a use case for describing for codelist item values.

This has been documented in the Define-XML v2.1 specification and the XML Schema (look at the define-extension.xsd schema file).

The Description element has to come after the Alias element.

It does not make sense to move the Description element within the Decode element. That would throw a schema validation error.

To summarize, the example presented in the original issue is correct. It conforms to Define-XML v2.1 specification and Define-XML v2.1 XML Schema.
I also agree with Jozef that XML Schema validation is always recommended. 
Tools supporting Define-XML should not contradict results from XML Schema validation. 

Best,
Lex

CodeListItem Description

Aaaah! Thanks Lex, learning from you again ... :-)
I indeed didn't look into the extenion schema define-extension.xsd.
@Matthias: how did you generate your define.xml, not starting from a spreadsheet I hope ...

CodeListItem description

Thanks both for the quick and insightful replies!

@Jozef: We don't start from a spreadsheet for generating define.xml's. Why do you ask?

spreadsheet

I asked just out of curiosity, also as I am a Define-XML trainer for CDISC, and we want to have an impression of what (advanced? GUI-based? ...) tools people are using for developing and generating Define-XML-s.

We use an in-house developed…

We use an in-house developed tool for generating the define.xml!

Trevor

on December 12, 2023

P21

Hi Matthias, May I ask: …

Hi Matthias,

May I ask:

• What version of P21C you are using?
• How are you validating your define.xml, with data or define only?
• What engine and standard are you using?

Thanks

Trevor
Sr. Manager, P21 Product Management 

Confirming it is Define 2.1

Hi Matthias,

Can you also confirm it is Define 2.1? I was looking through the schema files and saw that support for a Description element is only supported in Define 2.1 (not Define 2.0).

You can usually tell if it is Define 2.1 by looking at the XML file in a text editor and checking the versions match what I highlighted in the image below:

I experimented moving around the Description element in a valid Define 2.1 document and confirmed that DD0007 is not fired when it's the last element under CodeListItem/EnumeratedItem. It's not allowed anywhere within those elements in Define 2.0.

Thanks,

Travis