Package Lifecycle Management
Overview
Administrators have the ability to create packages of functionality to migrate across environments and can manage the lifecycle of these packages by deploying or updating a specific package. Package Lifecycle Management provides a unique namespace to environments associated with entities, such as implementation partners, who want to create and protect their intellectual property. In addition, the content of packages is encrypted. As a result, users cannot edit the content of a package outside of an Oracle CPQ site, and the import of packages across versions is not possible.
Administration
Steps to Enable
To enable the Package Lifecycle Management feature, open a Service Request (SR) on My Oracle Support.
Apply a Namespace to a Util Library Function
Beginning in Oracle CPQ 2017 R1, administrators can open a Service Request (SR) on My Oracle Support to set a site namespace. When this occurs, the namespace displays in the Namespace field on the Util BML Library Function Editor: Properties and Parameters page for imported functions. The use of a namespace prevents a naming conflict when migrating the util library function from a source to a target site.
When migrated, namespaced util library functions appear in folders based on the namespace of the site from which they were migrated.
Lock a Util Library Function
Administrators can lock util library functions from the Util BML Library Function List page. Locking a util function hides the implementation details (e.g. BML) from other administrators. This functionality provides customers with a way to protect their intellectual property when distributing packages to other sites.
Complete the following procedure to lock a util function.
Note: A Site Namespace is required and Util Locking must be enabled to lock util functions.
- Click Admin to go to the Admin Home page.
-
Click BML Library in the Developer Tools section.
The Util BML Library Functions List page opens.
-
Check the Select box for the util to be locked, the click Lock.
After the util function is locked the Status is updated to "Locked".
Note: When administrators lock a util library function on their local site, they can continue to view and edit the util library function using the Util BML Library Function Editor: Properties & Parameters page.
Unlock a Util Library Function
Complete the following procedure to unlock a util function.
- Click Admin to go to the Admin Home page.
-
Click BML Library in the Developer Tools section.
The Util BML Library Functions List page opens.
-
Check the Select box for the util to be unlocked, the click Unlock.
After the util function is unlocked the Status is cleared.
Create an Override Function
An override function is an editable copy of an original, unlocked, and namespaced util library function. Administrators can upload an unlocked and namespaced util library function and view the util library function in the Util BML Library Function Editor: Properties and Parameters page. While administrators can view the properties, parameters, and BML code, they cannot change an unlocked util library function without creating an override function.
Complete the following procedure to unlock a util function.
- Click Admin to go to the Admin Home page.
-
Click BML Library in the Developer Tools section.
The Util BML Library Functions List page opens.
-
Click the Create link to create an "Override" function.
Note: The Create link only displays when an administrator has not yet created an override function.
The util library function then opens in the Util BML Library Function Editor: Properties & Parameters page. Administrators can use this page to create an override function by editing the original function.
Note: Administrators cannot import new attributes or library functions into an override function. They can, however, use the Function Wizard or test the BML in the Debugger. For example: Administrators can enter Context Parameters in the Debugger and view the returned text.
-
Update the util function, then click Update.
When the Edit and Remove links display on the Util BML Library Functions List page, this indicates an override function already exists. Administrators can perform the following:
Note: Administrators can migrate override functions along with their original namespaced util library functions. The migration flow maintains customizations made to the original namespaced util library functions.
Notes
-
Oracle highly recommends that customers only enable the Package Lifecycle Management functionality in a complex deployment structure or when developing content specifically for other environments. If customers only have a Test and Production site, Oracle does not recommend enabling the functionality.
-
Partners who change an environment’s namespace are responsible for managing all of their different namespaced util library functions. Migration treats each different namespaced util library function as a different util library function.
Bulk downloads do not download namespaced util library functions.
Related Topics
See Also