BMC ITSM9 Person Update
Version 1
Updates a single ITSM v9.x CTM People entry related to the Remedy Login specified with the REST API.
Note: If a site is provided and a site ID is not, an error will occur. If a site is provided without city, country, state, street, timezone, and zip/postal code information, the site will be set, but the "Site Address" field in CTM:People will still display the old location/address.
Note: If one component of the phone number is passed, all 4 should be.
Parameters
Name |
Description |
Error Handling |
Determine what to return if an error is encountered. |
Remedy Login ID: |
The Remedy Login ID associated to the CTM People record to update. |
Profile Status: |
The Remedy Profile Status. |
First Name: |
The First Name to set |
Last Name: |
The Last Name to set |
Middle Name: |
The Middle Name/Initial to set, Optional |
Client Type: |
The Client Type to set, often 'Office-Based Employee' or 'Contractor' or 'Customer'. Must be valid option of menu. |
Client Sensitivity: |
The Client Sensitivity to set. Either Standard or Sensitive. |
VIP: |
The VIP value to set. Yes or No |
Author: |
The author of the creation to the person record. |
Company: |
The Company to set |
Organization: |
The Organization to set |
Department: |
The Department to set |
Email Address: |
The email address to set |
Region: |
The region to set |
Site Group: |
The site group to set |
Site: |
The site to set |
CC Business: |
The phone number country code to set |
Area Code Business: |
The phone number area code to set |
Local Part Business Phone: |
The phone number local part to set |
Business Phone: |
The phone number (put together) to set |
Language |
The language to set (ex. en_US, fr_FR) |
Support Staff: |
|
Assignment Availability: |
|
Desk Location: |
|
Mail Station: |
|
ACD: |
|
Managers Name: |
|
Manager Login ID: |
|
Primary Domain: |
|
Cost Center Code: |
|
Unrestricted Access: |
|
Sample Configuration
Name |
Description |
Error Handling |
Raise Error |
Language |
<%=@answers['New Language']%> |
Remedy Login ID: |
|
Profile Status: |
|
First Name: |
|
Last Name: |
|
Middle Name: |
|
Client Type: |
|
Client Sensitivity: |
|
VIP: |
|
Author: |
|
Company: |
|
Organization: |
|
Department: |
|
Email Address: |
|
Region: |
|
Site Group: |
|
Site: |
|
CC Business: |
|
Area Code Business: |
|
Local Part Business Phone: |
|
Business Phone: |
|
Support Staff: |
|
Assignment Availability: |
|
Desk Location: |
|
Mail Station: |
|
ACD: |
|
Managers Name: |
|
Manager Login ID: |
|
Primary Domain: |
|
Cost Center Code: |
|
Unrestricted Access: |
|
Results
Name |
Description |
Handler Error Message |
Error, if one is found |
Result |
Json result of the update |
Changelog
BMC ITSM9 Person Update V1 (2018-06-29)
- Initial version. See README for details.
Related Handlers
- BMC ITSM7 Alternate Approver Lookup
- Retrieves the Login IDs for the current alternates for a Login ID
- BMC ITSM7 Approval Approve
- Approves a specific AP:Detail-Signature record.
- BMC ITSM7 Approver Alternate Add
- Adds an alternate approver.
- BMC ITSM7 Approver Alternate Cancel
- Cancels an alternate approver.
- BMC ITSM7 Approver Retrieve by Role
- Retrieves a list of approvers for the role provided.
- BMC ITSM7 Change Create
- Creates a BMC ITSM7 Infrastructure Change record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the parameters provided.
- BMC ITSM7 Change Retrieve
- Retrieves a single ITSM Change entry.
- BMC ITSM7 Update Change Status
- Updates the Change Status
- BMC ITSM7 Change Templated Create
- Creates a BMC ITSM7 Infrastructure Change record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the specified Change Template and data parameters provided.
- BMC ITSM7 Change Work CE
- Creates a BMC ITSM7 Infrastructure Change Work Info record based upon the parameters provided.
- BMC ITSM7 Change Work Info Create
- Creates a BMC ITSM7 Infrastructure Change Work Info record based upon the parameters provided.
- BMC ITSM7 Change Work Info Create
- Creates a BMC ITSM7 Infrastructure Change Work Info record based upon the parameters provided.
- BMC ITSM7 Functional Role Lookup
- Retrieves the Login IDs associated with a particular Functional Role and Group ID
- BMC ITSM7 Group Membership Lookup
- Retrieves Email Address(es) for the individual or support group, separated by commas.
- Bmc Itsm7 Incident Asset Relate
- Creates an HPD:Associations record to relate a CI to a Incident.
- BMC ITSM7 Incident Close
- Sets an Incidnet Status To closed.
- BMC ITSM7 Incident Create Detail
- Creates a BMC ITSM7 Incident (Help Desk) record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the parameters provided.
- BMC ITSM7 Incident Create
- Creates a BMC ITSM7 Incident (Help Desk) record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the parameters provided.
- BMC ITSM7 Incident Retrieve
- Retrieves a single ITSM Incident entry.
- BMC ITSM7 Incident Templated Create Detail
- Creates a BMC ITSM7 Incident (Help Desk) record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the specified Incident Template and parameters provided.
- BMC ITSM7 Incident Templated Create
- Creates a BMC ITSM7 Incident (Help Desk) record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the specified Incident Template and parameters provided.
- BMC ITSM7 Incident to Incident Relationship Create
- Creates a relationship between two ITSM7 incidents using the HPD:Associations form
- BMC ITSM7 Incident Work Info Create CE
- Creates a BMC ITSM7 Incident (Help Desk) Work Info record based upon the parameters provided. Meant for use with Request CE.
- BMC ITSM7 Incident Work Info Create on a Remote AR Server
- Creates a BMC ITSM7 Incident (Help Desk) Work Info record based upon the parameters provided.
- BMC ITSM7 Incident Work Info Create
- Creates a BMC ITSM7 Incident (Help Desk) Work Info record based upon the parameters provided.
- BMC ITSM7 Notification Events Find
- Returns an XML listing (enabled) record ids found in the NTE:CFG-Notification Events form.
- BMC ITSM7 Person Create
- Creates an ITSM v7.x CTM People entry with the Remedy Login Id.
- BMC ITSM7 Person Retrieve
- Retrieves a single ITSM v7.x CTM People entry related to the Remedy Login specified.
- BMC ITSM7 Person Update
- Updates an ITSM v7.x CTM People entry given the Remedy Login Id. It only updates the record with the given values if those values are provided (will not null out values). It also creates a WorkLog entry to audit the modification.
- BMC ITSM7 Support Group Membership Add
- Adds the individual to support group.
- BMC ITSM7 Task Templated Create
- Creates a TMS:Task entry that belongs to either a Change or Incident record.
- BMC ITSM7 Work Order Create Detail
- Creates a BMC ITSM7 SRM Work Order record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the parameters provided.
- BMC ITSM7 Work Order Work Info Create CE
- Creates a BMC ITSM7 Work Order Work Info record based upon the parameters provided.
- BMC ITSM7 Work Order Work Info Create
- Creates a BMC ITSM7 Work Order Work Info record based upon the parameters provided.
- BMC ITSM7 Work Order Work Info Create
- Creates a BMC ITSM7 Work Order Work Info record based upon the parameters provided.
- BMC ITSM8 Asset to Contract Assoc Create
- Attaches a contract to an asset. (A second handler is needed to attach the contract to the asset.)
- BMC ITSM8 Associations to Asset Create
- Attaches a items to an asset on the AST:CMDB Associations. (Second handlers are needed to attach the asset to the related item.)
- BMC ITSM8 Assoc to Change Request Create
- Attaches an item to a Change Request. (A second handler is needed to attach the change request to related item.)
- BMC ITSM8 Assoc to Incident Create
- Attaches an item to a Incident. (A second handler is needed to attach the incident to related item.)
- BMC ITSM9 Change Templated Create
- Creates a BMC ITSM9 Infrastructure Change record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the specified Change Template and data parameters provided.
- BMC ITSM9 Incident Create
- Creates an Incident record.
- BMC ITSM9 Incident Templated_Create
- Creates an Incident record.
- BMC ITSM9 Person Create
- Create an entry in the People Form
- BMC ITSM9 Person Retrieve
- Retrieves a single ITSM v9.x CTM People entry related to the Remedy Login specified.
- BMC ITSM9 Support Group Membership Add
- Adds the individual to support group.
- BMC ITSM9 Support Group Member Functional Role Add
- Adds the individual to support group.
- BMC ITSM9 Support Group Membership Remove
- Removes the individual from the support group.
- BMC ITSM9 Work Order Create Detail
- Creates a BMC ITSM9 SRM Work Order record that contains the Id of the triggering Kinetic Request submission and the task instance deferral token using the parameters provided.
- BMC People Work Info Create
- Create an entry in the People Worklog Form
- BMC SRM Templated Work Order Create
- Creates a BMC ITSM7 Work Order record based on a given a Work Order Template.