Scheduled Tasks

<?php
 /*
  * We add the method name to the $job_strings array.
  * This is the method that jobs for this scheduler will call.
  */
 $job_strings[] = 'cleanMeetingsScheduler';

 /**
  * Example scheduled job to change any 'Planned' meetings older than a month
  * to 'Not Held'.
  * @return bool
  */
 function cleanMeetingsScheduler(){
   //Get the cutoff date for which meetings will be considered
      $cutOff = new DateTime('now - 1 month');
      $cutOff = $cutOff->format('Y-m-d H:i:s');

      //Get an instance of the meetings bean for querying
   //see the Working With Beans chapter.
   $bean = BeanFactory::getBean('Meetings');

   //Get the list of meetings older than the cutoff that are marked as Planned
   $query = "meetings.date_start < '$cutOff' AND meetings.status = 'Planned'";
   $meetings = $bean->get_full_list('',$query);

   foreach($meetings as $meeting){
     //Mark each meeting as Not Held
     $meeting->status = 'Not Held';
     //Save the meeting changes
     $meeting->save();
   }
   //Signify we have successfully ran
   return true;
}

<?php
//We add the mod string for our method here.
$mod_strings['LBL_CLEANMEETINGSSCHEDULER'] = 'Mark old, planned meetings as Not \
Held';

class SomeClass
 {
     function SomeMethod($bean, $event, $arguments)
     {

         //Perform some setup of the email class
         require_once "include/SugarPHPMailer.php";
         $mailer=new SugarPHPMailer();
         $admin = new Administration();
         $admin->retrieveSettings();
         $mailer->prepForOutbound();
         $mailer->setMailerForSystem();
         $admin = new Administration();
         $admin->retrieveSettings();
         $admin->settings['notify_fromname']
         $mailer->From     = $admin->settings['notify_fromaddress']
         $mailer->FromName = $emailSettings['from_name'];
         $mailer->IsHTML(true);

         //Add message and recipient.
         //We could go all out here and load and populate an email template
         //or get the email address from the bean
         $mailer->Subject = 'My Email Notification! '.$bean->name;
         $mailer->Body = $event. ' fired for bean '.$bean->name;
         $mailer->AddAddress('Jim@example.com');
         return $mailer->Send();
     }
}

class SomeClass
 {
     function SomeMethod($bean, $event, $arguments)
     {
       require_once 'include/SugarQueue/SugarJobQueue.php';
       $scheduledJob = new SchedulersJob();

       //Give it a useful name
       $scheduledJob->name = "Email job for {$bean->module_name} {$bean->id}";

       //Jobs need an assigned user in order to run. You can use the id
       //of the current user if you wish, grab the assigned user from the
       //current bean or anything you like.
       //Here we use the default admin user id for simplicity
       $scheduledJob->assigned_user_id = '1';

       //Pass the information that our Email job will need
       $scheduledJob->data = json_encode(array(
                                             'id' => $bean->id,
                                             'module' => $bean->module_name)
                                         );

       //Tell the scheduler what class to use
       $scheduledJob->target = "class::BeanEmailJob";

       $queue = new SugarJobQueue();
       $queue->submitJob($scheduledJob);
     }
}

class BeanEmailJob implements RunnableSchedulerJob
{
   public function run($arguments)
   {

     //Only different part of the email code.
     //We grab the bean using the supplied arguments.
     $arguments = json_decode($arguments,1);
     $bean = BeanFactory::getBean($arguments['module'],$arguments['id']);

     //Perform some setup of the email class
     require_once "include/SugarPHPMailer.php";
     $mailer=new SugarPHPMailer();
     $admin = new Administration();
     $admin->retrieveSettings();
     $mailer->prepForOutbound();
     $mailer->setMailerForSystem();
     $admin = new Administration();
     $admin->retrieveSettings();
     $mailer->From     = $admin->settings['notify_fromaddress'];
     $mailer->FromName = $emailSettings['from_name'];
     $mailer->IsHTML(true);

     //Add message and recipient.
     //We could go all out here and load and populate an email template
     //or get the email address from the bean
     $mailer->Subject = 'My Email Notification! '.$bean->name;
     $mailer->Body = $event. ' fired for bean '.$bean->name;
     $mailer->AddAddress('Jim@example.com');
     return $mailer->Send();
   }
   public function setJob(SchedulersJob $job)
   {
     $this->job = $job;
   }
}

       $scheduledJob = new SchedulersJob();

       //Give it a useful name
       $scheduledJob->name = "Email job for {$bean->module_name} {$bean->id}";

       //Jobs need an assigned user in order to run. You can use the id
       //of the current user if you wish, grab the assigned user from the
       //current bean or anything you like.
       //Here we use the default admin user id for simplicity
       $scheduledJob->assigned_user_id = '1';

       //Pass the information that our Email job will need
       $scheduledJob->data = json_encode(array(
                                             'id' => $bean->id,
                                             'module' => $bean->module_name)
                                         );

       //Tell the scheduler what class to use
       $scheduledJob->target = "class::BeanEmailJob";

       //Mark this job for 2 retries.
       $scheduledJob->requeue = true;
       $scheduledJob->retry = 2;

SELECT * FROM job_queue ORDER BY date_entered DESC LIMIT 5

SELECT * FROM job_queue WHERE target = 'class::BeanEmailJob'

*************************** 1. row ***************************
assigned_user_id: 1
              id: 6cdf13d5-55e9-946e-9c98-55044c5cecee
            name: Email job for Accounts 103c4c9b-336f-0e87-782e-5501defb5900
         deleted: 0
    date_entered: 2015-03-14 14:58:15
   date_modified: 2015-03-14 14:58:25
    scheduler_id:
    execute_time: 2015-03-14 14:58:00
          status: done
      resolution: success
         message: NULL
          target: class::BeanEmailJob
            data: {"id":"103c4c9b-336f-0e87-782e-5501defb5900","module":"Accounts"}
         requeue: 0
     retry_count: NULL
   failure_count: NULL
       job_delay: 0
          client: CRON3b06401793b3975cd00c0447c071ef9a:7781
percent_complete: NULL
1 row in set (0.00 sec)

php -f cron.php