Document Management System support

Summary

Argus Bridge supports Document Management System integration with Argus via API (Enhancements 35332554 and 21548860)

Description

Argus supports Documentum version 22.1 and all use cases supported by Argus Safety also work with Documentum V.22.1. A new section titled Bridge Configuration is added to Console > System Configuration > Webservice. This menu is visible only if you belong to groups with access set to Enabled on the Webservice screen in Console > Access Management > Argus > Groups > Menus > Webservice. In addition, the following updates have also been made:
  • The Service Settings option has been moved from the Document Management screen to Service Settings;
  • A new common profile switch has been added;
  • A new Argus Bridge schema has been added.

The Bridge Configuration section contains parameters used to configure the below details for integration with any document management system:

Serviced Assembly section

Parameter name Description
Service The options available are document and translation. Select the Document option to configure the document management system.
Class name The DLL name.
Assembly File The actual DLL file created for the document management system.
Configuration JSON File Upload the JSON file. A sample JSON file is provided in the Argus Administration Guide.The following placeholders should be replaced with your requred values: {SERVER_URL}, {SERVER_PORT}, {THIRD_PARTY_REPO}, {USERNAME}, {PASSWORD}, {CABINET_ID}.
Service status This parameter can be set as:
  • Not configured
  • Configured
  • Argus Safety API Load Balancer URL is not configured

Note:

These settings are at global level and not enterprise specific.

Service Settings update

The Settings section is moved from Console > System Configuration > Common Profile Switches > Document Management to Console > System Configuration > Webservice > Bridge Configuration.

The following settings are now available:

  • The common profile switch label Enable storage of case attachment files in Document Repository and additionally the searching and attaching files already existing in Document Repository to a case is split into two separate parameters, as listed below:
    • Enable searching and attaching files already existing in External Storage to a case parameter. The available settings are Yes and No.
    • Enable storage of case attachment files parameter. The available settings are Argus and External Storage.
  • Enable Storage of ICSR reports in Document Repository option is renamed as Enable storage of ICSR reports. The available settings are Argus and External Storage.
  • Enable storage of submitted periodic reports in Document Repository option is renamed as Enable storage of submitted periodic reports. The available settings are Argus and External Storage.
  • Enable storage of submitted expedited reports in Document Repository option is renamed as Enable storage of submitted expedited reports. The available settings are Argus and External Storage.

Note:

These settings are at enterprise level.

New common profile switch

A new common profile switch has been added in Console > System Configuration > Common Profile Switches > Network Settings > Argus Safety API Load Balancer URL.

Note:

This profile switch is available in the default enterprise. It is set at the global level and not specific to the enterprise.

If a Load Balancer setup exists, then provide the Load Balancer URL. Otherwise, you should provide the web server URL.

New Argus Bridge schema

A new schema entitled ARGUS_BRIDGE has been added to manage bridge configurations and to store the BLOB file attachments. Storage of case attachments and of reports is managed thus:
  • When the Enable storage of case attachment files parameter is set to Argus, the data is stored only in Argus Bridge for new attachments in legacy cases or for new cases. This is available for the following tables: CASE_NOTES_ATTACH, CASE_NOTES_E2B_ATTACH, LAM_NOTES_ATTACHMENT.

    Note:

    For existing attachments of legacy cases, the attachments would continue to be stored in the CASE% tables. Due to this framework, the size of ARGUS_APP is expected to decrease gradually because large sized attachments are now stored in the ARGUS_BRDIGE schema.
  • When the Enable storage of case attachment files parameter is set to External Storage for the CASE_NOTES_ATTACH, CASE_NOTES_E2B_ATTACH, LAM_NOTES_ATTACHMENT tables, the data is stored only in the Document management system.

    In the exceptional cases where the application is unable to send the file to the document management system, then Argus temporarily stores the actual file in ARGUS_BRIDGE. The application would retry to move the attachment from Argus Bridge to the document management system based on the SERVICE.PROFILE.MAX_RETRY_COUNT table. The default retry value is three times. If the application retries as per the MAX_RETRY_COUNT table and it is not able to push the attachment to document management system, then the attachment is retained in ARGUS_BRIDGE.

    The SERVICE_PROFILE.MAX_RETRY_COUNT_REFRESH_INTERVAL table is used to evaluate the frequency of trying to move the attachment. The default value is set to eight hours.

  • When the parameter for ICSR/Expedited/Periodic reports is set to Argus, the data is stored only in CMN_REG_REPORTS.
  • When the parameter for ICSR/Expedited/Periodic reports is set to External Storage, the data is stored in CMN_REG_REPORTS due to regulatory needs and also in the document management system.

    Note:

    The reference is still maintained in ARGUS_BRIDGE.

    For exceptional scenarios, the application follows the same method as storage of case attachment files.

A migration script is executed while upgrading to 8.4.1. This migration script is to ensure that files stored in Documentum prior to the Argus 8.4.1 upgrade are synced up with ARGUS_BRIDGE.