Selecting Import Configuration from the Administration Menu will take you straight into a file browser. Select the configuration file you wish to import, and continue. You will be taken to the Import Configuration form. At this point you can press Choose Files to change the configuration file you will import, or Upload to continue with the import.
...
PhixFlow will automatically start to rebuild its database DTO caches when the import completes. We recommend that you run large import processes during periods of low system usage, for example overnight. This gives PhixFlow time to complete the import and rebuild the caches without affecting the performance seen by users.
Very large imports may exceed limits on the server. If this happens, PhixFlow reports an "upload too large" error.
Managing Missing Items
When you export items from one PhixFlow instance, it is important to ensure all items are present. For example, ensure any packages required by items are if items refer to other items in a package, ensure the package is included in the export.
| Note |
|---|
The import will fail if there is a reference to an item that does not exist:
|
Ask Eleanor to show me this as there is additional functionality and a new item
Other Actions → New option. Paste the string from console to find the thing with a problem. The message is on the target system, but you need to put the string into the source system
Check taht the message to go into the finder - is it finding the object that is missing (it should be!) or the object that's expecting the missing thing
PhixFlow reports the missing items in the console messages. You may need to If an import fails, check the console for log details. If there are missing items, the log will include
Error 612 - one for each missing item in the form: item-type "name" (reference) refers to item-type (reference)
Expand title Example Error 612 Area "inputform" (AreaComponent-08055461a13a51cb6914ca5be6dde21c) refers to Stream (Stream-36de2ecf9ecb2af08a42066d8c1fdd6a) but Stream (Stream-36de2ecf9ecb2af08a42066d8c1fdd6a) does not exist in the import zip or the repository.
It is important for all referenced items to be imported. Please re-export from the source instance, including Stream (Stream-36de2ecf9ecb2af08a42066d8c1fdd6a)
Note: To allow missing items when ALL AreaComponents refer to a Stream, consider adding AreaComponent.stream to System Configuration Allow Missing On Import. This will always null a reference from AreaComponents to a missing stream.Error 618 - one message summarising all the missing items.
Expand title Example Error 618 There are items missing from the import file. It is important for all referenced items to be imported.
Please re-export from the source instance, including the following items:
Stream-36de2ecf9ecb2af08a42066d8c1fdd6a
What to do
- Copy the list of missing items from Error 618 to a text file.
- Go back to the PhixFlow instance where the import file was generated.
- Go to
→ Other → Show in Repository,Insert excerpt _administration _administration nopanel true - Paste one missing item reference into the field.
- PhixFlow opens the repository with the missing item highlighted.
- Do something that means the item will be included in the export, Can the export window be open at the same time? Add it to a package, something else?
.Repeat for all the missing items. redo the export, making sure you include all the necessary items.You may need the import to complete, even with an item missing. In this case, use the System Configuration → Allow Missing on Import option to specify the file name of the missing items, then rerun the import
In very rare circumstances, there may be a problem with references between types of item. If this occurs, discuss with PhixFlow support if there is a way to resolve this issue. If
The support team can request that you allow imports to include incorrect references.
Only in this situation, you can use System Configuration → Allow Missing on Import option to allow PhixFlow to "null" any relationship from one type of item to a missing instance of another type.
What to do
In the console, find Error 612.
copy the <from object>.<to object> string
Go to System Configuration and find Allow Missing on Import
Paste the string into the field
Save the configuration
One example where this option is useful is when items from one instance refer to users. As there users should not have access to the import instance, <from item>.users allows PhixFlow to ignore (null) these references.
All log messages have a ? that goes to the system console help YOu need a link to troubleshooting import to here.
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
...