Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Div
stylefloat:right;max-width:35%;padding: 0px 0px 15px 15px;


Panel

On this page:

Table of Contents

Related pages:

Filter by label (Content by label)
showLabelsfalse
max5
spacesDOCS
showSpacefalse
sorttitle
typepage
cqllabel = "configure-smarthandler-mail" and type = "page" and space = "DOCS"currentSpace ( )
labelsdocumentation-space-sample

Related links:


...

  1. In JIRA, click the gear icon, and then click Applications.
  2. Under Integrations, click SmartHandler, and then click the handler in the list.
  3. Click the Data Points tab, and then do one of the following:

    • To create a new data point, click New Data Point.
    • To edit an existing data point, click the row in the list.
  4. In the Define a Data Point section, configure the following settings.

    FieldDescription
    NameEnter a name for the information you want to extract.
    DescriptionEnter a brief description of the extracted value.
    How many results will this Data Point return?If the regular expression will match more than one value in the email, select true, and then indicate the number of expected matches. The add-on will store each matching value as an item in an array. For example, if the email will contain the start time and end time for a maintenance window, you can enter 2, and then define a regular expression that looks for the time pattern.
    Is this a Date or Time?Select the check box if the value is a date or time, and then indicate the expected format. See Defining the Date or Time Format.


  5. In the Create Regex Expression section, define patterns to find the value you want to extract.

    1. (Optional) In the Template column, select the template that most closely matches the pattern you are looking for in the email message.
      The regex for the selected template is automatically populated as the initial regex.
    2. In the Initial Regex column, enter the regex for the entire pattern you are looking for.

      Tip

      The add-on supports the standard JavaScript syntax for regular expressions. To test your regexes, you can use online tools such as regexr.com and regex101.com.

      (Optional) In


    3. Status
      subtletrue
      colourGreen
      titleoptional
       In the Nested Regex column, enter the regex for subset of the initial regex that you want to extract as the value.
      For example, if your initial regex matches a pattern such as Invoice #123456, you can use a nested regex to extract only the number itself as the value of the data point. In this example, the initial regex would be ^Invoice\W#\d{6}$, and the nested regex would be ^\d{6}$. If you don’t enter a nested regex, the entire initial regex is used as the value.
    4. (Optional) To
    5. Status
      subtletrue
      colourGreen
      titleoptional
       To add another regular expression, click the plus sign, and then repeat steps a – d.
      The handler evaluates the regexes in order. If it does not find a match for the first regex, it will evaluate the next regex for a match. The handler stops evaluating subsequent regexes as soon as it finds a match in the email message.

      Info
      titleUse cases for multiple regexes

      This feature allows you to handle differences in formats for the same type of information. For example, an invoice number may be formatted as Invoice #123456 or Invoice #:123456, depending on the sender of the email. Likewise, you may have multiple number formats for invoices from different vendors.


...

  1. In the Define a Data Point section, select the Is this a Date or Time? check box checkbox.
    A menu appears that lists templates for common date and time formats.
  2. Select the template that most closely matches the expected format of the value in the email.
    The pattern for the selected template is automatically populated in the field below the menu.
  3. Edit the pattern to reflect how the value will be formatted in the email message.
    The add-on supports the Java date and time pattern syntax. For example, MM/dd/yyyy for dates formatted such as 10/21/2006. For a complete list of supported formats, see Java Documentation - Customizing Formats.

...