Work with management packs in the Service Manager Authoring Tool

Important

This version of Service Manager has reached the end of support. We recommend you to upgrade to Service Manager 2022.

Service Manager objects are stored in management packs. To modify an object using the Service Manager Authoring Tool, you open the management pack file that contains that object. To capture changes that you made in the Authoring Tool, you then save the changes in the original management pack file or in a new management pack file. If the original object that you changed is defined in a sealed management pack, you must save your changes in a new or an existing unsealed management pack. Unlike Service Manager, to save modified objects the Authoring Tool manipulates the actual management pack files on the hard drive-in an offline mode, without direct interaction with the Service Manager database.

Later, to implement these changes, you import the management pack file into the Service Manager console, which updates the Service Manager database with the information from the management pack file. You can also import the management pack file into a different environment, such as a production environment. When you import a management pack, the Service Manager server examines the XML code in the management pack file. If the management pack file contains XML code that isn't valid, the management pack isn't imported.

The procedures in this section describe how to work with management pack files in the Authoring Tool.

Open a management pack file in the Authoring Tool

If you want to customize objects that are defined in a management pack in Service Manager, you've to open the management pack file that contains these objects in the Service Manager Authoring Tool. You can use the following procedure to open a management pack file in the Authoring Tool.

The Management Pack Explorer pane in the Authoring Tool displays all the management packs that are open. A management pack that you open and change is designated with an asterisk (*)—for example, CustomMP*—until it's saved.

When you select a management pack file to open, the system opens the specified management pack. In addition, it opens the following management packs:

  • All the other management packs that are located in the same folder as the management pack that you're opening
  • All the management packs in the Library folder in the Service Manager installation folder, for example, in the \Program Files (x86)\Microsoft System Center\Service Manager 2016 Authoring\Library folder
  • All the management packs in the Library folder in the Service Manager installation folder, for example, in the \Program Files (x86)\Microsoft System Center\Service Manager Authoring\Library folder

This is important because the definitions from all open management packs co-exist in the Authoring Tool; therefore, they can't contradict each other.

Note

You can't create new management pack files in the <Authoring Tool Installation>\Library folder.

To open a management pack file

  1. On your desktop, select Start.

  2. Select Service Manager Authoring Tool, and wait for the Authoring Tool to open.

  3. In the Authoring Tool, on the menu bar, select File, and select Open.

  4. In the Open File dialog, select the management pack file that you want to open, and select Open. The file that you select must have an .xml or .mp file name extension. For example, select Management Packs as the file type, and then select the following management pack file:

    <Authoring Tool installation drive>\Program Files (x86)\Microsoft System Center\Service Manager 2016 Authoring\Library\ServiceManager.IncidentManagement.Library.mp

    <Authoring Tool installation drive>\Program Files (x86)\Microsoft System Center\Service Manager Authoring\Library\ServiceManager.IncidentManagement.Library.mp

  5. Wait for the management pack to open, and then verify that it's displayed in the Management Pack Explorer pane.

You can now select the management pack file that you opened, and you can expand Classes, Forms, Workflows, or References to view the objects of the management pack.

Create a new management pack file in the Authoring Tool

To be able to implement customizations that you make in the Service Manager Authoring Tool, you've to save them to a management pack file.

If you customize an object from a sealed management pack, you won't be able to save that customization in the original sealed management pack. In this case, you can either use an existing unsealed management pack or you can create a new management pack, which by default will be unsealed.

You can use the following procedure to create a new management pack file.

To create a new management pack file

  1. On your desktop, select Start.

  2. Select Service Manager Authoring Tool, and wait for the Authoring Tool to open.

  3. In the Authoring Tool, on the menu bar, select File, and select New.

  4. In the New Management Pack dialog, enter a file name and a location for the new management pack file.

    Ensure that the file name that you enter doesn't contain spaces or special characters, and don't specify the Authoring Tool installation folder as the location for new and customized management pack files.

  5. Select Open.

  6. In the Management Pack Explorer, verify that the new management pack is listed.

Next steps