ubcgi and ubpost are CGI interface scripts that enable web interaction with the Unibase SaaS application. They act as a fast and secure buffer between the internet and Unibase.
Setting up your httpd server
The httpd server should be set up with a cgi endpoint such as cgi-bin. eg http://somedomain/cgi-bin/ will be the location of the cgi scripts. Then the endpoint for making calls to Unibase will be http://somedomain/cgi-bin/ubpost.
Sample call
A typical call to Unibase might be http://somedomain/cgi-bin/ubpost
ubpost is the target of the unibase.js functions such as unibase.dataCGI (), unibase.idCGI(), and the function key/button clicks in ubprompt.
Arguments
The ubpost query string can be specified as multipart/form-data or application/x-www-form-urlencoded.
- PROMPT_NAME
- Run a unibase form program (ubprompt)
- Content-type: text/html
- ARGUMENTS
- FORM=Y to run the screen form
- KEY_F<number>. Run the script for function key <number>
- General arguments
- REPORT_NAME
- Run a unibase report (ubreport)
- Content-type: text/html
- ARGUMENTS
- MATCH (optional). The -m flag to ubreport
- MATCH_LAST (optional). The -l flag to ubreport
- INPUT_<variable>=<value>. <variable>=<value> is passed as input variables to the report.
- <value>=YES. <value> is passed as an argument to the report.
- <variable>=<value>. New environment <variable> with <value>.
- General arguments
- JSON_NAME
- Run a unibase report (ubreport)
- Content-type: application/json
- ARGUMENTS
- MATCH (optional). The -m flag to ubreport
- MATCH_LAST (optional). The -l flag to ubreport
- INPUT_<variable>=<value>. <variable>=<value> is passed as input variables to the report.
- <value>=YES. <value> is passed as an argument to the report.
- <variable>=<value>. New environment <variable> with <value>.
- General arguments
- XML_NAME
- Run a unibase report (ubreport)
- Content-type: not specified. Report must provide Content-type
- ARGUMENTS
- MATCH (optional). The -m flag to ubreport
- MATCH_LAST (optional). The -l flag to ubreport
- INPUT_<variable>=<value>. <variable>=<value> is passed as input variables to the report.
- <value>=YES. <value> is passed as an argument to the report.
- <variable>=<value>. New environment <variable> with <value>.
- General arguments
- PROC_NAME
- Run a procedure (script) located in $UG_APP/bin (/usr/local/app/<application>/bin)
- Content-type: not specified. Procedure must provide content-type
- ARGUMENTS
- General arguments
- Command arguments
- ITEM_NAME
- Run a unibase selection list (ubitem)
- Content-type: text/html
- ARGUMENTS
- FORM=Y to run the screen form
- General arguments
General arguments
Other arguments of the form <identifier>=<value> can be passed to ubcgi. <identifier> is put in the environment for the command with the value <value>.
Command arguments
Command line arguments can be passed through ubcgi using the form <argument>=YES, or ARG=<argument>
eg PROC_NAME=ls&-l=YES would execute ls -l
eg PROC_NAME=ls&ARG=-l would also execute ls -l