Libraries
A library is a set of instructions for how extensions, data elements, and rules interact with one another after they are deployed. When creating a library, you specify the changes you want to make to your library. At build time, these changes are combined with everything that has been submitted, approved, or published in previous libraries.
Libraries contain the addition or removal of:
- Rules
- Elements
- Extension configuration
Libraries must be assigned to an environment before they can be compiled into a build. Libraries are approved or rejected as a whole. You cannot approve or reject individual items within a library. A library moves between several environments as it makes its way through the publishing workflow.
Create a library create-a-library
To create a library, complete the following steps.
-
Open the Publishing tab.
The Publishing page lists the Dev libraries and provides the means to submit them for approval, move them to staging, or publish them to production.
-
Select Add New Library.
-
Name the library.
-
Assign the library to a Dev environment.
-
Add a change to the library.
To add an item, select Add a Change, then choose the items you want to add. Any item that has been edited or deleted is available to add to the chosen library.You can add the following to your library:
- Rules
- Data elements
- Extension configurations
-
To add any resources that have changed, select Add All Changed Resources.
-
Select Save or Save and Build for Development.
Deploying compiles a build and deploys it to the assigned environment.
Once a library is created, use the drop down menu for that library to select one of the following options:
-
Edit: This option allows you to change the library configuration.
-
Build for Development: This option compiles a build and deploys it to the assigned environment.
-
Submit for Approval: This option makes the library available for an Approver to move it to the next step in the publishing process.
-
Delete: This option removes the currently selected library from the publishing process.
Add to a library add-to-a-library
To add to a library, complete the following steps.
- Install the extensions you want to add.
- Create the data elements and rules you want to add.
- Open the Publishing tab.
- Select the library you want to change, then select Edit.
- Use the rules, data elements, and extensions buttons to select the items you want to add to the library.
- Save the changes.
Changes to the library are shown in the Library Contents change log.
Remove from a library
To remove something from a library, you must deactivate it and then publish the deactivated state.
- Disable the extensions you want to remove, along with any data elements and rules that depend on those extensions.
- Disable the data elements and rules you want to remove.
- Open the Publishing tab.
- Select the library you want to change.
- Use the rules, data elements, and extensions buttons to select the disabled items you want to remove from the library.
- Save the changes.
Manage library changes
To edit library options, complete the following steps.
-
Choose a library and select Edit to view library changes. All changes are shown in the Library Contents list.
-
Select a change to view and select a revision.
-
Select whether to show All items or Changed items.
-
Select the revision, then select Select Revision.
-
Select either Add a Change or Add All Changed Resources.
Active Library active-library
Libraries encapsulate a set of changes you’d like to make to your deployed code. Active Library makes this easier, allowing you to rapidly iterate through changes and see the impact.
Extensions, rules, and data elements can now be saved directly to the library you’re working on. If required, a new build can also be created or even a new library from the Active Library drop down.
The following list provides more information on managing an active library.
- Create a new library.
- Go to Rules, Data Elements, or Extensions.
- Select your Active Library.
- Make your changes, then save and build the library.
- Test your changes, and repeat these steps as needed.