About rearranged objects
- Last UpdatedJul 15, 2024
- 2 minute read
Rearranged objects maintain their location within a list of objects for the following Galaxy operations:
-
Export and import of a Galaxy
-
Back up and restore a Galaxy
-
GRLoad and GRDump operations
Also, objects can be programmatically moved to another location within a list of objects using the GRAccess ToolKit.
Rearranged Objects in the Export and Import of a Galaxy
When rearranged objects are exported to an aaPKG file, rearranged objects are retained when the aaPKG file is imported into another Galaxy. If the imported Galaxy includes rearranged objects, but the existing Galaxy does not, the object order of the imported Galaxy takes precedence.
Rearranged Objects in Backup and Restore of a Galaxy
When rearranged objects are backed up to a CAB file, rearranged objects are retained when the CAB file is restored to another Galaxy.
Rearranged Objects in a GRLoad and GRDump
When one or more objects are selected and exported through GRDump, then GRLoad can be used to import the contents of GRDump into another Galaxy. Objects retain their rearranged locations in the GRLoad import operation in the new Galaxy.
Rearrange an Object Programmatically using GRAccess Toolkit
You can use the GRAccess object model to write programs that automate the configuration of local and remote Galaxies. You can move an object in the Model view hierarchy using the SortOrder property that programmatically moves an object after a specified predecessor object in the list of objects shown in the Model view.
Class
IgObject
Syntax
[C#]
string SortOrder { set; get; };
[Visual C++]
[propget]
HRESULT SortOrder(
[out, retval] BSTR* thePredecessorName
);
[propput]
HRESULT SortOrder(
[in] BSTR newPredecessorName
);
Parameters
thePredecessorName
The current predecessor of this object.
newPredecessorName
The new predecessor of this object. The object does not need to be checked out.
Remarks
SortOrder sets or returns the preceding object name in the navigation hierarchy. When the sort order is set, the tagname of the asset is displayed in the ViewApp navigation hierarchy just below the predecessor.