Message

This topic describes how to configure the SAP message settings.

Note: The Message option is available only for Transaction, BAPI/RFM, and GUI Scripting technologies.

To configure message settings

  1. Open the Process file for which you want to configure the message settings, and select Home > Message. The SAP returned messages setting window is displayed.
  2. To configure the display messages, go to Basic Setting and perform the following tasks:
    1. Select the following options from the SAP-returned messages dropdown list:
      • 1-Display only first: Displays only the first message that is returned from SAP to Excel. All other SAP-returned messages are avoided.
      • 2-Display only last: Displays only the last message that is returned from SAP to Excel. All other SAP-returned messages are avoided.
      • Note: We recommend that you do not implement 1-Display only first and 2-Display only last options because of the limitations.

      • 3-Display all: Displays the messages depending on the suboptions you select. For example, select P-Process Runner to display all the messages related to Process Runner. This option is useful for complex transactions that require implementing various security levels.
    2. (Only for GUI Scripting) Select the following options in the What to do when ERROR is encountered section:
      • Continue current transaction: Allows you to select the Ignore 'control not to be found' messages checkbox. If you select this option, the transaction continues irrespective of the warning messages.
      • Stop current transaction: Stops the ongoing transaction.
    3. Select OK. The changes are saved.
  3. (Only for Transaction and BAPI/RFM) To modify the message text, go to Message Text transformation and select the Transform SAP message as per following settings checkbox. The following SAP message modification settings are enabled:
    1. Select the Id and No for which changes must be made and modify the default message and status.

      Note: If the message you want to modify is not listed in the table, you can manually add it by entering the ID, number, return message, and status. You can find the messages in the log column of the Process file after the file is run.

    2. Select OK. The SAP message text and status are configured for the file.

    Note: You can customize message for four SAP parameter values.

    Refer to the video to understand the functionality of SAP Message Text Transformation.

  4. (Only for Transaction and BAPI/RFM) To view the message variable values, go to Return value(s) mapping , and select the Map transaction return values to Excel column checkbox. The return value mapping settings are enabled.
    1.  Select the following options:
      • Auto write to next Excel Column: Places the next value in the next Excel column.
      • Write to Excel column as defined below: Places the next value in the column as per the defined configuration for the Excel value for Value 1 through Excel value for Value 4 fields.
      • Do this only for the last message record: Displays the configured settings for only the last message record.
      • Turn off auto status and log column and use this column: Enables you to specify the Excel column in which Process Runner writes the log.
    2. Select OK. The message variable values are displayed in the selected and Excel-mapped column.  
  5. Note: This feature is useful when message variable values are processed in different connected processes.

  6. (Only for Transaction and BAPI/RFM) To configure the success messages with a hyperlink, go to Hyperlink and select the Add Hyperlink to the success message on each run checkbox. Perform the following steps:
    1. In Transaction Code, enter the transaction code and in Parameter Command, enter the SAP field names for the transaction code and enter the parameter command to get the SAP return message or Excel column value.
      • %IRETVALUE<SAP message number>% returns value from SAP message, such as %IRETVALUE1%.
      • %IVALUE@A% returns value of current row from Excel column.
      • %IVALUE@A2% returns value of Excel cell A2.
      • %IVALUE@A.YEAR% fetches the year from value of current row from Excel column.
      • %IVALUE@A.MONTH% fetches the month from value of current row from Excel column.
      • %IVALUE@A.DAY% fetches the day from value of current row from Excel column.
      • %IVALUE@A.HOUR% fetches the hour from value of current row from Excel column.
      • %IVALUE@A.MINUTE% fetches the minutes from value of current row from Excel column.
      • %IVALUE@A.SECOND% fetches the second from value of current row from Excel column.
      • %IRETURN<SAP message number>.MID(Start Index, Length)% fetches the middle characters value from SAP message, such as %IRETURN1.MID(1,10)%.
    2. To add the SAP User ID to the hyperlink, select the Add SAP UserID to Hyperlink checkbox.
    3. Select OK. A hyperlink is added on each success message that redirects you to the saved data in SAP for the particular run.