At its core, Archipeg stores objects and associations. Object Catalog Designer in Archipeg allows you to view, create, edit, and delete objects and associations between them.
To start working with Object Catalog Designer, access one of the existing projects by clicking on its name. Next, click on the "Manage Objects" navigation link.
Catalog designer looks like a tree of folders. Each folder corresponds to an object type, and thus, you can locate the object of a given type by expanding the corresponding folder in the catalog designer.
To expand a folder in catalog designer, do one of the following:
If there are any existing objects of the selected type, they will display under the folder name; and the expanded folder's icon changes from dark to the white folder with outline only ().
Objects shown in the catalog designer tree have icons (e.g., ). An icon represents an object type, which can help distinguish objects of different kinds from each other.
You can tell whether an object type has any corresponding objects by its icon before expanding it. The empty object type has a solid dark folder icon (), while the non-empty type has a dark folder icon with horizontal lines inside it (). Note that folder icons might not reflect the existence or deletion of the objects of that type if multiple users are working on the same project simultaneously. That is, another user might have created or deleted objects, and your screen does not reflect it. To see the up-to-date folder icons, you can refresh the catalog designer screen. On the positive side, if an object of the expanded (clicked) type exists, it will display when you expand the type folder irrespective of its icon before expanding.
There are two ways of creating a new object using object catalog designer:
This action will open a new object editor dialog. Object editor dialog is described in the later section on this page.
There are two ways of editing an existing object using object catalog designer:
This action will open an existing object editor dialog. Object editor dialog is described in the later section of this page.
Object editor dialog is the same interface displayed on the screen for adding a new or editing an existing object. This dialog is a simple questionnaire that allows you to create, view, or modify an object of the selected type.
All objects in Archipeg have a required name and an optional description, which are the top-most fields in the object editor dialog. Additionally, you can specify associations between objects, which allow you to link different objects with each other. These links are also handy to traverse the objects by going from one object to another connected via an association.
To create an association from the currently open object to another object (i.e., to link these objects), do one of the following:
As a result, you will see a list of objects that have a compatible type. Select the objects you want to link to the currently open object and click the "Done" button. You will see the connected objects in the object editor dialog. At this point, the links are not saved to the model, so you need to ensure that you hit the "Save" button when you complete modifying the object.
Note that every association in Archipeg has two ends, so when you link one object to another, you are also creating a reverse link. Such behavior helps to traverse the object graph in two directions - from source to target and from the target to the source object.
To remove an existing association, find the linked object in the editor dialog, and click on the removal icon () next to its name.
If you want to delete an existing object, open it for modification, which will display the object editor dialog. At the bottom of this window, you will see a "Delete" button. After confirming the deletion request via an additional confirmation screen, Archipeg will delete the object from the model. Be cautious with this action, as it cannot be undone.
Deleting an object clears associations from or to this object that exist in Archipeg's model.
Earlier, we discussed how you could link objects to each other. Now it is time to learn how to leverage those associations and traverse the graph of connected objects in Archipeg's model. Object graph traversal is helpful to find answers to common questions such as applications that store a specific data object or people who participate in a given business process.
Start by opening an object that has one or more objects linked by association. Find those object names in the object editor dialog, and perform one of the following actions:
This action will close the currently open object editor dialog and reopen it for the newly selected object.
You can repeat the above steps to continue traversing the graph until you find the needed answer.
Archipeg web app comes with built-in help hints, which are described in detail here.
Object catalog designer seamlessly integrates with the help hints. If you turn the help toggle on, you will see the help icons () displayed in the catalog tree and the object editor dialog. You can click these icons to quickly learn about an element you see on the screen, such as object type or association.