Best practices for customizing Data Management jobs
This topic explains how to add custom fields to an out-of-the-box (OOTB) job, transformations, spreadsheets, and update load forms workflow. You can use the following end-to-end example and add custom fields to extend any OOTB job to support your customizations.
The following example describes how to add a second Company field to the Location spreadsheet and its related Pentaho jobs. However, this process can be used to add a custom field or fields to extend an OOTB job.
The following steps will explain how to add the Company column in the Location, People, and PeopleOrg spreadsheets and customize their related Pentaho transformations.
Complete the following steps in the order shown:
- Create a custom spreadsheet to support multi-company data loads
- Create a custom transformation
- Create a custom Atrium Integrator job
- Register the custom Atrium Integrator job with the Data Management Job Console
- Use the Spreadsheet Management Console to attach the multi-company support spreadsheet
- Create a custom Data Management job template
- Run the newly created multi-company job
- Review the transformations that can be modified for multi-company support
- Modify workflow to promote custom fields
Create a custom spreadsheet to support multi-company data loads
- Download the spreadsheet from Spreadsheet Management:
- From Mid Tier, select Applications > Data Management > Spreadsheet Management and make the following selections from the list:
- Spreadsheet Type: BMC Template
- Spreadsheet Category: Foundation
- Select the spreadsheet (Location in this example).
- Click Download.
- From Mid Tier, select Applications > Data Management > Spreadsheet Management and make the following selections from the list:
- Add the Company column to the spreadsheet:
- Rename the Location.xlsm spreadsheet to Multi_Company_Location.xlsm.
- Open Multi_Company_Location_xlsm.
- Add Company as the last column in the following worksheets:
- SIT_LoadSiteGroup
- SIT_LoadSiteCompanyAssoc
- CTM_LoadRegion
- Save your changes.
Create a custom transformation
- Using the BMC Atrium Integrator Spoon client, connect to the AR System server by specifying server name and AR System server admin credentials.
- Select File > Open.
- In the Select Repository Object window, scroll down the list to the Location object with type Transformation and select it.
- Click OK.
The transformation opens in a new window: - Select File > Save As and name the transformation Multi company support.
A new copy of the transformation is created. In the Multi company support transformation, add a field to SIT_LoadSiteGroup:
- Double-click the SIT_LoadSiteGroup icon.
- Select the Fields tab.
- Add a Company file with the following values:
- Name: Company
- Type: String
- Length: -1
- Precision: -1
- Trim type: none
- Repeat: N
- Click OK.
- Repeat step 6 for CTM_LoadRegion and SIT_LoadSiteCompanyAssoc.
- Double-click SIT:LoadSiteGroup and open the Field Mapping tab.
- Use the pull-down menu to change the Company mapping from JobCompany to Company, then click OK.
- Repeat Step 8 and 9 for CTM:LoadRegion and SIT:LoadSiteCompanyAssoc.
- Use the pull-down menu to change the Company mapping from JobCompany to Company, then click OK.
- Select File > Save to save the entire transformation.
Create a custom Atrium Integrator job
- Open the Location job and select File > Open.
- Scroll to Location with type Job, then click OK.
The Location job opens:
- Select File > Save As and name the job Multi-company support.
A copy of the job is created. - Select the Multi company support repository object:
- Double-click the Location icon:
- Click the Select a Transformation button (next to Specify by name and directory):
- Select the Multi company support transformation and click OK:
- Click OK.
- Double-click the Location icon:
- Select File > Save to save the entire job.
Register the custom Atrium Integrator job with the Data Management Job Console
- From the BMC Remedy Mid Tier, log on as a user with DMT Admin permissions.
- Select Applications > Data Management > Job Console > Other Function > Atrium Integrator Job.
- Click Create.
- Complete the form:
Atrium Integrator Job: Multi_Company_Support
- Type: job
- Directory: /
- Log Level: Minimal
- Select Attachment Required
- Data Tag: cust
- Click Save.
Use the Spreadsheet Management Console to attach the multi-company support spreadsheet
- From the BMC Remedy Mid Tier, log on using a user name with DMT Admin permissions.
- Select Applications > Data Management > Spreadsheet Management.
- Click Create and complete the form:
- Description: Support Multi-company upload for Location
- Company: Name of the company for which you want to make this spreadsheet available
- Spreadsheet Type: Custom Template
- Spreadsheet Category: Foundation
- Spreadsheet Group: Location
- Attach the Multi_Company_Location.xlsm spreadsheet.
Create a custom Data Management job template
- From the BMC Remedy Mid Tier, log on with UDM Admin permissions.
- Select Applications > Data Management > Job Console > Other Function > Search template.
- Search for Location.
- When the Location template is available, select Copy template.
- Complete the form:
- Template Name: Multi-company location support
- Template Description: Multi-company
- Category: Foundation
- Template Type: Custom Template
- Click Save.
- View the job template that you just created:
- Click New Search for the job template for the Multi-company location support job.
- Open the template in Modify mode.
- Expand the Load step.
- Select the Load Location step.
- Click View.
- Change Atrium Integrator Name to Multi_Company_Support and click Save.
Run the newly created multi-company job
- Log on as a user with DMT Admin permission with unrestricted access.
- Populate data with Multi_Company_Location_xlsm.
- Select Application > Data Management > Job Console > Job Function > Create Job.
- Specify the job name and select a company, then click Save.
- Select Step > Create > Using BMC template and select the Multi Company location support template.
- In the Load step, do the following:
- Attach the spreadsheet.
- Change job status from Draft to Built.
- Run the job to load the data.
Extend load forms workflow to add custom fields
If you have used the above steps 1-8 to add custom fields to the spreadsheet and transformation, then you need to follow the additional steps mentioned in Making data load work with Foundation data customizations. These additional steps are required if you have to modify the workflow that updates the data from the staging forms to the target forms.