PersonalProfileManagement (Community Profile OMAS Client 1.0 API)

java.lang.Object
- org.odpi.openmetadata.accessservices.communityprofile.client.PersonalProfileManagement

All Implemented Interfaces:

PersonalProfileManagementInterface
```
public class PersonalProfileManagement
extends Object
implements PersonalProfileManagementInterface
```
CommunityProfileLeadership provides the client-side interface for the Governance Program Open Metadata Access Service (OMAS). This client, manages all of the interaction with an open metadata repository. It is initialized with the URL of the server that is running the Open Metadata Access Services. This server is responsible for locating and managing the governance program definitions exchanged with this client.

Constructor Summary

Constructors
Constructor and Description
`PersonalProfileManagement(String serverName, String omasServerURL)` Create a new client with no authentication embedded in the HTTP request.
`PersonalProfileManagement(String serverName, String omasServerURL, String userId, String password)` Create a new client that passes userId and password in each HTTP request.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`String`	`createPersonalProfile(String userId, String profileUserId, String qualifiedName, String fullName, String knownName, String jobTitle, String jobRoleDescription, Map<String,Object> profileProperties, Map<String,String> additionalProperties)` Create a personal profile for an individual who is to be appointed to a governance role but does not have a profile in open metadata.
`void`	`deletePersonalProfile(String userId, String profileGUID, String qualifiedName)` Delete the personal profile.
`PersonalProfile`	`getPersonalProfileByGUID(String userId, String profileGUID)` Retrieve a personal profile by guid.
`PersonalProfile`	`getPersonalProfileByQualifiedName(String userId, String qualifiedName)` Retrieve a personal profile by personnel/serial/unique employee number of the individual.
`PersonalProfile`	`getPersonalProfileForUser(String userId, String profileUserId)` Retrieve a personal profile by userId.
`List<PersonalProfile>`	`getPersonalProfilesByName(String userId, String name)` Return a list of candidate personal profiles for an individual.
`void`	`updatePersonalProfile(String userId, String profileGUID, String qualifiedName, String fullName, String knownName, String jobTitle, String jobRoleDescription, Map<String,Object> profileProperties, Map<String,String> additionalProperties)` Update properties for the personal properties.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail
- PersonalProfileManagement
```
public PersonalProfileManagement(String serverName,
                                 String omasServerURL)
```
  Create a new client with no authentication embedded in the HTTP request.
  
  Parameters:
  
  serverName - name of the server to connect to
  
  omasServerURL - the network address of the server running the OMAS REST servers
- PersonalProfileManagement
```
public PersonalProfileManagement(String serverName,
                                 String omasServerURL,
                                 String userId,
                                 String password)
```
  Create a new client that passes userId and password in each HTTP request. This is the userId/password of the calling server. The end user's userId is sent on each request.
  
  Parameters:
  
  serverName - name of the server to connect to
  
  omasServerURL - the network address of the server running the OMAS REST servers
  
  userId - caller's userId embedded in all HTTP requests
  
  password - caller's userId embedded in all HTTP requests

Method Detail

createPersonalProfile

public String createPersonalProfile(String userId,
                                    String profileUserId,
                                    String qualifiedName,
                                    String fullName,
                                    String knownName,
                                    String jobTitle,
                                    String jobRoleDescription,
                                    Map<String,Object> profileProperties,
                                    Map<String,String> additionalProperties)
                             throws InvalidParameterException,
                                    PropertyServerException,
                                    UserNotAuthorizedException

Create a personal profile for an individual who is to be appointed to a governance role but does not have a profile in open metadata.

Specified by:: createPersonalProfile in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; profileUserId - userId of the individual whose profile this is.; qualifiedName - personnel/serial/unique employee number of the individual.; fullName - full name of the person.; knownName - known name or nickname of the individual.; jobTitle - job title of the individual.; jobRoleDescription - job description of the individual.; profileProperties - properties about the individual for a new type that is the subclass of Person.; additionalProperties - additional properties about the individual.
Returns:: Unique identifier for the personal profile.
Throws:: InvalidParameterException - the employee number or full name is null.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.

