5 Exporting & Importing Configuration Files

5.1 Exporting a SOT v3 Configuration 
5.2 Importing a SOT v3 Configuration

 

Users can quickly recreate project settings previously configured in another SOT v3 project by importing a Configuration File. For a SOT v3 project, Configuration Files allow users to go back and modify a project’s dataset (dependencies, activities, production fields, etc.) in third-party mine planning software, recreate a new SOT v3 project that includes these modifications, and quickly reapply the same project settings (from the previous version of the SOT v3 project) to the updated SOT project. Configuration Files can be used to avoid having to configure a SOT v3 project every time a project is re-created. This saves time when adjustments and corrections to a dataset are required or when multiple project scenarios with similar settings are considered.

 

5.1 Exporting a SOT v3 Configuration

A Configuration File is generated by exporting the settings from a SOT v3 project. Not all settings have to be exported from a SOT project and included in a Configuration File; the export can be selective.

To export a Configuration File,

  1. Open the SOT v3 project from which you wish to create a Configuration File.


     
  2. Click File; select Export Configuration from the menu options.


     
  3. An Export config file window will appear; this is where the settings that are to be exported as a part of the Configuration File are to be selected.
  4. The Configuration File can be created with all settings currently configured in the project by clicking Export.



    OR

    The list of configured settings can be expanded and specific settings excluded from those being exported in the Configuration File.


     
  5. To allow some settings to be excluded, deselect Project by clicking the checkbox.


     
  6. Expand a setting by clicking the arrow next to the setting.


     
  7. To exclude components of a setting from the Configuration File, deselect the relevant setting.


     
  8. Exclude a portion of the setting by deselecting some of the settings definitions.



    OR

    Exclude the setting entirely by deselecting all of its definitions.


     
  9. When satisfied with the settings selected, click  to create the Configuration File.
  10. An Export Configuration File dialog window will open. Name the Configuration File that will be exported and select the location; click Save.
  11. The Configuration File will be exported to the selected location.

 

5.2 Importing a SOT v3 Configuration

SOT v3 project settings can be recreated for a dataset by importing a previously created Configuration File. When configuring a project with a Configuration File, project settings can be imported exactly as defined, imported selectively or imported and applied to a different production or text field. How settings are imported from a Configuration File and interpreted in a SOT project is governed by the Import Method defined for each setting. By default, the Import Method will create setting definitions directly from the Configuration File. However, if SOT recognizes that a Configuration File’s setting is a duplicate of a setting that already exists in the project, the default is to ignore and skip importing the setting. The Import Method can also be changed to allow a duplicate setting to be updated by the Configuration File upon import.

Importing a Configuration File to a SOT project that is significantly different from the SOT project used to create the Configuration File should be avoided, as the settings may be incorrectly interpreted when imported, or ignored all together.

