Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue
nameImport export of RY Data

Documentation on how to import and export Requirement Yogi data to a Confluence or Jira instance.

New in 3.4.8

The backup / export / re-import feature was added in Requirement Yogi 3.4.8 (November 2022).

...

Step 1 - Export the entities to a temporary table

Confluence

Jira

Image RemovedImage Added


Requirement Yogi lets you choose:

  • The scope: It is possible to restrict the export to a single Confluence space. Restricting by Jira projects is not supported (The screenshot below doesn't contain the field 'Project key' anymore).

  • The backup key: In order to avoid collisions when 2 administrators are working on imports/exports, you can specify your own key. It doesn't matter what the key is, please keep it simple.

This step only copies all data into a single table, in preparation for the export. The table is as big as the entire database, therefore it will be important, later on, to empty this table.

None of those long-running task should be interrupted by, for example, a Confluence restart. If it happens, please restart the step.

Of course you can leave the page. If you lose the link, you can find the progress of the task in the "Queue" tab.

Image RemovedImage Added

At the end, we suggest to write the file to disk. If you have lost the link to this progress screen, you can perform this operation using the main menu:

Image RemovedImage Added

Step 2 - Write to disk

...

Here are the possible statuses (matching the database column AO_32F7CE_DBBACKUPMAPPING.STATUS):

  • (null): Not mapped yet,

  • UNMAPPED: Couldn't find a match,

  • MAPPED_AUTO: Displayed as "MAPPED" + an exclamation mark "!" - It was guessed by the software,

  • MAPPED_MANUAL: Displayed as "MAPPED" + a green checkmark - It was either set manually by the user, or the user clicked the button "MAPPED" to confirm a "MAPPED_AUTO" value.

Image RemovedImage Added

Once all entities are mapped, you can proceed to the next step.

...