API Dokumentation

API Dokumentation / Wiki

Die folgenden Seiten geben einen Überblick über die Funktionen des API (Programmierschnittstelle) des hyper Content & Digital Asset Management Servers.
Bitte beachten Sie, dass Sie in der Regel nur wenige Funktionen für die Entwicklung von Plugins oder speziellen Template-Funktionen, wie automatische Erstellung einer Navigation, Sitemap und so weiter, benötigen. Bitte studieren Sie den Template Designers Guide und Programers Guide für eine bessere Einsicht in die Handhabung dieser Funktionen.
Das API dient primär für die Umsetzung eigenständiger Anwendungen, die die Funktionen des hyper Content & Digital Asset Management Servers nutzen. Das API ist nicht mit dem OpenAPI zu verwechseln, welchen auf einer SOA (Service Oriented Architecture) basiert und nicht Bestandteil der Free Edition ist.

Fragen und Antworten bitte innerhalb der Google Group.

hyperCMS API Function Reference

▲ Report API Functions

createreport

Description
This function creates a new report.

Syntax
createreport ($report_name)

Input parameters

$report_name ... report name [string]

global input parameters

$user
$eventsystem
$mgmt_config
$hcms_lang
$lang

Output

result array

editreport

Description
This function saves the configuration of a report.

Syntax
editreport ($report_name, $config)

Input parameters

$report_name ... report name [string]
$config ... report configuration [array]

global input parameters

$user
$eventsystem
$mgmt_config
$hcms_lang
$lang

Output

result array

loadreport

Description
This function loads the report configuration file and provides the data as array.

Syntax
loadreport ($report_name)

Input parameters

$report_name ... report name [string]

global input parameters

$user
$eventsystem
$mgmt_config
$hcms_lang
$lang

Output

result array / false

deletereport

Description
This function deletes a report

Syntax
deletereport ($report_name)

Input parameters

$report_name ... report name [string]

global input parameters

$user
$eventsystem
$mgmt_config
$hcms_lang
$lang

Output

result array

analyzeSQLattributes

Description
This function analyzes the SQL Select or Where attributes and return its parts in an array

Syntax
analyzeSQLattributes ($str)

Input parameters

$str ... string with comma separated values [string]

Output

result array / false on error

analyzeSQLselect

Description
This function analyzes an SQL Select statement and return its parts in an array

Syntax
analyzeSQLselect ($sql)

Input parameters

$sql ... SQL statement [string]

Output

result array

showpiechart

Description
This function creates the Google Chart Code for a pie chart. The Google Chart API need to be loaded first!

Syntax
showpiechart ($title="", $x_title="", $x_value="", $y_title="", $y_value="", $data_array=array(), $width="100%", $height="100%", $id="hcmsPieChart", $suffix="", $loadAPI=true)

Input parameters

$title ... chart title [string]
$x_title ... chart x-axis title [string]
$x_value ... chart x-axis array key name holding the values [string]
$y_title ... chart y-axis title [string]
$y_value ... chart y-axis array key name holding the values [string]
$data_array ... assoz. data array [array]
$width ... chart width [string] (optional)
$height ... chart height [string] (optional)
$id ... ID of chart [string] (optional)
$suffix ... function name suffix [string] (optional)
$loadAPI ... load Google Chart API [boolean] (optional)

global input parameters

$mgmt_config
$hcms_lang
$lang
$user

Output

Google Chart code / false

showcolumnchart

Description
This function creates the Google Chart Code for a column chart. The Google Chart API need to be loaded first!

Syntax
showcolumnchart ($title="", $x_title="", $x_value="", $y1_title="", $y1_value="", $y2_title="", $y2_value="", $y3_title="", $y3_value="", $data_array=array(), $width="100%", $height="100%", $id="hcmsColumnChart", $suffix="", $loadAPI=true)

Input parameters

