Scripts on CoCoS Server

Introduction

Scripts in CoCoS can operate autonomicly on interval or can be triggerd by an event. And event trigger could be that a tag is changed van 0 to 1.

To create a script we use the scripteditor. Up to version 5.1 all scripts are create in PHP 8. 

Script Arguments

$value	Meegestuurde waarde in het script. Als een script wordt aangestoten vanuit een tag-trigger, dan is de waarde $value de waarde van de tag die de trigger veroorzaakte.
$source	De naam van het 'bron-object' wat zorgde voor de aanroep van dit script. Dit kan bijvoorbeeld de naam van een tag zijn (bij een tag-trigger) of de naam van een item, bijvoorbeeld wanneer een script wordt aangeroepen vanuit een hmi-item / event.
$arguments
$bucket
$trace
$arguments_ref
$return_tag
$cocos	Object (klasse) met functionaliteiten t.b.v. het ophalen/schrijven/aanmaken van tags, alsmede het schrijven van regels in het logboek. Hierbinnen zijn onderstaande methoden/funties beschikbaar.

The Example 

To describe the process of developing and publishing a script will work with an exemple that a connection to an external weather API. This weather API is publicly available and therefore the script is usable for everyone to experiment with. In this example we will activate a tag on temperature limits.