Difference between revisions of "Send WaitCall attrNotify list"

Latest revision as of 09:47, 16 May 2011

Overview

This method sends notifications to a list of concrete recipients.

This action can be called in spell code in method send_wait (or send) using call_attr action.

Usage

<source lang="javascript"> void send_wait (int timeout, object top_object, "call_attr", string factory_name, "notify_list",

               string contact_persid, int evt_level, string evt_mtitle, string evt_mbody, string msg_ack, 
               int trans_pt, string parent_object, int is_internal, int cmth_override)

</source>

• timeout - how long (?in seconds?) should the method wait for finishing the method (0 means infinite)
• top_object - root object for the method (on which the method is called)
• attr_name - name of attribute on which the action is called
• factory_name - "cnt" in this case
• contact_persid - list of space (' ') separated persistent IDs of notified contacts
• evt_level - notification level (low, normal, high, emergency)
• evt_mtitle - message subject
• evtmbody - message body (plain text format)
• msg_ack - unknown, but usually empty string: ""
• trans_pt - unknown, but has these values: 28 - for request; 29 - for change and issue
• parent_object - peristent ID of a base object (request, change...); this ticket will refer this notification in a Notification log
• is_internal - probably 0/1; usually 0
• cmth_override - ID of forced Notification method or 0 if method defined for given contact and evt_level should be used

Results

No results.

Examples

<source lang="javascript"> string evt_mtitle, evt_mbody; evt_mtitle = format("Change Order %s - '%s' Event Notify Group", chg_ref_num, event_tmpl.condition.sym); evt_mbody = format("change %s event notification\n", chg_ref_num); evt_mbody += format("priority: %d\n", priority.sym); evt_mbody += format("assigned to: %s\n", assignee.combo_name); evt_mbody += format("requester: %s\n", requestor.combo_name); evt_mbody += format("description: %s\n", description);

int evt_level; evt_level = 2; int trans_pt; trans_pt = 29; string contact_persid;

if (!is_null(group)) {

  contact_persid = misc::find_mang(group);
  if(!is_empty(contact_persid)) {
     send(top_object(), "call_attr", "cnt", "notify_list",
          contact_persid, evt_level, evt_mtitle, evt_mbody, "", trans_pt, persistent_id, 0, 0);
     if (msg_error()) {
        logf(ERROR, format("macro event error on notify_list '%s'", msg[0]));
     }
  }

} </source>