Difference between revisions of "Automatically Attach an Event"

From SDU
Jump to: navigation, search
(Step 2. Create the trigger)
(Step 1. Create the script)
Line 3: Line 3:
  
 
== Step 1. Create the script ==
 
== Step 1. Create the script ==
A script is created as an .spl file and placed in the [[NX_ROOT]]/site/mods/majic directory. When the Service Desk service starts, the contents of the majic directory are processed and cached. You can use any naming scheme you like for your .spl file, but it is recommended that the file be preceded with a 'z' for easy identification as a custom file (eg zMyCompany.spl, zcr_scripts.spl, zMyScripts.spl).
+
A script is created as an [[.spl file]] and placed in the [[NX_ROOT]]/site/mods/majic directory. When the Service Desk service starts, the contents of the majic directory are processed and cached. You can use any naming scheme you like for your [[spl file]], but it is recommended that the file be preceded with a 'z' for easy identification as a custom file (eg zMyCompany.spl, zcr_scripts.spl, zMyScripts.spl).
  
 
<!--c1--><div class='codetop'>CODE</div><div class='codemain'><!--ec1-->// User &#39;cr&#39; for Requests, Incidents &amp; Problems, &#39;chg&#39; for Changes, and &#39;iss&#39; for Issues<br>cr&#58;&#58;zmyscript&#40;...&#41;{<br>object group_leader1;<br>object attached_events_table_record1;<br>send_wait&#40;0, top_object&#40;&#41;, "get_co_group"&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>group_leader1 = msg&#91;0&#93;;<br>send_wait&#40; 0, top_object&#40;&#41;, "call_attr", "atev", "get_new_dob", NULL, NULL, group_leader1&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>attached_events_table_record1 = msg&#91;0&#93;;<br>attached_events_table_record1.obj_id = persistent_id;<br>// Enter the persid of the event<br>attached_events_table_record1.event_tmpl = "evt&#58;400001";<br>send_wait&#40;0, group_leader1, "checkin"&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>}<!--c2--></div><!--ec2-->
 
<!--c1--><div class='codetop'>CODE</div><div class='codemain'><!--ec1-->// User &#39;cr&#39; for Requests, Incidents &amp; Problems, &#39;chg&#39; for Changes, and &#39;iss&#39; for Issues<br>cr&#58;&#58;zmyscript&#40;...&#41;{<br>object group_leader1;<br>object attached_events_table_record1;<br>send_wait&#40;0, top_object&#40;&#41;, "get_co_group"&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>group_leader1 = msg&#91;0&#93;;<br>send_wait&#40; 0, top_object&#40;&#41;, "call_attr", "atev", "get_new_dob", NULL, NULL, group_leader1&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>attached_events_table_record1 = msg&#91;0&#93;;<br>attached_events_table_record1.obj_id = persistent_id;<br>// Enter the persid of the event<br>attached_events_table_record1.event_tmpl = "evt&#58;400001";<br>send_wait&#40;0, group_leader1, "checkin"&#41;;<br>if &#40;msg_error&#40;&#41;&#41; {<br>logf&#40;ERROR, "%s - %s", ref_num, msg&#91;0&#93;&#41;;<br>}<br>}<!--c2--></div><!--ec2-->
  
The trigger that will be created in step 2 is the first level filtering. If you need further filtering then utilize an [[if statement]] in the spel code above.
+
The trigger that will be created in step 2 is the first level filtering. If you need further filtering then utilize an [[if statement]] in the [[spel code]] above.
 
<br>
 
<br>
  

Revision as of 03:29, 17 January 2008

This article provides instructions for having system generated Activities set to Internal so it cannot be viewed by users of the Employee or Customer Interfaces.

Step 1. Create the script

A script is created as an .spl file and placed in the NX_ROOT/site/mods/majic directory. When the Service Desk service starts, the contents of the majic directory are processed and cached. You can use any naming scheme you like for your spl file, but it is recommended that the file be preceded with a 'z' for easy identification as a custom file (eg zMyCompany.spl, zcr_scripts.spl, zMyScripts.spl).

CODE
// User 'cr' for Requests, Incidents & Problems, 'chg' for Changes, and 'iss' for Issues
cr::zmyscript(...){
object group_leader1;
object attached_events_table_record1;
send_wait(0, top_object(), "get_co_group");
if (msg_error()) {
logf(ERROR, "%s - %s", ref_num, msg[0]);
}
group_leader1 = msg[0];
send_wait( 0, top_object(), "call_attr", "atev", "get_new_dob", NULL, NULL, group_leader1);
if (msg_error()) {
logf(ERROR, "%s - %s", ref_num, msg[0]);
}
attached_events_table_record1 = msg[0];
attached_events_table_record1.obj_id = persistent_id;
// Enter the persid of the event
attached_events_table_record1.event_tmpl = "evt:400001";
send_wait(0, group_leader1, "checkin");
if (msg_error()) {
logf(ERROR, "%s - %s", ref_num, msg[0]);
}
}

The trigger that will be created in step 2 is the first level filtering. If you need further filtering then utilize an if statement in the spel code above.

Step 2. Create the trigger

This step is to create the trigger that will initiate the script. The methods used to implement the trigger vary based on the Service Desk release. In the examples to follow, the trigger is designed to fire if the Status is being changed to 'Resolved'. Use whatever filter you like for attaching your event.

For r11.x releases triggers are created via the Schema Designer utility. Simply add the following code as a Site-Defined Trigger to the cr (Request), chg (Change Order), or iss (Issue) table.

CODE
POST_VALIDATE zmyscript() 111 FILTER(status{->'RE'});

For older releases triggers are made by creating a .mod file and placing it in the NX_ROOT/site/mods/majic directory. Name the .mod anything you like, but it is recommended that it be preceded with a 'z'.

CODE
MODIFY cr POST_VALIDATE zmyscript() 111 FILTER(status{->'RE'});

MODIFY chg POST_VALIDATE zmyscript() 111 FILTER(status{->'RE'});

MODIFY iss POST_VALIDATE zmyscript() 111 FILTER(status{->'RE'});


Step 3. Publish the Schema changes

The methods used to publish schema changes vary based on the Service Desk release.

For r11.x releases, follow these steps:

  1. Save your Schema changes
  2. Stop the Service Desk service
  3. Run pdm_publish from a command line
  4. Start the Service Desk service

For older release recycle the Service Desk service.