To import a Configuration File,

  1. Open the SOT v3 project to which the Configuration File will be applied.


     
  1. Click File; select Import Configuration from the menu options.

     
     
  1. A Select Configuration File dialog window will open. Click on the select file box.


     
  2. A Select Configuration File window will open; select a previously saved Configuration File to import.


     
  3. The path to the Configuration File will be entered into the Select Configuration File dialog window; click the  button.
  4. If Length or Weight fields were defined in the Configuration File, the Length/Weight window will open, listing the Length and Weight field Each Length or Weight field definition will have an Import Method specified.

    image51 2

    The Import Method defines how the setting in the Configuration File will be handled and interpreted when imported.


    If a Length or Weight field definition does not already exist in the SOT project, the Import Method will be set to its default, Create using field [field name].
    If a Length or Weight field definition does already exist in the SOT project, the Import Method will be set to the duplicate-handling default, Use [field name].



    For settings other than a Length or Weight field definition, if the setting does already exist in the SOT project, the Import Method will be set to the duplicate-handling default, Ignore.

    image53 2  

  5. To create a new Length or Weight field definition in the SOT project by directly importing the Length or Weight field setting contained in the Configuration File:
  1. Change nothing, leaving the Import Method settings defined as they are in the Configuration File.



  2. Click  Next.

    OR

    Exclude a Length or Weight field definition from being imported from the Configuration File:
  1. Change the Import Method of the Configuration File’s Length or Weight field definition by double clicking on the Import Method cell.


     
  2. A Select Import Method dialog window will open. Select the Ignore option; click OK.


     
  3. The Import Method for the Configuration file setting will now reflect the change.


     
  4. Click Next.

    OR

    Update a pre-existing Length or Weight field definition with the Length or Weight field definition contained in the Configuration File:
  1. Change the Import Method of the Configuration File’s Length or Weight field definition by double clicking on the Import Method cell.


     
  2. A Select Import Method dialog window will open. Select the Update option.



    The Update option is only available when a setting already exists in the SOT v3 project and is also contained in the Configuration File.

  3. Select from the drop-down list the Length or Weight field definition to update in the SOT project; click OK.


     
  4. The Import Method for the Configuration file setting will now reflect the change. Click Next.



    OR

    Create a new Length or Weight field definition in the project and use it in the project settings in place of an existing Length or Weight field by importing a different production field contained in the Configuration File:
  1. Change the Import Method of the Configuration File’s Length or Weight field definition by double clicking on the Import Method cell.


     
  2. A Select Import Method dialog window will open. Select the New option and the production field with which to create the new Length or Weight field setting from the drop-down list. Click OK.


     
  3. The Import Method for the Configuration file setting will now reflect the change. Click Next.


     
  1. If Products were defined in the Configuration File, a Products window will open listing the Product Each Product definition will have an Import Method set in the second column. Set each Import Method as desired, following the same procedure outlined in step 7. Click Next.


     
  2. If Contaminants were defined in the Configuration File, a Contaminants window will open listing the Contaminant Each Contaminant definition will have an Import Method set in the second column. Set each Import Method as desired, following the same procedure outlined in step 7. Click Next.


     
  3. If Other Properties were defined in the Configuration File, an Other Properties window will open listing the Other Property Each Other Property definition will have an Import Method set in the second column. Set each Import Method as desired, following the same procedure outlined in step 7. Click Next.


     
  4. If Equipment was defined in the Configuration File, an Equipment window will open listing the Equipment Each Equipment definition will have an Import Method set in the second column. Set each Import Method as desired, following the same procedure outlined in step 7. Click Next.



    Note: Equipment cannot be re-created from a Configuration File Equipment definition using a different production field, as Equipment is not defined with a production field.
     
  5. If Plants were defined in the Configuration File, a Plant window will open listing the Plant Each Plant definition will have an Import Method set in the second column. Set each Import Method as desired, following the same procedure outlined in step 7. Click Next.



    Note: Plants cannot be re-created from a Configuration File Plant definition using a different production field, as Plants are not defined with a production field.
     
  6. If Text Attribute Capacity Scenarios were defined in the Configuration File, a Text Attribute Capacity Scenarios window will open with a table listing in the first and second columns the Text Attribute associated with each of the imported Capacity Scenarios, which are shown in the third column.

    Create a new Text Attribute Capacity definition in the project by directly importing the Text Attribute Capacity definition contained in the Configuration File:
  1. Change nothing and click Next.



    OR

    Create a new Text Attribute Capacity definition in the project by importing a Text Attribute Capacity definition from the Configuration File, keeping the Capacity Constraints but using a different text field to define the Text Attribute Capacity:
  1. Double click on the To Attribute cell.



  2. A Select Text Field dialog window will open. Select from the drop-down list the desired text field; click OK.



  3. The text field that will be used for the Text Attribute Capacity Scenario setting will now be reflected in the To Attribute column. Click Next.



    OR

    Create a new Text Attribute Capacity definition in the project by importing a Text Attribute Capacity definition from the Configuration File, using the same text field but excluding some of the Capacity Constraints:
  1. Double click on the Import Selected Scenarios cell.


     
  2. A Select Scenarios dialog window will open; deselect the scenarios to be excluded. Click OK.


     
  3. The Import Method for the Configuration file setting will now reflect the change. Click Next.



  1. If any Added Dependencies were defined in the Configuration File, an Added Dependencies window will open listing the Added Dependencies. Deselect the definitions to exclude from the configuration import. Leave selected the definitions to include in the configuration import. Click Next.


     
  2. If any Activity Filter Scenarios were defined in the Configuration File, an Activity Filter Scenario window will open listing the scenarios. Deselect the scenarios to exclude from the configuration import. Leave selected the scenarios to include in the configuration import. Click Next.


     
  3. If any Financial Scenarios were defined in the Configuration File, a Financial Scenario window will open listing the scenarios. Deselect the scenarios to exclude from the configuration import. Leave selected the scenarios to include in the configuration import. Click Next.


     
  4. If any Mine Scenarios were defined in the Configuration File, a Mine Scenario window will open listing the scenarios. Deselect the scenarios to exclude from the configuration import. Leave selected the scenarios to include in the configuration import. Click Next.


     
  5. If any Seeds were saved in the Configuration File, a Seeds window will open listing the saved Seeds. Deselect the Seeds to exclude from the configuration import. Leave selected the Seeds to include in the configuration import. Click Next.


     
  6. If any Guidance Sets were defined in the Configuration File, a Guidance Set window will open listing the sets. Deselect the sets to exclude from the configuration import. Leave selected the sets to include in the configuration import. Click Next.


     
  7. If any Capacity Flexing Sets were defined in the Configuration File, a Capacity Flexing Set window will open listing the sets. Deselect the sets to exclude from the configuration import. Leave selected the sets to include in the configuration import. Click Next.


     
  8. If any Run Settings were defined in the Configuration File, a Run Settings window will open listing the definitions. Deselect the Run Setting definitions to exclude from the configuration import. Leave selected the definitions to include in the configuration import. Click Next.


     
  9. If any Execution Configurations were defined in the Configuration File, an Execution Configurations window will open listing the definitions. Deselect the Execution Configurations to exclude from the configuration import. Leave selected the Execution Configurations to include in the configuration import. Click Next.


     
  10. Click the Finish button and the configuration will import.

 

 

Back to Top