Documentation

    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

Connect an AI assistant

Your AI assistant can read this documentation directly, so it answers from the current content instead of guessing. Add one of the servers below to your client — they use the Model Context Protocol (MCP). Each one covers a different body of content, so add the one you need.

The catalog did not load. Refresh the page to try again.

Loading…

How can we help?

{{docApp.searchError}}

Searching in {{docApp.searchFilterBySpecificBookTitle}}

 {{docApp.currentResultsSearchText}}  in {{docApp.searchFilterBySpecificBookTitle}}
Found {{docApp.searchResponse.totalResultsAvailable}} matches. Showing the top {{docApp.searchResponse.results ? docApp.searchResponse.results.length : 0}}. Use a more specific search to further narrow down the results.
No documentation pages match this search, so all content types are shown. Most matches are in {{docApp.searchDocTypeRescue.best.name}}.
There is no book with the ID "{{docApp.searchBookRescue.bid}}", so the book filter from this link was ignored and results from all books are shown.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!

  • {{resultItem.title}} {{resultItem.matchedBy === 'semantic' ? 'semantic' : (resultItem.matchedBy === 'both' ? 'keyword + semantic' : 'keyword')}}

    {{resultItem.url}}

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

Profile Codes

Profile codes are organized into hierarchical tree structures that you can use to categorize your requests. This kind of categorization can help with your analytics and reporting.

Request profile codes

The request profile codes are used to categorize requests when they are open. These will typically be used to identify a symptom or area of concern. For example, if a user is having trouble with their laptop, the request profile code could be IT:Hardware:Laptop.

Closure profile codes

The closure profile codes are used to categorize requests when they are closed. These will typically be used to identify the resolution or action taken. For example, if a user is having trouble with their laptop and the issue was resolved by replacing the hard drive, the closure profile code could be IT:Hardware:Laptop:Replace Component.

Editor

You can find and configure profiles by navigating to Configuration > Service Manager > Administration > Request Profile Codes or Closure Profile Codes.

This main view shows all of the existing profiles (categories). Some profiles may have been automatically added through the installation of an application; these are pre-configured and ready for use.

You can use the editor to create the hierarchical structure contained within each profile.

Profile settings

Click the Profile Settings button to specify how your organization’s profiles are created. In the Import Profiles dialog, you can configure the following settings:

  • Name. This is preset based on whether the profiles you’re configuring are for opening requests or closing them.
  • Case-insensitive ordering. If you want ordering of profile names to happen regardless of lowercase or uppercase, select the checkbox under the Name field.
  • Code Separator. This separates the hierarchy levels. For example, IT:Software:Install uses the colon character as a separator to distinguish the IT profile as top-level, with Software under it, and with Install under Software.
  • Name Separator. This is shown in the UI to users when viewing a request. For example, using the characters -> as a separator, IT->Software->Install->Action Taken could be a closure category assigned to a request when it has been updated.
  • Maximum Code Length. This specifies the maximum number of characters a code can be created with.
  • Maximum Levels. This specifies the maximum number of hierarchy levels that can be used when creating codes.
  • Minimum Code Length. This specifies the minimum number of characters a code can be created with.
  • Code Allowed Chars. This specifies which characters can be used to create profile codes.

Adding profiles

Click + Top Level Item to start the process of creating a new profile.

To add a new profile within (under) an existing one, click + Item. This creates what is essentially a subcategory.

Deleting profiles

Select an existing profile and then in the properties box, click Delete.

Warning

The existing profiles may be in use; deleting them could have an unintended impact. You could break links, for example in workflows or custom lookups used in other places. Even when a new code set contains the same codes as the originals, the IDs will be different.

Importing profiles

You can use a template (a Microsoft Excel file) to bulk import or bulk update a set of profile codes into your instance.

Warning

When you import profiles, your existing profiles will be overwritten with what’s in the code set spreadsheet you’re importing from. If you want to add or append new profile codes to your existing code set, you must export your current set, add the new codes to that spreadsheet, then import from that.

It’s important to note that the existing profiles may be in use elsewhere, and deleting them could have an unintended impact. You could break links, for example in workflows or custom lookups used in other places. Even when a new code set contains the same codes as the originals, the IDs will be different.

The import scheme assumes the data to import will be on the sheet named Data. Make sure the data is static data. The data import routines do not consider expressions; nor do they run scripts or formulas in cells to get the resultant data.

To get the profile code set template:

  1. Click the down arrow attached to the Import Profiles button.
  2. Select Download xlsx template.
  3. Follow the guidance provided in the Information sheet of the workbook.

To import profiles:

  1. Once you have made changes to the import template to suit your needs, click Import Profiles.
  2. In the Import Profiles dialog, click Upload and import.
  3. Browse for the template you have saved changes to, and click Open.

Exporting profiles

To export profiles:

  1. Click the down arrow attached to the Import Profiles button.
  2. Select your preferred export option for output.
  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document