Extracting an RPS Mapping

You can extract an RPS mapping as part of the schema in which it is defined or you can extract only the RPS mapping itself.

You cannot extract a schema from a system with the Map to String (7.1 format) option set and load it into a JADE 7.1.06 or earlier system where the OID mapping is Map to String.

To extract an RPS mapping only

  1. In the Relational Population Service Browser, select the RPS mapping that you want to extract.

  2. Select the Extract command from the Relational menu. The Extract dialog is then displayed.

    As you can extract only the version of the RPS mapping already selected in the RPS Browser, when extracting an RPS mapping, the Multiple Schemas option button and Extract Latest check box are disabled.

    By default, all entities (class maps) in the RPS mapping are extracted; that is, the Extract All option button in the Current Schema group box is selected.

  3. Select the Use Parameter File option button if you want to use an existing parameter file to specify the selected class maps to extract.

    If you select the Use Parameter File option, you must first have defined a parameter text file by using a text editor (for example, Notepad) or by saving the parameters from a selective extract.

  4. Select the Selective Extract option button if you want to select specific class maps to be extracted. The Selective sheet is then displayed. For details, see "Specifying Selective RPS Extract Options", in the following subsection.

    Any specified class maps that you select are for this extract only. You can save the selective extract information, if required, by using the Save Parameters check box in the Selective sheet.

  5. Select the Changes option button if you want to extract only the changed class maps. The Changes sheet is then displayed. For details about using this sheet, see "Specifying Your Change Options", in Chapter 10.

  6. In the Schema File Name and Forms File Name text boxes of the Extract Options sheet, specify the appropriate names and location of your .scm and .ddb or .ddx files, respectively.

    By default, your RPS mapping is extracted to your JADE working directory (for example, s:\jade\test\bin) as .scm and .ddb or .ddx files that are prefixed with the name of your RPS mapping; for example, Documentation Example.scm and Documentation Example.ddx.

    If you want to extract the RPS mapping to an existing file or you are unsure of existing extract file names or location, click the Browse button. The common File dialog is then displayed, to enable you to select the appropriate file or location, if required.

    An error is raised if you do not specify the name of a file, your specified file name or path is invalid, or an existing file cannot be accessed.

  7. Click the OK button to confirm your selections, the Parameter sheet to specify your parameter option, the Selective sheet to specify your selective extract options, the Changes sheet to specify your RPS mapping change options, or the Cancel button to abandon your selections.

For details about schema extraction options, see "Extracting Your Schema", in Chapter 10.