Skip to content

Latest commit

 

History

History
58 lines (47 loc) · 3.66 KB

people-process.service.md

File metadata and controls

58 lines (47 loc) · 3.66 KB
Raw
Title Added Status Last reviewed
People Process service
v2.0.0
Active
2018-04-05

People Process service

Gets information about Process Services users.

Class members

Methods

  • getUserImage(user: UserProcessModel): string
    Gets the profile picture URL for the specified user.
  • getWorkflowUsers(taskId?: string, searchWord?: string): Observable<UserProcessModel[]>
    Gets information about users across all tasks.
    • taskId: string - (Optional) ID of the task
    • searchWord: string - (Optional) Filter text to search for
    • Returns Observable<UserProcessModel[]> - Array of user information objects
  • involveUserWithTask(taskId: string, idToInvolve: string): Observable<UserProcessModel[]>
    Sets a user to be involved with a task.
    • taskId: string - ID of the target task
    • idToInvolve: string - ID of the user to involve
    • Returns Observable<UserProcessModel[]> - Empty response when the update completes
  • removeInvolvedUser(taskId: string, idToRemove: string): Observable<UserProcessModel[]>
    Removes a user who is currently involved with a task.
    • taskId: string - ID of the target task
    • idToRemove: string - ID of the user to remove
    • Returns Observable<UserProcessModel[]> - Empty response when the update completes

Details

Use getWorkflowUsers to find users across all tasks, optionally filtering by the searchWord in the task name. The taskId parameter, if used, specifies a task to be excluded from the results. You would typically use this feature to find new users to assign to a task, in which case you would want to exclude users already assigned to that task.

The User Process model class used by the methods is seen throughout ADF's Process Services features. Note that for involveUserWithTask and removeInvolvedUser, null data is returned rather than usable details about users.

You can find more information about the REST API methods used by this service in the Task Actions API (for involveUserWithTask and removeInvolvedUser), the User Workflow API (for getWorkflowUsers) and the User API(for getUserImage).

See also