Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This page is for administrators or expert users who need to move items from one PhixFlow instance to another.

...

  1. In the 
    Insert excerpt
    _administration
    _administration
    nopaneltrue
    , select Import → Import Configuration.
  2. PhixFlow opens the Import Configuration window, then immediately opens a file manager window, where you can browse for the zip file.

  3. Select the zip file and click 
    Insert excerpt
    _upload_file
    _upload_file
    nopaneltrue
    .
  4. If your zip file is encrypted:.
    • PhixFlow prompts you to enter the password;  ; see see Passwords, above.
    • Optionally, untick Publish Streams, if you do not want PhixFlow to automatically publish stream data to its database; see Import and Updates to the PhixFlow Database, below.
    • Click 
      Insert excerpt
      _dialog_finish
      _dialog_finish
      nopaneltrue
      .
  5. PhixFlow imports the selected zip file.

When the import is complete, the console reports log messages that list the imported items. If the import fails, the console reports the errors; see Import Errors, below.

Import and Updates to the PhixFlow Database

If Publish Streams is ticked, at the end of the import process, PhixFlow publishes imported data to the database. This means that changes to streams and stream attributes will be applied to the stream data tables in the database when the import completes. If publishing fails, the import will still complete successfully , and the publishing errors will appear in the console. See also Publishing Streams.

...

Import Errors

Large Imports

Very large imports can fail if they exceed limits on the server. If this happens, PhixFlow reports an Upload too large error. Consider splitting the items into several export zip files.

Missing Items

An import will fail if there is a reference to an item that does not exist:

  • either in the import file
  • or in the target system.

When you export items from one PhixFlow instance, it is important to ensure all items are present in the zip. For example, if items refer to other items in a package, ensure the package is included in the export.

If an import fails due to missing items, the console will log the following error message:

...

  1. In the console, find the Error 618 message.
  2. Copy the references for the missing items to a text file.
  3. Go back to the PhixFlow instance where the import file was generated.
  4. Go to
    Insert excerpt
    _administration
    _administration
    nopaneltrue
    Other Show in Repository,
  5. Paste one missing item reference into the field.
  6. PhixFlow opens the repository with the missing item highlighted.

Repeat this process to find all the missing items. Re-export all items you require; see Export Pane. If you have may items, consider adding them to a Package.

Ignoring References

In very rare circumstances, there may be a problem with references between types of item. In this case, you can configure PhixFlow to "null" any relationship from one type of item to a missing instance of another type. For example, items from one instance can refer to users.  As different instances will have different users, the import will always fail. In this case, you can set PhixFlow to ignore (null) any references to missing users during an import.

Warning

Before deciding to ignore references, please discuss with PhixFlow support if there is another way to resolve your issue. 

To configure PhixFlow to ignore specific references,

  1. In the console, find the  Error 612 message from the failed import process.
  2. Copy the <from object>.<to object> string from the message.
  3. Go to System Configuration and paste the string into the Allow Missing on Import field.
  4. Save the configuration change.
  5. Re-import the zip file.

...

  1. .