/// <summary>Component from question.</summary>
/// <param name="format"> Describes the format to use.</param>
/// <param name="question"> The question.</param>
/// <param name="itemOrder">[in,out] The item order.</param>
/// <returns>A Questionnaire.ItemComponent.</returns>
private static Questionnaire.ItemComponent ComponentFromQuestion(
IReportingFormat format,
QuestionnaireQuestion question,
ref int itemOrder)
{
if (!format.Fields.ContainsKey(question.ValueFieldName))
{
return(null);
}
FormatField valueField = format.Fields[question.ValueFieldName];
FormatField displayField;
if (string.IsNullOrEmpty(question.DisplayFieldName) ||
(!format.Fields.ContainsKey(question.DisplayFieldName)))
{
displayField = valueField;
}
else
{
displayField = format.Fields[question.DisplayFieldName];
}
Questionnaire.ItemComponent component = new Questionnaire.ItemComponent()
{
LinkId = valueField.Name,
Required = valueField.IsRequired == true,
Repeats = false,
};
if (!string.IsNullOrEmpty(question.FieldSystem))
{
component.Code = new List <Coding>()
{
new Coding(question.FieldSystem, valueField.Name),
};
}
#if false // 2020.05.13 - Argonaut extensions aren't valid in R4 yet
component.AddExtension(
"http://fhir.org/guides/argonaut/questionnaire/StructureDefinition/extension-itemOrder",
new FhirDecimal(itemOrder++));
#endif
if (question.UseTitleOnly)
{
component.Text = $"{displayField.Title}";
}
else
{
component.Text = $"{displayField.Title}: {displayField.Description}";
}
int optionOrder = 0;
switch (valueField.Type)
{
case FormatField.FieldType.Date:
component.Type = Questionnaire.QuestionnaireItemType.Date;
break;
case FormatField.FieldType.Count:
component.Type = Questionnaire.QuestionnaireItemType.Integer;
break;
case FormatField.FieldType.Percentage:
component.Type = Questionnaire.QuestionnaireItemType.Decimal;
break;
case FormatField.FieldType.Boolean:
component.Type = Questionnaire.QuestionnaireItemType.Boolean;
break;
case FormatField.FieldType.Choice:
component.Type = Questionnaire.QuestionnaireItemType.Choice;
component.AnswerOption = new List <Questionnaire.AnswerOptionComponent>();
component.AddExtension(
"http://hl7.org/fhir/StructureDefinition/questionnaire-optionExclusive",
new FhirBoolean(true),
true);
foreach (FormatFieldOption option in valueField.Options)
{
Element element = new FhirString(option.Text);
#if false // 2020.05.13 - Argonaut extensions aren't valid in R4 yet
element.AddExtension(
"http://fhir.org/guides/argonaut/questionnaire/StructureDefinition/extension-itemOrder",
new FhirDecimal(optionOrder++));
#endif
component.AnswerOption.Add(new Questionnaire.AnswerOptionComponent()
{
Value = element,
});
}
break;
case FormatField.FieldType.MultiSelectChoice:
component.Type = Questionnaire.QuestionnaireItemType.Choice;
component.AnswerOption = new List <Questionnaire.AnswerOptionComponent>();
foreach (FormatFieldOption option in valueField.Options)
{
Element element = new FhirString(option.Text);
#if false // 2020.05.13 - Argonaut extensions aren't valid in R4 yet
element.AddExtension(
"http://fhir.org/guides/argonaut/questionnaire/StructureDefinition/extension-itemOrder",
new FhirDecimal(optionOrder++));
#endif
component.AnswerOption.Add(new Questionnaire.AnswerOptionComponent()
{
Value = element,
});
}
break;
case FormatField.FieldType.Text:
component.Type = Questionnaire.QuestionnaireItemType.Text;
break;
case FormatField.FieldType.ShortString:
component.Type = Questionnaire.QuestionnaireItemType.String;
break;
case FormatField.FieldType.Display:
default:
component.Type = Questionnaire.QuestionnaireItemType.Display;
break;
}
return(component);
}
/// <summary>Builds a questionnaire.</summary>
/// <exception cref="ArgumentNullException">Thrown when one or more required arguments are null.</exception>
/// <param name="format">Describes the format to use.</param>
/// <returns>A Questionnaire.</returns>
private static Questionnaire BuildQuestionnaire(
IReportingFormat format)
{
if (format == null)
{
throw new ArgumentNullException(nameof(format));
}
if (string.IsNullOrEmpty(format.Name))
{
throw new ArgumentNullException(nameof(format), $"Invalid IReportingFormat.Name: {format.Name}");
}
if ((format.Fields == null) || (format.Fields.Count == 0))
{
throw new ArgumentNullException(nameof(format), $"Invalid IReportingFormat.Fields: {format.Fields}");
}
if ((format.QuestionnaireSections == null) || (format.QuestionnaireSections.Count == 0))
{
throw new ArgumentNullException(nameof(format), $"Invalid IReportingFormat.QuestionnaireSections: {format.QuestionnaireSections}");
}
Questionnaire questionnaire = new Questionnaire()
{
Meta = new Meta()
{
Profile = new string[]
{
FhirSystems.Questionnaire,
},
},
Id = format.Name,
Name = format.Name,
Url = $"{CanonicalUrl}/Questionnaire/{format.Name}",
Version = QuestionnaireVersion,
Title = format.Title,
Description = new Markdown(format.Description),
Status = PublicationStatus.Draft,
Date = PublicationDate,
Publisher = Publisher,
Jurisdiction = new List <CodeableConcept>()
{
FhirTriplet.UnitedStates.GetConcept(),
},
UseContext = new List <UsageContext>()
{
new UsageContext()
{
Code = FhirTriplet.GetCode(FhirSystems.UsageContextType, CommonLiterals.ContextFocus),
Value = FhirTriplet.SctCovid.GetConcept(),
},
},
Item = new List <Questionnaire.ItemComponent>(),
};
int sectionNumber = -1;
int itemNumber = 0;
foreach (QuestionnaireSection questionnaireSection in format.QuestionnaireSections)
{
sectionNumber++;
itemNumber = 0;
Questionnaire.ItemComponent section = new Questionnaire.ItemComponent()
{
LinkId = $"section_{sectionNumber}",
Type = Questionnaire.QuestionnaireItemType.Group,
Item = new List <Questionnaire.ItemComponent>(),
Repeats = false,
};
#if false // 2020.05.13 - Argonaut extensions aren't valid in R4 yet
section.AddExtension(
"http://fhir.org/guides/argonaut/questionnaire/StructureDefinition/extension-itemOrder",
new FhirDecimal(sectionNumber));
#endif
if (format.Fields.ContainsKey(questionnaireSection.Title))
{
section.Text = $"{format.Fields[questionnaireSection.Title].Title}: {format.Fields[questionnaireSection.Title].Description}";
}
else
{
section.Text = questionnaireSection.Title;
}
foreach (QuestionnaireQuestion question in questionnaireSection.Fields)
{
Questionnaire.ItemComponent component = ComponentFromQuestion(
format,
question,
ref itemNumber);
if (component == null)
{
continue;
}
section.Item.Add(component);
}
questionnaire.Item.Add(section);
}
return(questionnaire);
}
private Questionnaire.ItemComponent CreateItemComponentV2(QuestionnaireItem2 item)
{
Questionnaire.QuestionnaireItemType?itemType = EnumUtility.ParseLiteral <Questionnaire.QuestionnaireItemType>(item.Type);
if (!itemType.HasValue)
{
throw new Exception($"QuestionnaireItemType at question with linkId: {item.LinkId} is not conforming to any valid literals. QuestionnaireItemType: {item.Type}");
}
Questionnaire.ItemComponent itemComponent = new Questionnaire.ItemComponent
{
Type = itemType,
};
itemComponent.LinkId = string.IsNullOrWhiteSpace(item.LinkId) ? null : item.LinkId;
itemComponent.Prefix = string.IsNullOrWhiteSpace(item.Prefix) ? null : item.Prefix;
itemComponent.Text = string.IsNullOrWhiteSpace(item.Text) ? null : item.Text;
if (!string.IsNullOrWhiteSpace(item.EnableWhen))
{
itemComponent.EnableWhen = ParseEnableWhen(item.EnableWhen).ToList();
// TODO: Defaults to 'any' in the first iteration of "migrate to R4".
itemComponent.EnableBehavior = Questionnaire.EnableWhenBehavior.Any;
}
if (itemType != Questionnaire.QuestionnaireItemType.Group && itemType != Questionnaire.QuestionnaireItemType.Display)
{
itemComponent.Required = item.Required.HasValue ? item.Required : null;
itemComponent.ReadOnly = item.ReadOnly;
itemComponent.Initial = string.IsNullOrEmpty(item.Initial)
? null
: new List <Questionnaire.InitialComponent> {
new Questionnaire.InitialComponent {
Value = GetElement(itemType.Value, item.Initial)
}
};
itemComponent.MaxLength = item.MaxLength.HasValue ? item.MaxLength : null;
}
if (itemType != Questionnaire.QuestionnaireItemType.Display)
{
itemComponent.Repeats = item.Repeats;
}
if (!string.IsNullOrWhiteSpace(item.ValidationText))
{
itemComponent.SetStringExtension(Constants.ValidationTextUri, item.ValidationText);
}
if (!string.IsNullOrWhiteSpace(item.Options) && item.Options.IndexOf('#') == 0)
{
itemComponent.AnswerValueSetElement = new Canonical($"#{item.Options.Substring(1)}");
}
else if (!string.IsNullOrWhiteSpace(item.Options) &&
(item.Options.IndexOf("http://") == 0 || item.Options.IndexOf("https://") == 0))
{
itemComponent.AnswerValueSetElement = new Canonical(item.Options);
}
if (!string.IsNullOrWhiteSpace(item.EntryFormat))
{
itemComponent.SetStringExtension(Constants.EntryFormatUri, item.EntryFormat);
}
if (item.MaxValueInteger.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MaxValueUri, item.MaxValueInteger.Value);
}
if (item.MinValueInteger.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MinValueUri, item.MinValueInteger.Value);
}
if (item.MaxValueDate.HasValue)
{
itemComponent.SetExtension(Constants.MaxValueUri, new FhirDateTime(new DateTimeOffset(item.MaxValueDate.Value.ToUniversalTime())));
}
if (item.MinValueDate.HasValue)
{
itemComponent.SetExtension(Constants.MinValueUri, new FhirDateTime(new DateTimeOffset(item.MinValueDate.Value.ToUniversalTime())));
}
if (item.MinLength.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MinLenghtUri, item.MinLength.Value);
}
if (item.MaxDecimalPlaces.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MaxDecimalPlacesUri, item.MaxDecimalPlaces.Value);
}
if (!string.IsNullOrWhiteSpace(item.RepeatsText))
{
itemComponent.SetStringExtension(Constants.RepeatsTextUri, item.RepeatsText);
}
if (!string.IsNullOrWhiteSpace(item.ItemControl))
{
CodeableConcept codeableConcept = new CodeableConcept
{
Coding = new List <Coding> {
new Coding
{
System = Constants.ItemControlSystem,
Code = item.ItemControl
}
}
};
itemComponent.SetExtension(Constants.ItemControlUri, codeableConcept);
}
if (item.MaxOccurs.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MaxOccursUri, item.MaxOccurs.Value);
}
if (item.MinOccurs.HasValue)
{
itemComponent.SetIntegerExtension(Constants.MinOccursUri, item.MinOccurs.Value);
}
if (!string.IsNullOrWhiteSpace(item.Regex))
{
itemComponent.SetStringExtension(Constants.RegexUri, item.Regex);
}
if (!string.IsNullOrWhiteSpace(item.Markdown))
{
if (itemComponent.Text == null)
{
throw new MissingRequirementException($"Question with linkId: {item.LinkId}. The 'Text' attribute is required when setting the 'Markdown' extension so that form fillers which do not support the 'Markdown' extension still can display informative text to the user.");
}
itemComponent.TextElement.SetExtension(Constants.RenderingMarkdownUri, new Markdown(item.Markdown));
}
if (!string.IsNullOrWhiteSpace(item.Unit))
{
Coding unitCoding = ParseCoding(item.Unit);
itemComponent.SetExtension(Constants.QuestionnaireUnitUri, unitCoding);
}
if (!string.IsNullOrWhiteSpace(item.Code))
{
itemComponent.Code = ParseArrayOfCoding(item.Code);
}
if (!string.IsNullOrWhiteSpace(item.Option))
{
List <Element> options = ParseArrayOfElement(item.Option);
foreach (DataType element in options)
{
if (element is ResourceReference)
{
itemComponent.AddExtension(Constants.OptionReferenceUri, element);
}
else
{
itemComponent.AnswerOption.Add(new Questionnaire.AnswerOptionComponent {
Value = element
});
}
}
}
if (!string.IsNullOrWhiteSpace(item.FhirPathExpression))
{
itemComponent.SetStringExtension(Constants.FhirPathUri, item.FhirPathExpression);
}
if (item.Hidden)
{
itemComponent.SetBoolExtension(Constants.QuestionnaireItemHidden, item.Hidden);
}
if (item.AttachmentMaxSize.HasValue && itemComponent.Type == Questionnaire.QuestionnaireItemType.Attachment)
{
itemComponent.SetExtension(Constants.QuestionnaireAttachmentMaxSize, new FhirDecimal(item.AttachmentMaxSize));
}
if (!string.IsNullOrWhiteSpace(item.CalculatedExpression))
{
itemComponent.SetStringExtension(Constants.CalculatedExpressionUri, item.CalculatedExpression);
}
if (!string.IsNullOrWhiteSpace(item.GuidanceAction))
{
itemComponent.SetStringExtension(Constants.GuidanceActionUri, item.GuidanceAction.Trim());
}
if (!string.IsNullOrWhiteSpace(item.GuidanceParameter))
{
itemComponent.SetStringExtension(Constants.GuidanceParameterUri, $"hn_frontend_{item.GuidanceParameter.Trim()}");
}
if (!string.IsNullOrWhiteSpace(item.FhirPathValidation))
{
itemComponent.SetStringExtension(Constants.FhirPathValidationUri, item.FhirPathValidation);
}
if (!string.IsNullOrWhiteSpace(item.FhirPathMaxValue))
{
itemComponent.SetStringExtension(Constants.SdfMaxValueUri, item.FhirPathMaxValue);
}
if (!string.IsNullOrWhiteSpace(item.FhirPathMinValue))
{
itemComponent.SetStringExtension(Constants.SdfMinValueUri, item.FhirPathMinValue);
}
if (!string.IsNullOrWhiteSpace(item.EnableBehavior))
{
itemComponent.EnableBehavior = EnumUtility.ParseLiteral <Questionnaire.EnableWhenBehavior>(item.EnableBehavior.ToLowerInvariant());
}
return(itemComponent);
}