Posted on May 07, 2015

Note:

Contact Support for more information or to obtain the QF.

Issues fixed in the QF

The QF introduces the following APIs in Rights Management Policy Manager:

  • getPolicySet( )
  • createPolicySet( )
  • updatePolicySet( )
  • getPolicySetIdByPolicySetName( )
  • deletePolicySets( )
  • managePolicySetPublishers( )
  • managePolicySetVisibleUsersGroups( )
  • managePolicySetCoordinators( )
  • updateCoordinatorPermission()

APIs details

_________________________________

getPolicySet( )
public PolicySet getPolicySet(String policySetId, boolean fetchPolicies) throws SDKException;

Returns details for the specified policySetId, and if fetchPolicies is set to true, it bring the details of all policies under it.

  • @param policySetId Id of the PolicySet whose information needs to be fetched
  • @param fetchPolicies if set to true, it will bring details of all policies under it. If set to false, it neither fetches the details nor the count of the policies under it.
  • @return PolicySet this object encapsulates all details related to PolicySet including policies         
  • @throws SDKException

_________________________________

createPolicySet( )
public String createPolicySet(PolicySet policySet) throws SDKException;

Creates a PolicySet. Note that creating a large number of PolicySets can have adverse performance effects.

  • @param PolicySet encapsulates all details related to PolicySet other than the policies under it
  • @return policySetId of the newly created PolicySet
  • @throws SDKException

_________________________________

updatePolicySet( )
public void updatePolicySetInfo(String name, String desc, String policySetId) throws SDKException;

Updates the information for the given PolicySetId.

  • @param name Updates the name of the PolicySet
  • @param description Updates the description of the PolicySet
  • @param policySetId ID of the PolicySet whose information needs to be updated
  • @throws SDKException

_________________________________

getPolicySetIdByPolicySetName( )
public String getPolicySetIdByPolicySetName(String policySetName) throws SDKException;

Gets the PolicySetId corresponding to the PolicySetName.  

  • @param policySetName of the PolicySet
  • @return policySetId of the policySet
  • @throws SDKException

_________________________________

deletePolicySets( )
public HashMap deletePolicySets(List<String> ids) throws SDKException;

Deletes all policySets whose ids are set as argument.

  • @param policySetIds IDs of the policySets that need to be deleted. If a policySetId does not exist, the system will throw SDKException.
  • @return A map that contains all those policySetIds (which existed in the system) as keys that were not deleted and reasons for same as values. This would not let a user delete any policySet that has policies under it.
  • @throws SDKException

_________________________________

managePolicySetPublishers( )
public void updatePolicySetPublishers(String policysetId, ArrayList userIds, boolean add) throws SDKException;

Helps add or remove Publishers on a given policySet

  • @param policySetId id of the policySet whose publishers need to be modified
  • @param userIds list of userIds which need to be added/removed from the policySet as publishers
  • @param add a boolean which when set to true will add users as publishers; if set to false will delete those as publishers
  • @throws SDKException

_________________________________

managePolicySetVisibleUsersGroups( )
public void updatePolicySetVisibleUsersGroups(String policysetId, ArrayList userIds, boolean add) throws SDKException;

Helps add or remove VisibleUsersGroups on a given policySet             

  • @param policySetId id of the policySet whose VisibleUsersGroups need to be modified
  • @param userIds list of userIds which need to be added or removed from the policySet as VisibleUsersGroups
  • @param add a boolean which if set to true will add users as VisibleUsersGroups, if set to false will delete those as VisibleUsersGroups
  • @throws SDKException

_________________________________

managePolicySetCoordinators( )
public void updatePolicySetCoordinators(String policysetId, ArrayList<PolicySetCoordinatorAndPerms> userIdAndPermsList, boolean add) throws SDKException;

Helps add or remove Coordinators on a given policySet           

  • @param policySetId id of the policySet whose Coordinators need to be modified
  • @param userIdAndPermsList list of userIds and their permissions (com.adobe.livecycle.rightsmanagement.client.infomodel.PolicySetCoordinatorAndPerms) which need to be added or removed from the policySet as Coordinators
  • @param add a boolean which if set to true will add users as Coordinators, if set to false will delete those as Coordinators     
  • @throws SDKException

_________________________________

manageCoordinatorPermission( )
public void updateCoordinatorPermission(String policySetId, String userId,  ArrayList perms) throws SDKException;

Helps update Coordinator's (userId) Permissions (perms) for a given policySetId    

  • @param policySetId id of the policySet on which the user will we added as co-ordinator
  • @param userId  user id that will be added as co-ordinator
  • @param perms an ArrayList to be set as permissions for the co-ordinator (userId). These would be amongst com.adobe.edc.server.constants.PolicyServerConstants.PolicySetAggregatePermissions, else it would throw an exception.           
  • @throws SDKException

_______________________________

(Ref# LC-3911817)

Prerequisites to installing the QF

  • AEM 6.0 forms Feature Pack 1

Installing and configuring the QF

  1. Take a backup of the <AEM_forms_root>/deploy folder. It is required if you decide to uninstall the quick fix.
  2. Stop your application server.
  3. Extract the QF archive file to your hard drive.
  4. In the directory named according to the operating system that you are using:
    • Windows
      Navigate to the appropriate directory on the installation media or folder on your hard disk where you copied the installer, and double-click the install.exe file.
      • (Windows 32-bit) Disk1\InstData\Windows\VM
      • (Windows 64-bit) Disk1\InstData\Windows_64bit\VM
    • Linux, Solaris, AIX
      Navigate to the appropriate directory, and from a command prompt, type ./install.bin.
      • (Linux) Disk1/InstData/Linux/NoVM
      • (Solaris) Disk1/InstData/Solaris/NoVM
      • (AIX)Disk1/InstData/AIX/VM

    This launches an install wizard that guides you through the installation.

  5. On the Introduction panel, click Next.
  6. On the Choose Install Folder screen, verify that the default location displayed is correct for your existing installation, or click Browse to select the alternate folder where AEM forms is currently installed, and click Next.
  7. Read the Quick Fix Patch Summary information and click Next.
  8. Read the Pre-Installation Summary information and click Install.
  9. When the installation is complete, click Next to apply the quick fix updates to your installed files.
  10. The Start Configuration Manager checkbox is selected by default. Click Done to run the Configuration Manager.

    To run Configuration Manager later, deselect the Start Configuration Manager option before you click Done. You can start Configuration Manager later using the appropriate script in the [AEM_forms_root]/configurationManager/bin directory.

  11. Depending on your application server, choose one of the following documents and follow the instructions in the Configuring and Deploying AEm forms section.

Impacted modules

  • Rights Management

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy