Data Management Administration Guide

Supporting
Version 7.6.04 of BMC Remedy Asset Management Version 7.6.04 of BMC Remedy Change Management Version 7.6.04 of BMC Remedy Service Desk
January 2011

www.bmc.com

Contacting BMC Software

You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information about the company, its products, corporate offices, special events, and career opportunities.

United States and Canada

Address BMC SOFTWARE INC 2101 CITYWEST BLVD HOUSTON TX 77042-2827 USA Telephone 1 713 918 8800 or 1 800 841 2031 Fax 1 713 918 8000

Outside United States and Canada

Telephone +01 713 918 8800 Fax +01 713 918 8000

Copyright 2007-2009, 2011 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the property of their respective owners. Current, Notes, and Prospect are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. IT Infrastructure Library is a registered trademark of the Office of Government Commerce and is used here by BMC Software, Inc., under license from and with the permission of OGC. ITIL is a registered trademark, and a registered community trademark of the Office of Government Commerce, and is registered in the U.S. Patent and Trademark Office, and is used here by BMC Software, Inc., under license from and with the permission of OGC. Linux is the registered trademark of Linus Torvalds. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. The information included in this documentation is the proprietary and confidential information of BMC Software, Inc., its affiliates, or licensors. Your use of this information is subject to the terms and conditions of the applicable End User License agreement for the product and to the proprietary and restricted rights notices included in the product documentation.

Restricted rights legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHEDRIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC SOFTWARE INC, 2101 CITYWEST BLVD, HOUSTON TX 77042-2827, USA. Any contract notices should be sent to this address.

Customer support
Support website
You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support. From this website, you can read overviews about support services and programs that BMC offers find the most current information about BMC products search a database for problems similar to yours and possible solutions order or download product documentation download products and maintenance report a problem or ask a question subscribe to receive proactive e-mail alerts find worldwide BMC support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbers

Support by telephone or e-mail

In the United States and Canada, if you need technical support and do not have access to the web, call 800 537 1813 or send an e-mail message to [email protected]. (In the subject line, enter SupID:yourSupportContractID, such as SupID:12345). Outside the United States and Canada, contact your local support center for assistance.

Before contacting BMC

Have the following information available so that Customer Support can begin working on your issue immediately: product information product name product version (release number) license number and password (trial or permanent)

operating system and environment information machine type operating system type, version, and service pack or other maintenance level such as PUT or PTF system hardware configuration serial numbers related software (database, application, and communication) including type, version, and service pack or maintenance level

sequence of events leading to the problem commands and options that you used messages received (and the time and date that you received them) product error messages messages from the operating system, such as file system full messages from related software

License key and password information

If you have questions about your license key or password, contact Customer Support through one of the following methods: Send an e-mail message to [email protected]. (In the Subject line, enter SupID:yourSupportContractID , such as SupID:12345.) In the United States and Canada, call 1 800 537 1813. Outside the United States and Canada, contact your local support center for assistance. Submit a new issue at http://www.bmc.com/support_home.

Data Management Administration Guide

Contents
About this book 9 About the BMC Remedy ITSM Suite ...........................................................................10 BMC Atrium CMDB ............................................................................................10 BMC Remedy Asset Management .....................................................................10 BMC Remedy Change Management .................................................................11 BMC Remedy Incident Management ................................................................11 BMC Remedy Problem Management ...............................................................11 BMC Service Request Management .................................................................12 BMC Service Level Management .......................................................................12 Related documentation ..................................................................................................13 Conventions .....................................................................................................................14 What's new in Data Management Administration ....................................................14 Chapter 1 Introduction 15 Overview of the Data Management tool .....................................................................15 Dataload process ..................................................................................................15 Changing data already loaded ...........................................................................17 Performance benchmarks ...................................................................................17 When to use the Data Management tool .....................................................................22 Examples showing typical uses of the tool .................................................................23 Migrating data - Data Load Console .................................................................24 Adding task groups and task group templates Data Load Console .......25 Adding another company to an existing installation of BMC Remedy ITSM Data Load Console ..........................................................................................31 Changing a users login ID Data Wizard Console .....................................48 Reorganizing a department and changing support group names Data Wizard Console ....................................................................................................52 Chapter 2 Completing the spreadsheets 55 Understanding the spreadsheets ..................................................................................55 Populating data in the spreadsheets ............................................................................56 Locating the data load spreadsheets .................................................................57 Loading data into an existing system ...............................................................57 Loading data into a new system ........................................................................58 What dependencies are there? ...........................................................................58 Spreadsheets required for minimum standard configuration ......................58

Contents

Set of foundation data load spreadsheets ........................................................60 Spreadsheet usage tips ...................................................................................................61 People, permissions, and support groups ........................................................61 Task templates and process templates ..............................................................66 Using Transactional-SharedComponents.xls to populate the Service or CI fields in an incident, problem, known error, or change .................................68 CTM:LoadSupportGroupAssociation with Support Staff set to Yes ...........73 Uploading work log attachments ......................................................................74 Chapter 3 Importing data 77 Overview of the Data Load Console ............................................................................77 Loading data from spreadsheets ..................................................................................78 Validating and promoting the data ..............................................................................81 Validating imported data ...................................................................................82 Fixing validation errors .......................................................................................83 Promoting validated data into the BMC Remedy ITSM forms .....................86 Troubleshooting validation and promotion ....................................................87 Deleting data ...................................................................................................................90 Chapter 4 Using the data wizard to modify data 91 Overview of the data wizard ........................................................................................91 Counting records that use the target value in specified fields .................................92 Viewing the audit log ..........................................................................................94 Prerequisites to updating target values .......................................................................95 Coordinating the update of product categorization with BMC discovery products .................................................................................................................97 Updating target values ...................................................................................................98 Limitations ............................................................................................................99 Post-update requirements ...........................................................................................104 Troubleshooting data wizard counts and updates ..................................................105 Monitoring the data wizard for a halted count or update ...........................106 Rerunning the count or update ........................................................................106 Chapter 5 Managing customizations 109 Identifying customizations ..........................................................................................109 Analyzing your customizations for impact on data load functionality ................109 Making data load work with your customizations .................................................110 Understanding the staging forms ....................................................................110 Adding custom fields ........................................................................................113 Making the data wizard work with your customizations ......................................115 Data wizard architecture overview .................................................................116

Data Management Administration Guide

Modifying the data wizard to work with new forms ...................................118 Modifying the data wizard to work with new fields on BMC Remedy ITSM forms ....................................................................................................................123 Appendix A Data load staging forms dependencies 137

Appendix B Error messages 143 Errors for invalid data ..................................................................................................143 Errors for required fields .............................................................................................174 Errors for duplicate data ..............................................................................................184 Errors during dataload promotion .............................................................................188 Appendix C Exclusions from the BMC Remedy ITSM Data Management tool 191 Exclusions from dataload ............................................................................................191 Exclusions from the data wizard ................................................................................191 Appendix D Data values 195 Configuration Item types .............................................................................................195 Locales ............................................................................................................................197 Notification events ........................................................................................................201 Permission groups ........................................................................................................207 Relationship types ........................................................................................................210 Request types .................................................................................................................210 Timing Reasons .............................................................................................................211 Status reasons ................................................................................................................211 For Transactional-Change.xls ...........................................................................212 For Transactional-Contract.xls .........................................................................213 For Transactional-Problem.xls .........................................................................214 For Transactional-Incident.xls ..........................................................................215 For Transactional-Task.xls ................................................................................217 Time zones .....................................................................................................................218 Appendix E How tabs map from spreadsheet to target form 221 Foundation data mapping ...........................................................................................221 Process setup data mapping .......................................................................................224 Transactional data mapping ........................................................................................225 Appendix F Loading sample data 229 About the sample data .................................................................................................229 Identifying the sample data records ...............................................................229 Spreadsheets .......................................................................................................229

Contents

Loading sample data after installation ......................................................................230 Deleting default and optional sample data ...............................................................231 Default and optional sample data ...................................................................232 Appendix G Modifying foundation data in related applications 239 Foundation data modified by the data wizard .........................................................239 Using BMC Remedy User to update the conditions and qualification forms ....................................................................................................................242

Data Management Administration Guide

About this book

The Data Management Administration Guide describes how to install and use the Data Management tool that is part of BMC Remedy IT Service Management (BMC Remedy ITSM). This document is intended for application administrators and BMC Remedy Action Request System administrators. BMC Remedy ITSM includes the following applications and solutions:
BMC Remedy Asset Management application BMC Remedy Change Management application BMC Remedy Service Desk solution (which includes the BMC Remedy Incident

Management application and the BMC Remedy Problem Management application)

BMC Remedy ITSM can be integrated with the following applications:

BMC Service Request Management application BMC Service Level Management application

The applications run in conjunction with the BMC Remedy Action Request System platform (AR System) and share a common database. All five of the applications consume data from the BMC Atrium Configuration Management Database (BMC Atrium CMDB) application. Like most BMC documentation, this book is available in printed and online formats. To request printed books or to view online books and notices (such as release notes and technical bulletins), see the Customer Support website at http://www.bmc.com/ support. Most product shipments also include the books on a documentation CD.

Online books are formatted as PDF or HTML files. To view, print, or copy PDF books, use the free Adobe Reader from Adobe Systems. If your product installation does not install the reader, you can obtain the reader at http://www.adobe.com.

Note

About this Book 9

About the BMC Remedy ITSM Suite

The software also offers online Help. To access Help, press F1 within any product or click the Help button in graphical user interfaces (GUIs).

About the BMC Remedy ITSM Suite

The following sections provide an overview of the following BMC Remedy ITSM products:
BMC Atrium CMDB on page 10 BMC Remedy Asset Management on page 10 BMC Remedy Change Management on page 11 BMC Remedy Incident Management on page 11 BMC Remedy Problem Management on page 11 BMC Service Request Management on page 12 BMC Service Level Management on page 12

BMC Atrium CMDB

BMC Atrium CMDB is installed prior to any of the BMC Remedy ITSM applications. It stores information about configuration items (CIs) and their relationships in an inheritance-based data model, and has the ability to reconcile data from different sources. BMC Atrium CMDB provides a "single source of truth" about your IT environment, enabling other BMC applications to manage CIs, predict the impact of configuration changes, and perform other Business Service Management (BSM) functions. For more information, see the BMC Atrium CMDB Users Guide.

BMC Remedy Asset Management

The BMC Remedy Asset Management application lets IT professionals track and manage enterprise configuration items (CIs)and their changing relationships throughout the entire asset life cycle. As part of the BMC Remedy ITSM Suite, Asset Management is integrated with BMC Remedy Service Desk (which contains the BMC Remedy Incident Management and BMC Remedy Problem Management

10 Data Management Administration Guide

About the BMC Remedy ITSM Suite

applications), BMC Remedy Change Management, and BMC Service Level Management, and offers flexibility to support customized business processes. For more information, see the BMC Remedy Asset Management User Guide.

BMC Remedy Change Management

Using best practices that are compatible with the IT Infrastructure Library (ITIL), BMC Remedy Change Management provides IT organizations with the ability to manage changes by enabling them to assess impact, risk, and resource requirements, and then create plans and automate approval functions for implementing changes. It provides scheduling and task assignment functionality, and reporting capabilities for reviewing performance and improving processes. Because BMC Remedy Change Management is integrated with the BMC Atrium CMDB, BMC Remedy Change Management lets you relate changes to other records, such as CIs (including services) and incidents. For more information, see the BMC Remedy Change Management User Guide.

BMC Remedy Incident Management

BMC Remedy Incident Management is used to manage incidents. Incident management is reactive, and is typically initiated in response to a customer call or automated event. An example of an automated event might be an alert from a monitoring system, such as BMC Service Impact Management (BMC SIM). The primary goal of the incident management process, according to ITIL standards, is "to restore normal service operation as quickly as possible with minimum disruption to the business, thus ensuring that the best achievable levels of availability and service are maintained." An incident is any event that is not part of the standard operation of a service and that causes an interruption to or a reduction in the quality of that service. Normal service operation is the operation of services within the limits specified by BMC Service Level Management (SLM). For more information, see the BMC Service Desk: Incident Management User Guide.

BMC Remedy Problem Management

BMC Remedy Problem Management is used to manage problem investigations, known errors, and solution database entries. Problem management can proactively prevent the occurrence of incidents, errors, and additional problems. A problem
About this Book

11

About the BMC Remedy ITSM Suite

investigation helps an IT organization get to the root cause of incidents. It initiates actions that help to improve or correct the situation, preventing the incident from recurring. After a problem investigation identifies the cause, this information can result in either a known error or a solution database entry. A known error is a problem that has been successfully diagnosed and for which a temporary workaround or permanent solution has been identified. A solution database entry contains information that might be required to provide or restore a service. For more information, see the BMC Service Desk: Problem Management User Guide.

BMC Service Request Management

BMC Service Request Management (BMC SRM) allows IT to define offered services, publish those services in a service catalog, and automate the fulfillment of those services for their users. With SRM, users have the ability to help themselves, which reduces the requests coming into the service desk. This enables IT to focus on more mission-critical activities, such as resolving incidents related to service failures and restoring critical services. BMC SRM also provides the ability to automate workflow for each service, enforcing consistency of process and faster fulfillment of the request. For more information, see the BMC Service Request Management Administrators and User's Guide.

BMC Service Level Management

BMC Service Level Management enables a service provider, such as an IT organization, a customer support group, or an external service provider, to formally document the needs of its customers or lines of business using service level agreements, and provide the correct level of service to meet those needs. BMC Service Level Management also provides a means to review, enforce, and report on the level of service provided. It streamlines the most important task of all, which is the communication between a service provider and its customers. Multiple service targets can be defined and monitored, acting as a bridge between IT service support and IT operations. This enables costs to be controlled and helps to provide a consistent level of service in support of key business services. For more information, see the BMC Service Level Management Users Guide.

12 Data Management Administration Guide

Related documentation