updatePersonalProfile

public void updatePersonalProfile(String userId,
                                  String profileGUID,
                                  String qualifiedName,
                                  String fullName,
                                  String knownName,
                                  String jobTitle,
                                  String jobRoleDescription,
                                  Map<String,Object> profileProperties,
                                  Map<String,String> additionalProperties)
                           throws InvalidParameterException,
                                  NoProfileForUserException,
                                  PropertyServerException,
                                  UserNotAuthorizedException

Update properties for the personal properties. Null values result in empty fields in the profile.

Specified by:: updatePersonalProfile in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; profileGUID - unique identifier for the profile.; qualifiedName - personnel/serial/unique employee number of the individual. Used to verify the profileGUID.; fullName - full name of the person.; knownName - known name or nickname of the individual.; jobTitle - job title of the individual.; jobRoleDescription - job description of the individual.; profileProperties - properties about the individual for a new type that is the subclass of Person.; additionalProperties - additional properties about the individual.
Throws:: InvalidParameterException - the known name is null or the qualifiedName does not match the profileGUID.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.; NoProfileForUserException

deletePersonalProfile

public void deletePersonalProfile(String userId,
                                  String profileGUID,
                                  String qualifiedName)
                           throws InvalidParameterException,
                                  NoProfileForUserException,
                                  PropertyServerException,
                                  UserNotAuthorizedException

Delete the personal profile.

Specified by:: deletePersonalProfile in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; profileGUID - unique identifier for the profile.; qualifiedName - personnel/serial/unique employee number of the individual.
Throws:: InvalidParameterException - the qualifiedName or guid is null.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.; NoProfileForUserException

getPersonalProfileByGUID

public PersonalProfile getPersonalProfileByGUID(String userId,
                                                String profileGUID)
                                         throws InvalidParameterException,
                                                PropertyServerException,
                                                UserNotAuthorizedException

Retrieve a personal profile by guid.

Specified by:: getPersonalProfileByGUID in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; profileGUID - unique identifier for the profile.
Returns:: personal profile object.
Throws:: InvalidParameterException - one of the parameters is invalid.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.

getPersonalProfileForUser

public PersonalProfile getPersonalProfileForUser(String userId,
                                                 String profileUserId)
                                          throws InvalidParameterException,
                                                 PropertyServerException,
                                                 UserNotAuthorizedException

Retrieve a personal profile by userId.

Specified by:: getPersonalProfileForUser in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; profileUserId - userId associated with the profile.
Returns:: personal profile object.
Throws:: InvalidParameterException - one of the parameters is invalid.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.

getPersonalProfileByQualifiedName
```
public PersonalProfile getPersonalProfileByQualifiedName(String userId,
                                                         String qualifiedName)
                                                  throws InvalidParameterException,
                                                         PropertyServerException,
                                                         UserNotAuthorizedException
```
Retrieve a personal profile by personnel/serial/unique employee number of the individual.

Specified by:

getPersonalProfileByQualifiedName in interface PersonalProfileManagementInterface

Parameters:

userId - the name of the calling user.

qualifiedName - personnel/serial/unique employee number of the individual.

Returns:

personal profile object.

Throws:

InvalidParameterException - the employee number.

PropertyServerException - the server is not available, or there is a problem retrieving the profile.

UserNotAuthorizedException - the calling user is not authorized to issue the call.

getPersonalProfilesByName

public List<PersonalProfile> getPersonalProfilesByName(String userId,
                                                       String name)
                                                throws InvalidParameterException,
                                                       PropertyServerException,
                                                       UserNotAuthorizedException

Return a list of candidate personal profiles for an individual. It matches on full name and known name. The name may include wild card parameters.

Specified by:: getPersonalProfilesByName in interface PersonalProfileManagementInterface
Parameters:: userId - the name of the calling user.; name - name of individual.
Returns:: list of personal profile objects.
Throws:: InvalidParameterException - the name is null.; PropertyServerException - the server is not available.; UserNotAuthorizedException - the calling user is not authorized to issue the call.

Class PersonalProfileManagement