This documentation supports the 18.05 version of Service Desk.

To view the latest version, select the version from the Product version menu.

Troubleshooting email record creation and updates

This topic describes how to troubleshoot email record creation and updates. The Messages tab on the Inbound Email Rule Configuration form provides you with a tool to help you troubleshoot incidents with the email service requests capability.

Issue symptoms

Some service request emails are not processed or not sent.  

Issue scope

One or more users experience this problem.

Resolution

To perform the following procedure, you must have system administrator and Email Rule Config permissions (Email Rule Config is a Foundation related permission).

You must also have permissions to view incident requests, problem investigations, known errors, work orders, and tasks so that you can use the troubleshooting tools. For information about specific Remedy Service Desk permissions, see Incident Management permissions and Problem Management permissions. For information about BMC Service Request Management permissions, see  User permissions.

Perform the following steps:

  1. From the Application list on the left side of the IT Home page, select Administrator Console > Application Administration Console > Custom Configuration > Foundation > Email Engine Rules > Configure Rules.
  2. In Company at the top of the form, select the company for which you are troubleshooting messages.
  3. Click the Messages tab. When this tab opens, it is filtered by Created Today by default. To see messages that were created before today but no more than seven days ago, click Last 7 Days at the top of the tab.
    When working in this tab, if you select Global from the Company menu, you do NOT see messages for all of the companies defined for your installation.

  4. The table on the left of the Messages tab contains a list of the email messages that were received for processing. The Show Messages radio buttons at the top of the tab control this filter. From this table, you can see the message's status (New, Done, or Error). Select a message that you are troubleshooting.

  5. The table on the right of the tab has additional information about the message selected in the table, including a summary of its To, From, and Subject fields. This table also tells you when the message was created, shows the system-generated, unique ID of the message, and indicates the name of the rule, or use case, that the Email Rule Engine ran.

  6. Click one of the following buttons:
    • Transaction — To see details of the email transaction if the transaction failed and you need to investigate the reason
    • View Request — To see the record created by the transaction

Related topics

Record creation and updates by email

Configuring the Email Rule Engine

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Stephen Lumini

    It would be helpful to have a section on how to "re-process" stuck messages. These are messages that did not get processed because they failed all the rules. There is some useful information here: https://communities.bmc.com/docs/DOC-63389

    Aug 07, 2019 04:14