5.1.1.2 Additional Configuration
The parameters in this section allow administrators to enhance, customize, or optimize the notebook’s behavior for their operational environment. These configurations cover attribute handling, validation, audit or process tracking, and user environment defaults.
Note:
(Optional) Review and adjust these settings based on your compliance, audit, UI, and performance requirements.| Sr. No. | Description | Name | Default Value | Comment |
|---|---|---|---|---|
| Overridable and Additional Attribute Value Handling (Store user-provided overrides and remarks in the IH Data Schema. Use these settings to control value saving behavior.) | ||||
| 1 | Flag to save values for overridable entity attributes | enableSaveOverrideValues | TRUE | Disabling may prevent storage of user input overrides. |
| 2 | Flag to save values for additional attributes such as user remarks, risk scores, or flags | enableSaveAdditionalAttrValues | TRUE | Set to FALSE if not tracking any supplementary information. |
| Restricted Word Validation Settings (Control restricted word validation and handling in user inputs.) | ||||
| 3 | Flag to validate restricted words in override attribute values | enableRestrictedWordValidationInOverride | TRUE | Set to FALSE to skip restricted word checks in overrides. |
| 4 | Flag to validate restricted words in additional attribute values | enableRestrictedWordValidationInAdditional | TRUE | Set to FALSE to skip restricted word checks in additional attributes. |
| 5 | Flag to treat restricted words in override attributes as errors (otherwise tracked as warnings) | restrictedWordValidationErrorModeInOverride | FALSE | If TRUE, validation failures will result in errors and may block processing. |
| 6 | Flag to treat restricted words in additional attributes as errors (otherwise tracked as warnings) | restrictedWordValidationErrorModeInAdditional | FALSE | If TRUE, validation failures will result in errors and may block processing. |
| Attribute Formatting and Default Value Controls (Manage delimiters and assign default values when source data is null.) | ||||
| 7 | Delimiter character for splitting multi-valued strings | ATTRIBUTE_DELIMITER | ~ | Modify only if the default delimiter conflicts with data. |
| 8 | Default value if date is null | DATE | 01-01-1970 | Use a value consistent with your business rules for missing dates. |
| 9 | Default date format | DATE_FORMAT | yyyy-MM-dd | Ensure this format matches expectations for data integration and reporting. |
| 10 | Default value if time is null | TIME | 00:00.0 | |
| 11 | Default time format | TIME_FORMAT | HH:mm:ss.S | |
| 12 | Default value if timestamp is null | DATE_TIME | 00:00.0 | |
| 13 | Default timestamp format | DATE_TIME_FORMAT | yyyy-MM-dd HH:mm:ss.S | |
| 14 | Default string value | STRING | Use only if null/empty string values must be replaced. | |
| 15 | Default long value | LONG | 0 | |
| 16 | Default float value | FLOAT | 0 | |
| 17 | Default integer value | INTEGER | 0 | |
| 18 | Default double value | DOUBLE | 0 | |
| 19 | Default boolean value | BOOLEAN | FALSE | |
| Audit & Process Tracking Configuration (Manage audit and process tracking behavior and storage.) | ||||
| 20 | Maximum records to collect before writing audit or process tracking batches | N_AUDIT_BATCH_SIZE | 1000 | Adjust based on memory, performance, and system load. |
| 21 | Time interval before saving audit or process tracking batches | V_AUDIT_SAVE_INTERVAL | PT20S | ISO-8601 duration string, e.g., PT20S means 20 seconds. |
| 22 | Maximum concurrent threads for batch processing | N_AUDIT_MAX_THREAD | 4 | Increase with caution; higher values may impact database performance. |
| 23 | Maximum retry attempts for batch writes to database | N_AUDIT_MAX_RETRY | 3 | Higher values may prolong processing time in the event of repeated failures. |
| 24 | Flag to log audit records in the log file if unsaved after all retries | F_LOG_UNSAVED_AUDIT_RECORDS | TRUE | Set to TRUE to avoid data loss, but monitor log file growth. |
| 25 | Wait time before retrying a failed batch write | V_AUDIT_RETRY_DELAY | PT15S | ISO-8601 duration; adjust based on retry policy. |
| 26 | Flag to store attribute values in audit records in the table | saveValueInAudit | FALSE | Recommended FALSE to prevent storing potential PII in audit logs. |
| 27 | Flag to track processing of all toolkit processes such as narrative generation and risk evaluation | saveProcessTracking | TRUE | To reduce overhead, set FALSE unless detailed tracking is required. |
| 28 | Process tracking detail level for records saved in the audit table (0-5) | process_level | 1 | Level 0=Minimal, 5=Most granular; recommend minimal in production. |
| 29 | Process tracking detail level for records saved in logs (0-5) | log_level | 1 | Level 0=Minimal, 5=Most granular; increase for diagnostics. |
| 30 | Flag to log process tracking records if unsaved after retries | F_LOG_UNSAVED_PROCESS_TRACKING_RECORDS | TRUE | Set to TRUE to retain failure cases for further investigation. |
| General and Performance Configuration (Control display, concurrency, caching, and environment context.) | ||||
| 31 | Default styling for the narrative iframe | NARRATIVE_IFRAME_STYLE | frameborder="0" style="height: 100vh; width: 100%;" | Adjust to meet UI/UX requirements. |
| 32 | Batch size for entity processing during narrative generation | NARRATIVE_BATCH_SIZE | 1000 | Larger batches may improve performance but increase memory usage. |
| 33 | Batch size to save and read values during PDF generation | PDF_BATCH_SIZE | 1000 | Balance throughput and resource usage. |
| 34 | SQL parallelism execution hint | PARALLEL_HINT | 8 | Match to database and hardware capabilities for best results. |
| 35 | Flag to cache narrative responses on the interpreter side for improved performance | enableNarrativeResponseCache | TRUE | Recommended TRUE for optimal performance; set FALSE to always regenerate. |
| 36 | Flag to enable database connection pool | enableConnectionPool | TRUE | Set to FALSE only if connection pooling is managed externally. |
| 37 | Feature name for the HTML table generator | HTML_TABLE_FEATURENAME | htmlTableGenerator | Change only if using a custom implementation. |
| 38 | Feature name for the DS table generator | DS_TABLE_FEATURENAME | dsTableGenerator | Change only if using a custom implementation. |
| 39 | Default INFODOM value used to fetch configuration from MMG | infodom | CS | |
| 40 | Default locale value used to fetch configuration from MMG | locale | en_US | Set to your application’s localization needs. |
| 41 | Workspace identifier value | workspace | CS | |
| 42 | Default user identifier value used to fetch configuration from MMG | user | MMGUSER | Change if using a dedicated technical username for configuration fetch. |
| 43 | Flag to track changes to original attribute values (if disabled, updates may overwrite prior values during restoration) | enableTracking | TRUE | Keeping TRUE ensures auditability of source value changes. |