Forge Options ============= Forge provides several options regarding rendering and saving in the ``Options`` menu. .. figure:: ../images/OptionsForge.png :alt: The options menu in Forge :width: 596 Application Settings -------------------- User Interface ~~~~~~~~~~~~~~ .. figure:: ../images/Settings_UserInterface.png :alt: The user interface settings :width: 703 - **Night Time** Switch between light and dark color theme for the Forge user interface. .. list-table:: * - .. image:: ../images/Settings_NightTime_Off.png :width: 651 - .. image:: ../images/Settings_NightTime_On.png :width: 651 * - *Night Time Off* - *Night Time On* - **Show element properties details** - **On command only** (Ctrl+1) Extensions are only displayed when you click the details button next to the element property. - **When Constrained** (Ctrl+2) Extensions are displayed when they have one or more constraints. This is the default selection. - **When Constrained Or Inherited** (Ctrl+3) Extensions are displayed when they have one or more constraints or when the base profile has defined one or more extensions. - **Element Id** (Ctrl+4) Show or hide all **Element Id** fields for extensions. By default **Element Id** fields for extensions are hidden. - **Element tree modified style** Selects how modified elements in the **Element Tree** are displayed. .. list-table:: * - .. image:: ../images/Settings_ModifiedStyle_Dimmed.png :width: 425 - .. image:: ../images/Settings_ModifiedStyle_Pen.png :width: 425 * - *Unmodified elements are displayed dimmed* - *Modified elements are indicated with a pen* - **Show file preview tab** Forge has three options that allow you to specify how the file serialization preview of a resource is presented: - XML + JSON - Same as source - None - **Show XML/JSON node expand button** When turned on allows you to collapse and expand nodes in the **XML** and **JSON** viewer. .. list-table:: * - .. image:: ../images/Settings_XmlFolding_Off.png :width: 628 - .. image:: ../images/Settings_XmlFolding_On.png :width: 628 * - *Show XML/JSON node expand button Off* - *Show XML/JSON node expand button On* - **Show common resource elements (id, meta, ...)** Shows or hides common resource elements in the **Element Tree**. .. list-table:: * - .. image:: ../images/Settings_CommonElements_Off.png :width: 408 - .. image:: ../images/Settings_CommonElements_On.png :width: 408 * - *Show common resource elements Off* - *Show common resource elements On* - **Show child elements when sliced** This option allows you to see the constraints that can be put on the sliced element. These constraints are implemented on all the slices. This is summarized in the “All slice” once rendered on Simplifier. .. list-table:: * - .. image:: ../images/Settings_SliceElements_Off.png :width: 418 - .. image:: ../images/Settings_SliceElements_On.png :width: 419 * - *Show child elements when sliced Off* - *Show child elements when sliced On* - **Expand all constrained elements on load** This option will expand constrained elements in the **Element Tree** when a resource is loaded. .. list-table:: * - .. image:: ../images/Settings_ExpandElements_Off.png :width: 424 - .. image:: ../images/Settings_ExpandElements_On.png :width: 424 * - *Expand constrained elements Off* - *Expand constrained elements On* - **Expand all constrained extensions on element properties on load** This option will expand constrained extensions in the **Element Properties** panel when a resource is loaded. .. list-table:: * - .. image:: ../images/Settings_ExpandElementExtensions_Off.png :width: 532 - .. image:: ../images/Settings_ExpandElementExtensions_On.png :width: 532 * - *Expand constrained extensions on element properties Off* - *Expand constrained extensions on element properties On* - **Force garbage collection on unload** When switched on this option will try to free up system memory when you close a document. - **Disable hardware rendering** If you encounter rendering issues with the Forge user interface then those are most likely caused by the video driver. In that case you can turn off hardware rendering. Persistence ~~~~~~~~~~~ .. figure:: ../images/Settings_Persistence.png :alt: The persistence settings :width: 703 - **Auto update publication data** When switched on this option will update the Date element of a conformance resource to the current date and time when uploading a resource to Simplifier. - **Save snapshot component** This option allows you to generate and include the snapshot component of a structure definition when saving a file to disk. - **Save with UTF-8 Byte Order Mark (BOM)** The UTF-8 BOM is a sequence of bytes at the start of a text file (0xEF, 0xBB, 0xBF) that allows the reader to more reliably guess a file as being encoded in UTF-8. - **Xml declaration** Xml documents can contain an Xml declaration that if present, must be the first construct in the document and it looks like this: ```` Forge has three options that allow you to specify when Xml declarations are saved to a resource: - Same as source - Include - Omit Note that when saving resources that are newly created, duplicated or upgraded, the Xml declaration is included when the option is set to **Same as source** or **Include** and omitted when set to **Omit**. - **Xml indent size** The indent size to use when saving Xml files. - **Json indent size** The indent size to use when saving Json files. FHIR ~~~~ .. figure:: ../images/Settings_FHIR.png :alt: The FHIR settings :width: 703 - **Validate FHIRPath expressions** All FHIRPath expressions in your resource are validated when this option is checked. - **Initialize global mappings from base profile** When creating a new profile this option will copy all the mappings from the base profile to the new profile. .. image:: ../images/Settings_GlobalMappings.png :width: 439 - **Discard DomainResource.text values** When this option is checked the **text** element of a **DomainResource** is cleared when it is opened. In effect this will clear the **Narrative** of your resource. .. image:: ../images/Settings_DiscardResourceText.png :width: 490 - **Repeat slicing discriminators om the differential to suppress eld-1 warnings (R4)** Check this option to prevent **eld-1** validator warnings. - **Correct the content type for translation extensions to match the context in which they are used** It is recommended to match the data type for the content property of the translation extension, with the data type of the property to which the translation extension was added. Folders ~~~~~~~ .. figure:: ../images/Settings_Folders.png :alt: The folders settings :width: 703 - **Parent folder FHIR projects** The default parent folder for your FHIR projects.