Reference13r1:Concept Apps: Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
Line 13: Line 13:
* innovaphone PBX from version 13r1
* innovaphone PBX from version 13r1


== Objects ==
== App Onjects Parameters ==


=== App ===
App Objects use a common set of parameters to link an App into the PBX. Not all App Objects use all these parameters
 
The App object is the generic mechanism to include an App in innovaphone myApps. The following parameters are used with this object:


;Description, Long Name, Name: Same meaning as for all objects
;Description, Long Name, Name: Same meaning as for all objects
Line 43: Line 41:
;Services: API which is used to get access to APIs provided by other App Services
;Services: API which is used to get access to APIs provided by other App Services
;RCC: Remote Call Control. The functionality including message names and parameters is based on the SOAP API
;RCC: Remote Call Control. The functionality including message names and parameters is based on the SOAP API
== Objects ==
There are different objects, which are used as App Objects. A generic one an some for special purposes.
=== App ===
The App object is the generic mechanism to include an App in innovaphone myApps.


=== AP ===
=== AP ===

Revision as of 13:13, 7 March 2019


The innovaphone PBX allows the integration of Apps into the innovaphone myApps client. An App consists of an App Service from which the App is loaded and executed in the innovaphone myApps client as a Web application inside an iframe. The App Service may be the PBX itself, an AppService running on an innovaphone App Platform, or any other webserver.

The PBX controls which user may use which App. This is the main mechanism for assigning rights to users.

So called App Objects are used in the PBX include Apps into the PBX. The main configuration items in an App Object are the link to an App Service and the password, which acts as a shared secret between the PBX and the App Service, so that the PBX can authenticate the user for the App Service.

There is the generic App Object, which can be used for any App without special integration into the PBX. Some services of the PBX use external App Services (e.g. Push). For these services, some special App Objects are available.

Applies To

  • innovaphone PBX from version 13r1

App Onjects Parameters

App Objects use a common set of parameters to link an App into the PBX. Not all App Objects use all these parameters

Description, Long Name, Name
Same meaning as for all objects
Password
This is the shared secret between the PBX and the App Service. It allows the PBX to authenticate users for the App Service. If an App Service provides a PBX Manager Plugin for configuration, this password is typically set by the Plugin as a random string. Manual configuration of ths password should only done, if there is no other way.
URL
The link to the App Service. This should be configured without filename extension. A postfix of .htm is added to the URL to load the App code as Web application. A postfix of .png is added to load the icon to be displayed in myApps. A size of 100px x 100px is recommended for the icon to have a nice display on 4K monitors.
Licenses
If the App uses Service Licenses, the number of licenses to beused by this service can be configured here. The PBX then tries to acquire licenses of the type Service(<name of the App .htm>)=<number>
Plain website
Indicates that this App service is a website, which does not make use of the authentication provided by the PBX. No App icon can be displayed for this kind of Apps.
Hidden
Apps marked as hidden are not displayed in the myApps client. This kind of Apps is used to provide APIs for other Apps and are loaded automatically when the API is used.
Websocket
If set, the App Object establishes a Websocket connection to the App Service. This way the App Service itself can make use of APIs provided by the PBX.

For each API an App Services wants to use the correspondig flag must be set in the App object to grant access to the API. The available APIs are

PbxSignal
Allows to register an endpoint using the innovaphone Json signaling protocol. Apps like Softphones can use this API
EpSignal
Allows an App to insert itself into the signaling path to a registered endpoint. Apps, which control registered phones and may want to add additional media for calls of endpoints can use this API
Messages
Access to saved chat messages
TableUsers
This API publishes the table "users". This can be used to replicate the PBX users
Admin
Create/Update/Delete Users and other PBX config itemss
PbxApi
User level access to the PBX, with functions like presence monitoring
Services
API which is used to get access to APIs provided by other App Services
RCC
Remote Call Control. The functionality including message names and parameters is based on the SOAP API

Objects

There are different objects, which are used as App Objects. A generic one an some for special purposes.

App

The App object is the generic mechanism to include an App in innovaphone myApps.

AP

An App object, which is used to load the hidden App from a App Platform Manager, which provides the APIs which are needed to configure an AP and load PBX Manager Plugins from the AP

Push

An special App object, which connects to a push service. The PBX uses this to deliver push notifications to smartphones. Any user, which wants to make use of the Push service, needs to have the push object configured as push property.

Voicemail

Executes voicemail scripts and loads the visual voicemail App from a voicemail App Service

Fax

Does the call signaling to FAX interfaces and load the Fax App from a fax App Service