20 Configure Argus Centralized Coding

You must execute the following batch files to set up the Argus Centralized Coding Interface schema and to migrate encoded terms for all cases to the Interface schema.

20.1 setup_centralized_coding_interface_schema.bat

This batch file creates the schema objects for the Argus Centralized Coding Interface schema.

This script also updates the coding status field with the current status for existing cases for the following fields. The code status fields displays whether all events are encoded and are in a coding state or if the case has codeable items as not coded.

  • LM_LAB_TEST_TYPES.CODE_STATUS

  • LM_LABELED_TERMS.CODE_STATUS

  • LM_PRODUCT.IND_CODE_STATUS

  • CASE_EVENT.CODE_STATUS

  • CASE_DEATH_DETAILS.CAUSE_CODE_STATUS

  • CASE_PROD_INDICATIONS.IND_CODE_STATUS

  • CASE_PAT_HIST.ITEM_CODE_STATUS

  • CASE_ASSESS.DIAGNOSIS_CODE_STATUS

To execute the batch file:

  1. Double-click the setup_centralized_coding_interface_schema.bat file and enter:

    1. log folder name

    2. database name

    3. DBA user credentials, such as system and password

    4. RLS schema owner name and password

      Execute the following query to get the RLS schema owner name:

      SELECT owner
      FROM all_objects
      WHERE object_name = PKG_RLS AND object_type = PACKAGE;
      
    5. Argus schema owner name, such as ARGUS_APP and password

    6. Argus Safety role name

    The script creates two users, ARGUS_DMS and DMS_LOGIN, and their tablespaces.

    The Interface schema object is present in the ARGUS_DMS schema.

  2. Enter the following:

    1. password for user ARGUS_DMS.

    2. password for user DMS_LOGIN.

    3. temporary tablespace name.

      If no input is provided, TEMP tablespace is taken by default.

      The script creates two tablespaces: DMS_DATA_01.DBF, and DMS_INDEX_01.DBF.

    4. path and data file name of the tablespaces, such as:

      C:\APP\ORADATA\DBNAMD\DMS_DATA_01.DBF

      C:\APP\ORADATA\DBNAMD\DMS_INDEX_01.DBF

    5. a log file name

  3. Press Enter when the Users and Roles are located.

  4. Check the log file to validate the successful completion of the script.

  5. Log in to the application and enable the Centralized Coding module.

    Configure Centralized Coding from the dictionary selection page in the Console.

20.2 dms_migration.bat

Execute this script to populate the already encoded terms from all cases to the Interface schema table. This script supports two types of migration:

20.2.1 Single Enterprise Migration in One Execution

To migrate encoded terms for case data for a particular enterprise, enter an enterprise_id such as 1.

20.2.2 All Enterprise Migration in One Execution

When you have multiple enterprises in the Argus Safety multi-tenant environment:

  • To migrate encoded terms of case data for one enterprise only, enter only one enterprise_id such as 1 when prompted.

  • To migrate encoded terms of case data for all enterprises in one go, enter input as ALL when prompted.

  • To migrate encoded terms of case data for some enterprises (but not all), the number of executions of dms_migration.bat = Migration of encoded terms of case data for the number of enterprises.

Note:

This migration script does not check whether the Argus Centralized Coding module is enabled for any specific enterprise. You must verify that module is enabled and then migrate data for enterprises.

To populate terms to the Interface table, you must load MedDRA into the Argus schema.

The migration script populates already encoded terms from all cases to the Interface table. Any open cases in the application are processed during migration.

Execute the batch file dms_migration.bat and enter the following:

  1. log folder name

  2. log file name

  3. TNSNAMES of the Argus Safety database when the Interface schema was created

  4. Argus Safety schema owner name and password

  5. Based on whether you want to migrate coded terms for all cases, one enterprise or for multiple enterprises:

    i. Enter the enterprise_id of one enterprise to migrate data for that particular enterprise.

    ii. Enter ALL as Input to migrate data for all enterprises.

    iii. To migrate coded terms of cases for more than one enterprise, execute step (i) multiple times and provide different enterprise_ids.

  6. application user name

    If no input is provided, admin is taken as user input.

  7. Check the log file to validate successful completion of the script.