AbstractReportingCloud
in package
Abstract ReportingCloud
Table of Contents
Constants
- DEFAULT_BASE_URI = 'https://api.reporting.cloud'
- Default base URI of backend
- DEFAULT_DATE_FORMAT = 'Y-m-d\\TH:i:sP'
- Default date/time format of backend is 'ISO 8601'
- DEFAULT_TIME_ZONE = 'UTC'
- Default time zone of backend
- DOCUMENT_DIVIDER_NEW_PARAGRAPH = 2
- Document divider - new paragraph
- DOCUMENT_DIVIDER_NEW_SECTION = 3
- Document divider - new section
- DOCUMENT_DIVIDER_NONE = 1
- Document divider - none
- FILE_FORMAT_BMP = 'BMP'
- Bitmap file format
- FILE_FORMAT_DOC = 'DOC'
- DOC file format
- FILE_FORMAT_DOCX = 'DOCX'
- DOCX file format
- FILE_FORMAT_GIF = 'GIF'
- GIF file format
- FILE_FORMAT_HTML = 'HTML'
- HTML file format
- FILE_FORMAT_JPG = 'JPG'
- JPEG file format
- FILE_FORMAT_PDF = 'PDF'
- PDF file format
- FILE_FORMAT_PDFA = 'PDFA'
- PDF/A file format
- FILE_FORMAT_PNG = 'PNG'
- PNG file format
- FILE_FORMAT_RTF = 'RTF'
- RTF file format
- FILE_FORMAT_TX = 'TX'
- TX (Text Control) file format
- FILE_FORMAT_TXT = 'TXT'
- Pure text file format
- FILE_FORMAT_XLSX = 'XLSX'
- XLSX file format
- FILE_FORMATS_DOCUMENT = [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_HTML, self::FILE_FORMAT_PDF, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX]
- Document file formats
- FILE_FORMATS_IMAGE = [self::FILE_FORMAT_BMP, self::FILE_FORMAT_GIF, self::FILE_FORMAT_JPG, self::FILE_FORMAT_PNG]
- Image file formats
- FILE_FORMATS_RETURN = [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_HTML, self::FILE_FORMAT_PDF, self::FILE_FORMAT_PDFA, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX, self::FILE_FORMAT_TXT]
- Return file formats
- FILE_FORMATS_TEMPLATE = [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX]
- Template file formats
- HIGHLIGHT_MODE_ACTIVATED = 2
- Activated highlight mode
- HIGHLIGHT_MODE_ALWAYS = 3
- Always highlight mode
- HIGHLIGHT_MODE_NEVER = 1
- Never highlight mode
- TRACKED_CHANGE_DELETED_TEXT = 8192
- DeletedText tracked change
- TRACKED_CHANGE_INSERTED_TEXT = 4096
- InsertedText tracked change
- DEFAULT_DEBUG = false
- Default debug flag of REST client
- DEFAULT_TEST = false
- Default test flag of backend
- DEFAULT_TIMEOUT = 120
- Default timeout of backend in seconds
- DEFAULT_VERSION = 'v1'
- Default version string of backend
Properties
- $apiKey : string
- Backend API key
- $baseUri : string
- Backend base URI
- $client : Client
- REST client to backend
- $debug : bool
- Debug flag of REST client
- $password : string
- Backend password
- $test : bool
- When true, API call does not count against quota "TEST MODE" watermark is added to document
- $timeout : int
- Backend timeout in seconds
- $username : string
- Backend username
- $version : string
- Backend version string
Methods
- getApiKey() : string
- Return the API key
- getBaseUri() : string
- Return the base URI of the backend web service
- getClient() : Client
- Return the REST client of the backend web service
- getDebug() : bool
- Return the debug flag
- getPassword() : string
- Return the password
- getTest() : bool
- Return the test flag
- getTimeout() : int
- Get the timeout (in seconds) of the backend web service
- getUsername() : string
- Return the username
- getVersion() : string
- Get the version string of the backend web service
- setApiKey() : self
- Set the API key
- setBaseUri() : self
- Set the base URI of the backend web service
- setClient() : self
- Set the REST client of the backend web service
- setDebug() : self
- Set the debug flag
- setPassword() : self
- Set the password
- setTest() : self
- Set the test flag
- setTimeout() : self
- Set the timeout (in seconds) of the backend web service
- setUsername() : self
- Set the username
- setVersion() : self
- Set the version string of the backend web service
- request() : ResponseInterface
- Request the URI with options
- uri() : string
- Construct URI with version number
- getAuthorizationHeader() : string
- Return Authorization Header, with either API key or username and password
Constants
DEFAULT_BASE_URI
Default base URI of backend
public
final string
DEFAULT_BASE_URI
= 'https://api.reporting.cloud'
Tags
DEFAULT_DATE_FORMAT
Default date/time format of backend is 'ISO 8601'
public
final string
DEFAULT_DATE_FORMAT
= 'Y-m-d\\TH:i:sP'
Note, last letter is 'P' and not 'O':
O - Difference to Greenwich time (GMT) in hours (e.g. +0200) P - Difference to Greenwich time (GMT) with colon between hours and minutes (e.g. +02:00)
Backend uses the 'P' variant
Tags
DEFAULT_TIME_ZONE
Default time zone of backend
public
final string
DEFAULT_TIME_ZONE
= 'UTC'
Tags
DOCUMENT_DIVIDER_NEW_PARAGRAPH
Document divider - new paragraph
public
final int
DOCUMENT_DIVIDER_NEW_PARAGRAPH
= 2
DOCUMENT_DIVIDER_NEW_SECTION
Document divider - new section
public
final int
DOCUMENT_DIVIDER_NEW_SECTION
= 3
DOCUMENT_DIVIDER_NONE
Document divider - none
public
final int
DOCUMENT_DIVIDER_NONE
= 1
FILE_FORMAT_BMP
Bitmap file format
public
final string
FILE_FORMAT_BMP
= 'BMP'
FILE_FORMAT_DOC
DOC file format
public
final string
FILE_FORMAT_DOC
= 'DOC'
FILE_FORMAT_DOCX
DOCX file format
public
final string
FILE_FORMAT_DOCX
= 'DOCX'
FILE_FORMAT_GIF
GIF file format
public
final string
FILE_FORMAT_GIF
= 'GIF'
FILE_FORMAT_HTML
HTML file format
public
final string
FILE_FORMAT_HTML
= 'HTML'
FILE_FORMAT_JPG
JPEG file format
public
final string
FILE_FORMAT_JPG
= 'JPG'
FILE_FORMAT_PDF
PDF file format
public
final string
FILE_FORMAT_PDF
= 'PDF'
FILE_FORMAT_PDFA
PDF/A file format
public
final string
FILE_FORMAT_PDFA
= 'PDFA'
FILE_FORMAT_PNG
PNG file format
public
final string
FILE_FORMAT_PNG
= 'PNG'
FILE_FORMAT_RTF
RTF file format
public
final string
FILE_FORMAT_RTF
= 'RTF'
FILE_FORMAT_TX
TX (Text Control) file format
public
final string
FILE_FORMAT_TX
= 'TX'
FILE_FORMAT_TXT
Pure text file format
public
final string
FILE_FORMAT_TXT
= 'TXT'
FILE_FORMAT_XLSX
XLSX file format
public
final string
FILE_FORMAT_XLSX
= 'XLSX'
FILE_FORMATS_DOCUMENT
Document file formats
public
final array<string|int, string>
FILE_FORMATS_DOCUMENT
= [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_HTML, self::FILE_FORMAT_PDF, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX]
FILE_FORMATS_IMAGE
Image file formats
public
final array<string|int, string>
FILE_FORMATS_IMAGE
= [self::FILE_FORMAT_BMP, self::FILE_FORMAT_GIF, self::FILE_FORMAT_JPG, self::FILE_FORMAT_PNG]
FILE_FORMATS_RETURN
Return file formats
public
final array<string|int, string>
FILE_FORMATS_RETURN
= [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_HTML, self::FILE_FORMAT_PDF, self::FILE_FORMAT_PDFA, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX, self::FILE_FORMAT_TXT]
FILE_FORMATS_TEMPLATE
Template file formats
public
final array<string|int, string>
FILE_FORMATS_TEMPLATE
= [self::FILE_FORMAT_DOC, self::FILE_FORMAT_DOCX, self::FILE_FORMAT_RTF, self::FILE_FORMAT_TX]
HIGHLIGHT_MODE_ACTIVATED
Activated highlight mode
public
final int
HIGHLIGHT_MODE_ACTIVATED
= 2
HIGHLIGHT_MODE_ALWAYS
Always highlight mode
public
final int
HIGHLIGHT_MODE_ALWAYS
= 3
HIGHLIGHT_MODE_NEVER
Never highlight mode
public
final int
HIGHLIGHT_MODE_NEVER
= 1
TRACKED_CHANGE_DELETED_TEXT
DeletedText tracked change
public
final int
TRACKED_CHANGE_DELETED_TEXT
= 8192
TRACKED_CHANGE_INSERTED_TEXT
InsertedText tracked change
public
final int
TRACKED_CHANGE_INSERTED_TEXT
= 4096
DEFAULT_DEBUG
Default debug flag of REST client
protected
bool
DEFAULT_DEBUG
= false
Tags
DEFAULT_TEST
Default test flag of backend
protected
bool
DEFAULT_TEST
= false
Tags
DEFAULT_TIMEOUT
Default timeout of backend in seconds
protected
int
DEFAULT_TIMEOUT
= 120
Tags
DEFAULT_VERSION
Default version string of backend
protected
string
DEFAULT_VERSION
= 'v1'
Tags
Properties
$apiKey
Backend API key
private
string
$apiKey
$baseUri
Backend base URI
private
string
$baseUri
$client
REST client to backend
private
Client
$client
$debug
Debug flag of REST client
private
bool
$debug
= false
$password
Backend password
private
string
$password
Tags
$test
When true, API call does not count against quota "TEST MODE" watermark is added to document
private
bool
$test
= false
$timeout
Backend timeout in seconds
private
int
$timeout
$username
Backend username
private
string
$username
Tags
$version
Backend version string
private
string
$version
Methods
getApiKey()
Return the API key
public
getApiKey() : string
Return values
stringgetBaseUri()
Return the base URI of the backend web service
public
getBaseUri() : string
Return values
stringgetClient()
Return the REST client of the backend web service
public
getClient() : Client
Return values
ClientgetDebug()
Return the debug flag
public
getDebug() : bool
Return values
boolgetPassword()
Return the password
public
getPassword() : string
Tags
Return values
stringgetTest()
Return the test flag
public
getTest() : bool
Return values
boolgetTimeout()
Get the timeout (in seconds) of the backend web service
public
getTimeout() : int
Return values
intgetUsername()
Return the username
public
getUsername() : string
Tags
Return values
stringgetVersion()
Get the version string of the backend web service
public
getVersion() : string
Return values
stringsetApiKey()
Set the API key
public
setApiKey(string $apiKey) : self
Parameters
- $apiKey : string
Return values
selfsetBaseUri()
Set the base URI of the backend web service
public
setBaseUri(string $baseUri) : self
Parameters
- $baseUri : string
Return values
selfsetClient()
Set the REST client of the backend web service
public
setClient(Client $client) : self
Parameters
- $client : Client
Return values
selfsetDebug()
Set the debug flag
public
setDebug(bool $debug) : self
Parameters
- $debug : bool
-
Debug flag
Return values
selfsetPassword()
Set the password
public
setPassword(string $password) : self
Parameters
- $password : string
Tags
Return values
selfsetTest()
Set the test flag
public
setTest(bool $test) : self
Parameters
- $test : bool
Return values
selfsetTimeout()
Set the timeout (in seconds) of the backend web service
public
setTimeout(int $timeout) : self
Parameters
- $timeout : int
Return values
selfsetUsername()
Set the username
public
setUsername(string $username) : self
Parameters
- $username : string
Tags
Return values
selfsetVersion()
Set the version string of the backend web service
public
setVersion(string $version) : self
Parameters
- $version : string
Return values
selfrequest()
Request the URI with options
protected
request(string $method, string $uri, array<string|int, mixed> $options) : ResponseInterface
Parameters
- $method : string
-
HTTP method
- $uri : string
-
URI
- $options : array<string|int, mixed>
-
Options
Return values
ResponseInterfaceuri()
Construct URI with version number
protected
uri(string $uri) : string
Parameters
- $uri : string
-
URI
Return values
stringgetAuthorizationHeader()
Return Authorization Header, with either API key or username and password
private
getAuthorizationHeader() : string