$title ... chart title [string]
$x_title ... chart x-axis title [string]
$x_value ... chart x-axis array key name holding the values [string]
$y1_title ... chart y1-axis title [string]
$y1_value ... chart y1-axis array key name holding the values [string]
$y2_title ... chart y2-axis title [string]
$y2_value ... chart y2-axis array key name holding the values [string]
$y3_title ... chart y3-axis title
$y3_value ... chart y3-axis array key name holding the values [string]
$data_array ... assoz. data array [array]
$width ... chart width [string] (optional)
$height ... chart height [string] (optional)
$id ... ID of chart [string] (optional)
$suffix ... function name suffix [string] (optional)
$loadAPI

global input parameters

$mgmt_config
$hcms_lang
$lang
$user

Output

Google Chart code / false

showareachart

Description
This function creates the Google Chart Code for an area chart. The Google Chart API need to be loaded first!

Syntax
showareachart ($title="", $x_title="", $x_value="", $y1_title="", $y1_value="", $y2_title="", $y2_value="", $y3_title="", $y3_value="", $data_array=array(), $width="100%", $height="100%", $id="hcmsAreaChart", $suffix="", $loadAPI=true)

Input parameters

$title ... chart title [string]
$x_title ... chart x-axis title [string]
$x_value ... chart x-axis array key name holding the values [string]
$y1_title ... chart y1-axis title [string]
$y1_value ... chart y1-axis array key name holding the values [string]
$y2_title ... chart y2-axis title [string]
$y2_value ... chart y2-axis array key name holding the values [string]
$y3_title ... chart y3-axis title
$y3_value ... chart y3-axis array key name holding the values [string]
$data_array ... assoz. data array [array]
$width ... chart width [string] (optional)
$height ... chart height [string] (optional)
$id ... ID of chart [string] (optional)
$suffix ... function name suffix [string] (optional)
$loadAPI

global input parameters

$mgmt_config
$hcms_lang
$lang
$user

Output

Google Chart code / false

showtimelinechart

Description
This function creates the Google Chart Code for a timeline chart. The Google Chart API need to be loaded first!

Syntax
showtimelinechart ($title="", $y_title="", $y_value="", $x1_title="", $x1_value="", $x2_title="", $x2_value="", $data_array=array(), $width="100%", $height="100%", $id="hcmsTimelineChart", $suffix="", $loadAPI=true)

Input parameters

$title ... chart title [string]
$y_title ... chart y-axis title [string]
$y_value ... chart y-axis array key name holding the values [string]
$x1_title ... chart x1-axis title
$x1_value ... chart x1-axis array key name holding the values [string]
$x2_title ... chart x2-axis title [string]
$x2_value ... chart x2-axis array key name holding the values [string]
$data_array ... assoz. data array [array]
$width ... chart width [string] (optional)
$height ... chart height [string] (optional)
$id ... ID of chart [string] (optional)
$suffix ... function name suffix [string] (optional)
$loadAPI ... load Google Chart API [boolean] (optional)

global input parameters

$mgmt_config
$hcms_lang
$lang
$user

Output

Google Chart code / false

showgeolocationchart

Description
This function creates the Google Maps Code for a geolocation chart. The Google Maps API need to be loaded first!

Syntax
showgeolocationchart ($title="", $marker_value="", $lat_value="", $lng_value="", $link_value="", $data_array=array(), $width="100%", $height="100%", $id="hcmsGeolocationChart", $suffix="", $loadAPI=true)

Input parameters

$title ... chart title [string]
$marker_value ... array key name holding the value for the marker title [string]
$lat_value ... array key name holding the value for the latitude of the marker [string]
$lng_value ... array key name holding the value for the longitude of the marker [string]
$link_value ... array key name holding the value for the marker link [string]
$data_array ... assoz. data array [array]
$width ... chart width [string] (optional)
$height ... chart height [string] (optional)
$id ... ID of chart [string] (optional)
$suffix ... function name suffix [string] (optional)
$loadAPI ... load Google Maps API [boolean] (optional)

global input parameters

$mgmt_config
$hcms_lang
$lang
$user

Output

Google Chart code / false