/// <summary>
/// Run the code example.
/// </summary>
/// <param name="user">The Dfa user object running the code example.
/// </param>
public override void Run(DfaUser user)
{
// Create UserRoleRemoteService instance.
UserRoleRemoteService service = (UserRoleRemoteService)user.GetService(
DfaService.v1_20.UserRoleRemoteService);
long subnetworkId = long.Parse(_T("INSERT_SUBNETWORK_ID_HERE"));
try {
// Get available permissions.
Permission[] permissions = service.getAvailablePermissions(subnetworkId);
// Display permission name and its id.
if (permissions != null)
{
foreach (Permission permission in permissions)
{
Console.WriteLine("Permission with name \"{0}\" and id \"{1}\" was found.",
permission.name, permission.id);
}
}
} catch (Exception e) {
Console.WriteLine("Failed to get permission. Exception says \"{0}\"",
e.Message);
}
}
/// <summary>
/// Run the code example.
/// </summary>
/// <param name="user">The Dfa user object running the code example.
/// </param>
public override void Run(DfaUser user)
{
// Create UserRoleRemoteService instance.
UserRoleRemoteService service = (UserRoleRemoteService)user.GetService(
DfaService.v1_19.UserRoleRemoteService);
String searchString = _T("INSERT_SEARCH_STRING_CRITERIA_HERE");
// Set user role search criteria.
UserRoleSearchCriteria userRoleSearchCriteria = new UserRoleSearchCriteria();
userRoleSearchCriteria.pageSize = 10;
userRoleSearchCriteria.searchString = searchString;
try {
// Get user roles that match the search criteria.
UserRoleRecordSet result = service.getUserRoles(userRoleSearchCriteria);
// Display user role names, ids, subnetwork ids, number of assigned users,
// and assigned permissions.
if (result != null && result.userRoles != null)
{
foreach (UserRole userRole in result.userRoles)
{
Console.WriteLine("User role with name \"{0}\", id \"{1}\", subnetwork id \"{2}\", " +
"and assigned to \"{3}\" users was found.", userRole.name, userRole.id,
userRole.subnetworkId, userRole.totalAssignedUsers);
if (userRole.permissions != null && userRole.permissions.Length != 0)
{
Console.WriteLine(" The above user role has the following permissions:");
foreach (Permission permission in userRole.permissions)
{
Console.WriteLine(" Permission with name \"{0}\" and id \"{1}\".",
permission.name, permission.id);
}
}
else
{
Console.WriteLine(" The above user role has no permissions assigned.");
}
}
}
else
{
Console.WriteLine("No user roles found for your criteria.");
}
} catch (Exception ex) {
Console.WriteLine("Failed to retrieve user roles. Exception says \"{0}\"", ex.Message);
}
}
/// <summary>
/// Run the code example.
/// </summary>
/// <param name="user">The Dfa user object running the code example.
/// </param>
public override void Run(DfaUser user)
{
// Create UserRoleRemoteService instance.
UserRoleRemoteService service = (UserRoleRemoteService)user.GetService(
DfaService.v1_19.UserRoleRemoteService);
String userRoleName = _T("INSERT_USER_ROLE_NAME_HERE");
long subnetworkId = long.Parse(_T("INSERT_SUBNETWORK_ID_HERE"));
long parentUserRoleId = long.Parse(_T("INSERT_PARENT_USER_ROLE_ID_HERE"));
long permission1Id = long.Parse(_T("INSERT_FIRST_PERMISSION_ID_HERE"));
long permission2Id = long.Parse(_T("INSERT_SECOND_PERMISSION_ID_HERE"));
// Create user role structure.
UserRole userRole = new UserRole();
userRole.id = 0;
userRole.name = userRoleName;
userRole.subnetworkId = subnetworkId;
userRole.parentUserRoleId = parentUserRoleId;
// Create a permission object to represent each permission this user role
// has.
Permission permission1 = new Permission();
permission1.id = permission1Id;
Permission permission2 = new Permission();
permission2.id = permission2Id;
// Add the permissions to the user role.
userRole.permissions = new Permission[] { permission1, permission2 };
try {
// Create user role.
UserRoleSaveResult userRoleResult = service.saveUserRole(userRole);
if (userRoleResult != null)
{
// Display user role id.
Console.WriteLine("User role with id \"{0} was created.", userRoleResult.id);
}
} catch (Exception ex) {
Console.WriteLine("Failed to create user role. Exception says \"{0}\"", ex.Message);
}
}
