...
Each of the different types of Custom Logic: Custom Events, Custom API, Custom Validation and Custom ValidationReports share these common syntaxes and available functions.
PCR-360 Data functions
query
Execute read-only SQL query on database.
...
...
language | php |
---|
...
array $this->query ( string $sql, array $bind_parameters );
Parameters
$sql The query string. All data inside the query should be bound with named bind variables or properly escaped.
$bind_parameters An array of key value pairs with elements that are bound parameters in the SQL statement being executed. Array key names match the named bind variables in the SQL statement.
...
List Code of the specified record. Returns NULL if nothing is found.
call
Custom Logic can invoke the API endpoints by using the call function. This function allows passing data from the logic to the API endpoint. When invoking this from the Custom API this feature call functions will follow the same API permissions granted the API Key that is being used.
Code Block | ||
---|---|---|
| ||
/*
$apiFunction Options:
saveService, saveServiceDesk, saveContact, saveCable, saveGla, saveEquipment, saveLocation,
renderCustomReport, renderCableViewPath
*/
array $this->call (string $method, array $params, bool $commitOnSuccess) |
Parameters
$method The callable method name. The available callable methods: saveCable, saveContact, saveEquipment, saveGla, saveService, and saveServiceDesk
$params An array of key payload data that is passed to the other API calling function.
$commitOnSuccess A True/False value telling PCR-360 whether to commit the database transaction successful call or not. When True, if a call is successful, PCR-360 will commit the change. When not provided with a True, the function will assume False is desired, and if an error occurs down the line, any successful changes will be rolled back. This parameter is ignored for Custom Validations.
Return Values
The function returns a result array containing 'data' which specifies the outcome of the call. For a successful call to saveServiceDesk, this array contain the Service Desk item/action that was created.
Example
In this example, the $payload array contains all the parameters required to create a Service Order and Action
Code Block | ||
---|---|---|
| ||
$result = $this->call("saveServiceDesk", $payload);
$response["servicedesk_number"] = $result["data"]; |
Example
In this example, the Contact API is being invoked via the Custom API endpoint
Code Block | ||
---|---|---|
| ||
$contact_request = [
"customer_number" => "ABC123",
"last_name" => "Help",
"first_name" => "PCR",
"email" => "help@pcr.com",
"email_directory" => 1,
"phone_number" => "616-555-1212",
"phone_primary" => 1,
"phone_type" => 1234, // RECID from Lists
"phone_directory" => 1,
"status" => 1,
"contact_directory" => 1,
"contact_types" => "CUSTOMER",
];
$result_contact = $this->call("saveContact", $contact_request);
if($result_contact["status"] == "success") {
$response["contact"] = $result_contact["data"];
} |
debug
The debug command outputs to a cache which is then displayed in the Debug tab/grid for the Custom Logic you are debugging.
Example
In this example, the debug function is being invoked.
Example debug use
Code Block | ||
---|---|---|
| ||
$this->debug(); |
...
Include Page | ||
---|---|---|
|
Child pages (Children Display) | ||||
---|---|---|---|---|
|