Limit help.txt to 80 char width to make output more consistent

This commit is contained in:
dotasek 2022-04-07 18:13:36 -04:00
parent cb1d20afeb
commit 293aa12bd8
1 changed files with 79 additions and 62 deletions

View File

@ -4,34 +4,37 @@ The validation tool compares a resource against the base definitions and any
profiles declared in the resource (Resource.meta.profile) or specified on the profiles declared in the resource (Resource.meta.profile) or specified on the
command line command line
The FHIR validation tool validates a FHIR resource or bundle. The FHIR validation tool validates a FHIR resource or bundle. Schema and
Schema and schematron checking is performed, then some additional checks are performed. schematron checking is performed, then some additional checks are performed.
* XML & Json (FHIR versions {{XML_AND_JSON_FHIR_VERSIONS}}) * XML & Json (FHIR versions {{XML_AND_JSON_FHIR_VERSIONS}})
* Turtle (FHIR versions {{TURTLE_FHIR_VERSIONS}}) * Turtle (FHIR versions {{TURTLE_FHIR_VERSIONS}})
If requested, instances will also be verified against the appropriate schema If requested, instances will also be verified against the appropriate schema W3C
W3C XML Schema, JSON schema or ShEx, as appropriate XML Schema, JSON schema or ShEx, as appropriate
Usage: java -jar [validator].jar (parameters) Usage: java -jar [validator].jar (parameters)
The following parameters are supported: The following parameters are supported:
[source]: a file, url, directory or pattern for resources to validate. At [source]: a file, url, directory or pattern for resources to validate.
least one source must be declared. If there is more than one source or if At least one source must be declared. If there is more than one source or
the source is other than a single file or url and the output parameter is if the source is other than a single file or url and the output parameter is
used, results will be provided as a Bundle. used, results will be provided as a Bundle.
Patterns are limited to a directory followed by a filename with an embedded Patterns are limited to a directory followed by a filename with an
asterisk. E.g. foo*-examples.xml or someresource.*, etc. embedded asterisk. E.g. foo*-examples.xml or someresource.*, etc.
-version [ver]: The FHIR version to use. This can only appear once. -version [ver]: The FHIR version to use.
This can only appear once.
valid values {{FHIR_MAJOR_VERSIONS}} or {{FHIR_MINOR_VERSIONS}} valid values {{FHIR_MAJOR_VERSIONS}} or {{FHIR_MINOR_VERSIONS}}
Default value is {{FHIR_CURRENT_VERSION}} Default value is {{FHIR_CURRENT_VERSION}}
-ig [package|file|folder|url]: an IG or profile definition to load. Can be -ig [package|file|folder|url]: an IG or profile definition to load.
the URL of an implementation guide or a package ([id]-[ver]) for Can be the URL of an implementation guide or a package ([id]-[ver]) for a
a built implementation guide or a local folder that contains a built implementation guide or a local folder that contains a set of
set of conformance resources. conformance resources.
If you would like to load the latest unreleased version of the implementation guide or package, If you would like to load the latest unreleased version of the
please define the version as '#current'. If no version is provided, the latest version implementation guide or package, please define the version as '#current'.
in the package cache will be used, or if no such cached package is available, the If no version is provided, the latest version in the package cache will
PackageCacheManager will load the latest from the the online package repo. be used, or if no such cached package is available, the PackageCacheManager
will load the latest from the the online package repo.
No default value. This parameter can appear any number of times No default value. This parameter can appear any number of times
-tx [url]: the [base] url of a FHIR terminology service -tx [url]: the [base] url of a FHIR terminology service
Default value is http://tx.fhir.org. This parameter can appear once Default value is http://tx.fhir.org. This parameter can appear once
@ -39,9 +42,9 @@ The following parameters are supported:
-txLog [file]: Produce a log of the terminology server operations in [file] -txLog [file]: Produce a log of the terminology server operations in [file]
Default value is not to produce a log Default value is not to produce a log
-profile [url]: the canonical URL to validate against (same as if it was -profile [url]: the canonical URL to validate against (same as if it was
specified in Resource.meta.profile). If no profile is specified, the specified in Resource.meta.profile).
resource is validated against the base specification. This parameter If no profile is specified, the resource is validated against the base
can appear any number of times. specification. This parameter can appear any number of times.
Note: the profile (and it's dependencies) have to be made available Note: the profile (and it's dependencies) have to be made available
through one of the -ig parameters. Note that package dependencies will through one of the -ig parameters. Note that package dependencies will
automatically be resolved automatically be resolved
@ -51,10 +54,12 @@ The following parameters are supported:
validation messages, but may allow easier debugging. If not specified, validation messages, but may allow easier debugging. If not specified,
then only a high-level message indicating that the referenced item wasn't then only a high-level message indicating that the referenced item wasn't
valid against the listed profile(s) will be provided. valid against the listed profile(s) will be provided.
-questionnaire mode: what to do with when validating QuestionnaireResponse resources -questionnaire mode: what to do when validating QuestionnaireResponse resources
none (default): just ignore the questionnaire reference * none (default): just ignore the questionnaire reference
required: check that the QuestionnaireResponse has a questionnaire and validate against it * required: check that the QuestionnaireResponse has a questionnaire and
check: if the QuestionnaireResponse has a questionnaire, validate against it validate against it
* check: if the QuestionnaireResponse has a questionnaire, validate
against it
The questionnaire must be loaded using the -ig parameter The questionnaire must be loaded using the -ig parameter
the location of a questionnaire. If provided, then the validator will validate the location of a questionnaire. If provided, then the validator will validate
any QuestionnaireResponse that claims to match the Questionnaire against it any QuestionnaireResponse that claims to match the Questionnaire against it
@ -66,36 +71,43 @@ the location of a questionnaire. If provided, then the validator will validate
-recurse -recurse
Look in subfolders when -ig refers to a folder Look in subfolders when -ig refers to a folder
-locale -locale
Specifies the locale/language of the validation result messages (eg.: de-DE Specifies the locale/language of the validation result messages (eg.:
de-DE
-sct -sct
Specify the edition of SNOMED CT to use. Valid Choices: Specify the edition of SNOMED CT to use. Valid Choices:
intl | us | uk | au | nl | ca | se | dk | es intl | us | uk | au | nl | ca | se | dk | es
tx.fhir.org only supports a subset. To add to this list or tx.fhir.org tx.fhir.org only supports a subset. To add to this list or tx.fhir.org ask
ask on https://chat.fhir.org/#narrow/stream/179202-terminology on https://chat.fhir.org/#narrow/stream/179202-terminology
-native: use schema for validation as well -native: use schema for validation as well
* XML: w3c schema+schematron * XML: w3c schema+schematron
* JSON: json.schema * JSON: json.schema
* RDF: SHEX * RDF: SHEX
Default: false Default: false
-language: [lang] -language: [lang] The language to use when validating coding displays - same
The language to use when validating coding displays - same value as for xml:lang value as for xml:lang
Not used if the resource specifies language Not used if the resource specifies language
Default: no specified language Default: no specified language
-strictExtensions: If present, treat extensions not defined within the specified FHIR version and any -strictExtensions: If present, treat extensions not defined within the specified
referenced implementation guides or profiles as errors. (Default is to only raise information messages.) FHIR version and any referenced implementation guides or profiles as errors.
-hintAboutNonMustSupport: If present, raise hints if the instance contains data elements that are not (Default is to only raise information messages.)
marked as mustSupport=true. Useful to identify elements included that may be ignored by recipients -hintAboutNonMustSupport: If present, raise hints if the instance contains data
-assumeValidRestReferences: If present, assume that URLs that reference resources follow the RESTful URI pattern elements that are not marked as mustSupport=true. Useful to identify
and it is safe to infer the type from the URL elements included that may be ignored by recipients
-security-checks: If present, check that string content doesn't include any html-like tags that might create -assumeValidRestReferences: If present, assume that URLs that reference
problems downstream (though all external input must always be santized by escaping for either html or sql) resources follow the RESTful URI pattern and it is safe to infer the type
from the URL
-security-checks: If present, check that string content doesn't include any html
-like tags that might create problems downstream (though all external input
must always be santized by escaping for either html or sql)
The validator also supports the param -proxy=[address]:[port] for if you use a proxy The validator also supports the param -proxy=[address]:[port] for if you use a
proxy
Parameters can appear in any order Parameters can appear in any order
Alternatively, you can use the validator to execute a transformation as described by a structure map. Alternatively, you can use the validator to execute a transformation as
To do this, you must provide some additional parameters: described by a structure map. To do this, you must provide some additional
parameters:
-transform [map] -transform [map]
@ -103,34 +115,39 @@ To do this, you must provide some additional parameters:
Any other dependency maps have to be loaded through an -ig reference Any other dependency maps have to be loaded through an -ig reference
-transform uses the parameters -defn, -txserver, -ig (at least one with the map files), and -output -transform uses the parameters -defn, -txserver, -ig (at least one with the map
files), and -output
Alternatively, you can use the validator to generate narrative for a resource. Alternatively, you can use the validator to generate narrative for a resource.
To do this, you must provide a specific parameter: To do this, you must provide a specific parameter:
-narrative -narrative
-narrative requires the parameters -defn, -txserver, -source, and -output. ig and profile may be used -narrative requires the parameters -defn, -txserver, -source, and -output. ig
and profile may be used
Alternatively, you can use the validator to convert a resource or logical model. Alternatively, you can use the validator to convert a resource or logical model.
To do this, you must provide a specific parameter: To do this, you must provide a specific parameter:
-convert -convert
-convert requires the parameters -source and -output. ig may be used to provide a logical model -convert requires the parameters -source and -output. ig may be used to provide
a logical model
Alternatively, you can use the validator to evaluate a FHIRPath expression on a resource or logical model. Alternatively, you can use the validator to evaluate a FHIRPath expression on a
To do this, you must provide a specific parameter: resource or logical model. To do this, you must provide a specific parameter:
-fhirpath [FHIRPath] -fhirpath [FHIRPath]
* [FHIRPath] the FHIRPath expression to evaluate * [FHIRPath] the FHIRPath expression to evaluate
-fhirpath requires the parameters -source. ig may be used to provide a logical model -fhirpath requires the parameters -source. ig may be used to provide a logical
model
Finally, you can use the validator to generate a snapshot for a profile. Finally, you can use the validator to generate a snapshot for a profile.
To do this, you must provide a specific parameter: To do this, you must provide a specific parameter:
-snapshot -snapshot
-snapshot requires the parameters -defn, -txserver, -source, and -output. ig may be used to provide necessary base profiles -snapshot requires the parameters -defn, -txserver, -source, and -output. ig may
be used to provide necessary base profiles