Selecting the File or Files to Load

You can drag a file or files from the Windows Explorer and drop one or more files onto the Load button on the JADE development environment toolbar or the Schema Browser list box, to open the Load Options dialog and populate the Schema File Name text box with the file or files. If you drop:

• A single file with a .mul file type, the Load Multiple Schemas check box is checked.

• More than one file, the Load Multiple Files check box is checked and all of the dropped file names are displayed in the Schema File Name text box, so that you can add more files, if required.

Dropping a folder is rejected.

You can drag files from the Windows Explorer and drop them on the Load Options dialog Schema File Name and Forms File Name text boxes. Dragging and dropping a file on the Schema File Name text box has the following effect.

• If a single .mul file is dropped on the text box, the Load Multiple Schemas check box is checked and the text box displays the name of the multiple schemas file. (The file must be of type .mul, for this action to be recognized.)

• If a single schema file is dropped on the text box and the Load Multiple Schemas check box is unchecked, the name of the dropped schema file replaces any file that was already displayed in the text box.

• If a single file is dropped on the text box and the Load Multiple Files check box is checked, the file is added to the list of file names in the Select Multiple File Names text box.

• If multiple form and data definition (.ddb or .ddx) or method (.mth) files are dropped and the Load Multiple Files check box is unchecked, the Load Multiple Files check box is checked, any previously selected files are cleared, and all of the dropped file names are displayed in the Select Multiple File Names text box.

• If multiple files are dropped and the Load Multiple Files check box is checked, the files are added to the list of files names displayed in the Select Multiple File Names text box.

Dropping a single form and data definition (.ddb or .ddx) file on the Forms File Name text box displays that file name, replacing any previously displayed forms definition file or files. Dropping multiple files on the Forms File Name text box in the same action is rejected.

2018.0.01 and higher

To specify your load options on the File Selection sheet

1. Check the Load Multiple Schemas check box if you want to load an extract file containing multiple schemas. A single schema is loaded by default; that is, this check box is unchecked.

   The Multi Extract File Name text box is then displayed instead of the Schema File Name text box, and the Forms File Name text box is disabled. (A multiple schemas extract file itself contains merely a list of extracted files, with each extracted schema having a separate pair of .scm and .ddb or .ddx files.)

2. Check the Load Multiple Files check box if you want to load multiple files. A single file is loaded by default; that is, this check box is unchecked.

   The common Open dialog is then displayed, to enable you to select the schema files (that is, any combination of .scm, .ddb or .ddx, .cls, .mth, or .mul files) that you want to load into your JADE database. When you have selected the files from the appropriate directory or directories, click the Open button.

   The Select Multiple File Names text box containing your selected files is then displayed instead of the Schema File Name text box, the Forms File Name text box is disabled, and the Load Order sheet is enabled.

3. If you are loading a single schema, in the Schema File Name text box, specify the name and location of the schema file that you want to load. You must specify a value in this text box. An error is raised if you do not specify the name of an existing file or if the file cannot be accessed.

   If you are loading multiple schemas from a multiple schemas extract file, in the Multi Extract File Name text box, specify the name and location of the multiple schemas extract file you want to load (with a default .mul file suffix). You must specify a value in this text box. An error is raised if you do not specify the name of an existing file, if the file cannot be accessed, or the extract file and the schema metadata (.scm) and form and data definition (.ddb or .ddx) files are not located in the same directory. If you are unsure of your file name or location, click the Browse button. The common File dialog is then displayed, to enable you to select the appropriate file.

4. If you are loading a single schema, specify the name and location of the extracted forms file in the Forms File Name text box if you want to load an extracted file containing application forms as a separate transaction in the same load process. An error is raised if the file cannot be accessed.

   Click the Forms File Name text box to display the forms file with the same prefix as the schema file in the text box.

5. In the Load Style combo box, select the load style, as follows.

   • Load a new schema or load the schema as the latest schema version (a new version will be created if required), and allow structural changes. This is the default option.

   • Load the schema into the existing current schema version, which may potentially affect current runtime behavior. As structural changes are not allowed, the load will not proceed if structural changes are to be introduced. If you are loading a schema file containing only method changes into a multiuser system, select this option, to ensure that no structural changes are attempted that would require a reorganization of the database and impact existing users. If a structural change is detected, the schema load returns an error.

   • Load into latest versioning only structural changes, which loads only structural changes into the latest version and does not version methods or other non-structural entities. This may potentially affect current runtime behavior.

   If you want to set the default load style that is selected in the Load Style combo box when the Load Options dialog is displayed, specify the LoadStyleDefault parameter and the optional LoadStyleSecond and LoadStyleThird parameters in the [Jade] section of the JADE initialization file. For details, see your JADE Initialization File Reference.

6. If you are loading multiple files and you want to specify the order in which the files are loaded, click the tab of the Load Order sheet. For details, see the following section.

7. If you want to select additional load options (for example, loading checked out methods or changing the target schema), click the Advanced button.

   The Advanced Load Options dialog is then displayed. For details, see "Specifying Advanced Load Options", later in this chapter.