Skip Headers
JD Edwards EnterpriseOne Tools Workflow Tools Guide
Release 9.1

E24264-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

B System Functions in JD Edwards EnterpriseOne Workflow

This appendix discusses the Send Message Extended system function that you use for JD Edwards EnterpriseOne Workflow.

B.1 Send Message Extended

This system function enables an application to send email messages to users, groups, and so forth. The following table describes the system function parameters:

System Function Parameter Description
To recipient Input, optional. The account or accounts to which to send the email.
Cc recipient Input, optional. The account or accounts to which to send a courtesy copy of the email.
Bcc recipient Input, optional. The account or accounts to which to send a blind courtesy copy of the email.
Mailbox Input, required. The mailbox name to which to deliver the email. The mailbox is used only if the mail is delivered to the Work Center. For mail delivered externally (such as SMTP mail), this parameter is ignored. Set the parameter to a specific mailbox or to an applicable object from the object list.
Subject Input, required. The text to display in the subject line of the email. If the value is <Blank> or <Zero>, and you are basing the email on a DD item using the Message parameter, then the system sets the subject line to the DD item description, if one exists.

Set the parameter to an alphanumeric constant, (<Literal>, <Blank>, <Zero>), or an applicable object from the object list.

Text Input, required. The text to display in the body of the email. Set the parameter to an alphanumeric constant, (<Literal>, <Blank>,<Zero>), or an applicable object from the object list.
Shortcut Input, required. A link to a JD Edwards EnterpriseOne application. Set the parameter to the application to which to link or to <None>.
Message Input, optional. The text to display in the body of the email, based on a DD item glossary. The recipient formatting preferences (for dates, times, and numeric values) as well as language preference (should a translation for the DD item be available) are used when composing the text that represents the message. Set the parameter to the DD item you want to use or to <None>.
Media Object Name Input, optional. The name of the media object to include in the email. Set the parameter to an applicable object from the object list, or to <None>.
Media Object Key Input, optional. The key of the media object to include in the email. Set the parameter to an application object from the object list, or to <None>.

B.1.1 Additional Notes

This system function enables an application to send email messages to users, groups, and so forth.

The Send Message Extended system function supports multiple ways to define the recipient of a message. You can dictate that the message is for a limited group (such as individuals, distribution lists, and so forth), or you can make the recipients dynamic. The delivery method is based on each user's email preferences. You must send the message using at least one of the recipient parameters, although which one you use is immaterial to the system.

When mapping a recipient parameter, these options are available:

  • AB Number

    To send a message to a single user, enter the address book number of a user as the recipient. The mail will be sent to the default contact (contact number 0) for this address book number. Set the parameter to an applicable object from the object list.

    Note:

    JD Edwards EnterpriseOne version 8.10 applications do not employ contacts; therefore, email is sent directly to a user based on the address book number.
  • Contact

    To send a message to an individual in a user's contact list, enter the address book number of a user and then the number of the contact. Set the parameters to an applicable object from the object list.

    Note:

    JD Edwards EnterpriseOne version 8.10 applications do not employ contacts; therefore, this parameter has no effect.
  • Grouped Distribution List

    To send a message to the members of a distribution list, enter the address book number of the list and its structure type. Set the parameters to an applicable object from the object list.

  • Hierarchical Distribution List

    To send a message to the members of a hierarchical distribution list, enter the distribution list structure type, and the address book number of the node to start from in the list. Set the parameters to an applicable object from the object list.

    Note:

    This option is available only from within the JD Edwards EnterpriseOne Workflow Modeler.
  • SMTP Address

    To send a message to a single user, enter the SMTP address of the user as the recipient. Set the parameter to an applicable object from the object list.

  • Define Dynamic Recipient

    This option enables the selection of any kind of recipient at runtime, as opposed to choosing the kind of recipient at design time (AB Number, Contact, Grouped Distribution List, Hierarchy Distribution List, or SMTP Address).

    All the parameters must be mapped to objects from the available object list. At runtime, the recipient is chosen dynamically based on the value of the Recipient Type:

    • Recipient Type is '00':

      This is the equivalent of selecting <None>.

    • Recipient Type is '01':

      This is the equivalent of selecting <Contact>. The subfields Address book Number and Contact Number are used to determine the recipient.

    • Recipient Type is '02':

      This is the equivalent of selecting <AB Number>. The subfield Address book Number is used to determine the recipient.

    • Recipient Type is '03':

      This is the equivalent of selecting <Grouped Distribution List>. The subfields Address book Number and Structure Type are used to determine the recipients where Address book Number is the AB number for the distribution list and Structure Type is the organizational structure, based on user-defined code (UDC) 01/TS.

    • Recipient Type is '04':

      This is the equivalent of selecting <Hierarchical Distribution List>. The subfields Address book Number and Structure Type are used to determine the recipients where Structure Type is the structure and list to use and Address book Number is the point in the hierarchy from which to start.

      Note:

      This hierarchical resolution is available only when you send the email to the JD Edwards EnterpriseOne work center.
    • Recipient Type is '05':

      This is the equivalent of selecting <SMTP Address>. The subfield SMTP Address will be used to determine the recipient.

    • Other values

      Do not use other values, as they are reserved for future use. The list of supported recipient types is defined by UDC 98/SM.

  • None

    To not specify a recipient (use None when a recipient is optional).

    The body of the email can be preset text (Text), or can be based on a DD item (<Message>). In either case, you can include a media object (<Media Object Name> and <Media Object Key>) and/or a link directly to a JD Edwards EnterpriseOne application (<Shortcut>) as well.

    Attachments can be sent with the mail, by providing the Media Object Name and Media Object Key parameters.

    The system function will retrieve the attachments stored within the Media Object specified, and add the data to the mail sent. Only the Media Object 'RTF Text' and 'URL File' attachment types are supported.