Related documentation
The table that follows lists the available documentation for BMC Remedy ITSM. It also lists other documents referenced within the Data Management Administration Guide and within the instructions in the spreadsheets. Unless otherwise noted, online documentation in Adobe Acrobat (PDF) format is available on the product installation distribution media, on the Customer Support website (http://www.bmc.com/support), or both. You can order printed documentation from the Customer Support website. A complete list of documents that support the BMC Remedy ITSM applications is available from the Customer Support website. To access the support website, you must have a support contract. Table 1: Related documentation
Title BMC Remedy ITSM BMC Remedy IT Service Management Installation Guide Procedures for installing the BMC Remedy IT Service Management applications and solutions (including the BMC Remedy ITSM Data Management tool, the BMC Remedy Service Desk solution, BMC Remedy Change Management, and BMC Remedy Asset Management). Procedures for using the BMC Remedy Asset Management application; includes new features and an overview. Procedures for using the BMC Remedy Change Management application; includes new features and an overview. Procedures for using the BMC Remedy Data Import utility. Procedures for configuring the BMC Remedy ITSM applications. Procedures for using the BMC Remedy Service Desk: Incident Management application; includes new features and an overview. Procedures for using the BMC Remedy Service Desk: Problem Management application; includes new features and an overview. Provides a conceptual overview of the applications that make up the BMC Remedy IT Service Management Suite. Description

Note

BMC Remedy Asset Management User Guide BMC Remedy Change Management User Guide BMC Remedy Data Import Help BMC Remedy IT Service Management Administration Guide BMC Remedy Service Desk: Incident Management User Guide BMC Remedy Service Desk: Problem Management User Guide BMC Remedy IT Service Management Concepts Guide BMC Atrium CMDB BMC Atrium CMDB Users Guide

Information about using the BMC Atrium CMDB, including searching for CIs and relationships, launching federated data, reporting, and running reconciliation jobs.

About this Book

13

Conventions

Title BMC Service Level Management BMC Service Level Management Users Guide BMC Service Request Management BMC Service Request Management Guide for Administrators and Users

Description

Procedures for using the BMC Service Level Management application; includes new features and an overview.

Procedures for administrating and using the BMC Service Request Management application.

Conventions
This document uses the following special conventions:
All syntax, operating system terms, and literal examples are presented in this typeface. Variable text in path names, system messages, or syntax is displayed in italic text:

testsys/instance/fileName
This document uses a symbol to show menu sequences. For example, Actions =>

Create Test instructs you to choose the Create Test command from the Actions menu.

What's new in Data Management Administration

This topic summarizes product changes and enhancements. Prior to BMC Remedy ITSM 7.6.04, you could not promote data if errors were found during validation and all records had to be validated without errors. As of BMC Remedy ITSM 7.6.04, the processes are streamlined so you can successfully promote data that has validated without error even when there are staging forms with records that have errors. For more information, see Fixing errors on staging forms on page 84. The dataimport.bat file is no longer available from BMC Remedy Developer Studio. Instead the Data Load utility now uses dataimport.bat from the BMC Remedy Data Import utility to import data to a staging form.

14 Data Management Administration Guide

1
Introduction
You can use the BMC Remedy IT Service Management (BMC Remedy ITSM) Data Management tool to import data into BMC Remedy ITSM and to modify existing data.

Overview of the Data Management tool

This section provides an overview of the steps that you follow to use the Data Management tool to load data into and modify existing data in your BMC Remedy ITSM system. It also provides some high-level scenarios that describe when you might want to use the Data Management tool and some examples of typical ways to use the tool. For examples of typical ways to use the Data Management tool, see Examples showing typical uses of the tool on page 23. For more information about loading data into your BMC Remedy ITSM system, see Importing data on page 77. For more information about changing data already loaded into the system, see Using the data wizard to modify data on page 91. You must have AR System Administrator permissions to see the Data Management tool options in the Custom Configuration tab of the Application Administration Console. For instructions on installing the Data Management tool, see the BMC Remedy IT Service Management Installation Guide.

Dataload process
You can use the Data Management tool to load data from spreadsheets into your BMC Remedy ITSM system. Figure 1 on page 16 shows the steps in the dataload process. Each step is further described in Dataload steps in more detail on page 16.

Chapter 1 Introduction 15

Overview of the Data Management tool

For more detailed information about the Data Load Console, see Overview of the Data Load Console on page 77. Figure 1: Overview of the dataload process

Dataload steps in more detail

This section describes the dataload steps illustrated in the overview of the dataload process in more detail, providing references to chapters and sections later in the guide. 1 Add data to spreadsheets, and modify any existing data as necessary.

16 Data Management Administration Guide

Overview of the Data Management tool

Note You can manually type information into the spreadsheets or you can export it from BMC Remedy ITSM or another application and then import it into the spreadsheets.
The Data Management tool includes Microsoft Excel workbook files. Each tab in a workbook file corresponds to a form in BMC Remedy ITSM, as described in How tabs map from spreadsheet to target form on page 221. For instructions on working with the spreadsheets, see Completing the spreadsheets on page 55. 2 Use the Data Load Console to convert the spreadsheet data to CSV files. The tool converts the spreadsheet data to the appropriate CSV files, as described in Loading data from spreadsheets on page 78. 3 Use the Data Load Console to import the data. You must perform specific steps to load the data. For instructions, see Loading data from spreadsheets on page 78. 4 Validate the data. For instructions, see Validating and promoting the data on page 81. 5 Promote the data into BMC Remedy ITSM. For instructions, see Validating and promoting the data on page 81.

Note If you have customized BMC Remedy ITSM, see Managing customizations on page 109.

Changing data already loaded

If you have loaded data into your BMC Remedy ITSM system or you already have data in your system, you can use the data wizard to modify that data. For more information about the data wizard, see Using the data wizard to modify data on page 91.

Performance benchmarks
BMC measured performance benchmarks for the following uses of the Data Management tool:
Chapter 1 Introduction 17

Overview of the Data Management tool

Loading foundation data in bulk Loading transactional data in bulk Modifying records with the data wizard

Performance benchmarks for loading foundation data

This section shows how many records per hour were processed by the Data Management tool in the BMC Software performance lab. Table 2: Performance benchmarks for foundation data
Task Load people data from the CSV file to staging forms Validate people data in staging forms Promote people data into BMC Remedy ITSM forms Throughput (records per hour) 225,000 1,000,000 220,000

The test data for these performance benchmarks consisted of 238,000 People records, which included 1,200 support staff.

Hardware environment
The performance benchmarks were performed on two Dell PowerEdge 1850 servers connected to a LAN with 100 MBps network interface card. Each server has two 3.8 Ghz Intel Xenon processors, 4 GB RAM and two local hard drives (10 KB rpm).

Software environment
Table 3 on page 18 indicates the software environment for the two servers. Table 3: Software environment for performance benchmark lab during foundation data load testing
Server A A A B B Component Windows 2003 server BMC Remedy AR System server BMC Remedy ITSM applications Red Hat Enterprise Linux Oracle 10g R2 Version Running on

Enterprise Edition SP1 Dell PowerEdge 1850 7.0.1 patch 004 7.0.2 patch 005 2.6.9-55.ELsmp 10.2.0.3 Windows 2003 Server Not applicable Dell PowerEdge 1850 Red Hat Enterprise Linux

The BMC Remedy AR System server was configured for multi-threading, as described in the BMC Remedy IT Service Management Installation Guide.
18 Data Management Administration Guide

Overview of the Data Management tool

For Oracle configuration, the initialization parameters were set as follows:

cursor_share=force optimizer_index_cost_adj=25 optimizer_index_caching=90 sga_target=800M pga_aggregate_target=200M open_cursors=300

Data files were on one hard drive, while all the online redo log files were on another dedicated hard drive.

Performance benchmarks for loading incident records

This section shows how many records per hour were processed by the Data Management tool in the BMC Software performance lab. Table 4: Performance benchmarks for transactional data
Task Load incident records from the CSV file to staging forms Validate incident data in staging forms Throughput (records per hour) 181,000 186,000 Tips to enhance throughput None Use a BMC Remedy AR System server with a more powerful CPU. Throughput is limited by the CPU capacity of the BMC Remedy AR System server. Improve the I/O subsystem on the database server. Throughput is limited by the disk I/O capacity on the database server.

Promote incident data into BMC Remedy ITSM forms

92,000

The test data for these performance benchmarks consisted of the following records:
320,000 incident tickets 140,000 people records 10,000 service catalog entries

Chapter 1 Introduction 19

Overview of the Data Management tool

3,000 sites 462 companies

Hardware environment
The performance benchmarks were performed on two Dell PowerEdge 1850 servers connected to a LAN with 10 MBps network interface card. Each server has two 3.8 Ghz Intel Xenon processors, 4 GB RAM and two local hard drives (10 KB rpm).

Software environment
Table 5 on page 20 indicates the software environment for the two servers. Table 5: Software environment for performance benchmark lab during transactional data load testing
Server A A A B B Component Windows 2003 server BMC Remedy AR System server BMC Remedy ITSM applications Red Hat Enterprise Linux Oracle 10g R2 Version Running on

Enterprise Edition SP1 Dell PowerEdge 1850 7.0.1 patch 004 7.0.3 patch 006 2.6.9-55.ELsmp 10.2.0.3 Windows 2003 Server Not applicable Dell PowerEdge 1850 Red Hat Enterprise Linux

The BMC Remedy AR System server was configured for multi-threading, as described in the BMC Remedy IT Service Management Installation Guide. For Oracle configuration, the initialization parameters were set as follows:
cursor_share=force optimizer_index_cost_adj=25 optimizer_index_caching=90 sga_target=800M pga_aggregate_target=200M open_cursors=300

Data files were on one hard drive, while all the online redo log files were on another dedicated hard drive.

20 Data Management Administration Guide

Overview of the Data Management tool

Performance benchmarks for modifying records with the data wizard

This section shows the length of time to process specified data by the Data Management tool in the BMC Software performance lab. Table 6: Performance benchmarks for updating company fields on the Incident form (HPD:Help Desk form)
Total number of records 500,000 500,000 1,000,000 1,000,000 1,000,000 Number of affected records 250,000 0 500,000 250,000 0 Time to complete updates 41 seconds 17.6 seconds 2 minutes, 27 seconds 1 minute, 31 seconds 1 minute, 10 seconds

Hardware environment
The performance benchmarks were performed on one Dell PowerEdge 2950 server connected to a LAN. The server has one 1.86 Ghz Intel E5320 processor (4 cores), 8 GB RAM, and two local hard drives.

Software environment
Table 7 on page 21 indicates the software environment for the two servers. Table 7: Software environment for performance benchmark lab during data wizard testing
Component Windows 2003 server BMC Remedy AR System server BMC Remedy ITSM applications Oracle 10g R2 Version Enterprise Edition SP2 7.0.1 patch 006 7.0.3 patch 006 10.2.0.1 Running on Dell PowerEdge 2950 Windows 2003 Server Windows 2003 Server Windows 2003 Server

For Oracle configuration, the initialization parameters were set as follows:

sga_target=1224M pga_aggregate_target=800M

Chapter 1 Introduction 21

When to use the Data Management tool

Data files were on one hard drive, while all the online redo log files were on another dedicated hard drive.

When to use the Data Management tool

You can use the Data Management tool whenever you want to import data or modify data. This section lists typical scenarios and the high-level procedures.

Note You cannot run the Dataload tool and the data wizard at the same time.
Table 8: Scenarios for using the Data Management tool Scenario BMC Remedy ITSM is being installed for the first time Procedures Load foundation data and process-setup data. Optionally, use the data wizard to modify sample data for your environment. A company, business unit, department, or other group is being added to an existing installation of BMC Remedy ITSM BMC Remedy ITSM is being migrated from an earlier version Load foundation data and, optionally, process-setup data.

Load foundation data, process-setup data, and transactional data. Use the data wizard to modify data to be appropriate to your implementation of the current version of BMC Remedy ITSM. For information about migration tasks, see Migrating data - Data Load Console on page 24.

An acquisition, reorganization, or rebranding has occurred, resulting in changes to the names of companies, support groups, or other areas

Use the data wizard to rename data to the new values.

The three levels of data in BMC Remedy ITSM, illustrated in Figure 2 on page 23, are:
Foundation data Configuration data that applies to all of the BMC Remedy

ITSM applications, such as companies, sites, people, and categorization.

Process setup data Configuration data that affects processes for a specific

application. For example, decision trees can be used by BMC Remedy Service Desk.

22 Data Management Administration Guide

Examples showing typical uses of the tool

Transactional data Records created during day-to-day use of the product, such

as incidents and change requests.

Figure 2: Levels of data in BMC Remedy ITSM

Examples showing typical uses of the tool

This section provides the following examples that illustrate some typical uses of the Data Management tool.
Migrating data from an earlier version of BMC Remedy ITSM or from a third-

party tool. See Migrating data - Data Load Console on page 24. and task group templates Data Load Console on page 25.

Adding new tasks and task group templates to a system. See Adding task groups

Adding another company to an existing BMC Remedy ITSM installation. See

Adding another company to an existing installation of BMC Remedy ITSM Data Load Console on page 31. Console on page 48.

Changing a users login ID. See Changing a users login ID Data Wizard

Reorganizing a department, which requires support group names to be changed

to reflect the new organization. See Reorganizing a department and changing support group names Data Wizard Console on page 52.

Chapter 1 Introduction 23

Examples showing typical uses of the tool

Migrating data - Data Load Console

Migration scenarios for using the Data Management tool include:
Migrating from a version earlier than 6.0 If you use automated migrations,

you would have to run more than one migration, to first migrate to 6.0, and then to the current version. The procedure using the Data Management tool can eliminate steps. different times. For example, if you have both BMC Remedy Service Desk and BMC Remedy Change Management 6.0, you might choose to initially install BMC Remedy Service Desk, and load the appropriate data. At a later date, you could install BMC Remedy Change Management and load the appropriate data. installation, for example if your earlier version of BMC Remedy ITSM includes many customizations, or if the existing data is of questionable quality. In this case, you can load your quality foundation data.

Migrating in a phased approach You can load different portions of data at

Migrating as a fresh installation You might want to treat migration as a fresh

In each of these scenarios, you must perform the following steps. Detailed instructions are provided for most steps in following chapters. 1 Install BMC Remedy ITSM. 2 Export data from your earlier version of BMC Remedy ITSM or another tool you are using. 3 Import the data into the spreadsheets. 4 Clean up the data in the spreadsheets, which might include adding newly required information that is missing. 5 Use the Data Load Console to import (convert, load, validate, and promote) the data into BMC Remedy ITSM. 6 Optionally, use the data wizard to modify data to be appropriate to your implementation of BMC Remedy ITSM. Because of enhancements to BMC Remedy ITSM, you might want to modify some data. For example, now that categorizations are separate for products and operations, you might want to modify your categorizations.

24 Data Management Administration Guide

Examples showing typical uses of the tool

Adding task groups and task group templates Data Load Console
In this scenario, an administrator may want to add new task templates and task group templates to a system. For more information about using the Data Load Console, see Importing data on page 77.

To add new task templates and task group templates using Data Load Console
1 Populate the ProcessSetup-Task.xls spreadsheet, using the following tabs:
Task templates Use the TMS-TaskTemplate tab. Task group templates Use the TMS-TaskGroupTemplate tab. Template associations Use the TMS-AssociationTemplate tab. Template flow control Use the TMS-FlowTemplate tab.

Figure 3 on page 26 shows the TMS-TaskTemplate tab of the ProcessSetupTask.xls spreadsheet filled in. Note that green fields (columns) are mandatory

and orange fields must be filled in based on other fields. The rest of the fields are optional. The comment text at the top of the columns provides instructions on how to populate each field.

Chapter 1 Introduction 25

Examples showing typical uses of the tool

Figure 4 on page 26 shows the TMS-AssociationTemplate tab filled in and Figure 5 on page 27 shows the TMS-FlowTemplate tab filled in. Figure 3: TMS-TaskTemplate tab filled in with Task Template details

Figure 4: TMS-AssociationTemplate tab filled in with task group association details

26 Data Management Administration Guide

Examples showing typical uses of the tool

Figure 5: TMS-FlowTemplate tab filled in with flow details

2 Convert, import, validate, and promote the data into the system. a From the Data Load Console, select Process Setup as the category of data and click Convert CSV Files. The security for macros in Excel must not be set to "Very High."

Note

Chapter 1 Introduction 27

Examples showing typical uses of the tool

Figure 6 on page 28 shows the Process Setup data selected and Convert CSV Files being clicked. Figure 6: Data Load Console with Process Setup data selected for loading

b In the Input Parameters window, enter the MS Excel Path and the Data Management Client install path, and click Start.

Note If you browse to the directory on your system, make sure the path points to a directory and not a filename.
The CSV files are created in the ITSMDataManagementInstallDir\7.6\CSVs \ProcessSetup directory. c Click Import CSV Files. d In the Import Parameters window, enter the parameters, as required. For more information about entering the parameters, see Loading data from spreadsheets on page 78. e Click Start to import the CSV files. f From the Data Load Console, select Process Setup as the data category and click Validate.

28 Data Management Administration Guide

Examples showing typical uses of the tool

g Click View Status to see the progress of the validation step. If errors occur, see Fixing validation errors on page 83 for information about how to fix the errors. h After the validation step has completed, click Promote. When the status of all of the forms listed changes to Complete, the promotion step is complete. Figure 7 on page 29 shows the promoted task group data that you can access when you click View Status. Figure 7: Promoted Task Group data

The System Administrator can then use the tasks and task group templates available in the Application Administration Console. Figure 8 on page 29 shows a task group template being accessed. Figure 8: Task Group Template window accessing loaded task groups and tasks

Chapter 1 Introduction 29

Examples showing typical uses of the tool

Once they are in the system:

The Task Administrator can modify the tasks and task groups as applicable. The Support Staff can make change requests using these tasks and task groups.

Figure 9 on page 30 shows task group templates being selected for a change request. Figure 9: Loaded task group templates selected for a change request

The Support Staff can also view task flow control on a change request. Figure

10 on page 30 shows the Process Flow Status window for a change request.

Figure 10: Process Flow Status for a change request

30 Data Management Administration Guide

Examples showing typical uses of the tool

Adding another company to an existing installation of BMC Remedy ITSM Data Load Console
In this scenario, an existing company acquires another company and wants to add it to the existing BMC Remedy ITSM system. In this case, the acquired company is added to the system keeping its original name (for legal purposes it was acquired as a separate entity). For more information about using the Data Load Console, see Importing data on page 77.

To add another company to an existing installation

1 Populate, load, and validate the new company information into the parent companys BMC Remedy ITSM system by using the Company.xls spreadsheet. 2 Migrate the companys existing ticketing information from their current system, which could be BMC Remedy ITSM or another ticketing system. See the following procedure for detailed steps.

To populate, load, and validate the new company information

1 Populate the Company.xls spreadsheet, using the 01 COM-Company tab. Figure 11 on page 32 shows the 01 COM-Company tab of the Company.xls spreadsheet populated with data. Green fields (columns) are mandatory, and orange fields must be filled in based on other fields. The rest of the fields are optional. The comment text at the top of the columns provides instructions on how to populate each field.

Chapter 1 Introduction 31

Examples showing typical uses of the tool

Note For the base set of data, provide only the information for the required fields (highlighted in green).
Figure 11: 01 COM-Company tab with the new companys information

2 To load postal code information, fill in the information in the Geography.xls spreadsheet. 3 Fill in the site information in the 01 SIT-Site tab of the Location.xls spreadsheet. Figure 12 on page 33 shows the tab with data. See Table 9 on page 45 for a list of the fields, tabs, and spreadsheets used.

32 Data Management Administration Guide

Examples showing typical uses of the tool

Note For this example, some optional data is provided to make the information complete.
Figure 12: 01 SIT-Site tab with the new companys location information

4 Fill in the 5 SIT-SiteCompanyAssociation tab in the Location.xls spreadsheet to associate company sites with the new company. These fields are shown in Figure 13 on page 33. Figure 13: 5 SIT-SiteCompanyAssociation tab

Chapter 1 Introduction 33

Examples showing typical uses of the tool

Note In addition to the fields shown above, you need to enter Enabled in the Status column as shown in Figure 12 on page 33.
5 Fill in the CTM-PeopleOrganization tab of the PeopleOrg.xls spreadsheet to define the organizations within the company. The spreadsheet is shown in Figure 14 on page 34. In this example, one organization called Human Resources is loaded, and it has one department called Benefits. If you want to add multiple organizations, you would create a row for each organization and enter the same company name for each. If you want to add multiple departments to the Human Resources organization, you would create a row for each department and use the same company and organization names.

Note There is no Enabled column on the CTM-PeopleOrganization tab of the PeopleOrg.xls spreadsheet so you do not need to fill this in.
Figure 14: CTM-PeopleOrganization tab

6 Enter support group information by filling in the 01 CTM-SupportGroup tab of the SupportGroup.xls spreadsheet. For this example, one support organization called IT Support is loaded, and it has one support group name called Calbro Services IT Support and one support group role called Service Desk. If you wanted to add multiple support organizations, you would create a row for each support organization and enter the same company name for each.

34 Data Management Administration Guide

Examples showing typical uses of the tool

Figure 15 on page 35 shows the SupportGroup.xls spreadsheet updated with the data for this example. Figure 15: 01 CTM-SupportGroup tab

You would enter 0 in the Vendor Groups column to indicate that vendor groups should be used. Selecting Vendor indicates whether the support group is a vendor group that can be selected on the vendor tab of an Incident.

Note

Note The Support Group form has an On-Call Group selection that is not represented in the SupportGroup.xls spreadsheet. The Data Load utility sets this option to No by default, and if an On-Call record that is related to this Support Group is loaded, the Data Load utility sets the On-Call Group flag to Yes.
7 Fill in the following tabs in the People.xls spreadsheet to specify information such as login IDs, permissions, roles, and assignment availability:
01 CTM-PeopleTemplate 02 CTM-People 03 CTM-PeopleTemplatePG 04 CTM-PeopleTemplateSG

Chapter 1 Introduction 35

Examples showing typical uses of the tool

05 CTM-PeopleTemplateSFR

If you have only a few individuals for whom you need to load information, you can load people individually using different tabs in the People.xls spreadsheet rather than using the People templates. The tabs that you use to load people when using the templates are the same as the spreadsheet tabs listed in this step. a To define a People template, fill out the 01 CTM-PeopleTemplate tab of the People.xls spreadsheet. Figure 16 on page 37 shows you the tab populated with the data being used in this example.

Tip

36 Data Management Administration Guide

Examples showing typical uses of the tool

Note When you load people, the purpose of this tab is only to specify the template information, such as name. The other fields, such as Company Name, are loaded from the 02 CTM-People tab. These other fields, however, are stored in the People Template (after loading), and are used when creating individual people records through the Application Administration console. The information in the 01 CTM-PeopleTemplate tab is not used at all; the information in the 02 CTM-People tab is used to load the person.
Figure 16: 01 CTM-PeopleTemplate tab

Chapter 1 Introduction 37

Examples showing typical uses of the tool

b To define all the individuals in the new company, fill in the 02 CTM-People tab of the People.xls spreadsheet. Figure 17 on page 38 shows the tab populated with the data being used for this example. Figure 17: 02 CTM-People tab

c To define the permission groups, fill in the 03 CTM-PeopleTemplatePG tab of the People.xls spreadsheet. Figure 18 on page 39 shows the tab populated with the data being used for this example.
38 Data Management Administration Guide

Examples showing typical uses of the tool

Figure 18: 03 CTM-PeopleTemplatePG tab

Chapter 1 Introduction 39

Examples showing typical uses of the tool

d To define the support groups, fill in the 04 CTM-PeopleTemplateSG tab of the People.xls spreadsheet. Figure 19 on page 40 shows the tab populated with the data being used for this example. Figure 19: 04 CTM-PeopleTemplateSG tab filled in

40 Data Management Administration Guide

Examples showing typical uses of the tool

e To define the functional roles, fill in the 05 CTM-PeopleTemplateSFR tab of the People.xls spreadsheet. Figure 20 on page 41 shows the tab populated with the data being used for this example. Figure 20: 05 CTM-PeopleTemplateSFR

f To define the login information, fill in the 06 CTM-Login tab of the People.xls spreadsheet. Figure 21 on page 41 shows the tab populated with the data being used for this example. Figure 21: 06 CTM-Login tab filled in

Chapter 1 Introduction 41

Examples showing typical uses of the tool

8 Import, validate, and promote the data into the system. a From the Data Load Console, select Foundation as the category of data and click Convert CSV Files. b In the Input Parameters window, if the defaults are not correct, change the paths and click Start.

Note If you browse to the directory on your system, make sure the path points to a directory and not a filename.
The CSV files are created in the ITSMDataManagementInstallDir\7.6\CSVs \ProcessSetup directory. Figure 22 on page 42 shows the Input Parameters window with the default locations for Microsoft Excel and the Data Management installation path. Figure 22: Input Parameters window with default paths

c Click Import CSV Files. Figure 23 on page 42 shows the Input Parameters window that is displayed when you click Import CSV Files. Figure 23: Input Parameters window displayed after clicking Import CSV Files

42 Data Management Administration Guide

Examples showing typical uses of the tool

d In the Import Parameters window, enter the parameters, as required. For more information about entering these parameters, see Loading data from spreadsheets on page 78. If you browse to the directory on your system, make sure the path points to a directory and not a filename. e Click Start to import the CSV files. A message box is displayed when the import function has completed. f From the Data Load Console, select Foundation as the data category and click Validate. Figure 24 on page 43 shows the Validate button on the Data Load Console. Figure 24: Data Load Console showing the Validate button

Note

The Dataload Status window opens automatically showing the progress of the validation step.

Chapter 1 Introduction 43

Examples showing typical uses of the tool

Figure 25 on page 44 shows the Dataload Status window. If errors occur, see Fixing validation errors on page 83 for information about how to fix the errors. Figure 25: Dataload Status window

g After the validation step has completed, close the Dataload Status window.

44 Data Management Administration Guide

Examples showing typical uses of the tool

h From the Data Load Console, select Foundation as the data category and click Promote. Figure 26 on page 45 shows the Promote button and the data that was successfully validated in the previous steps. Figure 26: Data Load Console showing Promote button and validated data

When the status of all of the forms listed changes to Complete, the promotion step is complete. 9 Click View Status to verify that the dataload has successfully completed. The system is then ready for use by employees in the newly added company.

Summary of spreadsheets and fields filled in to add a new company

In summary, this example has walked you through how to fill in the spreadsheets required to add a new company to an installation of BMC Remedy ITSM. The Base set of sample data for adding the company table summarizes the spreadsheets, tabs, and fields that were required to be filled in to do this. Table 9: Base set of sample data for adding the company
Information type Company details Spreadsheet Company.xls Tabs 01 COM-Company Fields Company Type Status Required? Required Required Required

Chapter 1 Introduction 45

Examples showing typical uses of the tool

Information type Site information

Spreadsheet Location.xls

Tabs 01 SIT-Site

Fields Site Name Country State/Province City Zip / Postal Code Time Zone Status

Required? Required Required Not required Required Not required Not required Required Required Required Required Required Required Required Required Required Required Required Required Required

Location.xls

5 SITSiteCompanyAssociation

Company Site Status

Organization / department information Support group information

PeopleOrg.xls

CTM-PeopleOrganization Company Organization Department

SupportGroup.xls

01 CTM-SupportGroup

Support Company Support Organization Support Group Name Support Group Role Vendor Group Status

46 Data Management Administration Guide

Examples showing typical uses of the tool

Information type People information

Spreadsheet People.xls

Tabs 01 CTM-PeopleTemplate

Fields Template Name Profile Status Client Type Company Support Staff VIP Client Sensitivity Assignment Availability Template Status

Required? Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required Required

02 CTM-People

Last Name First Name Client Type Company Internet E-mail Profile Status

03 CTMPeopleTemplatePG

Permission Group License Type Template Name

04 CTMPeopleTemplateSG

Support Organization Support Group Name Support Group Association Role Assignment Availability Default Group Template Name

05 CTMPeopleTemplateSFR

Company Support Organization Support Group Name

Functional Role Alias Required Assignment Required Availability Chapter 1 Introduction 47 Template Name Required

Examples showing typical uses of the tool

Information type People information (continued)

Spreadsheet People.xls (continued)

Tabs 06 CTM-Login

Fields Login Type Host Name Login ID Person ID

Required? Required Required Required Required

Changing a users login ID Data Wizard Console

In this scenario, a user's recent name change requires a change in that user's ID. For more detailed information about using the Data Wizard Console, see Using the data wizard to modify data on page 91.

To use the data wizard to change a user ID

1 Launch the Data Wizard Console: a Choose Start => Programs => BMC Software => AR System => BMC Remedy User. b Open the BMC ITSM Application Administration Console. c Expand Foundation and Data Management Tool as shown in Figure 27 on page 49.

48 Data Management Administration Guide

Examples showing typical uses of the tool

d Double-click Data Wizard Console as shown in Figure 27 on page 49. Figure 27: Launching Data Wizard Console from the Application Administration Console

2 To determine how many records will be affected by the login ID update, run the count function in the data wizard and viewing the log after the count has completed. a Select Count target values as the action you want to perform. b Select Login ID as the type of data to be acted upon.

Chapter 1 Introduction 49

Examples showing typical uses of the tool

Figure 28 on page 50 shows the Data Wizard Status Screen with the results log for the count operation. Figure 28: Data Wizard Console status screen showing the results log

3 Depending on the number of records that will be affected, choose a time to perform the update. If a large number of records are affected, you might want to schedule the update to run in off hours. In the example shown in Figure 28 on page 50 two forms are affected: CTM: SupportGroupAssociation and CTM: SupportGroupFunctionalRole. Each form has two login IDs that have to be updated.

50 Data Management Administration Guide

Examples showing typical uses of the tool

4 Run the update function in the data wizard. Figure 29 on page 51 shows the Update target values function and the Login ID data type selected. Figure 30 on page 51 shows the next screen with the Login ID details for the update specified. Figure 29: Data Wizard Console showing update for Login ID selection

Figure 30: Next screen showing Login ID details for the update

5 View the resulting status and log to see how many records were updated.

Chapter 1 Introduction 51

Examples showing typical uses of the tool

Figure 31 on page 52 shows the results screen after the Update Login ID function has run. The number of records updated for each form should match the count from step 2. Figure 31: Results of the Update Login ID function

The individual can now sign in using the new login ID.

Reorganizing a department and changing support group names Data Wizard Console
In this scenario, your company has reorganized its IT department and needs to rename some support groups. For more detailed information about using the Data Wizard Console, see Using the data wizard to modify data on page 91.

To use the data wizard to change support group names

1 Launch the Data Wizard Console: a Open the BMC ITSM Application Administration Console. b Expand Foundation and Data Management Tool. c Double-click Data Wizard Console as shown in Figure 27 on page 49. 2 Determine how many records updating support group names will affect by running the count function in the data wizard and viewing the log after the count has completed.

52 Data Management Administration Guide

Examples showing typical uses of the tool

a From the Select the action you want to perform list, select Count target values. b From the Select the type of data to be acted upon list, select Support Group. Figure 32 on page 53 shows the Update target values function and the Support Group data type selected. Figure 33 on page 53 shows the next screen with the Support Group details for the update specified. Figure 32: Data Wizard Console showing update for Support Group selection

Figure 33: Next screen showing Support Group details for the update

3 Depending on the number of records that will be affected, choose a time to perform the update. If a large number of records are affected, you might want to schedule the update to run in off hours. 4 Run the update function in the data wizard: a From the Select the action you want to perform list, select Update target values.

Chapter 1 Introduction 53

Examples showing typical uses of the tool

b From the Select the type of data to be acted upon list, select Support Group. Figure 34 on page 54 shows the Support Group form that is displayed and the data entered for the update. Figure 34: Support Group form with data entered for update

5 View the resulting status and log to see how many records were updated. The results screen shows the updates made after the Update Support Group function has run. The number of records updated for each form should match the count from step 2. The employees can now use BMC Remedy ITSM under their new support group.

54 Data Management Administration Guide

2
Completing the spreadsheets
Before you can import data, you must complete the appropriate data load spreadsheets.

Understanding the spreadsheets

This section provides an overview of the data load spreadsheets. Additional instructions are provided within the spreadsheets. Each workbook contains related spreadsheets. The first tab provides instructions for using the spreadsheet. Each of the subsequent tabs corresponds to the form into which the data is populated. Figure 35: Example spreadsheet

Chapter 2 Completing the spreadsheets 55

Populating data in the spreadsheets

Column headings provide instructions for completing that column of the spreadsheets according to the following standards:
A green column heading indicates a required field. An orange column heading indicates a field that might be required, depending on

a value set in another column.

Text in the first row provides instructions for entering data in the column.

The number above each column heading is the database length of the field. This number corresponds to the number of bytes in the field. For English and other singlebyte languages, the number of bytes is the same as the number of characters. Doublebyte languages use two bytes per character. Validation on each column indicates if you entered data longer than this maximum allowed length. The successful validation of field lengths in Microsoft Excel spreadsheets for multibyte languages does not guarantee that the data will be imported successfully. The data import process uses the number of bytes when importing to fields while Excel validates the number of characters.

Note This validation occurs only when you type in the spreadsheet cells. If you bring in data by copying and pasting from another source or by importing data into the spreadsheet, you bypass the validation.

Populating data in the spreadsheets

This section provides general instructions for populating data in the data load spreadsheets, which you use to load data into the system. To make it easier for you to distribute the spreadsheets to others to complete, each spreadsheet includes instructions specific to the spreadsheet. When using the spreadsheets, leave the tabs in their original order. Deleting, inserting, or changing the order of tabs causes errors when you perform the steps to convert the spreadsheets to CSV files.

Note

56 Data Management Administration Guide

Populating data in the spreadsheets

Tip Microsoft Excel has a limit of 65,536 rows in a spreadsheet, which limits the number of records that you can include in a single spreadsheet. To deal with this issue, copy the contents from the installation directory (the default is C:\Program Files\BMC Software\DataManagementClient) to multiple new directories. If you have installed the client files in a directory that is not in the default installation path, copy them to multiple new directories. The number of required directories depends on the number of rows of data (as a multiple of 65,536). For example, if you need three directories, you might set them up as: C:\Program Files\BMC Software\DataManagementClient1 C:\Program Files\BMC Software\DataManagementClient2 C:\Program Files\BMC Software\DataManagementClient3 For forms that have too many records for a single spreadsheet, enter the data in multiple spreadsheets and in multiple directories. If you are not loading records in all spreadsheets, you can delete the spreadsheets from the extra directories. You can run batch files from the separate directories concurrently, which enhances performance for loading data from the CSV files into the staging forms.

Locating the data load spreadsheets

This topic describes where to find the data load spreadsheets. Use the data load spreadsheets that are in the 7.6 folder in the Data Management Client install directory. By default, the installation path is C:\Program Files\BMC Software\DataManagementClient.

If you set your macro security to medium or high, then you can choose to disable your macros so you can open them in Excel without running them.

Tip

Loading data into an existing system

If you are updating an existing BMC Remedy IT Service Management (BMC Remedy ITSM) system (for example, loading data for a new department or location) some data already exists in your BMC Remedy ITSM system. Do not re-enter data that is already loaded into your system. You must complete spreadsheets only for the new data that you are loading.

Chapter 2 Completing the spreadsheets 57

Populating data in the spreadsheets

Loading data into a new system

To load only the minimum standard configuration, complete only the spreadsheets listed in the Spreadsheets and tabs required to load minimum standard configuration table. If you want to load all of the foundation data for a new BMC Remedy ITSM 7.6.0x system (which forms the foundation for all other data in BMC Remedy ITSM), or some subset of this data, see also Table 10 on page 58. BMC recommends that you start with spreadsheets that are self-contained and do not have dependencies on data in other spreadsheets. BMC recommends that you start with Company.xls.

What dependencies are there?

When entering data, be aware that data in one spreadsheet can depend on data that is either entered on another spreadsheet or already loaded in the system. For example, the company field, which is entered on most spreadsheets, must match a company either created in Company.xls or already loaded on the system. These dependencies are noted in the instructions in the spreadsheets. Table 11 on page 60 also lists dependencies among the foundation spreadsheets. The spreadsheets are listed in Table 10 on page 58 in the order that the corresponding data is validated and promoted in the Data Load Console. You might choose to complete spreadsheets in this sequence.

Spreadsheets required for minimum standard configuration

This section describes the spreadsheets that you need to load for a minimum standard configuration. Table 10: Spreadsheets and tabs required to load minimum standard configuration
Required spreadsheets Company.xls Location.xls Required tabs 01 COM-Company 01 SIT-Site 5 SIT-SiteCompanyAssociation SupportGroup.xls 01 CTM-SupportGroup Description Use this tab to specify companies. Use this tab to specify sites. Use this tab to associate each site to a company. Sites are physical locations. Use this tab to specify support groups.

58 Data Management Administration Guide

Populating data in the spreadsheets

Required spreadsheets People.xls Note: You do not need to use all the People tabs listed here. If you are loading people using templates, use the tabs that apply to templates; otherwise use the tabs that apply to loading people individually. See People, permissions, and support groups on page 61 for more information.

Required tabs 01 CTM-PeopleTemplate

Description To load support staff, you can use people templates. On this tab you specify the template names that are referenced on the other tabs. You can also load people individually using the 02 CTM-People, 18 CTMPeoplePermissionGroups, 19 CTMSupportGroupAssociation, and 20 CTMSupportGrpFunctionalRole tabs. Use the other tabs in People.xls to set the permission groups, support groups, and support group functional roles for each people template, for individuals, or for both. For more information about how to use people templates to load individuals into the system and assign them permissions, see People, permissions, and support groups on page 61.

02 CTM-People

Use this tab to load people. For more information about how to load people into the system and assign them permissions, see People, permissions, and support groups on page 61. Note: Do not use data load to load Demo and Appadmin users, because these are existing administrator accounts.

03 CTM-PeopleTemplatePG

Use this tab to specify the BMC Remedy ITSM application permission groups for each people template. For more information about how to load people into the system and assign them permissions, see People, permissions, and support groups on page 61. Use this tab to specify the support groups for each people template. For more information about how to load people into the system and assign them permissions, see People, permissions, and support groups on page 61.

04 CTM-PeopleTemplateSG

Chapter 2 Completing the spreadsheets 59

Populating data in the spreadsheets

Required spreadsheets People.xls (continued)

Required tabs 05 CTM-PeopleTemplateSFR

Description Use this tab to specify the support group functional roles for each people template. For more information about how to load people into the system and assign them permissions, see People, permissions, and support groups on page 61. Use this tab to specify the ITSM Application permissions for each individual.

18 CTM-PeoplePermissionGroups

19 CTM-SupportGroupAssociation Use this tab to specify the support groups for each individual. 20 CTMSupportGrpFunctionalRole Use this tab to specify the support group functional roles for each individual.

Set of foundation data load spreadsheets

Foundation data, loaded by the foundation data load spreadsheets, forms the foundation for all other data in BMC Remedy ITSM. Dependencies among foundation data load spreadsheets are shown in the following table. Table 11: Dependencies among foundation data load spreadsheets
Data entered in this spreadsheet Depends on data entered in these spreadsheets Company Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Geography Yes SystemSe People tup Org Location Financials Support Group Catalogs

Location People SupportGroup Financials People ProductCatalog Operational Catalog GenericCatalog

Process setup data, loaded by the process-setup data load spreadsheets, depends on foundation data. Transaction data, loaded by the transaction setup data load spreadsheets, depends on foundation data. If you are loading transaction data, make sure that you consider
60 Data Management Administration Guide

Spreadsheet usage tips

information in the Transactional-SharedComponents.xls file. This spreadsheet includes tabs for shared child forms. If you are loading task information for change or incident requests, consider the following points:
You can load both task groups and tasks. You can load only one level of task group. This means that a task group can

contain tasks, but cannot contain other task groups.

Unless you are loading ad hoc tasks, you must specify the Task Template ID.

To populate data in the spreadsheet

1 Complete the spreadsheets according to the instructions on the Instructions tab and in the column headings. All leading and trailing spaces and tab characters are stripped when the data is imported into staging forms. 2 Save the file to the spreadsheet folder where the Data Management tool was installed. The default path is: C:\Program Files\BMC Software\DataManagementClient

Spreadsheet usage tips

This section documents some tips for using the spreadsheets.

People, permissions, and support groups

Permission Groups, Support Group Associations, and Support Group Functional Roles (hereafter referred to as permissions) can be assigned as follows:
Using templates. For detailed information about using templates, see Assigning

permissions and permission groups using templates on page 63.

On an individual basis. For detailed information about assigning permissions to

individuals, see Assigning permission groups and permissions on an individual basis on page 65

Using a combination of templates and assigning directly to individuals.

Chapter 2 Completing the spreadsheets 61

Spreadsheet usage tips

Note When you assign permission groups and permissions using both templates and on an individual basis, the template permissions are assigned first and the individually assigned permissions are appended to these. If the same permission is specified in a template as well as for an individual, a validation error occurs. Remove the duplication to fix the error.
The People.xls spreadsheet contains the following tabs that you use to define people and their permissions:
The 01 CTM-PeopleTemplate tab is used to load existing People templates from

previous systems. However People templates are also used for linking Permission Groups, Support Groups, and Functional Roles to a People Record that is being loaded. See Assigning permissions and permission groups using templates on page 63 for more information.

The 02 CTM-People tab defines people that are being loaded into the system. The 03 CTM-PeopleTemplatePG tab includes columns for Permissions Group and

License Type, both of which are required fields. Use this tab to assign permission groups using templates. person record in the 01 CTM-PeopleTemplate tab. Use this tab to assign permission support groups using templates.

The 04 CTM-PeopleTemplateSG tab is used to associate support groups to a

The 05 CTM-PeopleTemplateSFR tab is used to load a support group functional

role for a person record in the 01 CTM-PeopleTemplate tab. Use this tab to assign functional roles using templates. access to a person record in the 02 CTM-People tab. Use this tab to assign access to company records on an individual basis. Group and License Type, both of which are required fields. Use this tab when you assign permission groups directly to an individual. with a person record in the 02 CTM-People tab. Use this tab to assign support groups on an individual basis.

The 17 CTM-PeopleAccessRestrictions tab is used to provide company record

The 18 CTM-PeoplePermissionGroups tab includes columns for Permissions

The 19 CTM-SupportGroupAssociation tab is used to associate support groups

The 20 CTM-SupportGrpFunctionalRole tab is used to load a support group

functional role for a person record in the 02 CTM-People tab. Use this tab to assign functional roles on an individual basis.

62 Data Management Administration Guide

Spreadsheet usage tips

Assigning permissions and permission groups using templates

Templates are used as follows:
People templates make it easier to load people who fulfill the same role within a

given support group. See the steps in the procedure that follows to understand how to fill in the People.xls spreadsheet to load People records using templates.

When you load people, the purpose of the 01 CTM-PeopleTemplate tab is only to

specify the template information, such as name. The other fields, such as Company Name, are loaded from the 02 CTM-People tab. These other fields, however, are stored in the People Template after promotion and are used when you create individual people records through the Application Administration console. Figure 36 on page 63 shows how the Template Name field relates the 01 CTM-PeopleTemplate tab to the 02 CTM-People tab. Figure 36: Template Name field relationship

Defining permissions using templates

To define permissions using templates
1 Specify a Template Name on the 01 CTM-PeopleTemplate tab in People.xls, and the rest of the required fields.
Chapter 2 Completing the spreadsheets 63

Spreadsheet usage tips

Note The information in the 01 CTM-PeopleTemplate tab is not used; the information in the 02 CTM-People tab is used to load the person.
The template information is joined to the people information by the template name, as shown Figure 37 on page 64. After a template has been defined in the 01 CTM-PeopleTemplate tab and the People records have been defined on the 02 CTM-People tab, you can create a permission record using the 03 CTM-PeopleTemplatePG tab. 2 Enter the template name specified in the 01 CTM-PeopleTemplate tab in the Template Name column of the 03 CTM-PeopleTemplatePG tab. You must enter one permission per spreadsheet row (many permissions to one template are allowed). Figure 37 on page 64 shows an example of permission groups being assigned to a group of people, with the records being linked to each other by the Template Name. Figure 37: Permission Groups assigned to many people using a template

64 Data Management Administration Guide

Spreadsheet usage tips

3 Verify that the permissions that you are assigning are not already defined in the 18 CTM-PeoplePermissionGroups tab, which are used to define permissions on an individual basis. 4 Repeat steps 1 through 3 to specify support groups using the 04 CTM:PeopleTemplateSG tab and functional roles using the 05 CTM:PeopleTemplateSFR tab.

Assigning permission groups and permissions on an individual basis

You can also assign permissions on an individual basis by using the following tabs:
18 CTM-PeoplePermissionGroups 19 CTM-SupportGroupAssociation 20 CTM-SupportGrpFunctionalRole

The permissions that you assign individually are appended to any permissions assigned by a template. If there are duplicate permissions, a validation error occurs.

Note

To define the permissions on an individual basis

1 Fill in the information for the individual on the 02 CTM-People tab. 2 Based on the type of permissions that you want to assign, fill in any of the following tabs:
18 CTM-PeoplePermissionGroups to assign permission groups. This tab is

linked to the 02 CTM-People tab by the Remedy Login ID column. to the 02 CTM-People tab by the Login ID column.

19 CTM-SupportGroupAssociation to assign support groups. This tab is linked

20 CTM-SupportGrpFunctionalRole to assign support group functional roles.

This tab is linked to the 02 CTM-People tab by the Login ID column.

Chapter 2 Completing the spreadsheets 65

Spreadsheet usage tips

Figure 38 on page 66 shows an example of permission groups being assigned to an individual, with the records being linked to each other by the Remedy Login ID. Figure 38: Permission groups assigned to an individual

3 Verify that the permissions you that are assigning are not already defined in any templates that you are using to assign permissions. 4 Repeat steps 1 through 3 for all the individuals to whom you want to assign permissions on an individual basis.

Task templates and process templates

This section describes:
The limitations that exist for task template validation. How you use task templates to load tasks and the associations between their child

objects, such as tasks and task groups, versus how you use process templates to load processes and the associations between their child objects, such as tasks and task groups.

66 Data Management Administration Guide

Spreadsheet usage tips

Limitations of task template validation

No validation is performed on the automatic fields on the TMS-TaskTemplate tab of the Process Setup-Task.xls spreadsheet. However, the automatic command is validated. This behavior corresponds to the same behavior that exists on the TMS:Task Template form.

Differing uses of task and process templates

The system behaves differently when it uploads child tasks and task groups using templates defined in the ProcessSetup-Task.xls and Transactional-Task.xls spreadsheets. The upload works for each as follows:
ProcessSetup-Task.xls When you upload data referencing a Task Group

Template in the Task Group Template Identifier field on the TMSTaskGroupTemplate tab, any associated task groups and tasks are also uploaded automatically. Template in the Template ID field on the TMS-TaskGroup tab, associated tasks are not uploaded automatically. This is because tasks defined by the task group template may already be in progress in the system. To upload a task group template's tasks, you need to explicitly define the tasks on the TMS-Task tab in the Transactional-Task.xls spreadsheet.

Transactional-Task.xls When you upload tickets referencing a Task Group

Figure 39 on page 68 shows the Transactional-Task.xls spreadsheet with the Template ID field referencing a template and also the TMS-Task tab which must be filled to make sure any associated tasks are also uploaded.

Chapter 2 Completing the spreadsheets 67

Spreadsheet usage tips

Figure 39: Transactional-Task.xls spreadsheet showing Template ID and TMS-Task tab

Using Transactional-SharedComponents.xls to populate the Service or CI fields in an incident, problem, known error, or change
To populate the Service and CI fields of an incident, problem, and known error, or to update the Service field only of a change, you use the fields in the SHR-Associations tab of the Transactional-SharedComponents.xls spreadsheet.

68 Data Management Administration Guide

Spreadsheet usage tips

Figure 40 on page 69 describes the fields on the SHR-Association tab of TransactionalSharedComponents.xls. Figure 40: Fields on the SHR-Associations tab of Transactional-SharedComponents.xls

Fill in the Type of Relationship field only to create an association that updates the Service or CI. Fill in the rest of the fields (required fields are highlighted in green) to complete the association, even if you do not fill in the Type of Relationship field.

Note

What do I fill in to update the Service and CI fields?

To use the SHR-Associations tab of the Transactional-SharedComponents.xls spreadsheet to update the Service and CI fields on the HPD:Help Desk, PBM:Problem Investigation, PBM:Known Error, form or just the Service field on the CHG:Infrastructure Change form, you need to enter one of the following values in the CI Type of Relationship field, depending on whether you want to update the Service or CI field. If you want to update both fields, you need to create two rows specifying each of the following values once in each row.
Service CI (or 1000) to update the Service field

Chapter 2 Completing the spreadsheets 69

Spreadsheet usage tips

WARNING If you enter Service CI (or 1000) for incidents, problems, known errors, and changes only, the Product Categorization information is updated based on the information already defined for the service.
CI (or 2000) to update the CI field

If you enter CI (or 2000), for incidents only the Resolution Product Categorization information is updated based on the information already defined for the CI. For an example of entering data in the spreadsheet to populate the Service and CI fields of an incident, see Example: Updating the Service and CI fields for an incident on page 71.

WARNING

The SHR-Associations tab of the Transactional-SharedComponents.xls spreadsheet is also used to define associations, including CI associations. Leave the Type of Relationship field blank to create this type of association. If you enter a value in the Type of Relationship field, the values that you enter in the Request Identifier - To and Request Identifier - From fields are used to retrieve the data that will be entered in the Service and CI fields for the incident. Depending on whether you are updating the Service or CI fields, the values that you enter in these fields are different. Table 12 on page 70 describes what to enter in these fields in each of these situations.
Table 12: Values to enter in the Request Identifier - To and From fields Fields being updated Spreadsheet field Description of value to enter

Note

Note: The Request Identifier - To and Request Identifier - From fields are interchangeable, which means you can enter the values described below in either field, depending on whether you are updating the Service or CI field. Service Request Identifier - To Request Identifier - From CI Request Identifier - To Request Identifier - From The incident, change, problem, or known error number. The Reconciliation ID that identifies the business service CI to load into the Service field. The incident number. The Reconciliation ID that identifies the CI to load into the CI field.

If you entered a value in the Type of Relationship field (to indicate you want to update either the Service or CI fields on an incident, problem, known error, or

70 Data Management Administration Guide

Spreadsheet usage tips

change), in addition to the fields described in Table 12 on page 70, you should update the rest of the fields on the spreadsheet as follows:
Request Identifier Type - Tothe Request Identifier Type. Always should contain

one of the following values:

9000 (or Incident) to indicate that you are updating an incident record 20000 (or Problem Investigation) to indicate that you are updating a

problem investigation record

16000 (or Known Error) to indicate that you are updating a known error record 12000 (or Infrastructure Change) to indicate that you are updating an

infrastructure change record

Relationship TypeAlways should contain the value Related to or 35000. Request Identifier TypeAlways should contain the value 6000 or Configuration Item to indicate that the information is being retrieved from a CI.

Example: Updating the Service and CI fields for an incident

For this example, you want to load data for incident INC000000000354 and populate the Service and CI fields for this incident at the same time. You want to populate these fields as follows:
Service with System Access CI with BMCHDNODE

Figure 41 on page 71 shows you how to fill in the spreadsheet. Because you are populating both the Service and CI fields on the incident, you need to fill in two rows on the spreadsheet. Figure 41: SHR-Associations tab filled in

Chapter 2 Completing the spreadsheets 71

Spreadsheet usage tips

Table 13 on page 72 explains the values in the fields on the spreadsheet shown in Figure 41 on page 71. Table 13: Spreadsheet fields and values used to populate the Service and CI fields
Spreadsheet field Row 1 of spreadsheet example CI Type of Relationship Request Identifier - To Request Identifier Type - To Relationship Type Service CI INC000000000354 9000 Related to Indicates that the Service field of the incident should be updated. The incident number identifying the incident to update. Indicates that an incident record is to be updated. Must be Related to when something is specified in the CI Type of Relationship field. Value Explanation

Request Identifier - From

RE17892Hge879hsjiPOI987ykjshnNSfxd The Reconciliation ID that identifies the service to load into the Service field. In this case, this reconciliation ID loads System Access into the Service field of the incident. Indicates that the information to populate the Service field is coming from a CI.

Request Identifier Type - From 6000

Row 2 of spreadsheet example CI Type of Relationship Request Identifier - To CI INC000000000354 Indicates that the CI field of the incident should be updated. The incident number identifying the incident to update. This is the same number that was used for Row 1 since both the Service and CI fields are being populated for this incident. Indicates that an incident record is to be updated. Must be Related to when something is specified in the CI Type of Relationship field.

Request Identifier Type - To Relationship Type

9000 Related to

72 Data Management Administration Guide

Spreadsheet usage tips

Spreadsheet field Request Identifier - From

Value

Explanation

REtt739kdjLMHG875rrsfd467jHSDKfge The Reconciliation ID that s identifies the CI to load into the CI field. In this case, this reconciliation ID loads BMCHDNODE into the CI field of the incident. Indicates that the information to populate the CI field is coming from a CI.

Request Identifier Type - From 6000

The following figure shows incident INC000000000354 with the Service and CI fields populated with the information uploaded by the spreadsheet in Figure 41 on page 71. Figure 42: Incident form showing Service and CI fields

CTM:LoadSupportGroupAssociation with Support Staff set to Yes

The dataload utility loads data hierarchically, in its order of dependence. Data on which other data completely depends is loaded first, and data on which other data does not depend is loaded last. The rest of the data is loaded somewhere in the middle of this continuum based on its dependency.
Chapter 2 Completing the spreadsheets 73

Spreadsheet usage tips

For example, CTM:People data is loaded before CTM:Support Group Association data, because there is a hard dependency on the CTM:People data. However, when a People record has Support Staff set to Yes, at least one support group association has to exist. Because CTM:Support Group Association data is loaded after CTM:People data, it is not possible to validate if at least one valid support group association exists or not. Therefore, when setting Support Staff to Yes, you need to manually check that one support group association will also exist after all of the data has been loaded.

Uploading work log attachments

The spreadsheets allow attachments to be loaded into forms that have work logs. Use the Form and spreadsheet matrix for uploading work log attachments table to identify the spreadsheet, tab, and fields that you need to fill in for each form. The steps that follow the table provide instructions for uploading attachments to the work log and provide clearer instructions, and also describe the syntax to use for the Attachment 1 through Attachment 3 fields. Table 14: Form and spreadsheet matrix for uploading work log attachments
Form AST:WorkLog CHG:WorkLog CTR:WorkLog HPD:WorkLog SRM:WorkInfo Transactional-Problem.xls Spreadsheet Transactional-Asset.xls Transactional-Change.xls Transactional-Contract.xls Transactional-Incident.xls Tab AST-WorkLog CHG-WorkLog CTR-WorkLog HPD-WorkLog Fields to fill in Attachment 1 Attachment 2 Attachment 3 PBMKnownErrorWorkLog PBMInvestigationWorkLog Transactional-Task.xls TMS-WorkInfo

PBM:Known Error WorkLog PBM:Investigation WorkLog TMS:WorkInfo

To fill in the spreadsheets to upload attachments

1 Open the spreadsheet associated with the form to which you want to upload attachments as identified in Table 14 on page 74. 2 Select the tab identified for that spreadsheet.
74 Data Management Administration Guide

Spreadsheet usage tips

3 Scroll to the fields (columns) Attachment 1, Attachment 2, and Attachment 3. 4 Identify one attachment for each field, starting with the Attachment 1 field, up to a maximum of three attachments. Use the following syntax:
...CSVs\Transaction\Attachments\subDirectory\fileName.extension

Creating a subdirectory is optional. If you do create one, it must be under the ...CSVs \Transaction\Attachments directory. If the file attachment is directly under the CSVs\Transaction\Attachments directory, just specify the FileName.extension. If the attachment is under a sub-directory, you must specify SubDirectory \fileName.exension. 5 Fill in any other fields to which you want to upload information. Green fields are required and orange fields are required based on other fields. 6 Load, validate, and promote the data as described in Importing data on page 77.

Note

Chapter 2 Completing the spreadsheets 75

Spreadsheet usage tips

76 Data Management Administration Guide

3
Importing data
After the spreadsheet is complete and is converted to CSV files, you must complete the following steps to import the data. These steps must be performed from the Data Load Console. Detailed instructions for each step are provided in this chapter. 1 Load data from spreadsheets. 2 Validate and promote the data. When appropriate, you can delete the data from the staging forms.

Overview of the Data Load Console

This section provides an overview of the Data Load Console. Instructions for using the console are provided in the following sections.

Chapter 3 Importing data 77

Loading data from spreadsheets

Use the Data Load Console to load data into BMC Remedy ITSM. Figure 43: Data Load Console

A table lists the staging forms. The default order of these forms in the table corresponds to the sequence in which they are processed. For each form, the table indicates the staging status, whether errors were detected, the number of records that are not yet promoted, and the number of records that are available for promotion. The table refreshes every 10 minutes. During validation and promotion, you can monitor progress by checking which forms have been validated or promoted.

Loading data from spreadsheets

After you populate the data load spreadsheets, you must load the data into data load staging forms. You must perform this procedure from a computer with the data load spreadsheets installed. During this procedure, you convert the spreadsheets into CSV files, and then import the CSV files into staging forms.

To load data from spreadsheets

1 Access the Data Load Console.
78 Data Management Administration Guide

Loading data from spreadsheets

a Choose Start => Programs => BMC Software => AR System => BMC Remedy User. b Using BMC Remedy User, log in to the BMC Remedy AR System server to which you are importing data. c From the Application Administration Console, click the Custom Configuration tab. d From the Application Setting list, choose Foundation => Data Management Tool => Data Load Console. 2 For the category, select from Foundation, Process Setup, or Transactional. The table lists all the staging forms for the category. The staging status is No Data for all forms that do not yet have data loaded. 3 Click Convert CSV Files. The Input Parameters window appears. 4 Enter the parameters, as described in Table 15 on page 79. Table 15: Input parameters for converting spreadsheets to CSV files
Input parameter MS Excel Path Description The tool uses Microsoft Excel to convert the spreadsheets. You must specify the path to Microsoft Excel on your computer. The default path for Microsoft Excel 2003 is C:\Program Files \Microsoft Office\OFFICE11. Note: If you browse to the directory on your system, make sure the path points to a directory and not a filename. Data Management Install Path The tool must be able to find the spreadsheets and supporting files on your computer. You must specify the path to which the Data Management tool was installed. The default path is C:\Program Files\BMC Software \DataManagementClient. Note: If you browse to the directory on your system, make sure the path points to a directory and not a filename.

5 To start the conversion, click Start.

Chapter 3 Importing data 79

Loading data from spreadsheets

For each tab in the corresponding data load workbook (such as Company.xls), the application creates a CSV file in the ITSMDataManagementInstallDir\7.6\CSVs \Foundation, CSVs\ProcessSetup or CSVs\Transaction directory. If the conversion terminates before completing, you might have a blank cell in the final column. The final column is required in all spreadsheets. 6 Click Import CSV Files. The Import Parameters window appears. 7 Enter the parameters, as described in Table 16 on page 80. Table 16: Input parameters for importing CSV files
Input parameter DataImport.bat Path Description The tool uses BMC Remedy Data Import to import the CSV files. You must specify the path to this executable. The default path is C:\Program Files\BMC Software \ARSystem\dataimporttool. Note: If you browse to the directory on your system, make sure the path points to a directory and not a filename. Data Management Install Path The value that you entered in step 4. Note: If you browse to the directory on your system, make sure the path points to a directory and not a filename. User Password To run the BMC Remedy Data Import utility, the tool uses the User ID by which you are currently logged in. Enter the corresponding password. Note: If you turn logging on, your password is captured in the log. You may want to change your password to something else before importing data with logging turned on, and then change it back after you have finished the dataload process. External Authentication String RPC Number If required by the BMC Remedy AR System server, enter the External authentication. If required by the BMC Remedy AR System server, enter the RPC number.

Note

8 To import the CSV files, click Start.

80 Data Management Administration Guide

Validating and promoting the data

Data is imported into staging forms. This import process strips all leading and trailing spaces, and all tab characters from the data. The import process creates a log file in the ITSMDataManagementInstallDir \7.6\Logs directory for each CSV file that was imported. The name of the import log corresponds to the CSV file that is imported. For example, for COMCompany.csv, the import log is COM-Company.log. If a CSV file is missing or has no data, an error message is generated in the log file, but the data load utility continues, and loads data for CSV files that do exist and have valid data. 9 Examine the log files for error messages. Error messages indicated in Table 17 on page 81 are benign and can be ignored. Table 17: Benign error messages
Error message Explanation

Note

The Datafile option given does not exist. Cannot The CSV file did not exist. If you did not intend to load import. data from the corresponding Excel workbook tab, you can ignore this error message. The Datafile type is not supported. Cannot import. AR Import generates this error message in response to files with a CSV extension. The file is successfully imported, however.

10 If you are using an Oracle database, after loading large amounts of data, run the following SQL command to re-gather Oracle Optimizer Statistics:
begin dbms_stats.gather_schema_stats( ownname=> '"ARADMIN"' , cascade=> TRUE, estimate_percent=> null, degree=> null, no_invalidate=> FALSE, granularity=> 'AUTO', method_opt=> 'FOR ALL COLUMNS SIZE AUTO', options=> 'GATHER'); end;

Validating and promoting the data

Data is initially loaded into staging forms. To validate and promote the data, you must use the Data Load Console to perform the following tasks:

Chapter 3 Importing data 81

Validating and promoting the data

1 Validate the imported data. 2 Fix errors. If there are licensing warnings, you must also fix those warnings. 3 Promote validated data from the staging forms into the appropriate BMC Remedy ITSM forms. If you are loading large amounts of data, BMC recommends that you close the Data Load Console after you start validation or promotion. The table refresh affects performance. For example, to check the progress of CTM_Loadpoeple, you can either reopen the Data Load Console or run the following SQL query:
select DL_STATUS,count(*) rowcnt from CTM_loadpeople group by DL_STATUS

Tip

Validating imported data

Before you can promote the data, you must validate it. When you proceed with validation, the max filter setting is temporarily changed to 999999999. The max filters setting is increased to allow for the large number of filters required to process large volumes of data. This setting is changed back to its original value when validation is complete. BMC recommends that you note the current value of max filters before proceeding; if the procedure is halted before it completes, you might need to manually reset this value.

Note

If you want to run the validation again after all the data is validated without errors, you will get an error message stating that there are no records to be validated. If you make a change on a staging form, however, the data can be revalidated. This situation might occur if you successfully complete validation, but then records are changed on the system that might affect the data being loaded, such as a company being deleted.

Tip

To validate imported data

1 Access the Data Load Console. a Choose Start => Programs => BMC Software => AR System => BMC Remedy User.

82 Data Management Administration Guide

Validating and promoting the data

b Using BMC Remedy User, log in to the BMC Remedy AR System server to which you are importing data. c From the Application Administration Console, click the Custom Configuration tab. d From the Application Setting list, choose Foundation => Data Management Tool => Data Load Console. 2 For the category, select from Foundation, Process Setup, or Transactional. The table lists all the staging forms for the category. Forms with data that you loaded from the spreadsheets are currently listed with a staging status of Unvalidated. A staging status of No Data indicates a form that does not have data loaded from a spreadsheet 3 Click Validate. After you confirm that you want to proceed, validation is performed on all unvalidated data in staging forms. Validated data is revalidated if records are modified on the parent form or if there are unvalidated records on the staging form. When you proceed with validation, the Data Load Status window appears, listing all forms with records to be validated. As the validation proceeds, the status changes from Pending to In Progress to Complete. If you close the Data Load Status window, you can open it by clicking View Status. When the validation is complete, however, this window closes and cannot be reopened. After validation is completed for a form, its staging status displayed on the Data Load Console changes to Validated. Validated forms might have errors. If you validate new people records, the tool validates whether sufficient licenses are available. If the number of licenses available is insufficient, an error message appears, and the data remains unvalidated. To view details of the license compliance check, choose Functions => License Compliance Check.

Fixing validation errors

This section describes how to check and fix errors that are specific to validation. Additional information that is applicable to both validation and promotion is provided in Troubleshooting validation and promotion on page 87.

Chapter 3 Importing data 83

Validating and promoting the data

Checking license compliance

You can load people into the system only if you have sufficient licenses. If you do not have enough licenses, an error message is displayed during validation. To view details of the license compliance check, choose Functions => License Compliance Check. Figure 44: License Compliance Check window

To fix the license compliance, you must either:

Add the required licenses. Load people only for whom you have sufficient licenses.

Fixing errors on staging forms

After validation is complete, the Error Detected column indicates whether an error was detected in a staging form.

To fix errors
1 Select the form with errors, and then click View.

84 Data Management Administration Guide

Validating and promoting the data

The staging form opens in Search mode. Figure 45: Example of a staging form in Search mode

2 To find records with errors, set Error_Flag to Yes, and then click Search. When you open a record that has an error, the staging form includes one or more error description codes and the corresponding error messages. For example, the record in Figure 46 on page 85 has two errors. For a list of error messages, see Error messages on page 143 Figure 46: A staging form displaying a record with an error

3 Fix the errors. You can fix errors directly on the form, or you can fix it in the spreadsheet. The last column in the spreadsheet is required. If you leave a cell blank in the last column, a row might be duplicated or missing in the CSV and corresponding staging form. You must fix this error on the spreadsheet. Because an error in a form can result in errors in dependent forms, you can sometimes save time by validating the data after fixing errors in one or two forms.

Tip

Chapter 3 Importing data 85

Validating and promoting the data

To fix the error on the form: Fix errors on the form only when the validation process is complete. If you fix the errors while validation is still running, the validation process might not complete and some records might not be validated. a Make the correction in the form. b Save the form. The staging status for the form is reset to Unvalidated. Error_Flag remains set to Yes until after you validate the data. To fix the error in the spreadsheet c Delete the data. d Fix the spreadsheet. e Reconvert the spreadsheet to CSV. f Reimport the CSV files. 4 Click Validate. Validation starts with the first staging form marked as Unvalidated or as Validated but with the error flag set to Yes. It continues with the dependent forms in sequence. If errors are still detected, you can repeat this procedure until all the errors are corrected or you can promote the data that validated without error. For more information on the dependent forms, see Data load staging forms dependencies on page 137.

Note

Promoting validated data into the BMC Remedy ITSM forms

When all the staging forms are validated, only the records that are validated without errors will be promoted. If a record is modified on a staging form that has dependent staging forms with records, those dependent staging forms will need to be re-validated prior to promotion.

Note

To promote validated data

1 Click Promote.
86 Data Management Administration Guide

Validating and promoting the data

Note When you proceed with promotion, the max filter setting is temporarily changed to 999999999. It is changed back to its original value when promotion is complete.
2 Confirm that you want to proceed. When you proceed, the Data Load Status window appears, listing all forms to be promoted. As the promotion proceeds, the status changes from Pending to In Progress to Complete. If you close the Data Load Status window, you can open it by clicking View Status. When the promotion is complete, however, this window closes and cannot be reopened. After data is promoted from a staging form into the BMC Remedy ITSM form, the staging status displayed on the Data Load Console changes to All Data Promoted and the number of records to promote is reset to 0. 3 If you are using an Oracle database, after promoting large amounts of data, run the following SQL command to regather Oracle Optimizer Statistics:
begin dbms_stats.gather_schema_stats( ownname=> '"ARADMIN"' , cascade=> TRUE, estimate_percent=> null, degree=> null, no_invalidate=> FALSE, granularity=> 'AUTO', method_opt=> 'FOR ALL COLUMNS SIZE AUTO', options=> 'GATHER'); end;

Troubleshooting validation and promotion

To troubleshoot possible errors in validation and promotion, you can perform tasks described in the following sections:
Monitoring the thread manager for a halted validation or promotion on page 88 Recovering from a halted validation or promotion on page 88 Checking for errors in validation and promotion on page 89

Chapter 3 Importing data 87

Validating and promoting the data

Monitoring the thread manager for a halted validation or promotion

When you start a validation or promotion, records are added to the DLD:ThreadManager form. At the end of the process, the records are removed. You can search for records in the DLD:ThreadManager form. If the records are not being added, modified, or removed, the process has halted. Follow the instructions in Recovering from a halted validation or promotion on page 88.

If you restart the BMC Remedy AR System server before recovering from a halted validation, you see the following error message:
Another validate of Promote process is running ... - AL DLD:DLC:FoundationValidate_102_ValidateOnly.

Note

Recovering from a halted validation or promotion

If either validation or promotion is halted before the operation is complete, an administrator must:
Reset the maximum number of filters for an operation to the original value. Delete the DLD:ThreadManager records. If you encounter the following error, check the Short Description field in the forms

that have the error flag set:

An error was encountered during data promotion. The Short Description field of this record has been updated with the error details. Check for other errors as described in Checking for errors in validation and

promotion on page 89.

To recover from a halted validation or promotion

1 Reset the maximum number of filters for an operation to the original value. a Choose Start => Programs => BMC Software => AR System => BMC Remedy User. b Using BMC Remedy User, log in to the BMC Remedy AR System server to which you are importing data. c Open the AR System Administration Console.
88 Data Management Administration Guide

Validating and promoting the data

d Choose System => General => Server Information. The Server Information window appears. e Click the Advanced tab. f Change the value in the Maximum Filters for an Operation field to the original value, and then click OK. BMC Remedy AR System is installed with this value set to 200000. 2 Delete the DLD:ThreadManager records. a Open DLD:ThreadManager. b Search for all records. To do this, put % in the RequestID field and click Search. c Select all the records. d Choose Actions => Delete. A message asks you to confirm whether to delete the records. e Click OK. You can now rerun validation or promotion. 3 To check the Short Description field in the forms that have the error flag set: a In BMC Remedy User, search for forms with the error flag set to Yes. b Check the Short Description field for text that explains the error. c Fix the error. d Continue with the validation process.

Checking for errors in validation and promotion

Check for errors in validation and promotion in the following places:
The Data Load Console-Errors found on staging forms are flagged. For details

about fixing errors, see Fixing errors on staging forms on page 84.

ARerror.log-This log file lists errors in running validation and promotion. Chapter 3 Importing data 89

Deleting data

CAI Events form-Search for records with Return Code set to Error. The comments

in Return Message indicate which error occurred.

Deleting data
You can delete data from staging forms except when validation or promotion is running. The navigation pane on the left of the Data Load Console provides two functions:
Delete Promoted Staging Data Deletes only promoted data from all staging

forms.

Delete All Staging Data Deletes all data from all staging forms, regardless of

the current status.

You can delete individual records from staging forms, using the same method that lets you delete individual records in any BMC Remedy AR System form. If you delete any records from a staging form that has been validated, you must rerun the validation before you promote data.

If you delete all records from a validated staging form, the other forms are listed as validated on the Data Load Console. You must rerun validation, however, to make sure that other records on other forms are not dependent on the deleted records. If you do not rerun validation, you might receive an error message during promotion.

Note

90 Data Management Administration Guide

4
Using the data wizard to modify data
You can use the data wizard to modify foundation data throughout all applicable BMC Remedy ITSM forms and in configuration item (CI) records in BMC Atrium CMDB.

Note Only a user with AR System Administrator permission can use the data wizard.

Overview of the data wizard

Some data, such as company name and site name, cannot be modified on the foundation configuration forms, because this data is used in records throughout the BMC Remedy ITSM applications and in BMC Atrium CMDB. For example, the site name is created on the SIT:Site form, but it can also be used on records on the CTM:People form, HPD:Help Desk form, and on CIs in BMC Atrium CMDB. You can use the data wizard to modify this data, as it modifies the data in all applicable BMC Remedy ITSM forms and, where appropriate, in CI records in BMC Atrium CMDB. Table 18 on page 92 indicates where the data wizard modifies data.

Chapter 4 Using the data wizard to modify data 91

Counting records that use the target value in specified fields

Table 18: Which records are affected by the data wizard Records modified by data wizard Records not modified by data wizard

BMC Remedy ITSMall forms, except where Other datasets in BMC Atrium, such as the sandbox noted in Exclusions from the data wizard on dataset of the BMC Topology Discovery dataset page 191 Local databases for discovery products that are stored BMC Atrium CMDBCI records in the BMC outside BMC Atrium CMDB Asset dataset BMC Service Level Management records BMC Service Request Management records BMC Remedy Knowledge Management records

You can use the data wizard to modify or count only data that has a status of Enabled. If you have records that are not modified by the data wizard, you must modify them in the relevant application. For more information about modifying data from other applications, see Modifying foundation data in related applications on page 239.

Note

Counting records that use the target value in specified fields

Before you modify data, you can use the data wizard to count records that use the target value. For example, if you plan to change a site name from "Canada" to "Canadian HQ," the data wizard can tell you:
All forms that reference the Site Name field How many records on each form contain the target value ("Canada" in the example)

You can use this information for planning the change.

To count records that use the target value in specified fields

1 Access the data wizard. a Log in to the BMC Remedy AR System server as an administrator.

92 Data Management Administration Guide

Counting records that use the target value in specified fields

b From the Application Administration Console, click the Custom Configuration tab. c From the Application Setting list, expand Foundation, expand Data Management Tool, and then double-click Data Wizard Console. The Data Wizard Console is displayed as shown in Figure 47 on page 93. Figure 47: Data Wizard Console

2 Select the Count target values action. 3 Select the data that you are counting. You can select any of the following types of data:
Company Name Person Name Login ID Generic Categorization Operational Categorization Product Categorization Product Model / Version Site Name Site Information Support Group

When you select the type of data, a window appears, prompting you for the target value.

Chapter 4 Using the data wizard to modify data 93

Counting records that use the target value in specified fields

4 Enter or select the target value. For some types of data, you might specify values for multiple fields. For example, for Product Categorization, you can specify multiple tiers of categorization. For some types of data, you can specify search criteria to locate the appropriate original value. For example, for Person Name, you can specify the Company Name. Figure 48: Example of the Data Wizard Console ready to count records for a person name

5 Click Go. You are prompted to confirm whether to proceed. When you proceed, the Data Wizard Status window appears, listing forms to be counted. As the count proceeds, the status changes from Pending to Complete. If you close the Data Wizard Status window, you can open it by clicking View Status. When the count is complete, however, you cannot open this window.

Viewing the audit log

The audit log displays all the forms that were checked for records to update.

94 Data Management Administration Guide

Prerequisites to updating target values

To To view the audit log

1 Click View Audit Log. 2 Select the appropriate Count record. You can also see the results of previous counts. The Data Administration Action Results tab displays the results of the count in a table. The table lists all forms that reference the data administration type, and the number of records for each form that include the target value.

Prerequisites to updating target values

To maintain data integrity you must perform certain prerequisite actions before you use the data wizard to update target values. This section describes details of these actions. You must perform all actions that apply to your environment. Failure to do so can compromise data integrity. To prevent loss of data or to aid in reverting your data back to its original state before using the data wizard, you should back up your database before beginning.

WARNING

Note Data wizard updates should be run at times when the systems are unavailable for general use, such as a scheduled change windows.

Chapter 4 Using the data wizard to modify data 95

Prerequisites to updating target values

Table 19: Prerequisite actions to maintain data integrity Area Escalations Actions to perform Disable escalations by performing the following steps:

1 Open the AR System Administration Console. 2 Choose System => General => Server Information. 3 Select Disable escalations. 4 Click OK. 5 Close BMC Remedy User, and then restart the BMC Remedy AR System server.
Note: For the server group environment, if the Disable escalations option is not available, use BMC Remedy Developer Studio to manually disable escalation objects on the primary server. Reconciliation Engine Make sure that reconciliation does not run by performing the following steps:

1 Open the BMC Atrium CMDB Console. 2 Click the Reconciliation Manager tab. 3 In the Job History area, look for active jobs.
If a reconciliation job is currently running, you must wait for it to complete before you run the data wizard.

1 If no jobs are active, inactivate currently scheduled jobs. 2 Check again for active jobs, to make sure that none were started.
Discovery products If you have discovery products that populate BMC Atrium CMDB, such as BMC Topology Discovery or BMC Configuration Discovery, you must perform the following steps:

1 Stop the discovery products from populating BMC Atrium CMDB. 2 Update the company or other foundation data being changed in the discovery
products as applicable. Note: The data wizard updates the discovery data sets in BMC Atrium CMDB. Note: If you are updating product categorization, see the example in the following section Coordinating the update of product categorization with BMC discovery products on page 97

96 Data Management Administration Guide

Prerequisites to updating target values

Area Distributed Server Option (DSO)

Actions to perform DSO keeps databases synchronized between two separate BMC Remedy AR System servers. Updates performed by the data wizard do not trigger DSO. Also, you must not allow DSO events to update the database while the data wizard is performing an update. If you are using DSO, you must perform the following steps:

1 Turn off DSO on both servers. 2 Run the same data wizard updates on both servers.
If you do not run exactly the same updates on both servers, the databases are no longer be synchronized, which results in failed DSO events.

1 Turn DSO back on.

Coordinating the update of product categorization with BMC discovery products

This section provides an example of coordinating updates to product categorization with BMC discovery products. You can perform this procedure if you have upgraded from BMC Topology Discovery version 1.4 to version 1.5 and want to change from default categorization to best practice categorization. You can modify this procedure for other updates to product categorization or for BMC Foundation Discovery or BMC Configuration Discovery.

To coordinate the update of product categorization with BMC discovery products

1 Stop the discovery server. 2 Modify the categorization XML file. If you are changing from default categorization to best practice categorization on BMC Topology Discovery, perform the following steps. a Browse to TDHome\public_html\visualis\filter\normalization\default, where TDHome is the location where the BMC Topology Discovery server is installed. b Rename defaultcategorizationrules.xml to defaultcategorizationrules.xml.old.

Chapter 4 Using the data wizard to modify data 97

Updating target values

c Rename bestpraticescategorizationrules.xml to defaultcategorizationrules.xml. 3 Use the data wizard to update the product categorization in the product catalog, in CIs stored in BMC Atrium CMDB, and in BMC Remedy ITSM records, as described in Updating target values on page 98. 4 Restart the discovery server.

Updating target values

You can use the data wizard to modify:
Company Name Person Name Login ID Generic Categorization Operational Categorization Product Categorization Product Model / Version Site Name Site Information Support Group

The data wizard updates the specified target value in the appropriate foundation configuration form and changes the specified target value in other BMC Remedy ITSM application forms and, where applicable, on CI forms in BMC Atrium CMDB. For example, if you change a product categorization value, this value is changed in the product catalog, on BMC Remedy ITSM application forms that include product categorization, and for all applicable CIs. The data wizard updates historical records, such as closed incident and problem records. It does not, however, update audits on the form. When you update records with the data wizard, the Last Modified By and Last Modified Date fields are set for auditing purposes. For more information about how the Login ID is updated, see Updating Login ID on page 99.
98 Data Management Administration Guide

Updating target values

Limitations
The data wizard updates records only if the status of the parent record is set to Enabled. For example, you cannot update a company if the company is set to Offline on the Company form. The data wizard does not update the following areas:
Any character fields that contain the target value concatenated with other text. For

example, if you are updating the Company Name from "My Company" to "Calbro, instances of "My Company" in Work Info fields and Summary fields would not be updated. Only instances of "My Company" in the Company Name field would be updated.

Qualifications on the Report Console or notification messages. Additionally, you cannot use the data wizard to change your own Login ID.

Oracle database limitation

When the data wizard is used for an Oracle database, it cannot update data that has leading or trailing spaces.

Limitations of auditing
The audit log file is not updated when you run the data wizard. The only information available on a form to track what changes the data wizard has made is the name captured in the Last Modified By field and the date captured in the Last Modified Date field of a form. However, if a form is further updated after it has been modified by the data wizard, the record of who ran the data wizard on the particular form is lost.

Updating Login ID
The Submitter field on BMC Remedy ITSM application forms and on CI forms is populated with the applicable Login ID value. When you change a Login ID, the Submitter field is updated on all applicable BMC Remedy ITSM application forms. If the Last Modified By field is the target value, the data wizard does not set the field to the new value. When the data wizard makes updates, it sets the Last Modified By field to the Login ID of the person making the update.

Chapter 4 Using the data wizard to modify data 99

Updating target values

Updating categorization
The product catalog, operational catalog, and generic catalog include multiple levels of categorization. Catalog entries can be defined to multiple levels of categorization. Table 20 on page 100 define to levels of categorization.
Table 20: Examples of product catalog entries Categorization level Tier 1 Tier 2 Tier 3 Manufacturer Product Name Example 1 Hardware Machine Server Hewlett Packard Proliant Example 2 Hardware Machine Server Example 3 Hardware Machine

The following three scenarios illustrate how the levels of categorization that are present in your catalog and the levels of categorization that you specify in the data wizard affect which categorization records are updated:
Scenario 1All three examples are present in your product catalog, and you want

to change "Machine" to "Processing Unit." You could specify only the first two tiers to be updated. The remaining categorization levels are updated throughout the catalog.

Scenario 2All three examples are present in your product catalog, and you

specify three tiers to be updated (for example, you change Hardware - Machine Server to Hardware - Processing Unit - Server). Example 1 and Example 2 are both updated, but Example 3 is not updated.

Scenario 3Example 3 is not part of the product catalog, and you specify three

tiers to be updated. Any forms outside the product catalog with only two tiers specified (for example, an incident with product categorization of Hardware Machine) are updated, however, to keep categorization consistent. These additional forms that are updated are not included in the count. As a result, if you compare the audit for the count and the update, you might notice a discrepancy.

Updates to the product catalog, operational catalog, and generic catalog work the same way. The data wizard has a limitation on updating categorization. For example, the product catalog could have two entries with the first entry containing the following tiers:
Tier 1Hardware

100 Data Management Administration Guide

Updating target values

Tier 2Processing Unit Tier 3Desktop

The second entry could contain the following tiers:

Tier 1Discovered Tier 2Machine Tier 3Server

If you specify in the data wizard to change Tier 1Discovered to Tier 1Hardware and to change Tier 2Machine to Tier 2Processing Unit, the update is not allowed because Tier 1 and Tier 2 already exist as Tier 1Hardware and Tier 2Processing Unit. Instead, you would specify additional tiers when you update categorization. In this example, you would also specify to change Tier 3Server to Tier 3 Server. Although the value remains the same for Tier 3, because the values change for Tier 1 and Tier 2, the updated product catalog entry is not the same as the original product catalog entry.

Before you run the data wizard, you must follow the instructions in Prerequisites to updating target values on page 95.

Note

Updating target values

To update target values
1 Access the data wizard. a Log in to the BMC Remedy AR System server as an administrator. b From the Application Administration Console, click the Custom Configuration tab. c From the Application Setting list, choose Foundation => Data Management Tool => Data Wizard Console. 2 Select the Update target values action. 3 Select the data that you are modifying. When you select the type of data, a window appears, prompting you for the target value and the new value.

Chapter 4 Using the data wizard to modify data 101

Updating target values

4 Enter or select the target value. For some types of data, you might specify values for multiple fields. For example, for Product Categorization, you can specify multiple tiers of categorization. For some types of data, you can specify search criteria to locate the appropriate target value. For example, for Site Name, you can specify the Company and, optionally, Region or Site Group. To select a person, you must press ENTER in the first name or last name field. The search criteria are mandatory for Generic Categorization, Product Model/ Version, Site Information, and Support Group, because they are required to select the correct records to update. For example, the same support group name might be used for both My Company and Calbro, but you are changing the support group for My Company. 5 Specify the new value. You can click Copy to copy the target value and then make the appropriate changes, or you can type the new value. You must specify a new value for each target value. For example, if you are updating the support group name but keeping the support organization, you would copy the support organization and enter a new support group name. The new value cannot duplicate a value that is already in the system.

Note

Tip To copy all fields at the same time, click Copy All.

102 Data Management Administration Guide

Updating target values

Figure 49 on page 103 shows the Data Wizard Console fields populated to update a support group. Figure 49: Example of the Data Wizard Console ready to update a support group

6 Click Go. You are prompted to confirm whether to proceed. When you proceed, the Data Wizard Status window appears, listing forms to be updated. As the update is processed, the status changes from Pending to Complete. If you close the Data Wizard Status window, you can open it by clicking View Status. When the update is complete, however, this window cannot be reopened. After you complete the updates, you must follow the instructions in Post-update requirements on page 104.

Note

Viewing the audit log

The audit log displays all the forms that were checked for records to update. The listed forms include the field being updated, although some forms might not include records that contain the target value.

Chapter 4 Using the data wizard to modify data 103

Post-update requirements

To view the audit log

1 Click View Audit Log. 2 Select the appropriate Update record. The Data Administration Action Results tab displays the results of the update in a table. The table lists all forms that reference the data administration type. For some forms, the table also lists the number of records that were updated. This information is listed for all of the forms. This information is also included for the following forms and the main child forms: Helpdesk (incident), Helpdesk Assignment Log, Impacted Areas, Change, CIs, Problem, Known Error, and Solution.

Post-update requirements
To maintain data integrity, you must perform certain actions after updating target values. This section provides describes the actions required to be performed. You must perform all actions that apply to your environment. Failure to do so can compromise data integrity.
Table 21: Actions to perform after updating target values Area Escalations Actions to perform Re-enable escalations by performing the following steps:

WARNING

1 Open the AR System Administration Console. 2 Choose System => General => Server Information. 3 Clear Disable escalations. 4 Click OK. 5 Close BMC Remedy User, and then restart the BMC Remedy AR System server.
Note: For the server group environment, if the escalation objects on the primary server are disabled manually using BMC Remedy Developer Studio because the Disable escalations option is not available, use BMC Remedy Developer Studio to manually re-enable the escalation objects on the primary server.

104 Data Management Administration Guide

Troubleshooting data wizard counts and updates

Area Reconciliation Engine

Actions to perform Reactivate the reconciliation jobs by performing the following steps:

1 Open the BMC Atrium CMDB Console. 2 Click the Reconciliation Manger tab. 3 In the Job History area, activate currently inactive jobs.
Discovery products If you have discovery products that populate BMC Atrium CMDB, such as BMC Topology Discovery or BMC Configuration Discovery, you must perform the following steps:

1 Update the company or other foundation data being changed in the discovery
products as applicable, if you have not already done so.

2 Restart the discovery product that populates BMC Atrium CMDB.

Distributed Server Option (DSO) Note: You must turn off DSO before running the data wizard, as described in Prerequisites to updating target values on page 95.

1 Run the same data wizard updates on the other servers, if you have not
already done so.

2 Turn DSO back on.

Server groups and other environments with two application servers sharing a database After you run the update on one server, you must restart BMC Remedy AR System services on the other application server or server groups.

Troubleshooting data wizard counts and updates

To troubleshoot possible errors during counts and updates, you can perform the following activities:
The amount of time for a count or update to take depends on the total number of

records being checked and on the number of affected records. For example times, see Performance benchmarks for modifying records with the data wizard on page 21.

Rerunning the count or update on page 106

Chapter 4 Using the data wizard to modify data 105

Troubleshooting data wizard counts and updates

Monitoring the data wizard for a halted count or update

Monitor the Data Wizard Status window. If an item in the Status Window is stuck at Pending, and does not change to Complete, an error might have occurred during the update. If the count or update is halted or interrupted, follow the procedure described in Rerunning the count or update on page 106 to rerun the data wizard action. The amount of time for a count or update to take depends on the total number of records being checked and on the number of affected records. For example times, see Performance benchmarks for modifying records with the data wizard on page 21.

Note

To check for errors

1 Check for errors in the following places:
DLD:Lock form - Search for a record with FormName01 =

DLD:SYS:DataWizAction. If there is such record, it indicates either the process is still running, or a processing error is preventing this record from being deleted after the process has completed. DLD:SYS:DataWizAction. The comments in the Return Message field indicate which error occurred.

CAI Events form Search for records with App Interface Form =

Filter log Run the filter log to check for any errors.

Rerunning the count or update

If the count or update is halted or interrupted, you can rerun the data wizard action; the count or update is completed on the remaining forms.

To rerun the count or update

1 Clear the lock that indicates the data wizard is running. a Open the DLD:Lock form. b Search for a record where the Form Name01 field is set to DLD:SYS:DataWizAction. c Delete the record.

106 Data Management Administration Guide

Troubleshooting data wizard counts and updates

2 Rerun the count or update. a On the Data Wizard Console, click View Audit Log. b Open the audit of the action that was halted or interrupted. c Click Re-Run. The count or update resumes running from where it was halted or interrupted.

Note You can perform a new count instead of rerunning a count. For an update, however, you must perform a rerun.

Chapter 4 Using the data wizard to modify data 107

Troubleshooting data wizard counts and updates

108 Data Management Administration Guide

5
Managing customizations
The Data Management tool is designed to load data into and to modify data in an outof-the-box BMC Remedy ITSM 7.6.0x product suite. The BMC Remedy ITSM 7.6.0x product suite includes significant enhancements to the functionality of the applications and the types of data being stored from the previous version. Despite these capabilities, you might have customized BMC Remedy ITSM, because of various business drivers. To make sure that the Data Management tool functions correctly in a customized BMC Remedy ITSM application, you must identify the customizations, analyze the impact, and make the customizations work with the tool.

Identifying customizations
Use these tips to identify your customizations:
Documentation If your customizations are documented, you can use this

information to create a list of the workflow, fields, and forms that have been added or changed within your application.

Naming conventions Application developers sometimes use a naming

convention that identifies customized workflow. The workflow is then placed within a namespace reserved for this purpose. For example, if the HPD:HPDGetPerson active link is modified, it could have been copied to HPD:CUSGetPerson, using CUS in the name to indicate that it is customized workflow.

Analyzing your customizations for impact on data load functionality

After you identify customizations, you must determine their impact on the data load functionality. The types of customizations to BMC Remedy ITSM that can impact the functionality of the Data Management tool are as follows:

Chapter 5 Managing customizations 109

Making data load work with your customizations

Custom fields with Required entry mode Whether these fields are new or are

modified on existing BMC Remedy ITSM forms, they impact the data load. You must make sure that these fields are populated with data. Otherwise, the data load fails.

Fields with Optional entry mode If these fields have custom workflow to

enforce data entry when records are created or updated, they impact the data load. If required, duplicate the custom workflow on the data load staging forms to enforce the same constraints. To determine the appropriate staging form, see How tabs map from spreadsheet to target form on page 221 Data Management tool. When data is loaded by the tool, all BMC Remedy ITSM workflow on forms targeted for the load are bypassed, with the exception of workflow firing from the tool itself.

Custom workflow In most cases, workflow customizations do not impact the

This workflow bypass on target forms is performed by using filter workflow with goto actions. These filters fire on execution order 0 based on keywords that are received from the data load staging forms. Some custom workflow, however, does impact the data load function. For example, the workflow might be triggered on creation of the record on the form to create other child or dependent records elsewhere.
New customized forms In most cases, new forms do not impact the data load

function. If dependencies are created between a new customized form and data load target forms, however, you must perform additional evaluation.

Making data load work with your customizations

This section contains some detailed steps on how to incorporate your customizations into the Data Management tool. The following topics are provided:
Understanding the staging forms on page 110 Adding custom fields on page 113

Understanding the staging forms

This section describes how the workflow in the data load staging forms is structured. Use this information for customizations of the Data Management tool.
110 Data Management Administration Guide

Making data load work with your customizations

The following topics are provided:

Staging form filters on page 111 Staging form permissions on page 112 Staging form fields on page 112

Staging form filters

You can customize two types of filters. Both types of filters run on modify and only on records that have not been promoted:
Filters that run on validation

The filters that perform the validations are coded in the 200299 execution order range. For fields that must be set for use in validation, the filters with those actions are coded in this range. Validation filters look at the keyword VALIDATE.
Filters that run on promote

The calculation filters that set the fields needed for promotion, and the filters that perform the actual promotion (push to target forms) are coded in the 700 798 execution order range. Promotion filters look at keyword LOAD. Table 2 on page 18 lists the execution order and filter actions for the staging forms. Make customizations only in the 200299 and the 700798 execution order range. Table 22: Execution order and filter actions
Execution order 0 10 - 13 200 - 299 300 500 700 - 798 799 900 Filter actions Skip to execution order 1001 Related to error handling Validation Set data load status to Validated If any field data is changed, set data load status to Unvalidated Calculation, promotion Set data load status to Promoted Delete record

Note

Chapter 5 Managing customizations 111

Making data load work with your customizations

Staging form permissions

Staging forms have Public-Hidden permission. All fields on staging forms have PublicWrite permission.

Staging form fields

Fields on staging forms are grouped in different sections, as indicated in the following figure. Figure 50: Example of a staging form

The first section of the staging form contains fields that provide information about the processing of the staging form. They include fields for ID, data load status, error flag, error code, and error message. These fields are not promoted to the target form. The second section of the staging form contains fields that contain the data being imported. These fields correspond to the columns of data entered on the staging form. These fields are promoted to the target form. The third section of the staging form contains fields that are calculated from data in the second section These fields are read-only; the values are entered only through filter calculations. These fields are promoted to the target form.
112 Data Management Administration Guide

Making data load work with your customizations

The fourth section of the staging form contains system fields. Hidden fields, which are not in the view, are used for temporary calculation by workflow.

Note

Adding custom fields

The following scenario demonstrates the steps to take when a new field is added to a target form and how to incorporate the field into the Data Management tool. To determine the staging form equivalent of the target form into which you are loading data, see How tabs map from spreadsheet to target form on page 221. In this scenario, a new required character field called Employee ID, with field ID 536871147, has been created in the CTM:People form. The requirement is to incorporate this new field into the Data Management tool so that the contents of this field can be loaded at the same time as the other out-of-the-box fields. Filters for this staging form use the Matching IDs feature. Some forms require an additional step, as described in Modifying workflow to promote custom fields on page 114.

Tip

Note

To add the customization

1 Add a new column called Employee ID in the 02 CTM-People tab of the People.xls spreadsheet. The last column on every spreadsheet must be a mandatory field (green), so the new column must be added somewhere before the last column. This spreadsheet is installed with the Data Management tool. You can use this column to populate and load the contents of the custom field at the same time as the other People records. 2 Update the CTM-People.arm file. This file is located in the ITSMDataManagementInstallDir\7.6\Mappings directory. Update the file by adding the following line: Mapping:
$536871147$="Employee ID"

WARNING

Chapter 5 Managing customizations 113

Making data load work with your customizations

This mapping is required for importing the modified spreadsheet into the staging form. 3 Re-create an exact copy of this field in the CTM:LoadPeople staging form. The field must exist on the staging form, so that it can accept the new customized field. After this step, you can load new People records that contain the customized Employee ID column. For some forms, however, you must first modify the filter on the staging form before you can promote the data. For more information, see Modifying workflow to promote custom fields on page 114.

Modifying workflow to promote custom fields

For most forms, you do not need to modify the workflow for the promotion of data from the staging form to the target form. In the Employee ID example, the filters use the Matching IDs feature, so no modification is needed. For some forms, however, you must modify the workflow. If you add fields to a form that does not use this feature, such as the FIN:LoadCostCenterUDAAssoc form, you must: 1 Copy the new fields from the target form to the staging form. 2 In the Push Field action, select the new fields in the Field and Value fields. The staging versions of these target forms do not use the Matching IDs feature, and require the workflow modification for custom fields:
FIN:CostCenterUDAAssoc Business Time Holidays Business Time Workdays COM:Company Alias All people attributes forms: CTM:People IT Skills CTM:Login ID CTM:People Benefit Info CTM:People Education CTM:People HR Attendance Mgmt 114 Data Management Administration Guide

Making the data wizard work with your customizations

CTM:People HR Time Management CTM:People Travel Profile CTM:People Wallet CTM:People Worklog NTE:CFG-Notification Events PBM:Problem Investigation PBM:Solution DB Alias

Modifying workflow to promote custom fields

To modify workflow to promote custom fields
1 Copy the new field from the target form to the staging form. 2 View the filters on the staging form. 3 Open the filter that pushes to the target form. This filter is in the 700799 range. For example, on the FIN:LoadCostCenterUDAAssoc form, the filter is called FIN:DCU:CreatCostCenterUDA_750_FIN! 4 On the If Action tab, in the fields area, choose the Name and choose Value => Field. The Name indicates the field name on the target form. Choose Value => Field to select the field name on the staging form. These two fields might be the same field name. 5 Save your changes.

Making the data wizard work with your customizations

If you have new forms or if you have added foundation data fields to BMC Remedy ITSM forms, you can modify the data wizard to work with these customizations. The following topics are provided:
Chapter 5 Managing customizations 115

Making the data wizard work with your customizations

Data wizard architecture overview on page 116 on Data wizard architecture

overview on page 116

Modifying the data wizard to work with new forms on page 118 Modifying the data wizard to work with new fields on BMC Remedy ITSM forms

on page 123

Data wizard architecture overview

This section provides a high-level overview of the data wizard architecture. You modify two forms to make the data wizard work with your customizations: DLD:SYS:DataWizardProductStatus and DLD:SYS:Data WizAction. The numbers indicate the sequence of steps that occur when you perform a count or modify from the Data Wizard Console. Figure 51: High-level architecture overview

Table 23 on page 116 describes the forms and plugins included or touched by the data wizard.
Table 23: Forms and plugins included or touched by the data wizard Form or plugin Data Wizard Console (DLD:DataWizardConsole form) Customize? No Description Console from which the user runs the data wizard.

116 Data Management Administration Guide

Making the data wizard work with your customizations

Form or plugin DLD:SYS:DataWizAction form

Customize? Yes

Description The core of the data wizard. All filters containing count or update SQL statements reside on this form. These filters run in different guides, based on the action and type of data. These SQL statements look at T tables and C columns. A join of data in the SHARE:Application_Properties form and the DLD:SYS:DataWizardProductStatus form. To make the data wizard work with new forms you add data to the DLD:SYS:DataWizardProductStatus form. The DLD:SYS:DataWizardProductStatus form contains the data displayed in the Status window when an action runs. Each record contains the application ID, data administration type, and target object. The target object is the form name displayed by the Status window. On this form, do not delete any record installed with the data wizard. Contains a record of each count or update of each form for audit Updates the Status window to indicate whether a count or update is in progress or complete.

DLD:SYS:DataWizardProducts form

Yes, but only if adding new forms to be updated by the data wizard

DLD:SYS:DataWizardAudit form DLD:SYS:DataWizardStatus form Target form DLD:Lock form

No No

Not applicable Counted or updated by the data wizard. No Prevents the data wizard from running a count or update while another count or update is in progress.

CAI plugins

Not applicable Breaks the workflow from the user interface, which releases control to the user.

When the user performs a count or update, the data wizard performs the following steps: 1 The user completes the information about the Data Wizard Console and clicks Go. 2 The data wizard uses the DLD:SYS:DataWizAction form to create a new record in the DLD:Lock form. 3 The DLD:SYS:DataWizAction form pushes to the CAI plugin, which releases console control back to the user. 4 The CAI plugin continues to run filter actions on the DLD:SYS:DataWizAction form. 5 The DLD:SYS:DataWizAction form copies the list of forms from the DLD:SYS:DataWizardProducts form.

Chapter 5 Managing customizations 117

Making the data wizard work with your customizations

6 The DLD:SYS:DataWizAction form updates the status on the DLD:SYS:DataWizardStatus form to In progress. 7 The DLD:SYS:DataWizAction form counts and updates target forms. 8 The DLD:SYS:DataWizAction form gets the number of records to be updated (only for a count). 9 For each form that contains one or more fields of the data administration type, the DLD:SYSDataWizAction form creates a record on the DLD:SYS:DataWizAudit form. 10 The DLD:SYS:DataWizAction form updates the status on the DLD:SYS:DataWizardStatus form to Completed. 11 The DLD:SYSDataWizAction form deletes the record from the DLD:Lock form. The filter actions in Table 24 on page 118 control the data wizard.
Table 24: Filter actions for the data wizard Execution order range 0 - 149 150 200 - 499 500 - 849 850 900 Filter actions Validation. Check and create a DLD:Lock record Push to CAI plugin Perform count Perform update Related to updating categorizations Deletes the DLD:Lock record Range to customize None None 400 - 499 700 - 799 None None

Modifying the data wizard to work with new forms

To modify the data wizard to work with a new form, you must:
Add a record to the DLD:SYS:DataWizardProductStatus form to indicate the new

form.

Add filters to the DLD:SYS:DataWizAction form to perform all the steps required

for both the count and update actions.

Throughout this chapter, newFieldIDCustom refers to the customized new field and not the new value field from the console.

Note

118 Data Management Administration Guide

Making the data wizard work with your customizations

To modify the data wizard to work with new forms

1 Choose Start => Programs => BMC Software => AR System => BMC Remedy User and log on. 2 In BMC Remedy User, open DLD:SYS:DataWizardProductStatus. Figure 52: Example of a record in the DLD:SYS:DataWizardProductStatus form

3 Create a record for each new form and complete the fields, as indicated in Table 25 on page 119. If a group of forms belongs to the same application and contains fields of the same data type, you can create a single record for the group of forms. If a form contains multiple fields of different data types, you must create a record for each data type. Table 25: Fields on DLD:SYS:DataWizardProductStatus
Field Application ID Data Administration Type Target Object Target Option Description Description Contains the ID of the BMC Remedy AR System application to which the form belongs. This ID is listed on the SHARE:Application_Properties form. The type of data of the field on the form. Select from the types of data that can be updated, such as Company Name. The name of the form or the name of the group of forms. A description of the target object.

Chapter 5 Managing customizations 119

Making the data wizard work with your customizations

Field Estimated Minute/10000 Updated Execution Order Instance ID Level Keyword Level Flag All

Description Not used. Leave this field blank. Use an execution order in the 8001000 range. Other values are reserved for BMC. Automatically generated when you save the form. Leave this field blank. Leave this field blank.

4 Open BMC Remedy Developer Studio. 5 Create the count action filter on the DLD:SYS:DataWizAction form, as described in Details of the count action filter for new forms on page 120. 6 Create the modify action filter on the DLD:SYS:DataWizAction form, as described in Details of modify action filter for new forms on page 122.

Details of the count action filter for new forms

The filter runs on Modify. Specify an execution order within the 400499 range. The filters Run If qualification is the following statement: ( 'z1D Action' =
"STARTDATAWIZCOUNT" ) AND ( 'DataAdministrationType' = "dataType")

The dataType is the data type of the field, such as Company Name. In the count filter, create the actions listed in the following table. The actions must run in the specified sequence. Table 26: Actions for the count action filter
Sequence Action Field on Filter window 1 Set Server Name Fields Read Value for Field From Name Value Value CURRENT TRANSACTION CURRENT TRANSACTION z1D_TargetObject (name of the form that becomes the value specified in Value, which follows) formName where formName is the name of the new form or new group of forms that you specified on DLD:SYS:DataWizardProductStatus. Name (in the preceding row) is set to the value specified here. For example, z1D_FormName in the row above would be set to the formName value specified here.

120 Data Management Administration Guide

Making the data wizard work with your customizations

Sequence Action Field on Filter window 2 3 Call not applicable Guide Set Server Name Fields Read Value for Field From SQL Command Name Value

Value DLD:DAT:SetStatusInProgress serverName SQL SELECT schemaId FROM arschema WHERE name = 'formName ' z1D_FormName (name of the form that becomes the value specified in Value) formName which specifies the value to which Name (in the proceeding row) is set. For example, z1D_FormName in the row above would be set to the formName value specified here. z1D_schemaID (name of the field that becomes the value specified in Value, which follows) "T" + $1$, which specifies the value to which Name (in the preceding row) is set. For example, z1D_schemaID in the row above would be set to "T" + $1$. serverName SQL SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C newFieldIDCustom = '$ targetFieldName $' Note: The exact SELECT SQL command depends on the number of fields of the same date type on the form. Note: newFieldIDCustom is the customized new field and not the new value field from the console.

Name Value

Set Server Name Fields Read Value for Field From SQL Command

Name Value

z1D_RecordCount01 (name of the field that becomes the value specified in Value, which follows) $1$ , which specifies the value to which Name (in the preceding row) is set. For example, z1D_schemaID in the row above would be set to $1$. DLD:DAT:Count_PushToAudit

Call not applicable Guide

Note: If the target object is a group of forms, for each form, repeat the actions from sequence 3 through 5, before you continue with sequence 6. 6 Call not applicable Guide DLD:DAT:SetStatusComplete

Chapter 5 Managing customizations 121

Making the data wizard work with your customizations

Details of modify action filter for new forms

The filter runs on Modify. Specify an execution order within the 700799 range. The filters Run If qualification is the following statement: ( 'z1D Action' =
"STARTDATAWIZUPDATE" ) AND ( 'DataAdministrationType' = "dataType")

The dataType placeholder refers to the data type of the field, such as Company Name. In the count filter, create the actions listed in Table 27 on page 122. The actions must run in the specified sequence. Table 27: Actions for the update action filter
Sequence 1 Action Set Fields Field on Filter window Server Name Read Value for Field From Name Value CURRENT TRANSACTION CURRENT TRANSACTION z1D_TargetObject (name of the form that becomes the value specified in Value, which follows) formName, where formName is the name of the new form or name of the new group of forms that you specified on DLD:SYS:DataWizardProductStatus DLD:DAT:SetStatusInProgress serverName SQL SELECT schemaId FROM arschema WHERE name = ' formName ' z1D_FormName (name of the form that becomes the value specified in Value) formName, which specifies the value to which Name (in the preceding row) is set. For example, z1D_FormName in the row above would be set to the formName value specified here. z1D_schemaID (name of the field that becomes the value specified in Value, which follows) "T" + $1$ , which specifies the value to which Name (in the preceding row) is set. For example, z1D_schemaID in the row above would be set to "T" + $1$.

Value

2 3

Call Guide Set Fields

not applicable Server Name Read Value for Field From SQL Command Name Value

Name

Value

122 Data Management Administration Guide

Making the data wizard work with your customizations

Sequence 4

Action Direct SQL

Field on Filter window Server Name SQL Command

Value serverName UPDATE $z1D_schemaID$ SET C newFieldIDCustom = '$ newFieldNameFromConsole $' WHERE C newFieldIDCustom = '$ targetFieldNameFromConsole $' Note: The exact UPDATE SQL command depends on the number of fields of the same data type on the form.

Set Fields

Server Name Read Value for Field From SQL Command

serverName SQL SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C newFieldIDCustom = '$ newFieldNameFromConsole $' Note: The exact SELECT SQL command depends on the number of fields of the same date type on the form.

Name

z1D_RecordCount02 (name of the field that becomes the value specified in Value, which follows) $1$ , which specifies the value to which Name (in the preceding row) is set. For example, z1D_schemaID in the row above would be set to $1$. DLD:DAT:Update_PushToAudit

Value

Call Guide

not applicable

Note: If the target object is a group of forms, for each form, repeat the actions from sequence 3 through 6, before you continue with sequence 7. 7 Call Guide not applicable DLD:DAT:SetStatusComplete

Modifying the data wizard to work with new fields on BMC Remedy ITSM forms
To modify the data wizard to work with new fields on BMC Remedy ITSM forms, you must modify filters on the DLD:SYS:DataWizAction form. Perform the following procedure for each new field on BMC Remedy ITSM forms.

Chapter 5 Managing customizations 123

Making the data wizard work with your customizations

To modify the data wizard to work with new fields on BMC Remedy ITSM
1 Open BMC Remedy Developer Studio. 2 Search for the filter on the DLD:SYS:DataWizAction form that contains the count action for the form that contains the new field. Use the following information to find the appropriate filter:
Count filters created by BMC are in the execution order 200399 range. Count Filters created by BMC follow a naming convention. They start with

either DLD:DAT:dataAdministrationType_Count or INT:Application:DAT:dataAdministrationType_Count. For example, the count filter for the Company Name field on the HPD:HelpDesk form is named INT:FNDHPD:DAT:CompanyLargeForms_Count_Q. the filter.

Forms that are included in a filter are sometimes listed in the Help Text tab of

3 In the Set Field action that performs the count action, modify the SQL statement to include the new field. The following SQL statement is an example for counting the Company field:
SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000001 = '$Company$' OR CnewFieldIDCustom = '$Company$'

For additional examples of SQL statements, see Examples of SQL statements on page 129. 4 Search for the filter on the DLD:SYS:DataWizAction form that contains the update action for the form that contains the new field.
Update filters created by BMC are in the execution order 500699 range. Update Filters created by BMC follow a naming convention. They start with

either DLD:DAT:dataAdministrationType_Update or INT:Application:DAT:dataAdministrationType_Update. For example, the update filter for the Company Name field on the HPD:HelpDesk form is named INT:FNDHPD:DAT:CompanyLargeForms_Update_Q`!. the filter.

Forms that are included in a filter are sometimes listed in the Help Text tab of

5 In the Set Field action that performs the update action, modify the SQL statement to include the new field.

124 Data Management Administration Guide

Making the data wizard work with your customizations

The following SQL statement is a simple example for updating the Company field:
UPDATE $z1D_schemaID$ SET C1000000001 = '$Company_NewVal$', CnewFieldIDCustom = '$Company_NewVal$' WHERE C1000000001 = '$Company$' OR CnewFieldIDCustom = '$Company$'

The following SQL statement is an example for updating the Company field with a CASE statement. When two or more fields are updated on a form, CASE statements are used to improve performance.
UPDATE $z1D_schemaID$ SET C1000000001 = case C1000000001 when '$Company$' else C1000000001 end, C1000003965 = case C1000003965 when '$Company$' else C1000003965 end, CnewFieldIDCustom = case CnewFieldIDCustom when '$Company_NewVal$' else CnewFieldIDCustom end, WHERE (C1000000001 = '$Company$' OR C1000003965 CnewFieldIDCustom = '$Company$') then '$Company_NewVal$' then '$Company_NewVal$' '$Company$' then = '$Company$' OR

6 A Set Field action after the update action performs a count. Modify the SQL statement in this action to include the new field. The following SQL statement is an example for counting the Company field after the update action:
SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000001 = '$Company_NewVal $' OR CnewFieldIDCustom = '$Company_NewVal$'

Field names of target and new value fields from the Data Wizard Console
When you modify an SQL statement, use the following tables to look up the target value database field name and new value database field name for use in the SQL statement. The Fields IDs for the company target and new value fields table shows the values for a data administration type of Company.

Company

Table 28: Field IDs for the Company target and new value fields
Target value database field name Company Target value field ID 1000000001 New value database field name Company_NewVal New value field ID 303215800

Person name

This section shows the values for a data administration type of Person Name.

Chapter 5 Managing customizations 125

Making the data wizard work with your customizations

Table 29: Field IDs for the Person Name target and new value fields
Target value database field name Company_PersonName Note: This field is required to perform a count or update. The Company_PersonName field, however, is not updated. FirstName_OriVal MiddleName_OriVal LastName_OriVal PersonID Note: This field is required to perform a count or update. The PersonID field, however, is not updated. LoginID_PersonName 301921200 Not applicable Not applicable 303216800 303216700 303216600 301352100 FirstName_NewVal MiddleName_NewVal LastName_NewVal Not applicable 303217400 303217300 303217200 Not applicable Target value field ID 303216100 New value database field name Not applicable New value field ID Not applicable

Login ID

This section lists the values for a data administration type of Login ID.

Table 30: Field IDs for the Login ID target and new value fields
Target value database field name LoginID_OriVal Target value field ID 303219700 New value database field name LoginID_NewVal New value field ID 303219800

Generic categorization

This section lists the values for a data administration type of Generic Categorization.

Table 31: Field IDs for the Generic Categorization target and new value fields
Target value database field name Category Type Note: This field is required to perform a count or update. The Category Type field, however, is not updated. Generic Categorization Tier 1 Generic Categorization Tier 2 Generic Categorization Tier 3 1000000744 1000000745 1000000746 GenericCatTier1_NewVal GenericCatTier2_NewVal GenericCatTier3_NewVal 303221200 303221300 303221400 Target value field ID 1000002257 New value database field name Not applicable New value field ID Not applicable

126 Data Management Administration Guide

Making the data wizard work with your customizations

Operational categorization

This section lists the values for a data administration type of Operational Categorization.

Table 32: Field IDs for the Organization Categorization target and new value fields
Target value database field name Categorization Tier 1 Categorization Tier 2 Categorization Tier 3 Target value field ID 1000000063 1000000064 1000000065 New value database field name OperationalCatTier1_NewVal OperationalCatTier2_NewVal OperationalCatTier3_NewVal New value field ID 303228300 303228400 303228500

Product categorization

This section shows the values for a data administration type of Product Categorization.

Table 33: Field IDs for the Product Categorization target and new value fields
Target value database field name CI Type Note: This field is used as part of search criteria. The CI Type field, however, is neither counted nor updated. Product Categorization Tier 1 Product Categorization Tier 2 Product Categorization Tier 3 Product Name Manufacturer 200000003 200000004 200000005 240001002 240001003 ProductCatTier1_NewVal ProductCatTier2_NewVal ProductCatTier3_NewVal ProductName_NewVal Manufacturer_NewVal 303229400 303229500 303229600 303229700 303229800 Target value field ID 301189500 New value database field name Not applicable New value field ID Not applicable

Product model and version

This section shows the values for a data administration type of Product Model/ Version.

Table 34: Field IDs for the Product Model/Version target and new value fields
Target value database field name ProductCatTier1_MV Note: This field is required to perform a count or update. The ProductCatTier1_MV field, however, is not updated. ProductCatTier2_MV 303231100 Not applicable Not applicable Target value field ID 303231000 New value database field name Not applicable New value field ID Not applicable

Chapter 5 Managing customizations 127

Making the data wizard work with your customizations

Target value database field name ProductCatTier3_MV ProductName_MV Manufacturer_MV Product Model/Version

Target value field ID 303231200 303231400 303231500 240001005

New value database field name Not applicable Not applicable Not applicable ProductMV_NewVal

New value field ID Not applicable Not applicable Not applicable 303221400

Site name

This section shows the values for a data administration type of Site Name.

Table 35: Field IDs for the Site Name target and new value fields
Target value database field name Site Target value field ID 260000001 New value database field name Site_NewVal New value field ID 303232800

Site information

This section shows the values for a data administration type of Site Information.

Table 36: Field IDs for the Product Model/Version target and new value fields
Target value database field name SiteName_SiteInfo Note: This field is required to perform a count or update. The SiteName_SiteInfo field, however, is not updated. Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Not applicable Street_NewVal Country_NewVal StateProvince_NewVal City_NewVal ZipPostalCode_NewVal TimeZone_NewVal 303234000 303234100 303234200 303234300 303234400 303235000 Target value field ID 303233800 New value database field name Not applicable New value field ID Not applicable

Support group

This section shows the values for a data administration type of Support Group.

128 Data Management Administration Guide

Making the data wizard work with your customizations

Table 37: Field IDs for the Support Group target and new value fields
Target value database field name SupportCompany_SGP Note: This field is used as part of search criteria. The SupportCompany_SGP field, however, is neither counted nor updated. Support Organization Support Group Name 1000000014 1000000015 SupportOrganization_NewVal SupportGroupName_NewVal 303235900 303236000 Target value field ID 303215700 New value database field name Not applicable New value field ID Not applicable

Examples of SQL statements

Company
When you modify an SQL statement, look up the example SQL statement for the applicable data administration type in the following sections. The following example is for the count action:
FormCTM:People FilterDLD:DAT:CompanyCTMLargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000001 = '$Company$'

The following example is for the update action:

FormCTM:People FilterDLD:DAT:CompanyCTMLargeForms_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C1000000001 = '$Company_NewVal$' WHERE C1000000001 = '$Company$'

Person name

You must use either the person ID or login ID to count or update the person name. This ID is used in the WHERE clause of the SQL statement. The following example is for the count action when the full name is on the form:
FormCTM:Support Group Association FilterDLD:DAT:PersonNameLargeForms_Count_Q

Chapter 5 Managing customizations 129

Making the data wizard work with your customizations

SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000080 = '$PersonID$'

The following example is for the update action when the full name is on the form:
FormCTM:Support Group Association FilterDLD:DAT:PersonNameLargeForms_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C1000000017 = '$FullName_NewVal$' WHERE C1000000080 = '$PersonID$'

The following example is for the count action when the full name, first name, and last name are on the form:
FormAPR:Approver Lookup FilterDLD:DAT:PersonNameWithLoginIDOther_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000080 = '$PersonID$'

The following example is for the update action when the full name, first name, and last name are on the form:
FormAPR:Approver Lookup FilterDLD:DAT:PersonNameWithLoginIDOther_Count`!_Q SQL statement: UPDATE $z1D_schemaID$ SET
C1000000637 = CASE WHEN (C1000000080 = '$PersonID$') THEN '$FullName_NewVal $' ELSE C1000000637 END, C1000000369 = CASE WHEN (C1000000080 = '$PersonID$') THEN '$FirstName_NewVal$' ELSE C1000000369 END, C1000000367 = CASE WHEN (C1000000080 = '$PersonID$') THEN '$LastName_NewVal $' ELSE C1000000367 END WHERE (C1000000080 = '$PersonID$')

Login ID

The following example is for the count action:

FormCTM:People WorkLog FilterDLD:DAT:LoginIDCTM2_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C2 = '$LoginID_OriVal$' OR C5 = '$LoginID_OriVal$' OR C1000000159 = '$LoginID_OriVal$'

The following example is for the update action:

FormCTM:People WorkLog 130 Data Management Administration Guide

Making the data wizard work with your customizations

FilterDLD:DAT:LoginIDCTM2_Count`!_Q SQL statement:

UPDATE $z1D_schemaID$ SET C2 = CASE C2 WHEN '$LoginID_OriVal$' THEN '$LoginID_NewVal$' ELSE C2 END, C1000000159 = CASE C1000000159 WHEN '$LoginID_OriVal$' THEN '$LoginID_NewVal$' ELSE C1000000159 END, C5 = CASE C5 WHEN '$LoginID_OriVal$' THEN '$LoginID_NewVal$' ELSE C5 END WHERE (C2 = '$LoginID_OriVal$' OR C1000000159 = '$LoginID_OriVal$' OR C5 = '$LoginID_OriVal$')

Generic categorization

To count or update categorizations, you need a filter for each level of categorization on the form. Whether a filter runs depends on which tiers the user specifies on the Data Wizard Console with new values. For example, if Tier 1, 2, and 3 are on the form, then three separate filters are needed to perform the action. One filter contains the SQL statement to count or update for all three tiers. Another filter will act on the first two tiers. Another filter acts on just the first tier. On the Data Wizard Console, if the user specifies all three tiers with new values, all three filters run. If the user specifies a new values for only Tier 1, only the filter containing Tier 1 runs. If only Tier 1 and 2 are on the form, you need only two filters. Category type is used in the SQL statements. If the category type is always the same for categorization, omit this field from the SQL statement. Otherwise, hard code the value in the SQL statement. The following example is for the count action when all three tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:GenCatTier3LargeForms_Count_Q SQL statement:
SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000744 = '$Generic Categorization Tier 1$' AND C1000000745 = '$Generic Categorization Tier 2$' AND C1000000746 = '$Generic Categorization Tier 3$' AND C1000002257 = '$Category Type$'

The following example is for the update action when all three tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:GenCatTier3LargeForms_Update`!_Q SQL statement:
UPDATE $z1D_schemaID$ SET C1000000744 = '$GenericCatTier1_NewVal$', C1000000745 = '$GenericCatTier2_NewVal$', C1000000746 = '$GenericCatTier3_NewVal$' WHERE C1000000744 =

Chapter 5 Managing customizations 131

Making the data wizard work with your customizations

'$Generic Categorization Tier 1$' AND C1000000745 = '$Generic Categorization Tier 2$' AND C1000000746 = '$Generic Categorization Tier 3$' AND C1000002257 = '$Category Type$'

The following example is for the count action when the first two tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:GenCatTier2LargeForms_Count_Q SQL statement:
SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000744 = '$Generic Categorization Tier 1$' AND C1000000745 = '$Generic Categorization Tier 2$' AND C1000002257 = '$Category Type$'

The following example is for the update action when the first two tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:GenCatTier2LargeForms_Update`!_Q SQL statement:
UPDATE $z1D_schemaID$ SET C1000000744 = '$GenericCatTier1_NewVal$', C1000000745 = '$GenericCatTier2_NewVal$' WHERE C1000000744 = '$Generic Categorization Tier 1$' AND C1000000745 = '$Generic Categorization Tier 2$' AND C1000002257 = '$Category Type$'

Operational categorization

Like generic categorization, operational categorization has multiple tiers of categorization that require multiple filters. The following example is for the count action when two tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:OperCatTier2LargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000063 = '$Categorization Tier 1$' AND C1000000064 = '$Categorization Tier 2$'

The following example is for the update action when two tiers are on the form:
FormCFG:GenericProdServiceAssoc FilterDLD:DAT:OperCatTier2LargeForms_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C1000000063 = '$OperationalCatTier1_NewVal$', C1000000064 = '$OperationalCatTier2_NewVal$' WHERE C1000000063 = 132 Data Management Administration Guide

Making the data wizard work with your customizations

'$Categorization Tier 1$' AND C1000000064 = '$Categorization Tier 2$'

The following example is for the count action for tier 1:

FormCFG:GenericProdServiceAssoc FilterDLD:DAT:OperCatTier1LargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000063 = '$Categorization Tier 1$'

The following example is for the update action for tier 1:

FormCFG:GenericProdServiceAssoc FilterDLD:DAT:OperCatTier1LargeForms_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C1000000063 = '$OperationalCatTier1_NewVal$' WHERE C1000000063 = '$Categorization Tier 1$'

Product categorization

Like generic categorization, product categorization has multiple tiers of categorization that require multiple filters. The following example is for the count action for all three tiers:
FormCFG:Group Event Mapping FilterDAT:ProdCatAllTiersOther1_Count_Q SQL statement:
SELECT COUNT(C1) FROM $z1D_schemaID$ WHERE (C200000003 = '$Product Categorization Tier 1$' AND C200000004 = '$Product Categorization Tier 2$' AND C200000005 = '$Product Categorization Tier 3$' AND C240001002 = '$Product Name$' AND C240001003 = '$Manufacturer$')

The following example is for the update action for all three tiers:
FormCFG:Group Event Mapping FilterDLD:DAT:ProdCatAllTiersOther4_Update`!_Q SQL statement:
UPDATE $z1D_schemaID$ SET C200000003 = '$ProductCatTier1_NewVal$', C200000004 = '$ProductCatTier2_NewVal$', C200000005 = '$ProductCatTier3_NewVal$', C240001002 = '$ProductName_NewVal$', C240001003 = '$Manufacturer_NewVal$' WHERE C200000003 = '$Product Categorization Tier 1$' AND C200000004 = '$Product Categorization Tier 2$'

Chapter 5 Managing customizations 133

Making the data wizard work with your customizations

AND C200000005 = '$Product Categorization Tier 3$' AND C240001002 = '$Product Name$' AND C240001003 = '$Manufacturer$'

Product model and version

The Product Name, Manufacturer, and Product Model/Version fields are referenced in the WHERE clause of the SQL statement. The following example is for the count action:
FormCFG:Group Event Mapping FilterDLD:DAT:ProdMVOther_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE (C240001002 = '$ProductName_MV$' AND C240001003 = '$Manufacturer_MV $' AND C240001005 = '$Product Model/Version$')

The following example is for the update action:

FormCFG:Group Event Mapping FilterDLD:DAT:ProdMVPCTCFG_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C240001005 = '$ProductMV_NewVal$' WHERE C240001002 = '$ProductName_MV$' AND C240001003 = '$Manufacturer_MV$' AND C240001005 = '$Product Model/ Version$'

Site name

The following example is for the count action:

FormCTM:People Template FilterDLD:DAT:SiteOther_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C260000001 = '$Site$'

The following example is for the update action:

FormCTM:People Template FilterDLD:DAT:SiteOther_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C260000001 = '$Site_NewVal $' WHERE C260000001 = '$Site$'

Site information

The Site Name field is referenced in the WHERE clause of the SQL statement The following example is for the count action:

134 Data Management Administration Guide

Making the data wizard work with your customizations

FormSIT:Site FilterDLD:DAT:SiteInfoLargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C260000001 = '$SiteName_SiteInfo$'

The following example is for the update action:

FormSIT:Site FilterDLD:DAT:SiteInfoLargeForms_Update`!_Q SQL statement:
UPDATE $z1D_schemaID$ SET C1000000004 = '$City_NewVal$', C1000000002 = '$Country_NewVal$', C1000000037 = '$Street_NewVal$', C1000000003 = '$StateProvince_NewVal$', C1000000039 = '$ZipPostalCode_NewVal$', C1000000541 = '$TimeZone_NewVal$' WHERE C260000001 = '$SiteName_SiteInfo$'

Support group

To count or update the support group, you might need multiple filters, depending on the number of levels on the form. Whether a filter runs depends on which tiers the user selects on the Data Wizard Console. For example, if Support Organization and Support Group are on the form, then you need two filters to perform the action. One filter will have the SQL statements to count and update for Support Organization and Support Group; the other filter acts on only the Support Organization. If all tiers are filled in for the new value on the console, both filters run. If only Support Organization is filled in, only the filter containing Support Organization runs. The following example is for the count action for both the Support Organization and Support Group fields:
FormCTM:People Permission Groups FilterDLD:DAT:SGPAllLargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000001 = '$SupportCompany_SGP$' AND C301363000 = '$Support Organization$' AND C301363100 = '$Support Group Name$'

The following example is for the update action for both the Support Organization and Support Group fields:
FormCTM:People Permission Groups FilterDLD:DAT:SGPAllLargeForms_Update`!_Q

Chapter 5 Managing customizations 135

Making the data wizard work with your customizations

SQL statement:
UPDATE $z1D_schemaID$ SET C301363000 = '$SupportOrganization_NewVal$', C301363100 = '$SupportGroupName_NewVal$' WHERE C1000000001 = '$SupportCompany_SGP$' AND C301363000 = '$Support Organization$' AND C301363100 = '$Support Group Name$'

The following example is for the count action for the Support Group field only:
FormCTM:People Permission Groups FilterDLD:DAT:SGPOrgLargeForms_Count_Q SQL statementSELECT COUNT(C1) FROM $z1D_schemaID$ WHERE C1000000001 = '$SupportCompany_SGP$' AND C301363000 = '$Support Organization$'

The following example is for the update action for the Support Group field only:
FormCTM:People Permission Groups FilterDLD:DAT:SGPOrgLargeForms_Update`!_Q SQL statementUPDATE $z1D_schemaID$ SET C301363000 = '$SupportOrganization_NewVal$' WHERE C1000000001 = '$SupportCompany_SGP$' AND C301363000 = '$Support Organization$'

136 Data Management Administration Guide

A
Data load staging forms dependencies
The following tables show the dependencies between the data load staging forms.

Foundation staging forms

Parent form CFG:LoadGenericCatalog CFG:LoadGenericProdSerAssoc CFG:LoadServiceCatalog Dependent forms CFG:LoadGenericCpyModuleAssoc CFG:LoadGenericCpyModuleAssoc CTM:LoadPeopleAttributes CFG:LoadServiceCatalogAssoc CFG:LoadGenericCpyModuleAssoc CTM:LoadPeopleAttributes COM:LoadCompany COM:LoadCompanyAlias CTM:LoadRegion SIT:LoadSiteGroup SIT:LoadSiteCompanyAssoc CTM:LoadPeopleOrganization CTM:LoadSupportGroup FIN:LoadConfigCostCentersRep CTM:LoadPeopleTemplate CTM:LoadPeople CTM:LoadPeoplePermissionGroups PCT:LoadProductCatalog PCT:LoadProdComAssoc CFG:LoadServiceCatalogAssoc CFG:LoadGenericCpyModuleAssoc

Appendix A Data load staging forms dependencies 137

Parent form CTM:LoadPeople

Dependent forms CTM:LoadPeoplePermissionGroups CTM:LoadSupportGroupAssociation CTM:LoadSupportGroupFunctionalRole CTM:LoadPeopleWorkLog NTE:LoadCFGNotificationEvents FIN:LoadCostCenterUDAAssoc CTM:LoadPeopleAttributes

CTM:LoadPeopleOrganization CTM:LoadPeopleTemplate

CTM:LoadPeopleTemplate CTM:LoadPeople CTM:LoadPeopleTemplateSG CTM:LoadPeopleTemplatePG CTM:LoadPeopleTemplateSFR CTM:LoadPeople FIN:LoadCostCenterUDAAssoc CTM:LoadPeopleModification

CTM:LoadPeopleTemplatePG CTM:LoadPeopleTemplateSG

CTM:LoadPeoplePermissionGroups CTM:LoadPeopleTemplateSFR CTM:LoadSupportGroupAssociation CTM:LoadSupportGroupFunctionalRole

CTM:LoadPostalCodes CTM:LoadRegion CTM:LoadSupportGroup

Not applicable. SIT:LoadSiteGroup SIT:LoadSiteCompanyAssoc CTM:LoadSupportGroupAlias CTM:LoadSGPAssignments CFG:LoadBusinessTimeWorkdays CFG:LoadBusinessTimeHolidays CTM:LoadSGPOnCall CTM:LoadPeopleTemplateSG CTM:LoadPeopleTemplateSFR CTM:LoadSupportGroupAssocation CTM:LoadSupportGroupFunctionalRole

CTM:LoadSupportGroupAssociation FIN:LoadConfigCostCentersRep NTE:LoadCFGPagerServIceConfig PCT:LoadProdModelVersion 138 Data Management Administration Guide

CTM:LoadSupportGroupFunctionalRole FIN:LoadCostCenterUDAAssoc CTM:LoadPeople CTM:LoadSGPOnCall CTM:LoadPeople PCT:LoadModelVersionPatch

Parent form PCT:LoadProductCatalog

Dependent forms PCT:LoadProductAlias PCT:LoadProdModelVersion PCT:LoadProdCatAliasMapping PCT:LoadProdComAssoc CFG:LoadGenericCpyModuleAssoc CTM:LoadPeopleAttributes

People PeopleAttribute SIT:LoadSite

People (parent for itself) PeopleAttribute (parent for itself) SIT:LoadSiteAlias SIT:LoadSiteCompanyAssoc CTM:LoadPeopleTemplate CTM:LoadPeople

SIT:LoadSiteCompanyAssoc SIT:LoadSiteGroup

CTM:LoadPeopleTemplate CTM:LoadPeople SIT:LoadSiteCompanyAssoc

Process Setup staging forms

Parent form APR:LoadAlternate APR:LoadApproverLookup CFG:LoadAssignment CFG:LoadDecisionTree CFG:LoadScripts CHG:LoadTemplate Dependent forms Not applicable. Not applicable. Not applicable. CFG:LoadDecisionTreeBranch CFG:LoadGroupEventMapping CTM:LoadDecisionTreeBranch CHG:LoadTemplateAssociations CHG:LoadTemplateSPGAssoc TMS:LoadAssociationTemplate HPD:LoadTemplate RQC:LoadSummaryDefinition TMS:LoadAssociationTemplate TMS:LoadAssignmentConfig TMS:LoadTaskGroupTemplate HPD:LoadTemplateAssociations HPD:LoadTemplateSPGAssoc Not applicable. TMS:LoadFlowTemplate Not applicable. TMS:LoadAssociationTemplate TMS:LoadFlowTemplate

Appendix A Data load staging forms dependencies 139

Parent form TMS:LoadTaskTemplate

Dependent forms TMS:LoadAssociationTemplate

Transaction staging forms

Parent form APR:LoadSignature AST:LoadAssetPeople AST:LoadBMC_BaseRelationship AST:LoadLicenseCertificates AST:LoadWorkLog CFG:LoadBroadcast CHG:LoadInfrastructureChange Dependent forms CHG:LoadInfrastructureChange Not applicable. Not applicable. AST:LoadLicenseCertificateProductAssociation CTR:LoadContract_Relationship Not applicable. CFG:LoadBroadcastSPGAssoc CHG:LoadWorkLog CHG:LoadImpactedAreas APR:LoadSignature TMS:LoadTaskGroup TMS:LoadTask CFG:LoadReminders CFG:LoadBroadcast SHR:LoadAssociations FIN:LoadCosts CTR:LoadContractBase CTR:LoadWorkLog CTR:LoadContract_Relationship FIN:LoadPayments FIN:LoadCosts HPD:LoadHelpDesk HPD:LoadWorkLog HPD:LoadImpactedAreas TMS:LoadTaskGroup TMS:LoadTask CFG:LoadBroadcast CFG:LoadReminders SHR:LoadAssociations FIN:LoadCosts

140 Data Management Administration Guide

Parent form PBM:LoadKnownError

Dependent forms PBM:LoadKnownErrorWorkLog TMS:LoadTask CFG:LoadReminders SHR:LoadAssociations FIN:LoadCosts

PBM:LoadProblemInvestigation

PBM:LoadInvestigationWorkLog PBM:LoadImpactedAreas TMS:LoadTask CFG:LoadReminders CFG:LoadBroadcast SHR:LoadAssociations FIN:LoadCosts

PBM:LoadSolutionDatabase

PBM:LoadSolutionDBAlias PBM:LoadSolutionWorklog PBM:LoadSolutionDBAdditionalMappings TMS:LoadTask CFG:LoadReminders SHR:LoadAssociations FIN:LoadCosts

TMS:LoadTask TMS:LoadTaskGroup

TMS:LoadTaskGroup TMS:LoadTask TMS:LoadWorkInfo

Appendix A Data load staging forms dependencies 141

142 Data Management Administration Guide

B
Error messages
This appendix lists error codes from the dataload process.

Errors for invalid data

The Error codes from invalid data table lists error codes from invalid data that is identified during the validation operation on records in staging forms. Table 38: Error codes from invalid data
Code 100 101 102 103 104 105 106 107 108 Message Invalid Bargaining Unit Invalid Benefit Group Invalid Compensation Method Invalid Dental Plan Invalid Employment Status Invalid Marital Status Invalid Medical Plan Invalid Pension Plan Invalid Person Explanation The bargaining unit value is not valid. Select the appropriate value. The benefit group value is not valid. Select the appropriate value. The compensation group value is not valid. Select the appropriate value. The dental plan value is not valid. Select the appropriate value. The employment status value is not valid. Select the appropriate value. The marital status value is not valid. Select the appropriate value. The medical plan value is not valid. Select the appropriate value. The pension plan value is not valid. Select the appropriate value. The person ID value must match a person ID either in the CTM:LoadPeople form or in the CTM:People form. Correct the person ID on this form or on the CTM:LoadPeople form.

Appendix B Error messages 143

Errors for invalid data

Code 109

Message Invalid Operational Category fields for IT skills Invalid Product Category fields for IT skills Invalid category or type Invalid Contact Type Invalid Home Country Invalid Manager

Explanation One or more of the operational category values is not valid. You can obtain correct values from the CFG:Service Catalog form. One or more of the product category tier values is not valid. You can obtain correct values from the PCT:Product Catalog form. The category and type values must match values in the CFG:Generic Catalog form. The contact type value is not valid. Select the appropriate value. The home country is not valid. Select the appropriate value. The managers login ID must match a login ID in the CTM:People form. If you do not know the managers login ID, you can search the CTM:People form on another field, such as last name. The pager service provider is not valid. Select the appropriate value. The template name must match a template name either in the CTM:LoadPeopleTemplate form or in the CTM:PeopleTemplate form. Correct the template name on this form or on the CTM:LoadPeopleTemplate form. The title value is not valid. Select the appropriate value. The company value is not valid. Select the appropriate value. The department value is not valid. Select the appropriate value. The organization value is not valid. Select the appropriate value. The site value is not valid. Select the appropriate value. The selected company does not include the specified site. If the company is correct, select the appropriate site. Otherwise, select the appropriate company, and then select the appropriate site. The support group value is not valid. Select the appropriate value. The permission group is not valid. For a list of valid permission groups, see Permission groups on page 207.

110

111 112 113 114

115 116

Invalid Pager Service Provider Invalid Template

117 118 119 120 121 122

Invalid Title Invalid Company Invalid Department Invalid Organization Invalid Site Invalid Site for selected Company

123 124

Invalid Support Group Invalid Permission Group

144 Data Management Administration Guide

Errors for invalid data

Code 125 126 127 128 129 130 131

Message Invalid Country Invalid Region Invalid Site Group Invalid City Assignment Group cannot be the same as the Support Group Invalid Assignment Group Invalid Functional Role

Explanation The country value is not valid. Select the appropriate value. The region value is not valid. Select the appropriate value. The site group value is not valid. Select the appropriate value. The city value is not valid. Select the appropriate value. Change either the Assignment Group or Support Group to make them different. The assignment group value is not valid. Select the appropriate value. The functional role that is selected is not valid or is not applicable to your currently installed applications. The product catalog value is not valid. Select the appropriate value. The product model / version value is not valid. Select the appropriate value. The operational catalog value is not valid. Select the appropriate value. Manufacturer must match entries found in the Company form or Company staging form with a company type of Manufacturer. Either enter both a Start Time and End Time or leave them both blank. Enter a Start Time that is before the End Time. Either change the Start Time of the next schedule to a time that is later than the End Time of the previous schedule or change the End Time of the previous schedule that is earlier than the Start Time of the next schedule. The time zone is not valid. For a list of valid time zones, see Time zones on page 218. The primary cost center code is not valid. Select the appropriate value. The cost center code is not valid. Select the appropriate value.

132 133 134 135

Invalid Product Catalog Invalid Product Model/Version Invalid Operational Catalog Invalid Manufacturer

136 137 138

Both Start And End Times Must Be Entered Or Left Blank Start Time Must Be Earlier Than End Time Start Time Of The Next Schedule Must Be Later Than The End Time Of The Previous Schedule

139 140 141

Invalid time zone Invalid Primary Cost Center Code Invalid Cost Center

Appendix B Error messages 145

Errors for invalid data

Code 142 143 144 145 146

Message Invalid Source Cost Center Person Does Not Have A Primary Cost Center Defined Total Distribution Percentage Is Greater Than 100 Cost Center And Source Cost Center Must Not Be The Same The allocation method for the source cost center in the Finance Cost Center Configuration form is not set to 'Equal Distribution' or 'User-Defined Percentage' Relationship Type Must Be Set To Secondary Cost Center Invalid Notification Event For The Module Name Invalid Login ID Invalid CI Type Invalid Company or Company is not enabled Support Group must exist as a valid Support Group on CTM:LoadPeopleTemplatesSG for the specified Template

Explanation The source cost center code is not valid. Select the appropriate value. Define the primary cost center on the Financials tab of the People form. Change the percentages so that the Total Distribution Percentage is less than 100. Either change the cost center or the source cost center to make them different. Set the source cost centers allocation method in the Finance Cost Center Configuration form to either Equal Distribution or User-Defined Percentage.

147 148 149 150 151

Set the Relationship Type to Secondary Cost Center. The notification event value is not valid for the module named. Select the appropriate value. The Login ID is not valid. Select the appropriate value. The CI type value is not valid. Select the appropriate value. The company value is either not valid or it is not enabled. Either select the appropriate value or assign the Enabled attribute. Either add the support group to match one that has been defined as a valid support group for the specified Template on the CTM:LoadPeopleTemplatesSG form, or correct the referenced support group to match one that has been properly defined. HR Time Management is a child record for HR Attendance Management. The HR Attendance Management record must exist already or be included in the HR Attendance Management attribute load for the HR Time Management record to load successfully.

152

153

HR Attendance Management record does not exist for the HR Time Management record

154

Invalid work time. Open Time must be Make the work time valid either by making the earlier than Close Time for any workday. open time prior to the close time or making the close time later than the open time. Invalid Person ID The person ID value is not valid. Select the appropriate value.

155

146 Data Management Administration Guide

Errors for invalid data

Code 156

Message

Explanation

The Allocation Method For The Source Set the allocation method in the Cost Center In the FIN:LoadConfigCostCentersRep form to either FIN:LoadConfigCostCentersRep Form Is Equal Distribution or User-Defined Percentage. Not Set To 'Equal Distribution' Or 'UserDefined Percentage' Invalid Manager Name Invalid Generic Catalog A valid Generic Product Operational relationship record cannot be found The manager name value is not valid. Select the appropriate value. The generic catalog value is not valid. Select the appropriate value. A valid record that matches the records Generic, Product, and Operational catalog cannot be found in CFG:LoadGenericProdSerAssoc or CFG:GenericProdServiceAssoc forms. You must create a relationship first between those catalog entries before creating a Company Module relationship to it. Delete the general access from the form.

157 158 159

160

General Access is automatically given and is not a valid permission group for this form Asset Viewer is automatically given

161

If the following permission groups are specified for the Template Name, Asset Viewer is not valid since it is automatically given: Task Manager Task User Incident User Incident Master Problem User Problem Master Infrastructure Change User Infrastructure Change Master Infrastructure Change Config Purchasing User

Appendix B Error messages 147

Errors for invalid data

Code 162

Message Invalid Client Type

Explanation The following client types are valid. You can use either the number or words to specify the client type: 2000 or Office-Based Employee 3000 or Field-Based Employee 4000 or Home-Based Employee 5000 or Contractor 7000 or Customer 8000 or Prospect 10000 or Vendor

163 164

Invalid Assignment Event Invalid Company, Region, Site Group and Site combination Invalid Process Name Invalid Contact Company Invalid Currency Invalid Approval Phase Company and Phase Name combination Invalid Company (IA)

The assignment event value is not valid. Select the appropriate value. The combination of the company, region, site group, and site values is not valid. Select the appropriate combination of values. The process name value is not valid. Select the appropriate value. The specified contact company is not a valid company value. Select the appropriate value. The currency value is not valid. Select the appropriate value. The combination of approval phase company and phase name values is not valid. Select the appropriate combination of values. IA stands for Impacted Area. Impacted Area is a child form containing organizational structures, such as Company > Region > Site or Group > Site > Organization > Department. Impacted areas can be created from incidents, changes, and assets. The company specified for the impacted area is not a valid company value. Select the appropriate value.

165 166 167 168

169

170

Invalid Region (IA) for selected Company (IA)

The region value is not valid for the selected company. Select an appropriate region for the selected company.

148 Data Management Administration Guide

Errors for invalid data

Code 171

Message Invalid Site Group (IA) for selected Company (IA) Invalid Site (IA) for selected Company (IA) Invalid Company (IA), Organization (IA) and Department (IA) combination Invalid Requester Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Invalid Requester Group Invalid Change Manager Group combination (Company is required when Organization is present, and Organization is required when group is entered) Invalid Change Manager Group Invalid Change Implementer Group combination (Company is required when Organization is present, and Organization is required when group is entered) Invalid Change Implementer Group Invalid Change Coordinator Group combination (Company is required when Organization is present, and Organization is required when group is entered) Invalid Change Coordinator Group Invalid Alternate Login ID Invalid For Login ID Invalid Process

Explanation The site group is not valid for the selected company. Select an appropriate site group for the selected company. The site is not valid for the selected company. Select an appropriate site for the selected company. The company, organization, and department combination is not valid. Select the appropriate combination of values. The requestor group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The requestor group is not valid. Select the appropriate value. The change manager group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The change manager group is not valid. Select the appropriate value. The change Implementer group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The change Implementer group value is not valid. Select the appropriate value. The change coordinator group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The change coordinator group value is not valid. Select the appropriate value. The alternate login ID value is not valid. Select the appropriate value. The for login ID value is not valid. Select the appropriate value. The process value is not valid. Select the appropriate value.

172 173

174

175 176

177 178

179 180

181 182 183 184

Appendix B Error messages 149

Errors for invalid data

Code 185 186 187 188 189 190

Message Invalid Timing Reason for the Class selected No Configuration Items were found for the selected CI Type No Configuration Items were found for the CI Name entered Company (IA) required when any other IA fields are entered

Explanation The timing reason is not valid for the selected class. Select the appropriate value. Select a CI type that has associated configuration items. Select a CI name that has associated configuration items. Select a value for company or clear the values from the other IA fields.

Invalid Support Group Association Role The support group association role is not valid. Select the appropriate value. Invalid Assignment Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Invalid Assignment Support Group The assignment support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The support group specified for assignment support group is not a valid support group value. Select the appropriate value. The assignee is not valid. Select the appropriate value. The vendor assignment group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The vendor assignment group is not valid. Select the appropriate value. The resolution method is not valid. Select the appropriate value. The script type is not valid. Select the appropriate value.

191

192 193

Invalid Assignee Invalid Vendor Assignment Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Invalid Vendor Assignment Group Invalid Resolution Method Invalid Script Type

194 195 196 197

Invalid Company, Organization and Site The combination of company, organization, and Group combination site is not valid. Select appropriate combination values. Invalid Author Invalid Script Description The Organization Company and Location Company must be the same when creating mapping records for the Incident Management Module The author is not valid. Select the appropriate value. The script description is not valid. Select the appropriate value. Change either the organization company value or the location company value to be the same.

198 199 1000

150 Data Management Administration Guide

Errors for invalid data

Code 1001 1002 1003

Message Invalid Resolution Product Categorization Invalid Resolution Product Model/ Version Resolution Category Tier 1 and 2 are required fields when Resolution Category Tier 3 is entered Resolution Category Tier 1 is a required field when either Resolution Category 2 or 3 is entered Invalid Resolution Categorization Invalid Template Authoring Group Invalid Status Reason for the Status selected Invalid Resolution Cause Invalid Template Authoring Company Invalid CI Relationship Type selected Invalid Incident Relationship Type selected Invalid Relationship Type selected Invalid Locale Invalid Solution Database ID Invalid Known Error ID Invalid Decision Tree Description

Explanation The resolution product categorization is not valid. Select the appropriate value. The resolution product model / version is not valid. Select the appropriate value. Either select values for resolution category tier 1 and tier 2, or clear the value selected for resolution category tier 3. Either select a value for resolution category tier 1, or clear the values selected for resolution category tier 2 and tier 3. The resolution categorization value is not valid. Select the appropriate value. The template authoring group value is not valid. Select the appropriate value. The status reason value is not valid for the selected status. Select the appropriate value. The resolution cause value is not valid. Select the appropriate value. The template authoring company value is not valid. Select the appropriate value. The CI relationship type value is not valid. Select the appropriate value. The incident relationship type value is not valid. Select the appropriate value. The relationship type value is not valid. Select the appropriate value. The locale value is not valid. Select the appropriate value. The solution database ID value is not valid. Select the appropriate value. The known error ID value is not valid. Select the appropriate value. The decision tree description value is not valid. Select the appropriate value.

1004

1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018

Invalid Decision Tree Previous Branch ID The decision tree previous branch ID value is not valid. Select the appropriate value. Invalid Decision Tree Main Branch ID The decision tree main branch ID value is not valid. Select the appropriate value.

Appendix B Error messages 151

Errors for invalid data

Code 1019

Message Decision Tree Branch ID cannot be the same as Decision Tree Main Branch ID

Explanation Either change the decision tree branch ID value or the decision tree main branch ID value to make them different.

1020

Decision Tree Branch ID cannot be the Either change the decision tree branch ID value or same as Decision Tree Previous Branch ID the decision tree previous branch ID value to make them different. No Configuration Items were found for Select a CI name and reconciliation identity the CI Name and Reconciliation Identity combination of values that has associated combination entered configuration items. Invalid Request Identifier Type, BMC Incident Management is not available Invalid Relationship Type selected Use a request ID that is associated with an installed Remedy component. For example, use one that is not associated with Remedy Incident Management. The relationship type value is not valid. Select the appropriate value.

1021

1022

1023 1024

Invalid Request Identifier - To (Request For Invalid Request Identifier - To, replace either Identifier and Request Identifier type do the request identifier or request identifier type so not match) that they match. Invalid Request Identifier - From (Request Identifier and Request Identifier type does not match) Invalid Customer Person ID For Invalid Request Identifier - From, replace either the request identifier or request identifier type so that they match. The customer person ID value is not valid. Select the appropriate value.

1025

1026 1027

More than one record on People has More than one record in the People.xls matched using Customer's Company, spreadsheet has the same value for customer First Name, Middle Name and Last Name company, first name, middle name, and last name. This record is likely a duplicate. Delete duplicate records. Invalid Customer Information Invalid Contact Person ID Invalid Contact Information The customer information value is not valid. Select the appropriate value The contact person ID value is not valid. Select the appropriate value The contact information values are not valid. Select the appropriate value

1028 1029 1030 1031

More than one record on People has More than one record in the People.xls matched using Contact's Company, First spreadsheet has the same value for contact Name, Middle Name and Last Name company, first name, middle name, and last name. This record is likely a duplicate. Delete duplicate records. Invalid Site for selected Customer Company Invalid Site for selected Contact Company The site value is not valid for the selected customer company. Select the appropriate value The site value is not valid for the selected contact company. Select the appropriate value

1032 1033

152 Data Management Administration Guide

Errors for invalid data

Code 1034 1035 1036 1037 1038

Message Invalid Customer Company Invalid Owner Support Group Invalid Owner Invalid Vendor Contact

Explanation The customer company value is not valid. Select the appropriate value The owner support group value is not valid. Select the appropriate value. The owner value is not valid. Select the appropriate value. The vendor contact value is not valid. Select the appropriate value.

More than one record on People has More than one record in the People.xls matched using Vendor's Company, First spreadsheet has the same value for vendors Name, Last Name and Phone Number company, first name, last name, and phone number. This record is likely a duplicate. Delete duplicate records. New is not a valid Status No Default Group was found for the Assignee No Default Group was found for the Owner Invalid Change Request Status Change the New status value to a valid status value. Change the assignee to one which has associated default groups. Change the owner to one which has associated default groups. The status indicates that the change request is in an active approval state so there should be pending approval signatures on the APR:LoadSignature form. However, there are no Pending Approval Signatures. Change the status of the change request to something other than active approval. The incident number value is not valid. Select the appropriate value. There are duplicate assignees with the same support company, support organization, and assigned group. Remove the duplicates.

1039 1040 1041 1042

1043 1044

Invalid Incident Number More than one Assignee was found for the specified Support Company, Support Organization and Assigned Group with the same name

1045

More than one Owner was found for the There are duplicate owners with the same owner specified Owner Support Company, support company, owner support organization, Owner Support Organization and and owner group. Remove the duplicates. Owner Group with the same name More than one Assignee was found with the same name. Try using the Assignee Login ID or the Support Company, Support Organization and Assigned Group fields to narrow the search There are duplicate assignees with the same name. To narrow the search, enter search criteria in the assignee login ID, support company, support organization, assigned group, or any combination of these fields.

1046

Appendix B Error messages 153

Errors for invalid data

Code 1047

Message More than one Owner was found with the same name. Try using the Owner Login ID or the Owner Support Company, Owner Support Organization and Owner Group fields to narrow the search Incident associating From is set as Duplicate - Can not make any Associations to this incident Incident associating From is set as Original - Can not use Relationship Type as Duplicate of for this incident

Explanation There are duplicate owners with the same name. To narrow the search, enter search criteria in the owner login ID, owner support company, owner support organization, owner group, or any combination of these fields. Replace the incident referenced in Incident Associating From with an incident that is not duplicate. Replace the incident referenced in Incident Associating From with an incident that is not original, or change the Relationship Type to a type other than Duplicate.

1048

1049

1050

The process specified indicates that it is The process specified indicates that it is the current the current process for the parent record process for the parent record. Change the status for the parent record so that it is in an active approval state. Invalid Owner Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Incident associating From will be set to Duplicate during promotion - Can not make any further Associations to this incident Incident associating From will be set to Original during promotion - Can not use Relationship Type as Duplicate of for this incident Incident associating To will be set to Original during promotion - Can not use Relationship Type as Original of for this incident Incident associating To will be set to Duplicate during promotion - Can not make any further Associations to this incident Invalid Request ID Invalid Recipient Group Invalid Recipient Person ID The owner support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). Either clear the associations being made to the incident referenced in Incident associating From or replace the incident reference with one that will not become a duplicate during promotion. Either reference an incident in Incident associating From that has a Relationship Type other than Duplicate or replace the incident reference with one that will not be set to original during promotion. Either reference an incident in Incident associating To that has a Relationship Type other than Original or replace the incident reference with one that will not be set to original during promotion. Either clear the associations being made to the incident referenced in Incident associating To or replace the incident reference with one that will not become a duplicate during promotion. The request ID value is not valid. Select the appropriate value. The recipient group value is not valid. Select the appropriate value. The recipient person ID value is not valid. Select the appropriate value.

1051

1052

1053

1054

1055

1056 1057 1058

154 Data Management Administration Guide

Errors for invalid data

Code 1059 1060

Message Invalid Recipient More than one People record matches Recipient

Explanation The recipient value is not valid. Select the appropriate value. More than one records in the TransactionalSharedComponents.xls spreadsheet has the same value in the Recipient column on the CFGReminders tab. Replace the recipient with a more specific name. For example, if you have just included first name, add the last name; if you have both first and last name and it is still is not unique, add a middle initial or name. Change either the request identifier to value or the request identifier from value to make them different. The requestor person value is not valid. Select the appropriate value. The requested for person value is not valid. Select the appropriate value. There are duplicate records with the same Requester in People.xls. Remove the duplicates. There are duplicate records with the same Requester For in People.xls. Remove the duplicates. The requestor support group value is not valid. Select the appropriate value. The requestor person ID value is not valid. Select the appropriate value. The requested for person ID value is not valid. Select the appropriate value. The assignee group value is not valid. Select the appropriate value. Change either the scheduled start date or scheduled end date so that the scheduled start date precedes the scheduled end date. Change either the actual start date or actual end date so that the scheduled start date precedes the scheduled end date. Either change the values in the company or cost center code to make the combination of values valid or set the cost center to active. The cost type value is not valid. Select the appropriate value. The identifier value is not valid. Select the appropriate value. Appendix B Error messages 155

1061 1062 1063 1064 1065

Request Identifier - To and Request Identifier - From cannot be the same Invalid Requester Person Invalid Requested For Person More than one People record matches Requester More than one People record matches Requested For Invalid Requester Support Group Invalid Requester Person ID Invalid Requested For Person ID Invalid Assignee Group Scheduled Start Date cannot be after Scheduled End Date Actual Start Date cannot be after Actual End Date Company and Cost Center Code combination is not valid or Cost Center is not set to Active Invalid Cost Type Invalid Identifier

1066 1067 1068 1069 1070

1071

1072

1073 1074

Errors for invalid data

Code 1075

Message No Default Group was found for the Problem Coordinator Assignee or Problem Coordinator Assignee Login More than one Problem Coordinator (PC) Assignee was found with the same name. Try using the PC Assignee Login or the PC Support Company, PC Support Organization and PC Assigned Group fields to narrow the search Invalid Problem Coordinator Assignee More than one Problem Coordinator (PC) Assignee was found for the specified Coordinator Support Company, Coordinator Support Organization and Coordinator Assigned Group with the same name Invalid Problem Coordinator Assigned Group Problem Coordinator Assignee Login or Problem Coordinator Assignee do not have Problem Coordinator functional role Invalid Vendor Name Invalid Root Cause Invalid Coordinator Support Company Invalid Coordinator Support Organization Invalid Coordinator Support Group Invalid Implementer Support Company Invalid Implementer Support Organization Invalid Implementer Support Group Invalid Association (Can not make associations to Solution Database from Infrastructure Change)

Explanation Provide the default group that is missing from either the problem coordinator assignee or problem coordinator assignee login. There are duplicate problem coordinator (PC) assignees with the same name. To narrow the search, enter search criteria in the PC Assignee Login, PC Support Company, PC Support Organization, PC Assigned Group, or any combination of these fields. The problem coordinator assignee value is not valid. Select the appropriate value. There are duplicate problem coordinator (PC) assignees with the same name. To narrow the search, enter search criteria in the PC Support Company, PC Support Organization, PC Assigned Group, or any combination of these fields. The problem coordinator assigned group value is not valid. Select the appropriate value. Check the Problem Coordinator Functional Role in the Support Groups tab of People form.

1076

1077 1078

1079 1080

1081 1082 1083 1084 1085 1086 1087 1088 1089

The vendor value is not valid. Select the appropriate value. The root cause value is not valid. Select the appropriate value. The coordinator support company value is not valid. Select the appropriate value. The coordinator support organization value is not valid. Select the appropriate value. The coordinator support group value is not valid. Select the appropriate value. The implementer support company value is not valid. Select the appropriate value. The implementer support organization value is not valid. Select the appropriate value. The implementer support group value is not valid. Select the appropriate value. Change the association to one that is valid.

156 Data Management Administration Guide

Errors for invalid data

Code 1090 1091

Message Invalid Requester Company Invalid Request Identifier Type, BMC Problem Management is not available

Explanation The requester company value is not valid. Select the appropriate value. Use a request identifier type that is associated with a Remedy component that is installed. For example, use a request identifier type that is not associated with Remedy Problem Management. Use a request identifier type that is associated with a Remedy component that is installed. For example, use a request identifier type that is not associated with Remedy Change Management. Change the Request Identifier Type - From to one that is valid. The problem investigation location is not valid. Select the appropriate values.

1092

Invalid Request Identifier Type, BMC Change Management is not available

1093

Invalid Request Identifier Type - From (Can not make associations From Solution Database) Invalid Problem Investigation Location Information

1094 1095

The Support Organization and Support The requesters support organization and support Group Name of the Requester is not valid. group name values are not valid. Select the appropriate values. Invalid Problem Assignment Support Group Invalid Problem Coordinator Assignment Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Invalid Problem Assignment Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Invalid Known Error Assignment Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Broadcast Start Date cannot be greater than Broadcast End Date Invalid Broadcast Originated From; BMC Remedy Incident Management is not available The problem assignment support group value is not valid. Select the appropriate value. The problem coordinator assignment support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present).

1096 1097

1098

The problem assignment support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). The known error assignment support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present). Change either the broadcast start date or the broadcast end date so that broadcast start date precedes broadcast end date. The Broadcast Originated From value is not valid. Select a value that does not require Remedy Incident Management to be installed. For example, numbers prefixed by HPD require Remedy Incident Management be installed.

1099

1100

1101

Appendix B Error messages 157

Errors for invalid data

Code 1102

Message Invalid Broadcast Originated From; BMC Remedy Change Management is not available

Explanation The Broadcast Originated From value is not valid. Select a value that does not require Remedy Change Management to be installed. For example, numbers prefixed by CHG require Remedy Change Management be installed. The Broadcast Originated From value is not valid. Select a value that does not require Remedy Problem Management to be installed. For example, numbers prefixed by PBM require Remedy Problem Management be installed. The broadcast originated from ID value does not exist or the originated from record is not correct. Correct either the broadcast originated from ID or the originated from record. The form is not valid. Use the appropriate form. The form is not valid. Use the appropriate form. The form is not valid. Use the appropriate form. The link to request ID value is not valid. Select the appropriate value. The broadcast originated from value entered in the Cost Category column on the FIN-Costs tab of the Transactional-SharedComponents.xls spreadsheet requires Remedy Incident Management be installed and it is not. Enter a value that corresponds with a component you have installed. F or example, enter a value other than Incident. The broadcast originated from value entered in the Cost Category column on the FIN-Costs tab of the Transactional-SharedComponents.xls spreadsheet requires Remedy Change Management be installed and it is not. Enter a value that corresponds with a component you have installed. For example, enter a value other than Infrastructure Change.

1103

Invalid Broadcast Originated From; BMC Remedy Problem Management is not available

1104

Invalid Broadcast Originated From ID; either ID does not exist or Originated From record has error Invalid Form; BMC Remedy Incident Management is not available Invalid Form; BMC Remedy Change Management is not available Invalid Form; BMC Remedy Problem Management is not available Invalid Link to Request ID Invalid Cost Category; BMC Remedy Incident Management is not available

1105 1106 1107 1108 1109

1110

Invalid Cost Category; BMC Remedy Change Management is not available

158 Data Management Administration Guide

Errors for invalid data

Code 1111

Message Invalid Cost Category; BMC Remedy Problem Management is not available

Explanation The broadcast originated from value entered in the Cost Category column on the FIN-Costs tab of the Transactional-SharedComponents.xls spreadsheet requires Remedy Incident Management be installed and it is not. Enter a value that corresponds with a component you have installed. For example, enter a value other than Problem Investigation. The cost category value is not valid. Assign it a value of either Incident, Infrastructure Change, Problem Investigation, Solution, or Known Error.

1112

Invalid Cost Category; Cost Category has to be Incident, Infrastructure Change, Problem Investigation, Solution, or Known Error

1113 1114

Invalid Requested By Support Company The requested by support company value is not valid. Select the appropriate value. No Default Group was found for the Change Manager or Change Manager Login No Default Group was found for the Change Implementer or Change Implementer Login More than one Change Manager Coordinator was found with the same name. Try using the Change Manager Login or the Manager Support Company, Manager Support Organization and Manager Support Group Name to narrow the search More than one Change Implementer was found with the same name. Try using the Change Implementer Login or the Implementer Support Company, Implementer Support Organization and Implementer Support Group Name to narrow the search Invalid Implementer More than one Change Manager was found for the specified Manager Support Company, Manager Support Organization and Manager Support Group Name with the same name Change either the change manager or the change manager login to one that has an associated default group. Change either the change implementer or the change implementer login to one that has an associated default group. There are duplicate change manager coordinators with the same name. To narrow the search, enter search criteria in the Change Manager Login, Change Manager Support Company, Manager Support Organization, Manager Support Group Name, or any combination of these fields. There are change implementers with the same name. To narrow the search, enter search criteria in the Change Implementer Login, Implementer Support Company, Implementer Support Organization, Implementer Support Group, or any combination of these fields. The implementer value is not valid. Select the appropriate value. There are duplicate change managers for the specified manager support company, manager support organization, or manager support group name with the same name. Remove any duplicates.

1115

1116

1117

1118 1119

Appendix B Error messages 159

Errors for invalid data

Code 1120

Message More than one Change Implementer was found for the specified Implementer Support Company, Implementer Support Organization and Implementer Support Group Name with the same name Invalid Change Manager Login Invalid Change Implementer Login Invalid End Time; End Time must be greater than Activate Time Invalid Manager Support Company Invalid Manager Support Organization Invalid Manager Support Group More than one People record matches Requested By Support Company, First Name, Middle Name and Last Name

Explanation There are duplicate change implementers for the specified implementer support company, implementer support organization, or implementer support group name with the same name. Remove any duplicates. The change manager login value is not valid. Select the appropriate value. The change implementer login value is not valid. Select the appropriate value. Either change the end time or the activate time so that the activate time precedes the end time. The manager support company value is not valid. Select the appropriate value. The manager support organization value is not valid. Select the appropriate value. The manager support group value is not valid. Select the appropriate value. There are duplicate records in People.xls with the same Requested By Support Company, First Name, Middle Name, or Last Name. Remove the duplicates.

1121 1122 1123 1124 1125 1126 1127

1128

More than one People record matches There are duplicate records in People.xls with Requested For First Name and Last Name the same Requested For First Name or Last Name. Remove the duplicates. The Requested By First Name and Last Name, or Person ID specified does not have a Login ID. When the Create Request flag is set to Yes, the Customer must have a Login ID Invalid Requested By Support Group combination (Company is required when Organization is present, and Organization is required when Group is entered) Either assign a login ID to the Requested By First Name, Last Name, or Person ID you specified, or assign the Create Request flag a value of No.

1129

1130

The requested by support group combination is not valid. Supply missing values, such as company (if organization is present) and organization (if group is present).

1131

Invalid Scheduled Start Date; Scheduled Change either the scheduled start date or the Start Date comes before the Required required start date so that the scheduled start date Start Date precedes the required start date. Invalid Requested End Date; Requested End Date must be greater than Requested Start Date Change either the requested end date or the requested start date so that the requested start date precedes the requested start date.

1132

160 Data Management Administration Guide

Errors for invalid data

Code 1133

Message Invalid Scheduled End Date; Scheduled End Date must be greater than Scheduled Start Date Invalid Actual End Date; Actual End Date must be greater than Actual Start Date Invalid Login ID in the Individual Approver field

Explanation Change either the scheduled end date or the scheduled start date so that the scheduled start date precedes the scheduled start date. Change either the actual end date or the actual start date so that the actual start date precedes the actual start date. The login ID value specified in the Individual Approver field is not valid. Select the appropriate value.

1134

1135

1136

Only the Individual Approver field or Values exist in fields other than the Individual Group Approver fields can be populated Approver or Group Approver. Clear the other fields of their values. For Group Approvers, the Support Company, Support Organization and Support Group fields are required Invalid Task Group Template ID There are no members in the specified Support Group that have the functional role of Infrastructure Change Approver Invalid Ticket Request ID Invalid Process Invalid Change Request Status Invalid Task Group Identifier. Either Task Group does not exist or Request ID and Request Form Name do not match the Task being loaded. The Level specified is greater than the Max Approval Level for the Process Invalid Breach Reason Invalid Breach Exception Either no support company, support organization, or support group or a combination of these was specified for the group approver. Specify the missing values. The task group template ID value is not valid. Select the appropriate value Replace the specified support group with one that has members assigned to the support group functional role. The ticket request ID value specified is not valid. Select the appropriate value. The process value specified is not valid. Select the appropriate value. Select a valid change request status. The task group identifier value specified is not valid. Either specify a task group that exists or specify a Request ID and Request Form Name that match the task being loaded. Either specify a Level that is less than the Max Approval Level for the Process or change the Max Approval Level that is less than the Level. The breach reason value is not valid. Select the appropriate value. The breach exception value is not valid. Select the appropriate value.

1137

1138 1139

1140 1141 1142 1143

1144

1145 1146 1147

Invalid Scheduled Start Date; Schedule Change either the scheduled start date or the Start Date comes before the Earliest Start earliest start date so that the scheduled start date Date precedes the earliest start date. The Level must be greater than 0 Change the value specified for level so that is greater than zero. Appendix B Error messages 161

1148

Errors for invalid data

Code 1149

Message

Explanation

The parent record must be in an active Assign active approval status to parent record. approval state for the Approval Status to be Pending The parent record must be in an active approval state if the process specified is the current process The parent record must be Rejected if the Approver Status is Rejected Change the parent record to the active approval state.

1150

1151 1152

Assign rejected status to parent record.

If the approval status is set to Rejected Change all of the approval signature records to all other approval signatures for the closed for that change record. same parent record and process must be set to Closed Change Manager or Change Manager Login do not have Change Manager functional role Either assign the Change Manager functional role to the Change Manager or Change Manager Login being specified, or specify a Change Manager or Change Manager Login that has Change Manager functional role assigned. The license type value specified is not valid. Select the appropriate value.

1153

1163 1164

Invalid License Type

Support Group must exist as a valid Either replace the login ID specified or the support Support Group on group to match on that exists on CTM:LoadSupportGroupAssociation for CTM:LoadSupportGroupAssociation. the specified Login ID Invalid Template Identifier for the Template Type selected or Template is not Active Predecessor and Successor with the same Instance ID is not permitted Proposed flow is not permitted as it would cause a loop Select a valid template identifier for the template type selected, or apply the Active attribute to the template. Either change the instance ID of the predecessor or change the instance ID of the successor. A flow have been previously defined that would make this flow recursive. For example, if you previously defined a flow from A to B, you cannot now define a flow from B to A. Only predecessors can be set to Start. The successor value specified is not valid. Select the appropriate value. The predecessor value specified is not valid. Select the appropriate value.

1165

1166 1167

1168 1169 1170 1171

Successor cannot be set to 'Start' Invalid Successor Invalid Predecessor

Invalid Flow; Predecessor and Successor Correct the flow to use predecessors and successors Associations must belong to the same that belong to the same parent. Parent

162 Data Management Administration Guide

Errors for invalid data

Code 1172

Message Parent of Association Template must be set to Type of 'Standard' and Status 'Active'

Explanation Set the association templates parent type to Standard and its status to Active.

1173 1174 1175

Invalid Association (Reverse Association Either discard the current association or correct the exists on Staging form) reverse association on the staging form. Invalid Association (Reverse Association Either discard the current association or correct the exists on Target form) reverse association on the target form. Invalid Association (Template Identifier Either use the same company in the template and Task Group Template Identifier identifier and task group template identifier, or use should have same company or Template - Global - as the template identifier company. Identifier Company should be '- Global -') Invalid Automatic Command Selection Invalid Task Group Template Identifier or Template is not Active Use a valid value in the automatic command selection. Either use a valid task group template identifier, or set the template status to Active.

1176 1177 1178 1179 1180 1181 1182 1183

Invalid Time Out Status Reason Selected Select a valid time out status reason. Invalid Request Form Name Parent Instance ID and Child Instance ID cannot be the same Invalid Parent Instance ID Invalid Child Instance ID Invalid Relationship (CI to CI Relationship is not allowed here) The requestor form name value specified is not valid. Select the appropriate value. Either change the parent instance ID or the child instance ID to make them different. The parent instance ID value specified is not valid. Select the appropriate value. The child instance ID value specified is not valid. Select the appropriate value. You are trying to create a relationship between CIs and that is not allowed. Change one of the CIs specified to a different type.

1184

Invalid Relationship (CI can not be Child) The CI must be the parent in a relationship. Change the parent to make it the CI and change the child to make it something other than CI. License Expiration Date Must Be Later Than The License Effective Date Expiration Date is in the past Invalid Owner Support Company Invalid Notification Group Change either the license expiration date or the license effective date so that the license effective date precedes the license expiration date. Change the Expiration Date so that it is either the current date or a date later than the current date. The Owner Support Company value specified is not valid. Select the appropriate value. The Notification Group value specified is not valid. Select the appropriate value.

1185

1186 1187 1188

Appendix B Error messages 163

Errors for invalid data

Code 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198

Message Invalid Parent Contract ID Invalid Notification Contact Invalid Change Requester Invalid Owner Group Invalid Owner Contact Invalid Authorized Callers Invalid Term Invalid Term Condition The Expiration Date must be later than the Start Date The Notification Date you entered is later than the Expiration Date. Enter a Notification Date that is earlier than the Expiration Date Invalid Parent Identifier for the Parent Type selected Invalid Parent Reconciliation ID Invalid Child Reconciliation ID Invalid Relationship Type Parent Reconciliation ID and Child Reconciliation ID cannot be the same 'Change Request Prev Status' cannot be the same as 'Change Request Status' if Status is Rejected or Pending

Explanation The parent contract ID value specified is not valid. Select the appropriate value. The Notification Contract value specified is not valid. Select the appropriate value. The Change Requester value specified is not valid. Select the appropriate value. The Owner Group value specified is not valid. Select the appropriate value. The Owner Contract value specified is not valid. Select the appropriate value. The Authorized Callers value specified is not valid. Select the appropriate value. The Term value specified is not valid. Select the appropriate value. The Term Condition value specified is not valid. Select the appropriate value. Change either the expiration date or the start date so that the start date precedes the expiration date. Change either the notification date or the expiration date so that the notification date precedes the expiration date. Either change the parent identifier to match the type selected or change the type to match the parent identifier specified. The Parent Reconciliation ID value specified is not valid. Select the appropriate value. The Child Reconciliation ID value specified is not valid. Select the appropriate value. The Relationship Type value specified is not valid. Select the appropriate value. Change either the Parent Reconciliation ID or the Child Reconciliation ID to make them different. Either change the value specified for Change Request Prev Status or Change Request Status to make them different or Change the Status to something other than Rejected or Pending.

1199

1200 1201 1202 1203 1204

1205

Invalid 'Change Req Prev Status Reason' Either change the value selected for Change Req for the 'Change Requested Prev Status' Previous Status Reason or the value selected for selected Changed Requested Prev Status.

164 Data Management Administration Guide

Errors for invalid data

Code 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215

Message Invalid Supplier Name Invalid Request Identifier - To (CI is not a Business Service CI) Invalid Request Identifier - From (CI is not a Business Service CI) Invalid Contract Type The License Type associated with the permission should be Not Applicable The License Type associated with the permission should be Read The License Type associated with the permission should be Fixed The License Type associated with the permission should be Floating

Explanation The Supplier Name value specified is not valid. Select the appropriate value. The Request Identifier - To value specified is not valid. Select the appropriate value. The Request Identifier - From value specified is not valid. Select the appropriate value. Select a valid contract type and retry. Change the license type so it is Not Applicable. Change the license type so it is Read. Change the license type so it is Fixed. Change the license type so it is Floating.

The License Type associated with the Change the license type so it is Fixed or Floating. permission should be Fixed or Floating The License Type associated with the Change the license type so it is Fixed, Floating or permission should be Fixed, Floating or None. None Invalid Payment Code Invalid Payment Period Invalid Categorization Tier 1 Invalid Categorization Tier 2 Invalid Categorization Tier 3 The Payment Code value specified is not valid. Select the appropriate value. The Payment Period value specified is not valid. Select the appropriate value. The Categorization Tier 1 value specified is not valid. Select the appropriate value. The Categorization Tier 2 value specified is not valid. Select the appropriate value. The Categorization Tier 3 value specified is not valid. Select the appropriate value.

1216 1217 1218 1219 1220 1221

CI Type of Relationship' can be 'CI' only Either use a value other than CI for CI Type of if 'Request Identifier Type' is 'Incident', Relationship or change the value specified for 'Known Error' or 'Problem Investigation' Request Identifier Type to one of Incident, Known Error or Problem Investigation. Invalid Service ReconID Invalid CI ReconID The Service Recon ID value specified is not valid. Select the appropriate value. The CI Recon ID value specified is not valid. Select the appropriate value.

1222 1223

Appendix B Error messages 165

Errors for invalid data

Code 1224

Message CI Type of Relationship' can be 'Service CI' only if 'Request Identifier Type' is 'Incident', 'Infrastructure Change', 'Known Error' or 'Problem Investigation' Parent Relationship Type can only be "Configuration Item" or "Contract" Child Relationship Type can only be "Contract" or "License Certificate" Invalid Cost per Asset Currency Invalid Residual Value Currency

Explanation Either use a value other than Service CI for CI Type of Relationship or change the value specified for Request Identifier Type to one of Incident, Infrastructure Change, Known Error or Problem Investigation. Change the value for Parent Relationship Type to Configuration Item or Contract. Change the value for Child Relationship Type to Contract or License Certificate. Correct the value specified for Cost per Asset Currency. Correct the value specified for Residual Value Currency.

1225 1226 1227 1228 1229 1230 1231

Invalid Payment Amount Due Currency Correct the value specified for Payment Amount Due Currency. Invalid Payment Amount Sent Currency Correct the value specified for Payment Amount Sent Currency. Connection Ans 01 must be an integer Either replace the value for Connection Ans 01 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1232

Connection Ans 02 must be an integer

Either replace the value for Connection Ans 02 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1233

Connection Ans 03 must be an integer

Either replace the value for Connection Ans 03 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

166 Data Management Administration Guide

Errors for invalid data

Code 1234

Message Connection Ans 04 must be an integer

Explanation Either replace the value for Connection Ans 04 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1235

Connection Ans 05 must be an integer

Either replace the value for Connection Ans 05 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1236

Connection Ans 06 must be an integer

Either replace the value for Connection Ans 06 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1237

Connection Ans 07 must be an integer

Either replace the value for Connection Ans 07 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1238

Connection Ans 08 must be an integer

Either replace the value for Connection Ans 08 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

Appendix B Error messages 167

Errors for invalid data

Code 1239

Message Connection Ans 09 must be an integer

Explanation Either replace the value for Connection Ans 09 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1240

Connection Ans 10 must be an integer

Either replace the value for Connection Ans 10 with an integer or change the field type to Char on the Build Connection Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1241

Compliance Ans 01 must be an integer

Either replace the value for Compliance Ans 01 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1242

Compliance Ans 02 must be an integer

Either replace the value for Compliance Ans 02 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1243

Compliance Ans 03 must be an integer

Either replace the value for Compliance Ans 03 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

168 Data Management Administration Guide

Errors for invalid data

Code 1244

Message Compliance Ans 04 must be an integer

Explanation Either replace the value for Compliance Ans 04 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1245

Compliance Ans 05 must be an integer

Either replace the value for Compliance Ans 05 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1246

Compliance Ans 06 must be an integer

Either replace the value for Compliance Ans 06 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1247

Compliance Ans 07 must be an integer

Either replace the value for Compliance Ans 07 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1248

Compliance Ans 08 must be an integer

Either replace the value for Compliance Ans 08 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

Appendix B Error messages 169

Errors for invalid data

Code 1249

Message Compliance Ans 09 must be an integer

Explanation Either replace the value for Compliance Ans 09 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1250

Compliance Ans 10 must be an integer

Either replace the value for Compliance Ans 10 with an integer or change the field type to Char on the Build Compliance Questions page of the Create License Type wizard. Note: For more information about configuring license types, see the chapter about asset management in the BMC Remedy IT Service Management Administration Guide.

1251

Connection Ans 01 must be blank since there is no associated question

Either remove the value for Connection Ans 01 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 02 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 03 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 04 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 05 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide.

1252

Connection Ans 02 must be blank since there is no associated question

1253

Connection Ans 03 must be blank since there is no associated question

1254

Connection Ans 04 must be blank since there is no associated question

1255

Connection Ans 05 must be blank since there is no associated question

170 Data Management Administration Guide

Errors for invalid data

Code 1256

Message Connection Ans 06 must be blank since there is no associated question

Explanation Either remove the value for Connection Ans 06 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 07 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 08 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 09 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Connection Ans 10 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 01 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 02 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 03 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 04 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide.

1257

Connection Ans 07 must be blank since there is no associated question

1258

Connection Ans 08 must be blank since there is no associated question

1259

Connection Ans 09 must be blank since there is no associated question

1260

Connection Ans 10 must be blank since there is no associated question

1261

Compliance Ans 01 must be blank since there is no associated question

1262

Compliance Ans 02 must be blank since there is no associated question

1263

Compliance Ans 03 must be blank since there is no associated question

1264

Compliance Ans 04 must be blank since there is no associated question

Appendix B Error messages 171

Errors for invalid data

Code 1265

Message Compliance Ans 05 must be blank since there is no associated question

Explanation Either remove the value for Compliance Ans 05 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 06 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 07 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 08 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 09 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide. Either remove the value for Compliance Ans 10 or configure a question using the License Type Wizard as described in the asset management chapter of the BMC Remedy IT Service Management Administration Guide.

1266

Compliance Ans 06 must be blank since there is no associated question

1267

Compliance Ans 07 must be blank since there is no associated question

1268

Compliance Ans 08 must be blank since there is no associated question

1269

Compliance Ans 09 must be blank since there is no associated question

1270

Compliance Ans 10 must be blank since there is no associated question

1271

Termination conditions, Expiration Date Either remove the values specified for Termination and Notification Date should be blank conditions, Expiration Date, and Notification Date when Term is Never ending fields, or change the value of Term to something other than Never ending. The Master Certificate Identifier must be Either remove the value specified for Master blank if Certificate Group Status is "No Certificate Identifier or change the value specified Group" or "Master Certificate" for Certificate Group Status to something other than No Group or Master Certificate. The Master Certificate Identifier specified either does not exist or does not have an identical Product Tier, License Type and Contract for this license certificate Either use a different master certificate identifier or choose another license certificate.

1272

1273

1274

The License Type specified does not exist Specify a license type that exists.

172 Data Management Administration Guide

Errors for invalid data

Code 1275

Message Certificate Group Status can be "Attached to Group" or "Master Certificate" only if Groupable is set to Yes for the corresponding License Type

Explanation Either change the value specified for the Certificate Group Status to something other than Attached to Group or Master Certificate or set Groupable to Yes for the license type.

1276

The Change Request Previous Status Either change the value of Change Request cannot be "Rejected" if Change Request Previous Status to something other than Rejected or Status is "Pending". A "Rejected" change change the Change Request Status to Restart. request can have a status of "Restart" but not "Pending" Requester Company must be a valid company in COM:Company form with a type of either Operating Company, Customer or Vendor The Requester Company must exist on COM:Company with a type of either Operating Company, Customer, or Vendor. Select the appropriate value.

1277

1278

Requested For Company must be a valid The Requested Company must exist on company in COM:Company form with a COM:Company with a type of either Operating type of either Operating Company or Company, Customer. Select the appropriate value. Customer Assignee Company must be a valid company in the COM:Company form Invalid Vendor Person ID The Corporate ID and Company specified does not exist on People form There is no Login ID associated to the Corporate ID and Company specified The Login ID associated to the Corporate ID and Company does not exist on User form The Template Name does not exist on CTM:LoadPeopleTemplate, or the template is not promoted Invalid Change Coordinator The Assignee Company must exist on COM:Company. Select the appropriate value. The Vendor Person ID must match a Person ID in the CTM:People form. Select the appropriate value. The Corporate ID and Company must match both the Corporate ID and Company in the CTM:People form. Select the appropriate value. The Login ID is not associated to the Corporate ID and Company specified in the CTM:People form. Select the appropriate value. The Login ID associated to the Corporate ID and Company must exist in the User form. Select the appropriate value. The Template Name must exist on CTM:LoadPeopleTemplate, or the template must be promoted. Select the appropriate value. The Change Coordinator specified must exist in CTM:People form with a functional role of Infrastructure Change Coordinator.

1279 1280 1281

1282

1283

1284

1285

1286 1287 1290

Product Type cannot be found using the The CI Type is invalid. Select the appropriate value. CI Type specified There must be a default support group specified for the template Invalid Certificate Name. There is no matching License Certificate. Specify a default support group for the template. The Certificate Name must exist in either AST:LoadLicenseCertificates or AST:LicenseCertificates.

Appendix B Error messages 173

Errors for required fields

Code 1291

Message Invalid categorization doesn't exist in the PDL:ProductDictionary Invalid CI Name Invalid Asset Reconciliation Identity Invalid Relationship Type - People

Explanation The Product Categorization must exist in PDL:ProductDictionary. Select the appropriate value. The CI Name is invalid. Select the appropriate value. The Asset Reconciliation Identity is invalid. Select the appropriate value. The Relationship Type is invalid for Asset People relationship. Select the appropriate value.

1292 1293 1294 1295 1296

Invalid Relationship Type - Organization The Relationship Type is invalid for Asset People Organization relationship. Invalid Relationship Type - Support Group Invalid Relationship Type - Support Group - Multiple Group Invalid Request Type Invalid Relationship Level Invalid People Organization structure The Relationship Type is invalid for Asset People Support Group relationship. Select the appropriate value. The Relationship Type is invalid for Asset People multiple Support Group relationship. Select the appropriate value. The Request Type is invalid. Select the appropriate value. The Relationship Level is invalid. Select the appropriate value. The People Organization structure must exist in the CTM:People Organization form. Select the appropriate value.

1297

1298 1299 1300

Errors for required fields

The Error codes from missing required fields table lists error codes from missing required fields. Table 39: Error codes from missing required fields
Code 200 201 202 203 Message Missing Required Fields For Access ID Missing Required Fields For It Skills Missing Home Fields Paging Times Is Required Explanation Specify values for the Access IDs required fields. When IT Skills is selected, Operational Category Tier 1 and Product Category Tier 1 are required. Home fields are required when client type is set to Home-based. Specify paging times values.

174 Data Management Administration Guide

Errors for required fields

Code 204 205

Message Time Zone Is Required The Open Times field and Close Times field must either both have values or both be empty Pager Service Provider Is Required When On-Call Paging Type Is Generic Pager Parameters Email Is Required For The Selected Pager Service Provider Pager Parameters Pin Is Required For The Selected Pager Service Provider

Explanation Specify a time zone. Either specify values or clear the values for both the Open Time and Close Times fields. Either specify a pager service provider value or assign On-Call Paging Type a value other than Generic. Either specify a pager parameters email value or select a pager service provider that does not require a pager parameters email. Either specify a pager parameters pin value or select a pager service provider that does not require a pager parameters pin.

206

207

208

209

Pager Parameters Phone Is Required For Either specify a pager parameters phone number The Selected Pager Service Provider value or select a pager service provider that does not require a pager parameters phone number. Pager Parameters Pin And Phone Is Either specify a pager parameters pin or a pager Required For The Selected Pager Service parameters phone value or select a pager service Provider provider that does not require a pager parameters pin or pager parameters phone. Operational Category Tier 1 and 2 are required fields when Operational Category Tier 3 is entered At least one sub-category is required when Incident Management is selected Change Management selected; at least one sub category is required Source Cost Center And Distribution Percentage Are Required Person ID Is Required Source Cost Center Is Required Both the Product Name and Manufacturer are required when defining a Product within Product Catalog Login ID is required when On-Call paging type is set to Individual Site Required when the Client Type is Office-Based Employee, Field-Based Employee or Contractor Either select values for operational category tier 1 and tier 2, or clear the value selected for operational category tier 3. Specify at least one subcategory. Specify at least one subcategory. Specify values for Source Cost Center and Distribution Percentage. Specify a value for Person ID. Specify a value for Source Cost Center. Specify values for both product name and manufacturer.

210

211

212 213 214 215 216 217

218 219

Either specify a value for Login ID or set the OnCall Paging Type to a value other than Individual. Either specify a value for Site or specify a value for Client Type other than Office-Based Employee, Field-Based Employee, or Contractor.

Appendix B Error messages 175

Errors for required fields

Code 220 221

Message Missing Required Fields for Wallet attribute Generic Category Tier 1 and 2 are required fields when Generic Category Tier 3 is entered Manufacturer is required when specifying Product Name Product Name required with specifying Manufacturer Product Tier 1 through 3, Manufacturer, and Product Name fields are required when Model Version is entered Product Tier 1 through 3 are required when either Product Name or Manufacturer is entered

Explanation When Wallet Attribute is selected, Category and Type are required. Either select values for generic category tier 1 and tier 2, or clear the value selected for generic category tier 3. Either specify a value for Manufacturer or clear any value specified for Product Name. Either specify a value for Product Name or clear any value specified for Manufacturer. Either specify values for Product Tier 1 through 3, Manufacturer, or Product Name, or clear any value specified for Model Version. Either specify values for Product Tier 1 through 3, or clear any value specified for Product Name and Manufacturer.

222 223 224

225

226

Product Tier 1 is required when Product Either specify values for Product Tier 1, or clear any Tier 2 or 3 is entered values specified for Product Tier 2 and Product Tier 3. Product Tier 1 and 2 are required fields Either specify values for Product Tier 1 and 2, or when Product Category Tier 3 is entered clear any value specified for Product Category Tier 3. Operational Category Tier 1 is a required field when either Operational Category 2 or 3 is entered Company Menu Structure Tier 1 is required when Menu Structure Tier 2 is entered Company Menu Structure Tier 1 and Tier 2 are required when Menu Structure Tier 3 is entered Organization is required when specifying Department User Service Restoration, User Service Request, Infrastructure Restoration or Infrastructure Event is required when Incident Management flag is selected Organization and Department must be blank when specifying Global Contact Company Either specify a value for Operational Category Tier 1 or clear any values specified for Operation Category 2 and Operational Category 3. Either specify a value for Company Menu Structure Tier 1 or clear any value specified for Menu Structure Tier 2. Either specify a value for Company Menu Structure Tier 1 or clear any value specified for Menu Structure Tier 3. Either specify a value for Organization or clear any values specified for Department. Either specify values for User Service Restoration, Service Request, Infrastructure Restoration, and Infrastructure Event, or deselect the Incident Management flag. Either clear the values specified for Organization and Department or clear the value specified for Global Contact Company.

227

228

229

230

231 232

233

234

Region, Site Group and Site must be Either clear the values specified for Region, Site blank when specifying Global Company Group, and Site, or clear the value specified for Global Company.

176 Data Management Administration Guide

Errors for required fields

Code 235

Message The License Type, Full Text License Type and Default Notification Mechanism is required when specifying Login ID The Login ID is required when the Support Staff flag is set to Yes The Currency is required when specifying the Hourly Rate Value Support Company, Support Organization and Support Group fields must be left blank when the Approval For field is set to Individual First Name, Last Name and Approver Login ID field must be left blank when the Approval For field is set to Group First Name, Last Name and Approver Login ID fields are required when the Approval For field is set to Individual Support Company, Support Organization and Support Group are all required when the Approval For field is set to Group

Explanation Either clear the values specified for License Type, Full Text License Type and Default Notification Mechanism or clear the value specified for Login ID. Either specify a value for Login ID or set the Support Staff flag to No. Either specify a value for Currency or clear any value specified for Hourly Rate Value. Either clear the values specified for Support Company, Support Organization, and Support Group, or set the Approval For field to a value other than Individual. Either clear the values specified for First Name, Last name, and Approver login ID, or set the Approval For field to a value other than Group. Either clear the values specified for First Name, Last Name, and Approver login ID, or set the Approval For field to a value other than Individual. Either clear the values specified for Support Company, Support Organization, and Support Group, or set the Approval For field to a value other than Group.

236 237 238

239

240

241

242

CI Type is required and CI Name must Either specify a value for CI Type as well as be blank when Select On field is set to CI clearing the value from CI Name or specify a value Type other than CI Type for the Select On field. CI Name and Reconciliation Identity are required. CI Type and All Product Categorization Tiers must be blank when the Select On field is set to CI Name Specify a value for both CI Name and Reconciliation Identity; either clear the values from CI Type and All Product Categorization Tiers or set the Select On field to a value other than CI Name.

243

244

All Product Categorization Tiers need to Either clear the values from All Product be blank when CI Name is entered Categorization Tiers or clear the value specified for CI Name. Process field is required when the Covering field is set to Specific Process Process field should be Left blank when the Covering field is set to All 'Time Management Type', Year and 'Status Reason' fields are required when the 'Attribute Type' is set to 'HR Time Management' Support Company, Support Organization and Assigned Group are required when Event field is "Script Either specify a value for Process or specify a value other than Specific Process in the Covering field. Either specify a value for Process or specify a value other than All in the Covering field. Either enter values for Time Management Type, Year, and Status Reason, or set HR Time Management to a value other than Attribute Type. Either specify values for Support Company, Support Organization, and Assigned Group, or set Event to value other than Script.

245 246 247

248

Appendix B Error messages 177

Errors for required fields

Code 249

Message Resolution Product Tier 1 is required when Resolution Product Tier 2 or 3 is entered

Explanation Either specify a value for Resolution Product Tier 1 or clear any values specified for Resolution Product Tier 2 and Resolution Product Tier 3.

250

Resolution Product Tier 1 and 2 are Either specify a value for Resolution Product Tier 1 required fields when Resolution Product and Resolution Product Tier 2 or clear any values Category Tier 3 is entered specified for Resolution Product Tier 3. Resolution Product Tier 1 through 3 are required when either Resolution Product Name or Manufacturer is entered Resolution Product Tier 1 through 3, Resolution Manufacturer, and Resolution Product Name fields are required when Resolution Model Version is entered Either specify a value for Resolution Product Tier 1 through Resolution Product Tier 3 or clear any values specified for Resolution Product Name and Manager. Either specify a value for Resolution Product Tier 1 through Resolution Product Tier 3 and Resolution Product Name or clear any values specified for Resolution Model Version.

251

252

253

Incident Template ID or Template Name Either specify values for Incident Template Id and are required when Incident Action Type Incident Template Name or set Action Type to a is Template value other than Template. Operational Category Tier 1 or Product Category Tier 1 are required when Incident Action Type is Categorization Either specify values for Operational Category Tier 1 and Product Category Tier 1 or set Incident Action Type to a value other than Categorization.

254

255

Summary or Notes are required when Either specify a value for Summary or Note or set Incident Action Type is Summary/Notes the Incident Action Type to a value other than Summary/Notes. Script Description is required when Incident Action Type is Script Solution Database ID is required when Incident Action Type is Solution Known Error ID is required when Incident Action Type is "Known Error Decision Tree Main Branch ID or Decision Tree Previous Branch ID fields are required when this branch is not a main branch Either specify a value for Script Description or set Incident Action Type to a value other that Script. Either specify a value for Solution Database ID or set Incident Action Type to a value other than Solution. Either specify a value for Known Error ID or set Incident Action Type to a value other than Known Error. Either specify values for Decision Tree Main Branch ID and Decision Tree Previous Branch ID columns in the ProcessSetup-Incident.xls spreadsheet or move the values from the CFGDecisionTree-Branch tab to the CFG-DecisionTreeMainBranch tab. Either specify values for Customers Company, First Name, and Last Name, or specify a value for Customer Person ID.

256 257

258

259

260

When the Customer Person ID is not populated, the Customer's Company, First Name and Last Name are required

261

When the Contact Person ID is not Either specify values for Contacts Company, First populated, the Contact's Company, First Name, and Last Name, or specify a value for Name and Last Name are required Contact Person ID.

178 Data Management Administration Guide

Errors for required fields

Code 262

Message The Resolution or Resolution Categorization Tier 1 field is required when the status is either Resolved or Closed and the Service Type is User Service Restoration or Infrastructure Restoration The Status Reason field requires a value when the Status is either Pending or Resolved The Last Resolved Date is required when the Status is either Resolved or Closed The Closed Date is required when the Status is Closed

Explanation Either specify values for the Resolution and Resolution Categorization Tier 1 fields, or set Status to a value other than Resolved or Closed or set Service Type to a value other than User Service Restoration or Infrastructure Restoration. Either specify a value for Status Reason or set Status to a value other than Pending or Resolved. Either specify a value for Last Resolved Date or set Status to value other than Resolved or Closed. Either specify a value for Closed Date or set Status to a value other than Closed.

263

264

265 266 267 268

The Assignment Group, Assignee, or Specify values for either Assignment Group, Assignee Login ID field must be filled in Assignee, or Assignee Login ID. The Owner Group, Owner, or Owner Login ID field must be filled in The Reported To Vendor Date is required when a Vendor Group is selected for assignment All Recipient Group Fields are required when Notify is set to Group Specify values for either Owner Group, Owner, or Owner Login ID. Either specify a Reported To Vendor Date or clear any Vendor Group specified for assignment. Either specify values for all of the recipient group fields or set Notify to a value other than Group.

269 270

Recipient Person ID or Recipient field is Either specify values for the Recipient Person ID or required when Notify is set to Individual Recipient fields or set Notify to a value other than Individual. Either the Person ID or the combination of Company, First Name, and Last Name is required for the customer Either specify a value for Person ID or change the values specified for Company, First Name, and Last Name to make them a valid combination.

271

272

When the Requester Person ID is not Either specify a value for Requestor Person ID, or populated, the Requester Company, specify values for Requester Company, First Name, First Name, and Last Name are required and Last Name. If any of the following fields are populated, all are required -- Company, Support Group, Organization, Support Group Name Either specify values in all or none of the following fields: Company Support Group Organization Support Group Name

273

Appendix B Error messages 179

Errors for required fields

Code 274

Message When the Requested For Person ID is not populated, the Requested For Company, First Name, and Last Name are required Either the Impact, Urgency or Priority is required When the Customer Person ID is not populated, the Customer Company, Customer First Name, and Customer Last Name are required If any of the following fields are populated, all are required --All Assignee Company, Assignee Organization, Assignee Group Name

Explanation Either specify a value for Requested For Person ID, or specify values for Requested For Company, First Name, and Last Name. Specify values for Impact, Urgency, and Priority. Either specify a value for Customer Person ID, or specify values for Customer Company, Customer First Name, and Customer Last Name. Either specify values in all or none of the following fields: All Assignee Company Assignee Organization Assignee Group Name

275 276

277

278

The Problem Coordinator Assignment Group, Problem Coordinator Assignee or Problem Coordinator Assignee Login must be filled in The Status Reason field requires a value when the Status is either Completed or Cancelled At least one of the three product categorizations or the product name is required when the problem investigation status is "Completed" When the Requester Person ID is not populated, the Requester's Company, First Name and Last Name are required The Problem Coordinator Assignee or Problem Coordinator Assignee Login is required when status is "Assigned" or "Under Investigation" The Assignee Assigned Group and Problem Assignee or Assignee Login ID are required when status is "Under Investigation" or "Completed" or "Closed"

Specify a value for Problem Coordinator Assignment Group, Problem Coordinator Assignee, or Problem Coordinator Assignee Login. Either specify a value for Status Reason or set the value of Status to something other than Completed or Cancelled. Either specify a value for one of the product categorizations or the product name or set the problem investigation status to a value other than Completed. Either specify a value for Requester Person ID, or specify values for Requestors Company, First Name, and Last Name. Either specify values for Problem Coordinator Assignee or Problem Coordinator Assignee Login or set the status to a value other than Assigned or Under Investigation. Either specify values for Assignee Assigned Group and Problem Assignee or Assignee Login ID fields, or set the status to a value other than Under Investigation, Completed, or Closed.

279

280

281

282

283

180 Data Management Administration Guide

Errors for required fields

Code 284

Message

Explanation

The Assignee Assigned Group (or Either specify values for Assignee Assigned Group Problem Assignee or Assignee Login ID) or Problem Assignee and Assignee Login ID, or set is required when the status is set to the status to a value other than Assigned or Closed. "Assigned" or "Closed" Vendor name and contact are required when the problem investigation is assigned to a vendor Either the Requested By Person ID or the combination of Requested By Support Company, First Name and Last Name is required Either the Requested For Person ID or the combination of Requested For First Name and Last Name is required Either specify values for vendor name and contact or unassign the problem investigation. Either specify values for Requested By Person ID or specify values that make the combination of Requested By Support Company, First Name, and Last Name valid. Either specify values for Requested For Person ID or specify values that make the combination of Requested For First Name and Last Name valid.

285

286

287

288

When the Requested By Person ID is not Either specify a value for Requested By Person ID populated, the Requested By Support or specify values for Requested By Support Company, First Name and Last Name Company, First Name, and Last Name. are required When the Requested For Person ID is not populated, the Requested For First Name and Last Name are required Either specify a value for Requested For Person ID or specify values for Requested For First Name and Last Name.

289

290 291 292 293 294

The Completed Date is required when Either specify a value for Completed Date or set the the Status is either Completed or Closed status to a value other than Completed or Closed. Level is required when the Process used is of type Parent-Child Individual Approver is required when the Process used is of type Parent-Child The Organization Company and Location Company must be the same The Change Manager Support Group, Change Manager or Change Manager Login must be filled in Link to Request ID and Form field is required Either specify a value for Level or specify a value other than Parent-Child for Process. Either specify a value for Individual Approver or specify a value other than Parent-Child for Process. Specify the same value for both Organization Company and Location Company. Specify values for Change Manager Support Group, Change Manager, or Change Manager Login. Specify values for Request ID and Form.

295 296

The Change Request Previous Status is Either specify a value for Change Request Previous required when Change Request Status is Status or set the Change Request Status to a value "Pending" or "Rejected" other than Pending or Rejected. The Change Request Previous Status Reason is required when Change Request Previous Status is "Pending" The Timing Reason is required when Timing is "Expedited" Either specify a value for Change Request Previous Reason or set the Change Request Previous Status to a value other than Pending. Either select a timing reason or change the timing to a value other than Expedited.

297

298

Appendix B Error messages 181

Errors for required fields

Code 299 2000

Message The Internet E-Mail is required when Default Notify Mechanism is E-mail

Explanation Either enter an email address or change the Default Notify Mechanism to a value other than E-mail.

The Scheduled Start Date and Scheduled Either add a scheduled start and end date or set the End Date are required when the Change Change Requested Status to Planning In Progress Requested Status is past the Planning In or a status prior to this. Progress state The Actual Start Date, Actual End Date, and Performance Rating are required when Change Request Status is Completed or Closed Owner or Owner Group are required when Notification Date is set The Term conditions field requires an entry for Rolling Contract The Change Request Previous Status is required when Change Request Previous Status Reason is filled in License Type, Full Text License Type and Default Notify Mechanism are required when Support Staff is "Yes" Contract Type is required Change Requester is required if End of Lease is defined Cost Center is required Expiration Date is required when specifying a Fixed or Rolling Contract term Notification Date is required when specifying a Fixed Contract term The Expiration Date is required The Notification Date is required Support Company, Support Organization and Notification Group are all required Connection Answer 01 is required Connection Answer 02 is required Connection Answer 03 is required Either supply an Actual Start Date, Actual End Date, and Performance Rating, or set the Change Request Status to a value other than Completed or Closed. Either specify an Owner or Owner Group or clear the Notification Date field. Specify Term conditions in the Rolling Contract field. Either select a value for Change Request Previous Status or clear the value selected for Change Request Previous Status Reason. Either complete all the required fields or set Support Staff to No. Populate the Contract Type field. Either populate the Change Requester field or remove End of Lease from the definition. Enter a cost center. Enter a value for Fixed Contract or Rolling Contract term. Enter a value for Fixed Contract term. Enter a value for Expiration Date. Enter a value for Notification Date. Enter values for Support Company, Support Organization, and Notification Group. Either enter a value for Connection Answer 01 or use a different license type. Either enter a value for Connection Answer 02 or use a different license type. Either enter a value for Connection Answer 03 or use a different license type.

2001

2002 2003 2004

2005

2006 2007 2008 2009

2010 2011 2012 2013

2014 2015 2016

182 Data Management Administration Guide

Errors for required fields

Code 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034

Message Connection Answer 04 is required Connection Answer 05 is required Connection Answer 06 is required Connection Answer 07 is required Connection Answer 08 is required Connection Answer 09 is required Connection Answer 10 is required Compliance Answer 01 is required Compliance Answer 02 is required Compliance Answer 03 is required Compliance Answer 04 is required Compliance Answer 05 is required Compliance Answer 06 is required Compliance Answer 07 is required Compliance Answer 08 is required Compliance Answer 09 is required Compliance Answer 10 is required A Master Certificate Identifier is required when Certificate Group Status is "Attached To Group" License Type is required

Explanation Either enter a value for Connection Answer 04 or use a different license type. Either enter a value for Connection Answer 05 or use a different license type. Either enter a value for Connection Answer 06 or use a different license type. Either enter a value for Connection Answer 07 or use a different license type. Either enter a value for Connection Answer 08 or use a different license type. Either enter a value for Connection Answer 09 or use a different license type. Either enter a value for Connection Answer 10 or use a different license type. Either enter a value for Compliance Answer 01 or use a different license type. Either enter a value for Compliance Answer 02 or use a different license type. Either enter a value for Compliance Answer 03 or use a different license type. Either enter a value for Compliance Answer 04 or use a different license type. Either enter a value for Compliance Answer 05 or use a different license type. Either enter a value for Compliance Answer 06 or use a different license type. Either enter a value for Compliance Answer 07 or use a different license type. Either enter a value for Compliance Answer 08 or use a different license type. Either enter a value for Compliance Answer 09 or use a different license type. Either enter a value for Compliance Answer 10 or use a different license type. Either specify a master certificate identifier or specify a value other than Attached to Group for Certificate Group Status. Enter a value for license type.

2035

Appendix B Error messages 183

Errors for duplicate data

Code 2036 2037 2038 2039 2040 2041

Message Target Date is required when Status is not at Draft stage Site field is required on template Client Type is required on template Company is required on template Login ID is required when request type is People Relationship Level, Contact Company, Organization, and Department are required when request type is People Organization Contact Company, Support Organization, and Support Group Name are required when request type is Support Group

Explanation Either specify a value for the Target Date, or set the Status to Draft. Specify a value for Site. Specify a value for Client Type. Specify a value for Company. Either specify a value for Login ID, or set the value of the request type to a value other than People. Either specify values for Relationship Level, Contact Company, Organization, and Department, or set the value of the request type to a value other than People Organization. Either specify values for Contact Company, Support Organization, and Support Group Name, or set the value of the request type to a value other than Support Group.

2042

Errors for duplicate data

The Error codes during dataload promotion table lists error codes from duplicate data. Table 40: Error codes from duplicate data
Code 300 Message Duplicate Record On Staging Form Explanation Either delete the duplicate record from the staging form or modify the data in the record to make it unique. Either delete the duplicate record from the target form or modify the data in the record to make it unique. Modify the company navigation tiers to make them unique. Either delete the duplicate Login ID from the staging form or modify it to make it unique. Either delete the duplicate Login ID from the user form or modify it to make it unique. Either delete the entry with the duplicate product categorization and blank product name from the target form or modify them to make them unique.

301

Duplicate Record On Target Form

304 305 306 307

Navigation Tiers for Company are not unique Login ID exists on the staging form Login ID exists on the User Form An entry with this product categorization and a blank product name already exists on target form

184 Data Management Administration Guide

Errors for duplicate data

Code 308

Message An entry with the product name and manufacturer already exists on the target form An entry with this product categorization and blank product name already exists on the staging form An entry with the product name and manufacturer already exists on the staging form Invalid product alias because a duplicate alias will be created from the Product Catalog staging form Duplicate Site Alias from Site staging form Duplicate Support Group Alias from Support Group staging form Cannot create company relationship. Global relationship will be created from the PCT:LoadProductCatalog staging form

Explanation Either delete this entry with the duplicate product name and manufacturer from the target form or modify them to make them unique. Either delete the entry with the duplicate product categorization and blank product name from the staging form or modify them to make them unique. Either delete the entry with the duplicate product name and manufacturer from the staging form or modify them to make them unique. Either delete the duplicate alias from the Product Catalog staging form or modify it to make it unique. Either delete the Duplicate Site Alias from the Site staging form or modify it to make it unique. Delete the duplicate Support Group Alias from the staging form or modify it to make it unique. An association for this product categorization was created for all companies (Global) through PCT:LoadProductCatalog when the Map to Global field is set to Yes for this product categorization on the PCT: LoadProductCatalog form (PCTProductCatalog on ProductCatalog.xls). Delete the record in the PCT:LoadProdComAssoc form for this product categorization. Modify the company relationship to make it unique.

309

310

311

312 313 314

315

Cannot create company relationship. Global relationship is already being created from the CFG:LoadGenericProdSerAssoc staging form Cannot create association to the specified company. Global association already exists on target form Cannot create association to the specified company. Global association already exists on staging form Cannot create global company relationship. Relationship already exists with other company on target form Cannot create global company relationship. Relationship already exists with other company on staging form

316

Delete the global association from the target form and try again or create an association using a company that is unique. Delete the global association from the staging form and try again or create an association using a company that is unique. Delete the global company relationship with the other company from the target form and try again, or create a global company relationship using another company. Delete the global company relationship with the other company from the staging form and try again, or create a global company relationship using another company.

317

318

319

Appendix B Error messages 185

Errors for duplicate data

Code 320

Message Invalid company alias because a duplicate alias will be created from Company staging form Cannot create company relationship. Global relationship will be created from the CFG:LoadServiceCatalog staging form Duplicate Company Multi-tiered menu structure already exists Alternate Login ID and For Login ID cannot be same Duplicate Script or Decision Tree Identifier on Staging Form Duplicate Script or Decision Tree Identifier on Target Form Duplicate Group Event Mapping Association on Staging Form Duplicate Group Event Mapping Association on Target Form Duplicate Decision Tree Branch ID on Staging Form Duplicate Decision Tree Branch ID on Target Form Cannot create association to the specified Support Group because a duplicate association would be created from Template staging form Duplicate Record on Reverse Target Association Form Duplicate Support Group on Broadcast Staging Form

Explanation Either delete the duplicate Company alias from the staging form, or create a company alias using a different company. Modify the company relationship to make it unique.

321

322

The duplicate Company multi-tiered menu structure exists either in the COM:Company form or in the COM:LoadCompany staging form. Change either the Alternate Login ID or the For Login ID so they are not the same. Delete the duplicate script and / or the duplicate decision tree identifier from the staging form, or modify them to make them unique. Delete the duplicate script and / or the duplicate decision tree identifier from the staging form, or modify them to make them unique. Delete the duplicate group event mapping association from the staging form, or modify it to make it unique. Delete the duplicate group event mapping association from the target form, or modify it to make it unique. Delete the duplicate decision branch identifier from the staging form, or modify it to make it unique. Delete the duplicate decision branch identifier from the target form, or modify it to make it unique. Create any associations other than those created by the Template staging form.

323 324

325

326

327

328 329 330

331 332

Delete the duplicate record from the reverse target association form, or modify it to make it unique. Delete the duplicate support group from the broadcast staging form, or modify it to make it unique.

333 334

Duplicate Solution Alias on Staging Form Delete the duplicate solution alias from the staging form, or modify it to make it unique. Duplicate Solution Alias on Target Form Delete the duplicate solution alias from the target form, or modify it to make it unique.

186 Data Management Administration Guide

Errors for duplicate data

Code 335 336 337 338 339

Message Duplicate Change Template on the Staging form Duplicate Change Template on the Target form The Signature Identifier must be unique Duplicate impacted area for a default entry Duplicate Permission Group exists on the Staging Form for People Template Permission Group Duplicate Support Group Association exists on the Staging Form for People Template Support Group Association Duplicate Support Group Functional Role exists on the Staging Form for People Template Support Group Functional Role Duplicate Template Identifier Duplicate Association Identifier Duplicate Default Group set to Yes on the Staging Form for People Support Group Association Duplicate Default Group set to Yes on the Target Form for People Support Group Association Duplicate Record On Target Form with same instance ID Duplicate Contract Identifier Duplicate Incident ID and Service ReconID exist on staging form.

Explanation Delete the duplicate change template from the staging form, or modify it to make it unique. Delete the duplicate change template from the target form, or modify it to make it unique. Change the signature identifier to make it unique. Delete the impacted area being loaded, since it will automatically be created by the change. Delete the duplicate permission group from the staging form for the People Template Permission Group. Delete the duplicate support group association from the staging form for the People Template Support Group Association. Delete the duplicate support group functional role from the staging form for the People Template Support Group Functional Role. Delete the duplicate template identifier. Delete the duplicate association identifier. Set only one default group to Yes on the staging form for People Support Group Association. Set only one default group to Yes on the target form for People Support Group Association. Either delete the duplicate record from the target form or specify a unique instance ID. Specify a unique contract identifier. Either delete the duplicate Incident ID and Service ReconID from the staging form or specify a unique Incident ID and Service ReconID.

340

341

342 343 344

345

346 347 348

349

Duplicate Incident ID and Service Either delete the duplicate Incident ID and Service ReconID exist on HPD:Associations form. ReconID from the HPD:Associations form or specify a unique Incident ID and Service ReconID. Duplicate Default Group set to Yes on the Staging Form for the same Template Name Duplicate Default Group set to Yes on the Target Form for the same Template Name On the staging form, either set a different Default Group to Yes or use a different Template Name. On the target form, either set a different Default Group to Yes or use a different Template Name.

350

351

Appendix B Error messages 187

Errors during dataload promotion

Code 352 353 354

Message Cannot create multiple Service or CI on staging form Cannot create multiple Service or CI on target form Duplicate Permission Group exists on the Target Form for People Template Permission Group Duplicate Support Group Association exists on the Target Form for People Template Support Group Association Duplicate Support Group Functional Role exists on the Target Form for People Template Support Group Functional Role The Corporate ID and Company specified is not unique on People form

Explanation Either delete the duplicate Service or CI from the staging form, or use a unique Service or CI. Either delete the duplicate Service or CI from the target form, or use a unique Service or CI. Remove the duplicate permission group from the People Template Permission Group target form. Remove the duplicate support group association from the People Template Support Group Association target form. Remove the duplicate support group functional role from the People Template Support Group Functional Role target form. Either delete the entry with the duplicate Corporate ID and Company on People form or modify it to make it unique.

355

356

357

358 359

The Login ID associated to the Either delete the duplicate record or modify it to Corporate ID and Company is not unique make it unique. Template Name is not unique on CTM:LoadPeopleTemplate Cannot update people record when Client Type on template is Home-Based Employee The relationship you are trying to create already exists on target form for the specified request type and role The relationship you are trying to create already exists on staging form for the specified request type and role Duplicate Primary Contact set to Yes on the Target Form Duplicate Primary Contact set to Yes on the staging form Either delete the duplicate Template Name from CTM:LoadPeopleTemplate or modify it to make it unique. Set the value of Client Type to a value other than Home-Based Employee. Either delete the duplicate record on the target form or modify it to make it unique. Either delete the duplicate record on the staging form or modify it to make it unique. Either delete the duplicate record on the target form or modify it to make it unique. Either delete the duplicate record on the staging form or modify it to make it unique.

360

361

362

363 364

Errors during dataload promotion

The Error codes during dataload promotion table lists error codes that occur during dataload promotion.
188 Data Management Administration Guide

Errors during dataload promotion

Table 41: Error codes during dataload promotion

Code 400 Message An error was encountered during data promotion. The Short Description field of this record has been updated with the error details. Explanation Check the Short Description field for the error message details and see step 3 in Troubleshooting validation and promotion on page 87 for troubleshooting information.

Appendix B Error messages 189

Errors during dataload promotion

190 Data Management Administration Guide

C
Exclusions from the BMC Remedy ITSM Data Management tool
This appendix lists areas excluded from the BMC Remedy ITSM Data Management tool.

Exclusions from dataload

The following area is excluded from bulk load data management:
Geography

The following foundation forms are excluded from bulk load:

CFG:Geography City CFG:Geography Country CFG:Geography Stat/Province

These foundation geography forms are excluded because BMC Remedy ITSM provides extensive data for all these forms with installation of the applications. To import additional data, import the records directly into these forms using BMC Remedy Data Import. For information about using BMC Remedy Data Import, see the BMC Remedy Data Import help.

Exclusions from the data wizard

Some fields on specified forms are excluded from the data wizard for one of the following reasons:
The field on the specified form is shorter than the field elsewhere in the application.

Appendix C Exclusions from the BMC Remedy ITSM Data Management tool 191

Exclusions from the data wizard

The field on the form is not uniquely identified.

You can manually update any of these fields, as required. If the field is shorter than required, however, you must increase the field length. Table 42 on page 192 lists fields not updated by the data wizard, because the field on the form is shorter than required. Table 42: BMC Remedy IT Service Management fields not updated by the data wizard
Form or forms Field or fields Contains Current length 50 128 Persons full name(duplicate of Owner) Login ID CTM:Login ID Created By LoginID 40 254 30 Required length 128 128 254

BMC.AM:BMC_InventoryStorage_ AST:InventoryStorage

Owner zFullName zLoginName

Persons full name

Table 43 on page 192 lists fields not updated by the data wizard, because the field on the form is not uniquely identified. For example, a persons name is listed on the form, but not the Person ID or Login ID. Table 43: Fields that are not uniquely identified
Form or forms CHG:CCMSavedSearch-CRCI CHG:CCMSavedSearch-ImpLoc CHG:CCMSavedSearch-ServiceCI Product Model/Version Fields containing Support group

AST:ConfigNotification AST:Notifications

192 Data Management Administration Guide

Exclusions from the data wizard

Form or forms AST:Install_ASI BMC.CORE:BMC_BaseElement CHG:CCMSavedSearch CHG:CCMSavedSearch-CRCI CHG:CCMSavedSearch-ImpLoc CHG:CCMSavedSearch-ServiceCI CHG:CHGSLM:Qualbuilder CTR:ContractBase HPD:IncidentInterface_Create (Direct Contact fields) PBM:ProblemInterface_Create SRM:Request (AppRequestAssignee) SRM:RequestInterface_Create (AppRequestAssignee) TMS:Flow TMS:TaskGroup TMS:TaskGroupTemplate

Fields containing A persons name

Appendix C Exclusions from the BMC Remedy ITSM Data Management tool 193

Exclusions from the data wizard

194 Data Management Administration Guide

D
Data values
The spreadsheets for data migration include instructions on how to complete the spreadsheet columns. This appendix provides tables of data values where the list of values was too lengthy to display in the spreadsheet.

Configuration Item types

On the ProductCatalog.xls spreadsheet, the 01 PCT-ProductCatalog tab includes a column for configuration item (CI) type, which must be completed with one of the following values:

Appendix D Data values 195

Configuration Item types

Account Activity Admin Domain Application Application Infrastructure Application Service Application System BIOS Element Bulk Inventory Business Process Business Service Card CDROM Drive Chassis Cluster Communication Endpoint Computer System Connectivity Collection Connectivity Segment Database Database Storage Disk Drive Disk Partition Document Equipment 196 Data Management Administration Guide

File System Floppy Drive Hardware Package Hardware System Component Inventory Location IP Connectivity Subnet IP Endpoint IPX Connectivity Network Keyboard Local Area Network (LAN) LNs Collection Local File System Logical System Component LPAR Mainframe Media Memory Monitor Network Port NT Domain Operating System Package Patch Physical Location Pointing Device Printer Processor

Locales

Product Protocol Endpoint Rack Remote File System Role Share Software Server System Resource System Software

Tape Drive UPS Virtual System Virtual System Enabler VM Ware Wide Area Network (WAN)

Locales
On the ProcessSetup-Incident.xls spreadsheet, the CFG-DecisionTree tab includes a column for Locale, which is a required field that must be completed with a locale code, such as en_US for English (US). If you create decision trees in English or in any of the languages into which the application is localized, you might complete the column with any of the following locale codes:
de_DE en_US es_ES fr_FR it_IT ja_JP ko_KR pt_BR

Appendix D Data values 197

Locales

zh_CN

The following list contains all supported locale codes:

en_US ar_AE ar_BH ar_DZ ar_EG ar_IQ ar_JO ar_KW ar_LB ar_LY ar_MA ar_OM ar_QA ar_SA ar_SD ar_SY ar_TN ar_YE be_BY bg_BG ca_ES cs_CZ da_DK

198 Data Management Administration Guide

Locales

de_AT de_CH de_DE de_LU el_GR en_AU en_CA en_GB en_IE en_IN en_NZ en_ZA es_AR es_BO es_CL es_CO es_CR es_DO es_EC es_ES es_GT es_HN es_MX es_NI es_PA

Appendix D Data values 199

Locales

es_PE es_PR es_PY es_SV es_UY es_VE et_EE fi_FI fr_BE fr_CA fr_CH fr_FR fr_LU hi_IN hr_HR hu_HU is_IS it_CH it_IT iw_IL ja_JP ko_KR lt_LT lv_LV mk_MK

200 Data Management Administration Guide

Notification events

nl_BE nl_NL no_NO pl_PL pt_PT ro_RO ru_RU sh_YU sk_SK sl_SI sq_AL sr_YU sv_SE th_TH tr_TR uk_UA zh_CN zh_HK zh_TW

Notification events
On the People.xls spreadsheet, the 16 NTE-CFG-NotificationEvents tab includes columns for Module Name and Notification Event, both of which are required fields. This section lists the module names in BMC Remedy IT Service Management (BMC Remedy ITSM) 7.6.0x along with the applicable notification events.

Appendix D Data values 201

Notification events

Table 44: Module names and applicable notification events

BMC Remedy ITSM 7.6.0x module Asset Management Applicable notification events Asset Scheduled Decommission Asset Scheduled Maintenance Bulk Inventory Reorder CI Status Change Configuration Item Approval Configuration Scheduled Maintenance Contract Expiration Contract Expiration Warning Escalated Notifications License Management Exception Resolution Escalation Response Escalation Unavailability Assignment Broadcast

Broadcast Notification

202 Data Management Administration Guide

Notification events

BMC Remedy ITSM 7.6.0x module Incident

Applicable notification events Assignment Change Associations Incident Escalation Known Error Solution Known Error Workaround OLA Resolution Escalated Notification OLA Resolution Escalation OLA Response Escalated Notification OLA Response Escalation Ownership Assignment Problem Investigation Associations Problem Investigation Completion Resolution SLA Resolution Escalated Notification SLA Resolution Escalation SLA Response Escalated Notification SLA Response Escalation UC Resolution Escalated Notification UC Resolution Escalation UC Response Escalated Notification UC Response Escalation Unavailability Restored

Appendix D Data values 203

Notification events

BMC Remedy ITSM 7.6.0x module Infrastructure Change (Continued on next page)

Applicable notification events Approval Approval Information Approval Resolution Escalated Notification Approval Resolution Escalation Change Coordinator Assignment Change Coordinator Approval Rejection Change Coordinator Completion Change Coordinator Latent Completion Change Coordinator Planning Change Coordinator Pre-planning Change Coordinator Re-scheduled Change Coordinator Scheduled Change Coordinator Scheduled For Review Change Manager Assignment Change Manager Approval Rejection Change Manager Completion Change Manager Group Escalation Change Manager Latent Completion Change Manager Next Dependent Change Change Manager Planning Change Manager Pre-planning Change Manager Predecessor Completion

204 Data Management Administration Guide

Notification events

BMC Remedy ITSM 7.6.0x module Infrastructure Change (Continued from previous page)

Applicable notification events Change Manager Re-scheduled Change Manager Scheduled Change Manager Scheduled for Review Change Worklog Assignment Implementer Assignment Implementer Planning Implementer Pre-planner Implementer Scheduled Manual Notification Non-Approval Information OLA Resolution Escalated Notification OLA Resolution Escalation OLA Response Escalated Notification OLA Response Escalation Requester Change Cancellation

Appendix D Data values 205

Notification events

BMC Remedy ITSM 7.6.0x module Infrastructure Change (Continued from previous page)

Applicable notification events Requester Change Receipt Confirmation Requester Completion Requester Change Re-scheduled Requester Change Scheduled Requester Rejection SLA Response Escalated Notification Task Cancellation Task Pending Unavailability Restored

Problem Management

Change Completed Known Error Assignment Known Error Manager Assignment Problem Assignment Problem Cancelled Problem Completed Problem Coordinator Assignment Solution Assignment Unavailability Restored

Reminders

Reminders Notification

206 Data Management Administration Guide

Permission groups

BMC Remedy ITSM 7.6.0x module Request Management

Applicable notification events Assignment Request Cancellation Request Definition Status Changed Request Manager Assignment Request Rejected Request Response Escalation Request Status Changed Request Submitted Work Order Assignee Assignment Work Order Manager Assignment Work Order Status Cancelled Work Order Status Completed Work Order Status In Progress Work Order Status Pending Work Order Status Rejected Work Order Submit

Task Management

Task Assigned Task Status Changed

Permission groups
This section lists the permission groups in BMC Remedy ITSM 7.6.0x, along with the applicable license types. For a more detailed description of each permission group, see the BMC Remedy IT Service Management Administration Guide.

Appendix D Data values 207

Permission groups

Table 45: Permission groups and applicable license types

BMC Remedy ITSM 7.6.0x permission group Applicable license types Read Activity Config Activity User Activity Viewer Administrator ApprovalAdmin ASE-Administrator Asset Admin Asset Config Asset User Asset Viewer Browser CM Dashboard User Command Event Master Config Categorization Admin Config Categorization User Config Group Mapping Admin Contact Location Admin Contact Organization Admin Contact People Admin Contact People HR Admin Contact People User Contact Support Admin Contract Admin Contract Config Contract User Contract Viewer Cost Manager Customize DSL Master Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Fixed Floating None Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes

208 Data Management Administration Guide

Permission groups

BMC Remedy ITSM 7.6.0x permission group

Applicable license types Read Fixed Floating None Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes

DSL Viewer Incident Config Incident Master Incident Submitter Incident User Incident Viewer Infrastructure Change Config Infrastructure Change Master Infrastructure Change Submit Infrastructure Change User Infrastructure Change Viewer Licensing Notification Admin Problem Config Problem Master Problem Submitter Problem User Problem Viewer Purchasing User Receiving User Release Config Release Master Release User Release Viewer Requester Console Config Requester Console Master ROI Admin ROI Viewer Security SLM Config

Appendix D Data values 209

Relationship types

BMC Remedy ITSM 7.6.0x permission group

Applicable license types Read Fixed Yes Yes Floating Yes Yes Yes Yes Yes Yes Yes Yes Yes None

SLM Customer SLM Manager Sub Administrator Summary Definition Config Task Administrator Task Application Config Task Manager Task Process Config Task User

Relationship types
On the Transactional-SharedComponents.xls spreadsheet, the SHR-Association tab is used to specify associations (or relationships) between records. You can create relationships between any request types, except those noted in the Relationships that are not valid table. Table 46: Relationships that are not valid
From request type Any Solution database Infrastructure change Incident marked as duplicate Incident marked as original Relationship type Any Any Any Any Duplicate of To request type Same request Any Solution database Any Any request type except incident

Request types
On the Transactional-SharedComponents.xls spreadsheet, the SHR-Association tab is used to specify associations (or relationships) between records. This tab includes two columns for Request Type that identify the request type of the two records being associated and that must be completed with one of the following text or numeric values:
210 Data Management Administration Guide

Timing Reasons

6000Configuration Item 9000Incident 12000Infrastructure Change 15000Solution Database 16000Known Error 20000Problem Investigation

For more information, see Using Transactional-SharedComponents.xls to populate the Service or CI fields in an incident, problem, known error, or change on page 68.

Timing Reasons
On the Transactional-Change.xls spreadsheet, the CHG-InfrastructureChange tab includes columns for Timing and Timing Reason. Timing is a required field on the Infrastructure Change form. Timing Reason is a required field for the Timing values listed in the Timing value and corresponding Timing reason values table. This table lists the values available for Timing and the corresponding values for Timing Reason. Table 47: Timing values and corresponding Timing Reason values
Timing values Expedited Timing Reason numeric values 1000 2000 3000 4000 Timing Reason text values Customer/business need Insufficient lead-time Known error correction Scheduling conflict

Status reasons
For forms that include Status as a required field, Status Reason is a required field for the status values indicated in the following tables. These tables are grouped by the spreadsheet used to upload data to the forms.

Appendix D Data values 211

Status reasons

For Transactional-Change.xls
On the Transactional-Change.xls spreadsheet, the CHG-InfrastructureChange tab includes columns for Status and Status Reason. Status is a required field on the Change form. Status Reason is a required field for only certain Status values. Table 48 on page 212 lists the Status values for which Status Reason is a required field. This table lists the values available for Status and the corresponding values for Status Reason. Table 48: Change Status values and corresponding Status Reason values
Status values Planning In Progress Status Reason numeric values 28000 29000 30000 Implementation In Progress 14000 17000 18000 19000 20000 21000 13000 Pending 27000 25000 22000 26000 23000 24000 Rejected 12000 15000 16000 Completed 10000 9000 11000 Status Reason text values Accepted Assigned Built In Rollout In Development In Test In Build In Rollback In Documentation In Verification Manager Intervention Miscellaneous Vendor Purchase Future Enhancement Support Group Communication Task Review Insufficient Task Data Insufficient Change Data Schedule Conflicts Final Review Required Final Review Complete Additional Coding Required

212 Data Management Administration Guide

Status reasons

Status values Closed

Status Reason numeric values 5000 6000 7000 8000

Status Reason text values Successful Successful with Issues Unsuccessful Backed Out No Longer Required Funding Not Available To Be Re-Scheduled Resources Not Available

Cancelled

1000 2000 3000 4000

For Transactional-Contract.xls
On the Transactional-Contract.xls spreadsheet, the AST-AssetLease, ASTAssetMaintenance, AST-AssetSoftware, AST-AssetSupport, AST-AssetWarranty, CTR-GenericContract, and CTR-MasterContract tabs include columns for Status and Status Reason. Status is a required field on the CTR:ContractBase, AST:AssetLease_, AST:AssetMaintenance_, AST:AssetSoftware_, AST:AssetSupport_, AST:AssetWarranty_, CTR:GenericContract_, and CTR:MasterContract_ forms. Status values and corresponding Status Reason values are listed in Table 49 on page 213. The corresponding Status Reason values are optional. If no Status value is entered, the default value is Executed. Table 49: Asset Status values and corresponding Status Reason values
Status values Draft Status Reason numeric values 2000 3000 Executed 1000 4000 5000 6000 7000 Status Reason text values In negotiation Pending Signature Active Requires Attention Under re-negotiation Change Pending On Hold

Appendix D Data values 213

Status reasons

Status values Historical

Status Reason numeric values 8000 9000 10000

Status Reason text values Expired Terminated Cancelled Scheduled for Deletion

Delete

11000

For Transactional-Problem.xls
On the Transactional-Problem.xls spreadsheet, several tabs include columns for Status and for Status Reason. Status is a required field on each corresponding form. Status Reason is a required field for the Status values listed in Table 50 on page 214. This table lists the values available for Status and the corresponding values for Status Reason. Table 50: Problem Status values and corresponding Status Reason values
Spreadsheet tab Known Error Status values Cancelled Status Reason numeric values 1000 2000 Corrected No Action Planned Scheduled for Correction 3000 4000 5000 6000 Status Reason text values Duplicate No Longer Applicable Pending PIR Funding Not Available Pending Infrastructure Change Pending Third Party Vendor

214 Data Management Administration Guide

Status reasons

Spreadsheet tab Problem Investigation

Status values Completed

Status Reason numeric values 1000 2000 3000 4000

Status Reason text values Known Error Unresolvable Solution Database Enhancement Request Duplicate Investigation Local Site Action Required Purchase Order Approval Registration Approval Infrastructure Change Support Contract Hold Third Party Vendor Action Reqd Pending Original Problem Supplier Delivery Request Client Action Required Client Hold Monitoring Problem Future Enhancement Automated Resolution Reported Not Applicable

Cancelled Pending

5000 6000 7000 8000 9000 10000 11000 12000 13000 14000 15000 16000 17000 18000 19000

Solution Database

Inactive

3000

For Transactional-Incident.xls
On the Transactional-Incident.xls spreadsheet, the HPD-HelpDesk tab includes columns for Status and Status Reason. Status is a required field on the Incident form. Status Reason is a required field for the Status values listed in Table 51 on page 216. This table lists the values available for Status and the corresponding values for Status Reason.

Appendix D Data values 215

Status reasons

Table 51: Incident Status values and corresponding Status Reason values
Spreadsheet tab Pending Status Reason numeric values 2000 3000 4000 5000 6000 7000 8000 9000 10000 11000 12000 13000 14000 19000 Resolved 11000 14000 15000 16000 17000 19000 Closed 1000 19000 Cancelled 20000 Status Reason text values Local Site Action Required Purchase Order Approval Registration Approval Supplier Delivery Support Contact Hold Third Party Vendor Action Reqd Client Action Required Infrastructure Change Request Future Enhancement Pending Original Incident Client Hold Monitoring Incident Automated Resolution Reported Future Enhancement Monitoring Incident Customer Follow-Up Required Temporary Corrective Action No Further Action Required Automated Resolution Reported Infrastructure Change Created Automated Resolution Reported No longer a Causal CI

On the Transactional-Incident.xls spreadsheet, the TMS-Task tab includes columns for Status and Status Reason. Status is a required field on the TMS:TaskGroup form. Status Reason is a required field for the Status values listed in the following table. This table lists the values available for Status and the corresponding values for Status Reason.

216 Data Management Administration Guide

Status reasons

Table 52: Incident task Status values and corresponding Status Reason values
Status values Closed Status Reason numeric values 1000 2000 3000 Pending 4000 9000 Staged 5000 6000 Waiting 7000 8000 Status Reason text values Success Failed Canceled Assignment Error Staging in Progress Staging Complete Acknowledgment Completion

For Transactional-Task.xls
On the Transactional-Task.xls spreadsheet, the TMS-Task tab includes columns for Status and Status Reason. Status Reason is a required field for the Status values listed in Table 53 on page 217. This table lists the values available for Status and their corresponding values for Status Reason. Table 53: Task Status values and corresponding Status Reason values
Status values Closed Status Reason numeric values 1000 2000 3000 Pending 4000 9000 Status Reason text values Success Failed Canceled Assignment Error

Appendix D Data values 217

Time zones

Time zones
On the SupportGroup.xls spreadsheet, the 06 BusinessTimeHolidays tab includes a column for time zone, which must be completed with one of the following values:
(GMT -12:00) Eriwetok, Kwajalein (GMT -11:00) Midway Island, Samoa (GMT -10:00) Hawaii (GMT -09:00) Alaska (GMT -08:00) Pacific Time (US & Canada); Tijuana (GMT -07:00) Arizona (GMT -07:00) Mountain Time (US & Canada) (GMT -06:00) Central Time (US & Canada) (GMT -06:00) Mexico City (Tegucigalpa) (GMT -06:00) Saskatchewan (GMT -05:00) Bogota, Lima, Quito (GMT -05:00) Eastern Time (US & Canada) (GMT -05:00) Indiana (East) (GMT -04:00) Atlantic Time (Canada) (GMT -04:00) Caracas, La Paz (GMT -03:30) Newfoundland (GMT -03:00) Brasilia (GMT -03:00) Buenos Aries, Georgetown (GMT -02:00) Mid-Atlantic (GMT -01:00) Azores, Cape Verde Is. (GMT) Casablanca, Monrovia (GMT) Greenwich Mean Time: Dublin, Edinburgh, Lisbon, London

218 Data Management Administration Guide

Time zones

(GMT +1:00) Amsterdam, Copenhagen, Madrid, Paris, Vilnius (GMT +1:00) Belgrade, Sarajevo, Skopje, Sofija, Zagreb (GMT +1:00) Bratislava, Budapest, Ljubljana, Prague, Warsaw (GMT +1:00) Brussels, Berlin, Bern, Rome, Stockholm, Vienna (GMT +2:00) Athens, Istanbul, Minsk (GMT +2:00) Bucharest (GMT +2:00) Cairo (GMT +2:00) Harare, Pretoria (GMT +2:00) Helsinki, Riga, Tallinn (GMT +2:00) Israel (GMT +3:00) Baghdad, Kuwait, Riyadh (GMT +3:00) Moscow, St. Petersburg, Volgograd (GMT +3:00) Nairobi (GMT +3:30) Tehran (GMT +4:00) Abu Dhabi, Muscat (GMT +4:00) Baku, Tbilisi (GMT +4:30) Kabul (GMT +5:00) Ekaterinburg (GMT +5:00) Islamabad, Karachi, Tashkent (GMT +5:30) Bombay, Calcutta, Madras, New Delhi (GMT +6:00) Almaty, Dhaka (GMT +6:00) Colombo (GMT +7:00) Bangkok, Hanoi, Jakarta (GMT +8:00) Beijing, Chongqing, Hong Kong, Urumqi (GMT +8:00) Perth

Appendix D Data values 219

Time zones

(GMT +8:00) Singapore (GMT +8:00) Taipei (GMT +9:00) Osaka, Sapporo, Tokyo (GMT +9:00) Seoul (GMT +9:00) Yakutsk (GMT +9:30) Adelaide (GMT +9:30) Darwin (GMT +10:00) Brisbane (GMT +10:00) Canberra, Melbourne, Sydney (GMT +10:00) Guam, Port Moresby (GMT +10:00) Hobart (GMT +10:00) Vladivostok (GMT +11:00) Magadan, Solomon Is., New Caledonia (GMT +12:00) Auckland, Wellington (GMT +12:00) Fiji, Kamchatka, Marshall Is.

220 Data Management Administration Guide

E
How tabs map from spreadsheet to target form
This appendix describes how tabs in the Excel (XLS) spreadsheets map to staging forms, and how the staging forms map to the primary target forms in BMC Remedy ITSM 7.6.0x.

Foundation data mapping

This section lists the mapping of foundation data from spreadsheets to target forms. Table 54: Foundation data mapping
Spreadsheet Company.xls Company.xls Financials.xls Tab 01 COM-Company 02 COM-CompanyAlias Staging form COM:LoadCompany COM:LoadCompanyAlias Target form or forms COM:Company COM:Company Alias

01 FINFIN:LoadConfigCostCente FIN:ConfigCostCentersRep ConfigCostCentersRepos rsRep ository itory 02 FINFIN:LoadCostCenterUDA CostCenterUDAssociatio Assoc ns 01 CFG-GenericCatalog 02 CFGGenericProdServiceAsso c CFG:LoadGenericCatalog CFG:LoadGenericProdSer Assoc FIN:CostCenterUDAAssoci ations CFG:Generic Catalog CFG:GenericProdServiceAs soc

Financials.xls

GenericCatalog.x ls GenericCatalog.x ls GenericCatalog.x ls Geography.xls Location.xls

03 CFGCFG:LoadGenericCpyMod CFG:GenericCompanyMod GenericCompanyModule uleAssoc uleAssoc Asso CTM-Postal Codes 01 SIT-Site CTM:LoadPostalCodes SIT:LoadSite CTM:PostalCodes SIT:Site

Appendix E How tabs map from spreadsheet to target form 221

Foundation data mapping

Spreadsheet Location.xls Location.xls Location.xls Location.xls OperationalCatal og.xls OperationalCatal og.xls People.xls People.xls

Tab 02 SIT-SiteAlias 03 CTM-Region 04 SIT-SiteGroup

Staging form SIT:LoadSiteAlias CTM:LoadRegion SIT:LoadSiteGroup

Target form or forms SIT:Site Alias CTM:Region SIT:Site Group SIT:Site Company Association CFG:Service Catalog

05 SITSIT:LoadSiteCompanyAss SiteCompanyAssociation oc 01 CFGOperationalCatalog CFG:LoadServiceCatalog

02 CFGCFG:LoadServiceCatalogA CFG:Service Catalog Assoc OperationalCatalogAssoc ssoc 01 CTM-PeopleTemplate 02 CTM-People CTM:LoadPeopleTemplate CTM:People Template CTM:LoadPeople CTM:People User (if a Remedy Login ID is specified)

People.xls People.xls People.xls

03 CTMPeopleTemplatePG 04 CTMPeopleTemplateSG 05 CTMPeopleTemplateSFR

CTM:LoadPeopleTemplate CTM:People Template PG PG CTM:LoadPeopleTemplate CTM:People Template SG SG CTM:LoadPeopleTemplate CTM:SupportGroupFun SFR ctionalRole AP:Role

People.xls People.xls People.xls

06 CTM-Login 07 CTM-PeopleWallet

CTM:LoadPeopleAttribute CTM:Login ID s CTM:LoadPeopleAttribute CTM:People Wallet s

08 CTMCTM:LoadPeopleAttribute CTM:People HR PeopleHRAttendanceMg s Attendance Mgmt mt 09 CTMCTM:LoadPeopleAttribute CTM:People HR Time PeopleHRTimeManagem s Management ent 10 CTM-PeopleEducation CTM:LoadPeopleAttribute CTM:People Education s 11 CTMPeopleTravelProfile CTM:LoadPeopleAttribute CTM:People Travel Profile s

People.xls

People.xls People.xls

222 Data Management Administration Guide

Foundation data mapping

Spreadsheet People.xls People.xls People.xls

Tab 12 CTMPeopleBenefitInfo 13 CTM-PeopleITSkills

Staging form

Target form or forms

CTM:LoadPeopleAttribute CTM:People Benefit Info s CTM:LoadPeopleAttribute CTM:People IT Skills s FIN:CostCenterUDAAssoci ations

14 FINFIN:LoadCostCenterUDA CostCenterUDAssociatio Assoc ns

People.xls People.xls People.xls People.xls People.xls

15 CTM-PeopleWorkLog CTM:LoadPeopleWorkLog CTM:People WorkLog 16 NTE-CFGNotificationEvents NTE:LoadCFGNotification NTE:CFG-Notification Events Events CTM:PeoplePermission Groups CTM:PeoplePermission Groups CTM:Support Group Association

17 CTMCTM:LoadPeoplePermissi PeopleAccessRestrictions onGroups 18 CTMCTM:LoadPeoplePermissi PeoplePermissionGroups onGroups 19 CTMCTM:LoadSupportGroup SupportGroupAssociatio Association n

People.xls

20 CTMCTM:LoadSupportGroupF CTM:SupportGroupFunctio SupportGrpFunctionalRo unctionalRole nalRole le CTMPeopleOrganization 01 PCT-ProductCatalog CTM:LoadPeople Organization PCT:LoadProductCatalog CTM:People Organization

PeopleOrg.xls ProductCatalog.x ls ProductCatalog.x ls ProductCatalog.x ls ProductCatalog.x ls ProductCatalog.x ls ProductCatalog.x ls SupportGroup.xls SupportGroup.xls

PCT:Product Catalog PCT:Product Alias PCT:ProductCompanyAsso ciation

02 PCT-ProductAlias 03 PCTProductCompanyAssoc 04 PCTProductModelVersion 05 PCTModelVersionPatch 06 PCTProdCatalogAliasMappi ng 01 CTM-SupportGroup 02 CTMSupportGroupAssignme nts

PCT:LoadProductAlias PCT:LoadProdComAssoc

PCT:LoadProdModelVersi PCT:Product Model/ on Version PCT:LoadModelVersionPa PCT:ModelVersion Patch tch PCT:LoadProdCatAliasMa PCT:ProductCatalogAliasM pping appingForm CTM:LoadSupportGroup CTM:Support Group

CTM:LoadSGPAssignment CTM:Support Group s Assignments

Appendix E How tabs map from spreadsheet to target form 223

Process setup data mapping

Spreadsheet SupportGroup.xls SupportGroup.xls SupportGroup.xls SupportGroup.xls

Tab 03 CTMSupportGroupAlias 04 CTMSupportGroupOnCall 05 BusinessTimeWorkdays

Staging form CTM:LoadSupportGroup Alias CTM:LoadSGPOnCall CFG:LoadBusinessTimeW orkdays

Target form or forms CTM:Support Group Alias CTM:Support Group OnCall Business Time Workdays

06 BusinessTimeHolidays CFG:LoadBusinessTimeHo CFG:Business Holidays lidays Storage Business Time Holidays

SystemSetup.xls

NTE-CFGPagerServiceConfig

NTE:LoadCFGPagerServic NTE:CFG-Pager Service eConfig Config

Process setup data mapping

This section lists the mapping of process-setup data from spreadsheets to target forms. All of the spreadsheets and tabs listed in Table 55 on page 224 are sample data and can be loaded as described in Loading sample data on page 229, if you chose not to load it at installation time. Table 55: Process setup data mapping
Spreadsheet ProcessSetup Change ProcessSetup Change ProcessSetup Change ProcessSetup Change ProcessSetup Change ProcessSetup Foundation Tab APR-ApproverLookup CHG-Template CHGTemplateSPGAssoc CHGTemplateAssociations Staging form Target form or forms

Note

APR:LoadApproverLook APR:Approver Lookup up CHG:LoadTemplate CHG:LoadTemplateSPG Assoc CHG:Template CHG:TemplateSPGAssoc

CHG:LoadTemplateAsso CHG:Template ciations Associations TMS:AssociationTemplat e CFG:Assignment

CHGTMS:LoadAssociationTe TemplateTaskTempAss mplate oc CFG-Assignment CFG:LoadAssignment

224 Data Management Administration Guide

Transactional data mapping

Spreadsheet ProcessSetup Foundation ProcessSetup Incident ProcessSetup Incident ProcessSetupIncident.xls ProcessSetup Incident ProcessSetup Incident ProcessSetup Incident ProcessSetup Incident ProcessSetup Incident ProcessSetup Incident ProcessSetupRequest.xls ProcessSetupTask.xls ProcessSetupTask.xls ProcessSetupTask.xls ProcessSetupTask.xls ProcessSetupTask.xls

Tab AP-Alternate HPD-Template HPDTemplateSPGAssoc HPDTemplateAssociations CFG-Scripts CFGGroupEventMapping CFG-DecisionTree CFG-DecisionTreeMainBranch CFG-DecisionTreeBranch CFG-DecisionTreeBranchItem RQCSummaryDefinition TMSTaskGroupTemplate TMS-TaskTemplate TMSAssociationTemplate TMS-FlowTemplate TMSAssignmentConfig

Staging form APR:LoadAlternate HPD:LoadTemplate HPD:LoadTemplateSPG Assoc HPD:LoadTemplateAsso ciations CFG:LoadScripts CFG:LoadGroupEventM apping CFG:LoadDecisionTree

Target form or forms AP:Alternate HPD:Template HPD:TemplateSPG Assoc HPD:Template Associations CFG:Scripts CFG:Group Event Mapping CFG:Decision Tree

CFG:LoadDecisionTreeBr CFG:Decision Treeanch Branch CFG:LoadDecisionTreeBr CFG:Decision Treeanch Branch CFG:LoadDecisionTreeBr CFG:Decision Treeanch Branch RQC:LoadSummaryDefi nition TMS:LoadTaskGroupTe mplate TMS:LoadTaskTemplate TMS:LoadAssociationTe mplate TMS:LoadFlowTemplate RQC:SummaryDefinition TMS:TaskGroupTemplat e TMS:TaskTemplate TMS:AssociationTemplat e TMS:FlowTemplate

TMS:LoadAssignmentCo TMS:AssignmentConfigu nfig ration

Transactional data mapping

This section lists the mapping of transactional data from spreadsheets to target forms.

Appendix E How tabs map from spreadsheet to target form 225

Transactional data mapping

All of the spreadsheets and tabs listed in Table 56 on page 226 are sample data and can be loaded as described in Loading sample data on page 229, if you chose not to load it at installation time. Table 56: Transactional data mapping
Spreadsheet TransactionalAsset.xls TransactionalAsset.xls Tab AST-WorkLog Staging form AST:LoadWorkLog Target form or forms AST:WorkLog

Note

ASTAST:LoadBMC_BaseRelati AssetToAssetRelations onship hip

BMC.CORE:BMC_BaseRelat ionship BMC.CORE:BMC_Compon ent BMC.CORE:BMC_Depende ncy BMC.CORE:BMC_Member OfCollection

TransactionalChange.xls TransactionalChange.xls TransactionalChange.xls TransactionalChange.xls

CHGInfrastructureChange CHG-WorkLog CHG-ImpactedAreas AP-Signature

CHG:Infrastructure Change CHG:LoadWorkLog CHG:LoadImpactedAreas APR:LoadSignature

CHG:LoadInfrastructureChang e CHG:WorkLog CHG:Impacted Areas

AP:Signature AP:Detail

TransactionalContract.xls TransactionalContract.xls TransactionalContract.xls TransactionalContract.xls TransactionalContract.xls

AST-AssetLease ASTAssetMaintenance AST-AssetSoftware AST-AssetSupport AST-AssetWarranty

CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase

CTR:ContractBase and AST:AssetLease_ CTR:ContractBase and AST:AssetMaintenance_ CTR:ContractBase and AST:AssetSoftware_ CTR:ContractBase and AST:AssetSupport_ CTR:ContractBase and AST:AssetWarranty_

226 Data Management Administration Guide

Transactional data mapping

Spreadsheet TransactionalContract.xls TransactionalContract.xls TransactionalContract.xls TransactionalContract.xls

Tab CTR-GenericContract CTR-MasterContract CTR-WorkLog ASTLicenseCertificates

Staging form CTR:LoadContractBase CTR:LoadContractBase CTR:LoadWorkLog

Target form or forms CTR:ContractBase and CTR:GenericContract_ CTR:ContractBase and CTR:MasterContract_ CTR:WorkLog

AST:LoadLicenseCertificat AST:LicenseCertificates es AST:Connection_BasicQues tions AST:Compliance_BasicQues tions

TransactionalContract.xls TransactionalIncident.xls

CTRCTR:LoadContract_Relatio CTR:Contract_Realtionship Contract_Relationship nship HPD-HelpDesk HPD:LoadHelpDesk HPD:HelpDesk SRM:Request

TransactionalIncident.xls TransactionalIncident.xls

HPD-Associations HPD-WorkLog

This information is on the SHR-Associations tab of Transactional-SharedComponents.xls spreadsheet, HPD:LoadWorkLog HPD:WorkLog SRM:WorkInfo

TransactionalIncident.xls TransactionalProblem.xls TransactionalProblem.xls TransactionalProblem.xls TransactionalProblem.xls TransactionalProblem.xls

HPD-ImpactedAreas PBMProblemInvestigation

HPD:LoadImpactedAreas

HPD:Impacted Areas

PBM:LoadProblemInvestig PBM:Problem Investigation ation

PBMPBM:LoadInvestigationWo PBM:Investigation WorkLog InvestigationWorkLog rkLog PBM-ImpactedAreas PBM-KnownError PBMKnownErrorWorkLog PBM:LoadImpactedAreas PBM:LoadKnownError PBM:ImpactedAreas PBM:Known Error

PBM:LoadKnownErrorWo PBM:Known Error WorkLog rkLog

Appendix E How tabs map from spreadsheet to target form 227

Transactional data mapping

Spreadsheet TransactionalProblem.xls TransactionalProblem.xls TransactionalProblem.xls TransactionalProblem.xls

Tab PBMSolutionDatabase PBM-SolutionAlias PBMSolutionWorkLog

Staging form

Target form or forms

PBM:LoadSolutionDatabas PBM:SolutionDatabase e PBM:LoadSolutionDBAlias PBM:SolutionDBAlias PBM:LoadSolutionWorkLo PBM:SolutionWorkLog g

PBMPBM:SolutionDBAdditiona CFG:Group Event Mapping SolutionDBAdditional lMappings Mapping CFG:GroupEventMapKDB Assoc SHR-Associations SHR:LoadAssociations

TransactionalSharedComponent s.xls

HPD:Associations AST:CMDB Associations PBM:Investigation Associations CHG:Associations

TransactionalSharedComponent s.xls TransactionalSharedComponent s.xls TransactionalSharedComponent s.xls TransactionalSharedComponent s.xls TransactionalSharedComponent s.xls TransactionalTask.xls TransactionalTask.xls TransactionalTask.xls

CFG-Reminders

CFG:LoadReminders

CFG:Reminders

FIN-Costs

FIN:LoadCosts

FIN:Costs

FIN-Payments

FIN:LoadPayments

FIN:Payments

CFG-BroadCast

CFG:LoadBroadcast

CFG:Broadcast

CFGBroadcastSPGAssoc TMS-TaskGroup TMS-Task TMS-WorkInfo

CFG:LoadBroadcastSPGAs CFG:BroadcastSPGAssociation soc TMS:LoadTaskGroup TMS:LoadTask TMS:LoadWorkInfo TMS:TaskGroup TMS:Task TMS:WorkInfo

228 Data Management Administration Guide

F
Loading sample data
This appendix describes how to load the Calbro sample data set if it was not loaded when BMC Remedy ITSM Suite was installed. It also describes how to delete the sample data.

About the sample data

The sample data set is a set of BMC Remedy ITSM records that are based on a fictitious company called Calbro Services. For more information about this company, see the BMC Remedy ITSM Concepts Guide.

Identifying the sample data records

Sample data records fall into two types:
Default sample data, which is loaded for all new installations of BMC Remedy

ITSM, regardless of whether you selected the option in the installation wizard to load the sample data ITSM only if you selected the option in the installation wizard to load the data Optional sample data cannot be loaded for an upgrade.

Optional sample data, which is loaded for only new installations of BMC Remedy

Note

Spreadsheets
The following sets of spreadsheets come with the Data Management client installer:
The generic set of spreadsheets in the 7.6\Spreadsheets folder. These

spreadsheets contain no data. Use these spreadsheets for bulk loading your data.

Appendix F Loading sample data 229

Loading sample data after installation

Sample data in the 7.6\SampleDataSpreadsheets\DefaultAndOptionalData

folder. These spreadsheets contain both default and optional sample data. They provide a complete reference for the sample data.

Sample data in the 7.6\SampleDataSpreadsheets\OptionalData folder. If you

chose not to load sample data at installation time, you can use these spreadsheets to load the sample data.

If you want to use the sample data, you can load it after installing BMC Remedy ITSM by using the Data Load utility. For more information about installing BMC Remedy ITSM and the Data Management tool, see BMC Remedy IT Service Management Installation Guide.

Loading sample data after installation

Refer to the tables in Appendix D of this guide as you follow the procedures in this section. The tables identify which spreadsheets, tabs, and rows of data are default or optional sample data.

To load the sample data after installation

1 Back up the generic spreadsheets that are installed on your client workstation from the 7.6\Spreadsheets folder under the Data Management Client installation path. You must copy the generic spreadsheets back to this location as described in step 5 below if you want to load your own data at another time. By default, the installation path is: C:\Program Files\BMC Software\DataManagementClient. 2 From the 7.6\Spreadsheets\SampleDataSpreadsheets folder, copy the entire OptionalData folder (maintaining the directory structure) to the Spreadsheets folder under the Data Management Client installation path. The default path is: C:\Program Files\BMC Software\DataManagementClient 3 Load the data as described in Chapter 3 "Importing data." 4 Validate and promote the data as described in Chapter 3. 5 When you are done promoting sample data to the system, copy the generic spreadsheets that you backed up earlier back into the Spreadsheets folder.

230 Data Management Administration Guide

Deleting default and optional sample data

Deleting default and optional sample data

If you have installed optional data, or loaded it after installation, you have the option to delete the sample data. BMC recommends that you back up all your data before you delete the sample data. For a detailed information on where the sample data is installed within BMC Remedy ITSM, see Default and optional sample data on page 232.

To delete default or optional sample data

1 To find out which forms you need to search, see Table 57 on page 232. 2 Search the corresponding forms and delete records based on the following values:
DataTags = SEEDDATA DataTags = SOLUTIONDATA

A few of the forms do not have a Data Tags field. These forms are indicated in Table 57 on page 232. For target forms that do not have the DataTags field, identify the default and optional solution data records and delete them. Consider using the following search criteria:
Submitter or Created by field with a value of Remedy Application Service

(ID of 2)

A Create Date that matches the date that the data was loaded A Name that matches the Support Group ID for loaded records on the Support

Group form (for the CTM:LoadSGPOnCall staging form and the CFG:Business Time Workdays target form only)

WARNING Do not delete records based on the creation date only. Before deleting, make sure that the data in these records is sample data.
3 Select the records to be deleted, and select Action => Delete. 4 Save the form.

If a problem occurs
For forms where the Delete button is disabled causing sample data records not able to be deleted, open the forms with BMC Remedy Developer Studio and enable the
Appendix F Loading sample data 231

Deleting default and optional sample data

Delete button from View Properties => Menu Access. After deleting the sample data records, disable the Delete button on the forms.

Default and optional sample data

This section provides information on where the sample data is installed within BMC Remedy ITSM. It lists all of the forms from which removal of sample data is required.
Table 57: Forms with sample data Staging form COM:LoadCompany COM:LoadCompany COM:LoadCompany Target form CTM:SYS-Access Permission Grps COM:Company Alias COM:Company Default or optional sample data? First two rows only (Calbro Services and Invention, Inc.) are default sample data; the rest of the rows are optional sample data. Default Default Default Default Default Default Default Default Default Default Default Default Default

COM:LoadCompanyAlias SIT:LoadSite SIT:LoadSite SIT:LoadSiteAlias SIT:LoadSiteGroup SIT:LoadSiteCompanyAssoc PCT:LoadProductCatalog PCT:LoadProductCatalog PCT:LoadProductCatalog PCT:LoadProductAlias PCT:LoadProdComAssoc PCT:LoadProdModelVersion PCT:LoadModelVersionPatch PCT:LoadProdCatAliasMapping APR:LoadSignature

COM:Company Alias SIT:Site SIT:Site Alias SIT:Site Alias SIT:Site Group SIT:Site Company Association PCT:Product Catalog PCT:Product Alias PCT:ProductCompanyAssociation PCT:Product Alias PCT:ProductCompanyAssociation PCT:Product Model/Version PCT:ModelVersion Patch

PCT:ProductCatalogAliasMappingForm Default AP:Signature Optional Note: This target form does not have a Data Tags field. Optional Optional Optional

CFG:LoadAssignment CFG:LoadBroadcast CFG:LoadBroadcast

CFG:Assignment CFG:Broadcast CFG:BroadcastSPGAssociation

232 Data Management Administration Guide

Deleting default and optional sample data

Staging form CFG:LoadBroadcastSPGAssoc CFG:LoadBusinessTimeHolidays (push default) CFG:LoadBusinessTimeHolidays CFG:LoadBusinessTimeHolidays

Target form CFG:BroadcastSPGAssociation CFG:Business Holidays Storage CFG:Business Holidays Storage Business Time Workdays

Default or optional sample data? Optional Optional Optional Default Note: This target form does not have a Data Tags field. Optional Note: This target form does not have a Data Tags field. Optional Note: This target form does not have a Data Tags field. Optional Optional Optional Default Default Default Default Default Optional Optional Optional Optional Optional Default Default Default Optional Optional Optional Optional

CFG:LoadBusinessTimeHolidays

Business Time Holidays

CFG:LoadBusinessTimeWorkdays

Business Time Workdays

CFG:LoadBusinessTimeWorkdays CFG:LoadDecisionTree CFG:LoadDecisionTreeBranch CFG:LoadGenericCatalog CFG:LoadGenericCPYModuleAssoc CFG:LoadGenericProdSerAssoc CFG:LoadGenericProdSerAssoc CFG:LoadGenericProdSerAssoc CFG:LoadGroupEventMapping CFG:LoadGroupEventMapping CFG:LoadReminders CFG:LoadScripts CFG:LoadScripts CFG:LoadServiceCatalog CFG:LoadServiceCatalog CFG:LoadServiceCatalogAssoc CHG:LoadImpactedAreas CHG:LoadInfraChangeEffortLog CHG:LoadInfrastructureChange CHG:LoadInfrastructureChange

CFG:Business Holidays Storage CFG:Decision Tree CFG:Decision Tree-Branch CFG:Generic Catalog CFG:GenericCompanyModuleAssoc CFG:Generic Catalog CFG:GenericProdServiceAssoc CFG:GenericCompanyModuleAssoc CFG:Group Event Mapping CFG:GroupEventMapScriptAssoc CFG:Reminders CFG:CFG ScriptTagNumGenerator CFG:Scripts CFG:Service Catalog CFG:Service Catalog Assoc CFG:Service Catalog Assoc CHG:Impacted Areas CHG:Infra. Change Effort Log CHG:Infrastructure Change SRM:AppInstanceBridge

Appendix F Loading sample data 233

Deleting default and optional sample data

Staging form CHG:LoadInfrastructureChange CHG:LoadInfrastructureChange CHG:LoadTemplate CHG:LoadTemplate CHG:LoadTemplateAssociations CHG:LoadTemplateSPGAssoc CHG:LoadWorklog CTM:LoadPeople

Target form SRM:Request CHG:Impacted Areas CHG:Template CHG:TemplateSPGAssoc CHG:Template Associations CHG:TemplateSPGAssoc CHG:WorkLog User

Default or optional sample data? Optional Optional Optional Optional Optional Optional Optional Optional Note: This target form does not have a Data Tags field. Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional

CTM:LoadPeople

CTM:People

CTM:LoadPeople (unrestricted access) CTM:People Permission Groups CTM:LoadPeople (Asset Viewer) CTM:LoadPeople (General Access) CTM:LoadPeople CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleAttributes CTM:LoadPeopleOrganization CTM:LoadPeoplePermissionGroups CTM:LoadPeopleTemplate CTM:LoadPeopleTemplate CTM:LoadPeopleTemplatePG CTM:LoadPeopleTemplatePGJoin CTM:People Permission Groups CTM:People Permission Groups FIN:CostCenterUDAAssociations CTM:People IT Skills CTM:People Education CTM:People HR Time Management CTM:Login ID CTM:People Benefit Info CTM:People Travel Profile CTM:People Wallet CTM:People HR Attendance Mgmt CTM:People Attributes CTM:People Organization CTM:People Permission Groups CTM:CFG PTTicket Num Generator CTM:People Template CTM:People Template PG CTM:People Permission Groups

234 Data Management Administration Guide

Deleting default and optional sample data

Staging form CTM:LoadPeopleTemplateSFR

Target form AP:Role

Default or optional sample data? Optional Note: This target form does not have a Data Tags field. Optional Optional Optional Note: This target form does not have a Data Tags field. Optional Optional Optional Optional Optional Optional Optional Optional Optional Default Default Default Note: This target form does not have a Data Tags field. Default Default Default Default Optional Optional Optional Note: This target form does not have a Data Tags field. Optional

CTM:LoadPeopleTemplateSFR CTM:LoadPeopleTemplateSFR CTM:LoadPeopleTemplateSFRJoin

CTM:SupportGroupFunctionalRole CTM:People_Template_SFR CTM:SupportGroupFunctionalRole

CTM:LoadPeopleTemplateSFRJoin CTM:LoadPeopleTemplateSG CTM:LoadPeopleTemplateSGJoin CTM:LoadPeopleTemplateSGJoin CTM:LoadPeopleWorklog CTM:LoadPeopleWorklog CTM:LoadPostalCodes CTM:LoadRegion CTM:LoadSGPAssignments CTM:LoadSGPOnCall CTM:LoadSGPOnCall CTM:LoadSGPOnCall

AP:Role CTM:People Template SG CTM:Support Group Association CTM:People Permission Groups CTM:People WorkLog CTM:People WorkLog CTM:PostalCodes CTM:Region CTM:Support Group Assignments CTM:Support Group On-Call CFG:BusTimeTagGenerator CFG:Business Time Workdays

CTM:LoadSupportGroup CTM:LoadSupportGroup CTM:LoadSupportGroup CTM:LoadSupportGroupAlias CTM:LoadSupportGroupAssociation CTM:LoadSupportGroupAssociation

CTM:Support Group CTM:Support Group Alias CTM:SYS-Access Permission Grps CTM:Support Group Alias CTM:Support Group Association CTM:People Permission Groups

CTM:LoadSupportGroupFunctionalRo AP:Role le

CTM:LoadSupportGroupFunctionalRo CTM:SupportGroupFunctionalRole le

Appendix F Loading sample data 235

Deleting default and optional sample data

Staging form CTR:LoadContract_Relationship CTR:LoadContract_Relationship CTR:LoadContract_Relationship CTR:LoadContract_Relationship CTR:LoadContract_Relationship (parent_ CTR:LoadContract_Relationship (child) CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadContractBase CTR:LoadWorkLog FIN:LoadConfigCostCentersRep FIN:LoadCostCenterUDAAssoc FIN:LoadCostCenterUDAAssoc FIN:LoadCosts FIN:LoadCosts FIN:LoadPayments HPD:LoadHelpDesk HPD:LoadHelpDesk HPD:LoadHelpDesk HPD:LoadHelpDesk HPD:LoadHelpDesk HPD:LoadImpactedAreas HPD:LoadTemplate HPD:LoadTemplate HPD:LoadTemplateAssociations

Target form FIN:Costs FIN:Association FIN:Association AST:CMDB Associations CTR:Contract_Relationship CTR:Contract_Relationship AST:AssetWarranty_ AST:AssetMaintenance_ AST:AssetSoftware_ AST:AssetSupport_ CTR:GenericContract_ CTR:MasterContract_ AST:AssetLease_ CTR:ContractBase CTR:WorkLog FIN:ConfigCostCentersRepository FIN:CostCenterUDAAssociations FIN:CostCenterUDAAssociations FIN:Association FIN:Costs FIN:Payments HPD:Help Desk HPD:Help Desk Assignment Log SRM:AppInstanceBridge SRM:Request SRM:WorkInfo HPD:Impacted Areas HPD:Template HPD:TemplateSPGAssoc HPD:Template Associations

Default or optional sample data? Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Default Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional

236 Data Management Administration Guide

Deleting default and optional sample data

Staging form HPD:LoadWorkLog HPD:LoadWorkLog NTE:LoadCFGNotificationEvents NTE:LoadCFGPagerServiceConfig PBM:LoadImpactedAreas PBM:LoadInvestigationEffortLog PBM:LoadInvestigationWorkLog PBM:LoadKnownError PBM:LoadKnownErrorWorkLog PBM:LoadProblemInvestigation PBM:LoadSolutionDatabase PBM:LoadSolutionDatabase PBM:LoadSolutionDatabase PBM:LoadSolutionDatabase

Target form SRM:WorkInfo HPD:WorkLog NTE:CFG-Notification Events NTE:CFG-Pager Service Config PBM:Impacted Areas PBM:Investigation Effort Log PBM:Investigation WorkLog PBM:Known Error PBM:Known Error WorkLog PBM:Problem Investigation PBM:Solution Database PBM:Solution DB Alias CFG:Group Event Mapping CFG:GroupEventMapKDBAssoc

Default or optional sample data? Optional Optional Optional Default Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional

PBM:LoadSolutionDBAdditionalMapp CFG:Group Event Mapping ings PBM:LoadSolutionDBAdditionalMapp CFG:GroupEventMapKDBAssoc ings PBM:LoadSolutionDBAlias PBM:LoadSolutionWorkLog RQC:LoadSummaryDefinition SHR:LoadAssociations SHR:LoadAssociations SHR:LoadAssociations (reverse) SHR:LoadAssociations (reverse) SHR:LoadAssociations SHR:LoadAssociations (reverse) TMS:LoadAssignmentConfig TMS:LoadAssociationTemplate TMS:LoadAssociationTemplate (task group) TMS:LoadAssociationTemplate (task template) PBM:Solution DB Alias PBM:Solution WorkLog RQC:SummaryDefinition HPD:Associations PBM:Investigation Associations HPD:Associations HPD:Associations AST:CMDB Associations AST:CMDB Associations TMS:AssignmentConfiguration TMS:AssociationTemplate TMS:SummaryData TMS:SummaryData

Appendix F Loading sample data 237

Deleting default and optional sample data

Staging form TMS:LoadAssociationTemplate TMS:LoadAssociationTemplate TMS:LoadFlowTemplate TMS:LoadTask TMS:LoadTask TMS:LoadTask TMS:LoadTask TMS:LoadTask TMS:LoadTaskGroup TMS:LoadTaskGroup TMS:LoadTaskGroup TMS:LoadTaskGroup TMS:LoadTaskGroupTemplate TMS:LoadTaskTemplate TMS:LoadWorkInfo

Target form TMS:FlowTemplate TMS:FlowTemplate TMS:FlowTemplate TMS:Task TMS:Association TMS:MetricsSummary TMS:SummaryData TMS:Flow TMS:TaskGroup TMS:Association TMS:SummaryData TMS:Flow TMS:TaskGroupTemplate TMS:TaskTemplate TMS:WorkInfo

Default or optional sample data? Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional Optional

238 Data Management Administration Guide

G
Modifying foundation data in related applications
The data wizard modifies foundation data in BMC Remedy ITSM forms and in configuration items (CIs). It does not, however, modify foundation data in other applications, such as BMC Service Level Management , BMC Remedy Knowledge Management, and BMC Service Request Management.

Foundation data modified by the data wizard

The following foundation data is modified by the data wizard. If you use the data wizard to modify this data, you must change the same data on applicable applications such as BMC Service Level Management, BMC Remedy Knowledge Management, and BMC Service Request Management.
Table 58: Foundation data modified by the data wizard Data administration type Company Person name Fields containing the value Company First Name Middle Name Last Name Full Name Required filters to find the correct value None Company Person ID Login ID Note: Login ID is a required filter only if the person has a Login ID

Appendix G Modifying foundation data in related applications 239

Foundation data modified by the data wizard

Data administration type Login ID

Fields containing the value

Required filters to find the correct value None

Login ID Submitter Last Modified By Any field that holds a login ID value

Generic categorization

Generic Categorization Tier 1 Generic Categorization Tier 2 Generic Categorization Tier 3

Category Type (required information)

Operational categorization

Operational Categorization Tier 1 Operational Categorization Tier 2 Operational Categorization Tier 3

None

Product categorization

Product Categorization Tier 1 Product Categorization Tier 2 Product Categorization Tier 3 Product Name Manufacturer

None

240 Data Management Administration Guide

Foundation data modified by the data wizard

Data administration type Product model and version

Fields containing the value Product Model/Version

Required filters to find the correct value

Product Categorization Tier 1 Product Categorization Tier 2 Product Categorization Tier 3 Product Name Manufacturer

Site Site information

Site Street Country State/Province City Zip/Postal Code Time Zone

None Site

Support group

Support Organization Support Group Name

Support Company

The data wizard does not update the BMC Service Level Management terms and conditions qualification. You must use BMC Remedy User to manually update fields in the forms shown in Table 59 on page 241.
Table 59: BMC Service Level Management conditions and qualification forms Form name SLM:RuleCondition SLM:ServiceTarget HPD:HPDSLM:Qualbuilder CHG:CHGSLM:Qualbuilder AST:ASTSLM:Qualbuilder Form alias SLM Condition Template Service Target Qualification Builder Qualification Builder Qualification Builder Field name Condition TermsandConditions Qualification Qualification Qualification Field ID 500068600 300271400 300271400 300271400 300271400

Appendix G Modifying foundation data in related applications 241

Foundation data modified by the data wizard

Using BMC Remedy User to update the conditions and qualification forms
To use BMC Remedy User to update the conditions and qualification forms
1 Open one of the forms in search mode. 2 Search for the records to modify. Use the Advanced Search Bar to find records that meet the following criteria:
'Name*' LIKE "SLM00101_TC%"

3 Open the record in modify mode and change the appropriate Terms and Conditions fields. For the HPD:HPDSLM:Qualbuilder, CHG:CHGSLM:Qualbuilder, and AST:ASTSLM:Qualbuilder forms, modify the Qualification (3002714000) field by changing the values of individual fields, and then click Save. For example, open a record in the HPD:HPDSLM:Qualbuilder form in modify mode and change the value of the Product Categorization Tier 1 field by selecting a value from the field list or by typing in the field. When you click Save, the Qualification (3002714000) field is updated. 4 Click Save. 5 Repeat steps 1 through 4 for each of the five forms listed in Table 59 on page 241.

242 Data Management Administration Guide

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Index
A
architecture, data wizard 116 attachments, uploading 74 audit log, data wizard 103 Configuration Item types 195 conventions, documentation 14 counting records 92 creating CSV files 78 CSV files errors creating 56 importing 78 CTM LoadSupportGroupAssociation 74 customizations analyzing impact 109 forms 109, 110 identifying 109 incorporating into data load tool 110 workflow 110

B
BMC Atrium CMDB, about 10 BMC Atrium CMDB, data wizard and 91 BMC discovery products, coordinating update of product categorization with 97 BMC Remedy Asset Management, about 11 BMC Remedy Change Management, about 11 BMC Remedy ITSM Data Management Tool when to use 22 BMC Remedy Knowledge Management data wizard and 91 BMC Service Level Management about 12 data wizard and 91 BMC Service Request Management about 12 data wizard and 91 bulk load customized forms 109 exclusions 191 process overview 15

D
data deleting 90 duplicate 184, 188 invalid 143 mapping 221 mapping, foundation 221 populating in spreadsheets 56 promoting 86 validating 82 data integrity 95, 104 Data Load Console, overview 77 data load staging forms dependencies 137

C
Calbro sample data 229 categorization updating 100 changes to the product 14 CI Type of Relationship 68 company fields SQL statement for data wizard customization 129 values for data wizard customization 125 Index 243

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Data Management tool benchmarks performance for data wizard 21 performance for loading foundation data 18 performance for loading incident records 19 bulk load performance benchmarks 18 data wizard performance benchmarks 21 hardware performance lab environment 18, 20, 21 performance benchmarks loading foundation data 18 loading incident records 19 updating records with data wizard 21 performance lab, hardware and software environments 18, 20, 21 software performance lab 18, 20, 21 data wizard architecture overview 116 audit log 103 BMC Atrium CMDB and 91 BMC Remedy Knowledge Management and 91 BMC Service Level Management and 91 BMC Service Request Management and 91 count action filter 120 customized forms 109, 118 customizing for Company field 125, 129 Generic Categorization field 131 generic categorization fields 126 login ID field 126 Login ID field 130 operational categorization fields 127 Operational Categorization fields 132 Person Name field 125, 129 Product Categorization fields 127, 133 Product Model and Version field 127, 134 Site Information field 128, 134 Site Name field 128, 134 Support Group field 128, 135 discovery local databases and 91 exclusions 191 foundation data and 239 limitations 99 modify action filter 122 new fields on standard forms 123 overview 91 rerunning count or update 106 troubleshooting 105 deleting data 90 dependencies, spreadsheets 58 discovery local databases, data wizard and 91 documentation, related 13 duplicate data errors 184, 188

E
electronic documentation 9 errors CSV fields, creating 56 duplicate data 184, 188 fixing 84 invalid data 143 license compliance 83 messages, benign 81 required fields 174 validation and promotion 89 events, notification 201 exclusions 191

F
field IDs 125 fields custom 110, 113 errors 174 staging form 112 filters count action 120 modify action 122 fixing errors 84 forms custom, and data wizard 118 custom, new 110 geography 191 promoting data into 86 staging, described 110 foundation data data wizard and 239 defined 22 mapping 221 foundation set of spreadsheets 60

G
generic categorization fields SQL statement for data wizard customization 131 values for data wizard customization 126 geography forms, exclusion from bulk load 191

244

Data Management Administration Guide

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

H
halted, data wizard count or update 106 Help online 10 HPD Help Desk form and spreadsheets 68

N
name fields updating using data wizard 98 notification events 201

O
online Help 10 operational categorization fields SQL statement for data wizard customization 132 values for data wizard customization 127

I
identifying customizations 109 incident CI field 68 Service field 68 Incident Management, about 11 Index Term 99 invalid data errors 143

P
people, permission groups, and support groups individual assignment 65 overview 61 templates, assigning using 63 performance benchmarks 17 loading foundation data 18 loading incident records 19 modifying records with data wizard 20 permission groups 61 permissions, staging forms 112 person name fields SQL statement for data wizard customization 129 values for data wizard customization 125 populating data in spreadsheets 56 post-update requirements 104 prerequisites data wizard updates 95 Problem Management, about 12 process setup data defined 22 mapping 224 process templates 66 product categorization fields SQL statement for data wizard customization 133 updating 97 values for data wizard customization 127 product changes 14 product model and version fields SQL statement for data wizard customization 134 values for data wizard customization 127 promoting data into ITSM forms 86

L
license compliance 84 limitations data wizard 99 loading data into new system 58 locales 197 login ID fields SQL statement for data wizard customization 130 values for data wizard customization 126

M
mapping data setup 224 foundation data 221 transactional data 225 migrating data 24 minimum standard configuration 58 modifying data wizard for custom forms 118 data wizard for new fields on standard forms 123 monitoring data wizard for halted count or update 106 thread manager 88

Index

245

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
promotion errors 89 halted 88 halted, recovering from 88 validation 87 spreadsheets assigning permissions using 63, 65 attachments, uploading 74 CTM LoadSupportGroupAssociation 74 dependencies 58 foundation set 60 loading data into new system 58 minimum standard configuration and 58 overview 55 people, permissions, and support groups 61 populating 56 process templates 66 required 57 Service and CI fields 68 Service and CI Fields on HPD Help Desk 68 Support Staff set to Yes 74 tab order 56 task templates 66 staging forms described 110 fields, overview 112 filters, described 111 permissions 112 standard configuration, minimum 58 status reasons 211 summary of changes 14 support group fields SQL statement for data wizard customization 135 values for data wizard customization 128 support groups 61

R
reason codes status 211 timing 211 recovering from halted validation or promotion 88 related documentation 13 relationship types 210 request types 210 required fields, errors 174 requirements, post-update 104 rerunning data wizard count 106 data wizard update 106

S
sample data about 229 deleting 231 loading after installation 230 Service and CI fields 68 site information fields SQL statement for data wizard customization 134 values for data wizard customization 128 site name fields SQL statement for data wizard customization 134 values for data wizard customization 128

T
tab order, spreadsheets 56 target and new value fields 125 target values counting records that use 92 updating 98 task templates 66 thread manager, monitoring 88 time zones 218 timing reasons 211 transactional data defined 23 mapping 225 Transactional-SharedComponents spreadsheet 68 troubleshooting data wizard 105 validation and promotion 87

246

Data Management Administration Guide

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
validation errors 89 halted 88 halted, recovering from 88 troubleshooting 87

U
updating categorization 100 product categorization 97 updating data, prerequisites 95 updating target values 98 uploading attachments 74

W
work log attachments 74 workflow customized 110 modifying for custom data 114

V
validating data 82

Index

247

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

248

Data Management Administration Guide

49532
*174619*