login Register forgot password or username?
Search:         
Cradle from 3SL, the complete Model Based Systems Engineering Toolsuite, specialising in requirements management, requirements capture, model based systems engineering and for systems engineering software, support and consultancy, the logical choice: Cradle from 3SL.

July 2008 [Cradle 5.7]

Import/Export

There have been several changes related to import/export, described in the following sections.

Sanitised Export Files

The c_io command line utility provided in both UNIX and Windows-based Cradle systems has a new -sanitise command line option that causes c_io to generate a sanitised export file.

A sanitised export file is identical to a normal Cradle format import/export file except that:

  • All subject matter data is sanitised
  • Binary frames are not exported

Sanitisation of subject matter data means to replace all non-whitespace (space and tab) characters by the character x. This sanitisation applies to the following attributes:

  • Name (except for data definitions)
  • Key
  • Comment
  • Description
  • Text frames (except for data definitions’ COMPOSITION frame)
  • Change histories

The Number and category code attributes are not sanitised.

When a sanitised export file is generated for all item types in a source database and the sanitised file is imported into another database, that destination (sanitised) database will have an identical schema and set of items and cross references to the source database, except that the content of the data in the destination database will be sanitised. This means queries, views, forms and so on will work in the same way in both databases (except only for queries based on the contents of frames).

Sanitised exports have several uses, one is to send exports of customers’ Cradle databases, or parts thereof, to 3SL whilst protecting the national, commercial or military sensitivity of the data.

Where the differences between a sanitised and an ordinary export are that all subject matter related data in the original export has been replaced by x characters in the sanitised export.

Query Based Exports From Command Line

A new -type query option has been added to the c_io command that allows the contents of an export file to be controlled by a query specified in new -query and -qloc options to specify the query’s name, and its location (personal, user, team, user type, project or system scope).

Query based exports can be performed with a c_io command of the form:

c_io -login user,pass,pcode -type query -query name -qloc location -export file

For example, a system Req - All query can be used with the command:

c_io -login user,pass,pcode -type query -query “Req - All” -qloc system -export file

Additional C_IO Feedback

User feedback has been improved in c_io in the form of two new options -verbose and -log.

The -log creates a log file containing the same summary of the items exported and imported and details of any errors and items not overwritten as can be produced from the Log... buttons in the Export Information and Import Information dialogues in Toolset and WorkBench.

If -sanitise and -log are being used, then all information in the log file is also sanitised.

The -verbose option causes a popup to be produced once the c_io command has completed its import or export, and can be convenient for exports and imports that take a long time to run.

Control Privileges

Two new privileges have been introduced to allow projects to optionally limit the ability to perform import and export operations to/from Cradle databases:

  • ALLOW_EXPORT - Allows the user to perform export operations
  • ALLOW_IMPORT - Allows the user to perform import operations

These privileges are enabled for all existing users in all existing projects.

These privileges apply to all export and import operations:

  • Bulk import and export through the Export Information and Import Information dialogues in Toolset and WorkBench
  • Bulk import and export through the c_io command line utility
  • Individual import and export from the Toolset’s editors

Export File Comments

Extra information is now included in all Cradle format import/export files produced by Toolset, WorkBench and the c_io command line utility. This new information appears as comments at the top and bottom of the import/export file:

  • An explanation of which tool was used to generate the export, and what options were used to produce the export file
  • Start and end dates and times for the generation of the import/export file: