.. include:: /includes.rst.txt .. comments - headings # with overline, for parts * with overline, for chapters = for sections - for subsections ^ for subsubsections " for paragraphs .. _edg_configuration_parameters: EDG Configuration Parameters ---------------------------- .. note:: * Any required passwords must be entered after saving changes. * Database updates and Sharepoint connection require an EDG server restart. Teamwork Platform Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 20 20 60 :class: tight-table * - Parameter - Default - Description * - *Comments activated* - true - Allows comments on data resources * - *Tasks activated* - true - Allows user tasks on data resources * - Metrics dashboards activated - false - EDG only. This enables user viewing and administrator editing of metrics dashboards. * - Disable Profile Avatars - false - Set this to true to remove the ability for users to add a profile image in the User Directory page. * - *Default namespace suggestion* - http://example.org/{type}/new# - This is the string used to pre-fill the **Default namespace** field for a new vocabulary/asset. The EDG default is *http://example.org/{type}/new#*, which an administrator can customize here. **Note** that the variable *{type}* produces the lowercase plural name of the vocabulary/asset type, e.g., “ontologies”. * - *Constraint violations block editing* - false - If true then the edit forms will block saving of edits if violations have at least sh:Violation severity. By default, users can override all violations, irrespective of their severity level, and continue despite them. * - *Only admins can upload files from TriG files* - true - If true then only administrators can upload TriG files containing graphs that are mapped to files. URI Construction Rules ^^^^^^^^^^^^^^^^^^^^^^ When a new asset is created, these parameters determine how its URI is automatically constructed. .. list-table:: :header-rows: 1 :widths: 20 10 70 :class: tight-table * - Parameter - Default - Description * - *Local name construct method* - label - Usually, the new URI begins with the collection’s default namespace string (see the collection’s **Settings** utility group), and this parameter determines its *suffix*. The parameters settings are shared in the table :ref:`below`. * - *Include class prefix* - true - When true, prepend the asset’s classname to the preceding local-name suffix parameter (except for: **custom**) * - *URI Prefix Separator* - \- - The character(s) used to separate the prefix value from the rest of the URI value when prefix is set, defaulting to “-“. * - *Include class acronym prefix* - true - When the preceding parameter (class name prefix) is true *and* this is true, use an abbreviated form of the class name *if available* * - *Users cannot modify URI* - false - When true, the URIs of new assets are automatically constructed and displayed, but collection editors cannot modify them. * - *URI Counter Offset* - 0 - The default offset used in the case of counter being set to construct URIs, defaulting to 0. .. _below: .. list-table:: Parameters Settings :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter value - URI structure * - **label** or *[EMPTY]* - The asset’s label is appended to the default namespace * - **uuid** - A generated UUID is appended to the default namespaceA generated UUID is appended to the default namespace * - **counter** - A sequential integer is appended to the default namespace (from a namespace-specific sequence beginning with 0) * - **custom** - *[EMPTY]* – The default namespace is not used: the editor must provide the full URI manually Lucene Configuration Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter - Description * - Lucene Unlimited Matches - If true then queries using the Lucene text index will not use an upper boundary (10000) of matches. Activating this will return more complete results but may lead to bad worst-case performance. This setting applies to EDG editors and not Search the EDG * - Use Lucene WhitespaceAnalyzer - Changes the Lucene index analyzer (currently used for the Text Indices/GraphQL-based and Seach the EDG queries only). The default StandardAnalyzer drops characters such as / and – while the WhitespaceAnalyzer preserves them. You need to restart the server and then rebuild the text index for this change to take effect. Reification Configuration Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter - Description * - Preserve reification statements - If true then EDG file importers will not attempt to convert rdf:Statement instances into corresponding reification URIs (and vice versa on export). By default this conversion applies to blank nodes only, unless alsoConvertURIStatements is true. Among the RDF file exporters, only the Sorted Turtle writer will observe this flag – all others do not convert reification URIs back to rdf:Statements. * - Also convert URI statements - If true then EDG file importers will not only convert rdf:Statements that are blank nodes but also URI statements. * - Record statement URIs - If true then EDG file importers will record the original URIs of rdf:Statements as values of dash:uri for round-tripping later. .. _ms365-auth-params: Microsoft 365 Authentication Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter - Description * - Registered Application ID - The application id generated when the EDG application was registered in Azure. * - Service account user name - The user name for the service account used to authenticate Microsoft 365 service requests (e.g. Microsoft Graph API). * - Service account password - Git Integration ^^^^^^^^^^^^^^^ .. list-table:: :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter - Description * - Git Folder - A local folder on the server that connects to a git repository. This must be the folder with a .git file or a sub-folder of such a folder. If a value is given then the user interface will have additional features to commit, push, pull and import asset collections using that repository. * - Git user name - The user name to authenticate to the git repository (e.g. for push requests). Typically combined with a password. Note that for GitHub access, the password may need to be a personal access token, see `https://github.com/settings/tokens` * - Git password - LineageGram Configuration Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ LineageGram is available as a plugin for Customers who have purchased Lineage Models as part of their packaging. Please contact TopQuadrant support for this install. .. list-table:: :header-rows: 1 :widths: 20 80 :class: tight-table * - Parameter - Description * - LineageGram Reach - Sets the number of hops made for building a lineage or impact diagram. A value of between 1 and 10 is advised. * - LineageGram Breadth - Sets the number of fan-in or fan-out paths that are evaluated for building a lineage or impact diagram, respectively. A value of between 2 and 10 is advised. * - LineageGram with Viewframes - If true sets the lineageGram to a framed view with collapsible panes. EDG Asset Collection Singletons ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ EDG Asset Collection Singletons are special asset collections that are automatically created when EDG is installed. Currently, there are two singletons: Governance Model and EDG Enumerations. Unlike other collection types, only one Governance Model and one EDG Enumerations collection can exist in a given installation of EDG. Assets in these collections are available for referencing in all other collections without a need to explicitly include them. Setup EDG Enumerations – Administrators can use this function to populate selection values for built-in EDG properties such as status and confidentiality. You will be able to load files with pre-build values and/or enter your own values. Configure Asset Collection Types ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ For the asset collection types allowed by the installed TopBraid product license, these settings allow administrators to show or hide those types in the user interface. Administrators can also modify “default includes” for each asset collection type. Default includes are graphs that are automatically included when a new collection is created. User Interface Configuration ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Some TopBraid EDG features support assigning language tags to string attribute values using a drop-down list when editing, for example: .. figure:: _images/edg_language_tags.png :alt: TopBraid EDG Language Tags :align: center :class: edg-figure **TopBraid EDG Language Tags** This section allows overriding and adding additional languages. The below entery is a space-delimited list where you can enter the language choices that will appear on EDG editing screens. Any codes can be entered, but the codes will interoperate better with other systems, such as Web browsers, if the ISO 639 language codes and, optionally, ISO 3166 country codes, are used. In the following, ISO codes for Spanish, English US English have been entered. These will be the only languages that appear in the language tag drop-down: .. figure:: _images/edg_custom_language_setting.png :alt: TopBraid EDG Custom Language Setting :align: center :class: edg-figure **TopBraid EDG Custom Language Setting** .. _edg_default_notifications: Default Notification Setup ^^^^^^^^^^^^^^^^^^^^^^^^^^ These are the default notification settings that are used to initialize new collections. For each collection-related event, administrators can indicate default choices for the governance roles that should be notified of it. Each collection can override their initial default settings, and changes to these defaults do not affect existing collections. .. seeealso:: * For information on associating governance roles with asset collections, see :ref:`operationalizing_data_governance`. * To manage a collection’s notifications, see the **Manage > Configure Notifications** documentation of its collection type. Governance Roles ^^^^^^^^^^^^^^^^ A user who is assigned a governance role will have permissions on a collection in that subject area. This global setting determines whether the role can create workflows. .. note:: A user having one role disabled for workflow creation could still create a workflow if they also have another applicable enabled role (or a permission profile assignment). There is also a setting for roles that edit source code and edit ADS scripts. If source code checked, users will see the source code panel in the editor and be able to make direct edits. If ADS is checked, users will see the ADS panel and be able to write scripts that are executed on this EDG instance. Please disable these for non-expert users. Landing Page Settings ^^^^^^^^^^^^^^^^^^^^^ The landing page widgets can be turned off or on for the entire EDG workspace. Users can turn off any widgets they don’t want to see individually from their users page, unless a widget has been deactivated here. It will then be unavailable to anyone.