Adobe IO : User Management : User Group Class

This article will focus on the groupHandler class that is incorporated in this module. This class is important as it will enable you to control the membership within each class.

As explained in the article about User Groups and Product Profile, you can manage your users within the Product Profiles or with User Groups for multi solution access. Product Profiles are exclusive to one product and sometimes, you may want to manage access rights for multiple products, the common requests being for Adobe Analytics and Adobe Launch, or Analytics and Target.

By creating users groups, you are able to manage multi-products access within the admin console. Adding a user to the group grants him access to a complete list of solution.

The API and the python module provides possibility to manage users attached to a product profile or to a user groups as they are both consider groups. However, at the moment of the writing, the groups doesn’t return the product profile attached to them.

GroupHandler Class

The groupHandler class will enable you to create an instance of a group and manage the users inside these groups.

This class comes with several methods :

groupHandler

Init

This method creates the instance itself. In order to be set, the class init method would need one argument, the group name.
Arguments :

• groupName : REQUIRED : the group name
• users=None : OPTIONAL : if you have a set of users that

It will set 2 objects after initialization; the users object, that is a list of users you have passed in, empty if you didn’t give any. The groupName, which is the string name of your group.

addUsers

This method takes one parameter (users). Users can be a string or a list and it is filling the internal variable “new_users” of the instance.

removeUsers

This method takes one parameter (users). Users can be a string or a list and it is filling the internal variable “delete_users“. It also remove the users from the other existing variables (“users” and “new_users“)

fill_users

This methods takes one parameter (df_users), df_users is the the list of users that has been retrieved by the method retrieveInfos.

This method is here to save you time and automatically filled the users list.

createAdminGroup

If the instance of the groupHandler class that you are creating doesn’t contain _admin_. A new method is created : createAdminGroup.

This new method is creating the admin group so you can add admin users to the user group created.

syncGroup

This method is used to send the information to adobe and therefore to sync your user group with adobe status.
It takes 2 parameters :

• action : REQUIRED: 2 possible values :
  • “add” : it will add the list of users of that group to it officially (passing the information to adobe)
  • “remove” : it will remove the list of users that you have in this instance, as “delete_users“. Sending that information to Adobe.
• token : OPTIONAL : It will take the token that is required for the connection. However, if the token is not provided but information to the adobe io account uploaded, it will automatically create the token before sending the information.

Code Example

I will show you an example on how you can create a group instance, add or remove a user and sync the group afterwards.

I hope that this article is making understand the different methods available on this module. I feel that this can be very useful for lots of Admin users with their Adobe management.

On this serie, you may want to read those articles: