2.26

Author: jorgecc-business-account

README.md

@@ -50,6 +50,7 @@ The target of this library is to ease the process to create a state machine for
     * [Getting a job](#getting-a-job)
     * [Database and jobs.](#database-and-jobs)
     * [Fields used in Job](#fields-used-in-job)
+  * [Flags](#flags)
   * [GUI](#gui)
   * [Classes](#classes)
   * [Cache Configuration](#cache-configuration)
@@ -286,8 +287,8 @@ Types of transition:
 It compares a constant. The binary operator for comparison are
 * = Equals
 * **<>** Not equals
-* **< <=** Less and less than
-* **> >=** Great and great than
+* **< <=** "Less" and "less than"
+* **> >=** "Great" and "greater than"
 * **contain** If a text contains other.
 ```php
 "when field contain 'text'"
@@ -581,6 +582,23 @@ $smachine->deleteJobDB($job); // we delete a specific job.
 * **$isUpdate** bool If the job is updated. It is used to store into the database (update)
 * **$log**  string[]
 
+## Flags
+It is possible to store one or multiples flags inside a job.  
+A flag is a state or value that:
+* It can have a name.
+* It could have a level, for example a level of severity.
+* It could have an expiration time.
+* can have an interchangeable value, such as switch on and switch off.
+* It is associate with a StateMachineOne instance and with a Job.
+
+Example of creates an array of flags:
+
+```php
+$flags=new Flags('flag1', true, $smachine); // the flags is called flag1, $smachine is a state machine 
+$flags->setParent($job); // it is also associate with a job.
+```
+
+
 
 
 ## GUI
@@ -655,6 +673,8 @@ Commonly, the log format could be of the type info or error.   Flag could show a
 Dual license (LGPL 3.0 and Commercial). See LICENSE file.
 
 ## Version
+* 2.26 2024-07-20
+  * added function setRecordEventState(),replayRecordInit() and replayRecordInsideLoop() 
 * 2.25 2024-07-19
   * added function setTime() 
 * 2.24 2024-07-18

example/exampletimeline.php

@@ -1,31 +1,62 @@
 <?php
 
+use eftec\statemachineone\Flags;
 use eftec\statemachineone\StateMachineOne;
 
 include '../vendor/autoload.php';
-
-$smachine=new StateMachineOne(null);
+echo "<h1>Example timeline</h1>";
+echo "This example shows to record a state machine event with times and later replicates it";
+echo "<h2>Initial</h2>";
+$smachine = new StateMachineOne(null);
+$smachine->setRecordEventState(__DIR__ . '/exampletimeline.json', true);
 $smachine->setDefaultInitState(1);
-$smachine->setDocDB('exampledb','col1','folder');
-$smachine->getDocOne()->autoSerialize(true,'json_array');
+$smachine->setDocDB('exampledb', 'col1', 'folder');
+try {
+    $smachine->getDocOne()->deleteCollection('col1');
+    $smachine->getDocOne()->createCollection('col1');
+} catch(Throwable $e) {
+
+}
+$smachine->getDocOne()->autoSerialize(true, 'json_array');
 $smachine->setTime(1000);
 //$smachine->setTime(6000);
+$smachine->setStates([1 => 'init', 2 => 'mid', 3 => 'end']);
+$smachine->fieldDefault = ['v1' => 0, 'flag1' => new Flags('flag1', true, $smachine), 'v3' => 'abc'];
+$smachine->addTransition(1, 1, 'where _time=1005 then flag1.push("a1","abc") and v3="second1005"', 'stay');
+$smachine->addTransition(1, 2, 'where _time>=1010 then flag1.push("a1","xyz") and v3="second1010"', 'change');
+$smachine->addTransition(2, 3, 'where _time>=1020 then and v3="second1020"', 'change');
+$smachine->setTime(1000);
+$job = $smachine->createJob();
+$job->idJob=1;
+for ($i = 1000; $i <= 1020; $i++) {
+    $smachine->setTime($i);
+    $smachine->checkJob($job);
+    //$smachine->recordEventState(__DIR__.'/event.php','php');
+    $r = $job->fields;
+    unset($r['flag1']);
+    echo "State:".json_encode($r)." time:$i<br>";
+}
+$smachine->deleteJobDB($job);
+echo "<h2>replay</h2>\n";
+$smachine->setRecordEventState(__DIR__ . '/exampletimeline2.json', true); // set a new record
+$oldValues = $smachine->replayRecordInit('exampletimeline.json');
+$job = $smachine->createJob();
 
 
-$smachine->setStates([1=>'init',2=>'mid',3=>'end']);
-$smachine->fieldDefault=['v1'=>0];
-$smachine->addTransition(1,2,'where _time>=1010','change');
-$smachine->addTransition(2,3,'where _time>=1020','change');
 
-$job=$smachine->createJob(['v1'=>1]);
+foreach ($oldValues as $row) {
+    $smachine->replayRecordInsideLoop($row,$job);
+    //$r = $job->fields;
+    //unset($r['flag1']);
 
-for($i=1000;$i<=1020;$i++) {
-    $smachine->setTime($i);
-    $smachine->checkAllJobs();
+    $smachine->checkJob($job);
+    $r = $job->fields;
+    unset($r['flag1']);
 
-    $lastJob = $smachine->getLastJob();
-    echo "State:$lastJob->state time:$i<br>";
-}
+    echo "State:".json_encode($r)." time:$i<br>";
 
 
+}
+$smachine->deleteJobDB($job);
+//var_dump($txt);
 //$smachine->saveDBAllJob();

lib/Job.php

@@ -7,7 +7,7 @@
  * Class Job
  * @package  eftec\statemachineone
  * @author   Jorge Patricio Castro Castillo <jcastro arroba eftec dot cl>
- * @version  2.25 2024-07-19
+ * @version  2.27 2024-07-20
  * @link     https://github.com/EFTEC/StateMachineOne
  */
 class Job