This documentation supports the 22.1 version of BMC Helix ITSM.To view an earlier version, select the version from the Product version menu.

Loading new organizational data


A DMT User can import data from external sources into BMC Helix ITSM applications using the jobs-based framework and then a DMT Admin can modify a job on behalf of another user.


Example

Joe Unser works for Apex Global in the Human Resources department and he is responsible for keeping organizational data in BMC Helix ITSMSuite of applications up-to-date. He starts his two-week vacation tomorrow.

Allen Allbrook is the DMT Admin for Apex Global. He will be Joe's backup while Joe is away. Because he is a DMT Admin, he can modify jobs that were created by other users.

Allen Allbrook defines Joe Unser as a DMT User and makes the modifications, as required. For more information, see Defining users and administrators for Data Management.

Based on the example, the following procedure describes the typical steps involved:

  1. From the Spreadsheet Management window, Joe Unser downloads the required People.xlsx Microsoft Excel spreadsheet, which is needed to update people information, onto his desktop.
    Joe uses Microsoft Excel to update the People.xlsx spreadsheet with the new people information.
    When the People records are loaded using People Templates using Data Management or the Onboarding Wizard the values specified on the People Template record are not used. Only the permission groups, support groups and functional roles tied to the people template are applied to the People record.
  2. From the Spreadsheet Management window, Joe uploads the People.xlsx spreadsheet back into the Data Management system.
  3. From the Job (New) window, Joe selects the standard out-of-the box People template and creates a job.
    The template includes a set of predefined steps.
    For more information see, Creating a job using out-of-the-box templates.
  4. Joe or Allen could choose to create a customized job that pauses the job at a selected status.
    For information, see Creating customized jobs.
  5. Joe realizes that there are more changes that need to be made before he can run the job.
    As he is going on vacation tomorrow, he asks Allen to add the missing support group information and run the job while he is away.
  6. Using Spreadsheet Management, Allen makes the required changes to the SupportGroup.xlsx spreadsheet and uploads the changes to the system.
  7. From the Job Console, Allen searches for Joe's job, retrieves it, and modifies Joe's job by adding the Support Group template to the job.
  8. Allen configures the Load step.
    For more information, see Load step.
  9. Allen runs the job.
    For more information, see Running a job.
    The Microsoft Excel spreadsheets are imported into the staging forms and the data is validated and promoted.
    The Load step maps the Excel spreadsheets to the staging forms.
    During validation, the alias replacement function for data loads replaces alias values on staging forms with the actual values based on defined alias mappings. For more information, see Alias-replacement-during-validation.
    The validate step also automatically converts the letter case of values on staging forms for the supported data type fields so the case is the same as the case used for the values on the parent form. For more information, see Case-insensitivity-correction-during-validation.
  10. From the Error Management console, Allen fixes any validation errors and re-runs the job.
    For information about fixing errors, see Managing-data-errors-from-data-load-jobs.
    Once Allen (or Joe) has run the job and the target server has their valid data, Allen (or Joe) would not typically load their data again. Instead, he would just fix any errors for the staging forms in Error Management console, rerun the job, and then promote the remaining data to the target server.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*