innovaphone wiki - User contributions [en]

Reference13r2:Apps/PbxManager/Explorer

2025-10-06T12:34:39Z

Seth Thomas: Remove Group Indications

The PBX Manager Explorer is a tool to search and modify the PBX objects configuration based on xpath expressions.

Care should be taken to apply any changes with the OK buttons. These changes come into effect immediately and cannot be reverted. It is good practise to save a backup of the configuration before applying any modification.

Clicking OK if there is no change is also not advised. It creates an unnecessary write operation.

== The search input ==

The search input is used for an xpath expression to filter the objects. Any object, for which an non-empty set is returned, is selected. If the search input is left empty, the expression "/user" is used, which selects all objects.

An example, which selects all objects with a long name starting With "A" would be

/user[starts-with(@cn, "A")]

== Add ==

To modify the data, an expression to add a tag or attribute can be added, by clicking on the plus icon. For example the expression

device/@hw = hw0

adds a "device" tag with the attribute "hw" set to hw0

== Del ==

By clicking on the minus icon an expression to remove a tag or attribut may be specified

== Display of current configuration ==

In the first window below the expressions, the current configuration for each selected object is displayed

== Preview of changed configuration ==

In the window below the configuration is display as if the changes where applied

== Operations ==

=== OK ===

applies the change to the current object

=== OK(all) ===

applies the change to all objects

=== Skip ===

skips the current object

=== Cancel ===

Cancels the operation. The changes already applied with OK are not reversed

== Examples ==
{{Template:3rd Party Input}}
==== Securing it with boolean object 'alwaystrue' ====
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + @bool = alwaystrue & + ep/@e164 = 88

=== Search all users with number ===
/user[not(pseudo)][@e164]

=== Search all user devices with Innovaphone MAC as hardware ID ===
/user/device[starts-with(@hw,"009033")]

=== Search all user with template "Config User" and remove password ===
/user[@config="Config User"] -> - @pwd - @pwdx

=== Give all phones without app the app phone ===
/user/device[starts-with(@hw,"009033")][not(@app)] -> + @app=phone

=== Give all user devices the flag 'Reverse Proxy' ===
/user[not(pseudo)][@e164]/device[not(@trusted)] -> + @trusted=true

=== Remove the Flag 'TLS only' from all user devices ===
/user[not(pseudo)][@e164]/device[@tls="true"] -> - @tls

=== Set a cfnr to 88 for all users with 'T' as first letter in name ===
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + ep/@e164 = 88

=== Setting an only int cfnr for all users ===

This is required, for example, for softphones that are not registered and internal callers should receive an announcement.

For this you have to enable the Call forward on myApps offline checkbox.

/user[not(pseudo)][@e164] -> + cd/@type = cfnr
Search for the empty cfnr and add the
/user[not(pseudo)][@e164]/cd[not(ep)] -> + ep/@e164 = 88 (or +ep/@h323 = Object-Name)
Add another + and add
+ src/@type = do

Finally, set the only int flag:

/user[not(pseudo)][@e164]/cd/src -> + ep/@ext = false

=== Disable all forkings with app rcc at node 'Testnode' ===
/user[not(pseudo)][@e164][@node="Testnode"]/fork[@app="rcc"][not(@off)] -> + @off = true

=== Give visibility-entries the flag 'visible' ===
This is a helpful job for migrations from V12 to set this in V13 new flag.

/user[not(pseudo)][@e164]/allow[not(@visible)] -> + @visible = true
or this example to remove the visibility flags for all users - new visibility flags can then be rolled out using a Config Template
/user[not(pseudo) and starts-with(@cn, *)] -> -allow

=== Replace all user passwords on users which already have set a password with '1234' ===
/user[not(pseudo)][@e164][@pwd] -> + @pwd = 1234

=== Move all members of Node 'node_old' to 'node_new' ===
/user[@node="_node_HQ"] -> + @node = node_new
Be careful by moving from node 'root', maybe you should use more filter options.

'''Remove Group Indications'''

/user[not(pseudo) ] [@gi] -> -@gi

== Links ==
[https://www.w3schools.com/xml/xpath_intro.asp XPath Tutorial (w3schools.com)]

Reference13r2:Apps/PbxManager/Explorer

2023-08-09T08:08:44Z

Seth Thomas:

The PBX Manager Explorer is a tool to search and modify the PBX objects configuration based on xpath expressions.

Care should be taken to apply any changes with the OK buttons. These changes come into effect immediately and cannot be reverted. It is good practise to save a backup of the configuration before applying any modification.

Clicking OK if there is no change is also not advised. It creates an unnecessary write operation.

== The search input ==

The search input is used for an xpath expression to filter the objects. Any object, for which an non-empty set is returned, is selected. If the search input is left empty, the expression "/user" is used, which selects all objects.

An example, which selects all objects with a long name starting With "A" would be

/user[starts-with(@cn, "A")]

== Add ==

To modify the data, an expression to add a tag or attribute can be added, by clicking on the plus icon. For example the expression

device/@hw = hw0

adds a "device" tag with the attribute "hw" set to hw0

== Del ==

By clicking on the minus icon an expression to remove a tag or attribut may be specified

== Display of current configuration ==

In the first window below the expressions, the current configuration for each selected object is displayed

== Preview of changed configuration ==

In the window below the configuration is display as if the changes where applied

== Operations ==

=== OK ===

applies the change to the current object

=== OK(all) ===

applies the change to all objects

=== Skip ===

skips the current object

=== Cancel ===

Cancels the operation. The changes already applied with OK are not reversed

== Examples ==

=== Search all users with number ===
/user[not(pseudo)][@e164]

=== Search all user devices with Innovaphone MAC as hardware ID ===
/user/device[starts-with(@hw,"009033")]

=== Search all user with template "Config User" and remove password ===
/user[@config="Config User"] -> - @pwd - @pwdx

=== Give all phones without app the app phone ===
/user/device[starts-with(@hw,"009033")][not(@app)] -> + @app=phone

=== Give all user devices the flag 'Reverse Proxy' ===
/user[not(pseudo)][@e164]/device[not(@trusted)] -> + @trusted=true

=== Remove the Flag 'TLS only' from all user devices ===
/user[not(pseudo)][@e164]/device[@tls="true"] -> - @tls

=== Set a cfnr to 88 for all users with 'T' as first letter in name ===
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + ep/@e164 = 88

==== Securing it with boolean object 'alwaystrue' ====
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + @bool = alwaystrue & + ep/@e164 = 88

=== Disable all forkings with app rcc at node 'Testnode' ===
/user[not(pseudo)][@e164][@node="Testnode"]/fork[@app="rcc"][not(@off)] -> + @off = true

=== Give visibility-entries the flag 'visible' ===

This is a helpful job for migrations from V12 to set this in V13 new flag.

/user[not(pseudo)][@e164]/allow[not(@visible)] -> + @visible = true
or this example to remove the visibility flags for all users - new visibility flags can then be rolled out using a Config Template
/user[not(pseudo) and starts-with(@cn, *)] -> -allow

== Links ==
[https://www.w3schools.com/xml/xpath_intro.asp XPath Tutorial (w3schools.com)]

Reference13r2:Apps/PbxManager/Explorer

2023-08-09T08:07:55Z

Seth Thomas:

The PBX Manager Explorer is a tool to search and modify the PBX objects configuration based on xpath expressions.

Care should be taken to apply any changes with the OK buttons. These changes come into effect immediately and cannot be reverted. It is good practise to save a backup of the configuration before applying any modification.

Clicking OK if there is no change is also not advised. It creates an unnecessary write operation.

== The search input ==

The search input is used for an xpath expression to filter the objects. Any object, for which an non-empty set is returned, is selected. If the search input is left empty, the expression "/user" is used, which selects all objects.

An example, which selects all objects with a long name starting With "A" would be

/user[starts-with(@cn, "A")]

== Add ==

To modify the data, an expression to add a tag or attribute can be added, by clicking on the plus icon. For example the expression

device/@hw = hw0

adds a "device" tag with the attribute "hw" set to hw0

== Del ==

By clicking on the minus icon an expression to remove a tag or attribut may be specified

== Display of current configuration ==

In the first window below the expressions, the current configuration for each selected object is displayed

== Preview of changed configuration ==

In the window below the configuration is display as if the changes where applied

== Operations ==

=== OK ===

applies the change to the current object

=== OK(all) ===

applies the change to all objects

=== Skip ===

skips the current object

=== Cancel ===

Cancels the operation. The changes already applied with OK are not reversed

== Examples ==

=== Search all users with number ===
/user[not(pseudo)][@e164]

=== Search all user devices with Innovaphone MAC as hardware ID ===
/user/device[starts-with(@hw,"009033")]

=== Search all user with template "Config User" and remove password ===
/user[@config="Config User"] -> - @pwd - @pwdx

=== Give all phones without app the app phone ===
/user/device[starts-with(@hw,"009033")][not(@app)] -> + @app=phone

=== Give all user devices the flag 'Reverse Proxy' ===
/user[not(pseudo)][@e164]/device[not(@trusted)] -> + @trusted=true

=== Remove the Flag 'TLS only' from all user devices ===
/user[not(pseudo)][@e164]/device[@tls="true"] -> - @tls

=== Set a cfnr to 88 for all users with 'T' as first letter in name ===
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + ep/@e164 = 88

==== Securing it with boolean object 'alwaystrue' ====
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + @bool = alwaystrue & + ep/@e164 = 88

=== Disable all forkings with app rcc at node 'Testnode' ===
/user[not(pseudo)][@e164][@node="Testnode"]/fork[@app="rcc"][not(@off)] -> + @off = true

=== Give visibility-entries the flag 'visible' ===

This is a helpful job for migrations from V12 to set this in V13 new flag.
/user[not(pseudo)][@e164]/allow[not(@visible)] -> + @visible = true
or this example to remove the visibility flags for all users - new visibility flags can then be rolled out using a Config Template
/user[not(pseudo) and starts-with(@cn, *)] -> -allow

== Links ==
[https://www.w3schools.com/xml/xpath_intro.asp XPath Tutorial (w3schools.com)]

Reference13r2:Apps/PbxManager/Explorer

2023-07-31T12:14:03Z

Seth Thomas:

The PBX Manager Explorer is a tool to search and modify the PBX objects configuration based on xpath expressions.

Care should be taken to apply any changes with the OK buttons. These changes come into effect immediately and cannot be reverted. It is good practise to save a backup of the configuration before applying any modification.

Clicking OK if there is no change is also not advised. It creates an unnecessary write operation.

== The search input ==

The search input is used for an xpath expression to filter the objects. Any object, for which an non-empty set is returned, is selected. If the search input is left empty, the expression "/user" is used, which selects all objects.

An example, which selects all objects with a long name starting With "A" would be

/user[starts-with(@cn, "A")]

== Add ==

To modify the data, an expression to add a tag or attribute can be added, by clicking on the plus icon. For example the expression

device/@hw = hw0

adds a "device" tag with the attribute "hw" set to hw0

== Del ==

By clicking on the minus icon an expression to remove a tag or attribut may be specified

== Display of current configuration ==

In the first window below the expressions, the current configuration for each selected object is displayed

== Preview of changed configuration ==

In the window below the configuration is display as if the changes where applied

== Operations ==

=== OK ===

applies the change to the current object

=== OK(all) ===

applies the change to all objects

=== Skip ===

skips the current object

=== Cancel ===

Cancels the operation. The changes already applied with OK are not reversed

== Examples ==

=== Search all users with number ===
/user[not(pseudo)][@e164]

=== Search all user devices with Innovaphone MAC as hardware ID ===
/user/device[starts-with(@hw,"009033")]

=== Search all user with template "Config User" and remove password ===
/user[@config="Config User"] -> - @pwd - @pwdx

=== Give all phones without app the app phone ===
/user/device[starts-with(@hw,"009033")][not(@app)] -> + @app=phone

=== Give all user devices the flag 'Reverse Proxy' ===
/user[not(pseudo)][@e164]/device[not(@trusted)] -> + @trusted=true

=== Remove the Flag 'TLS only' from all user devices ===
/user[not(pseudo)][@e164]/device[@tls="true"] -> - @tls

=== Set a cfnr to 88 for all users with 'T' as first letter in name ===
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + ep/@e164 = 88

==== Securing it with boolean object 'alwaystrue' ====
/user[not(pseudo) and starts-with(@cn, "T")] -> + cd/@type = cfnr 
/user[not(pseudo) and starts-with(@cn, "T")]/cd[not(ep)] -> + @bool = alwaystrue & + ep/@e164 = 88

=== Disable all forkings with app rcc at node 'Testnode' ===
/user[not(pseudo)][@e164][@node="Testnode"]/fork[@app="rcc"][not(@off)] -> + @off = true

=== Give visibility-entries the flag 'visible' ===
{{Template:3rd Party Input}}
This is a helpful job for migrations from V12 to set this in V13 new flag.
/user[not(pseudo)][@e164]/allow[not(@visible)] -> + @visible = true

or this example to remove the visibility flags for all users - new visibility flags can then be rolled out using a Config Template
/user[not(pseudo) and starts-with(@cn, *)] -> -allow

== Links ==
[https://www.w3schools.com/xml/xpath_intro.asp XPath Tutorial (w3schools.com)]

Reference11r1:Phone/User/Function-Keys/Boolean-Object

2019-04-11T13:39:57Z

Seth Thomas: /* Subscribe for Dialog Info */

== Boolean Object ==

This function monitors the state of the addressed [[{{NAMESPACE}}:PBX/Objects/Boolean | Boolean Object ]] in the innovaphone PBX.

'''Note:''' This function will only work if the monitoring user (i.e. the user configuring the key) receives group indications for the boolean object or if ''Subscribe for Dialog Info'' is used.

=== Current State ===
A Boolean Object as seen by the user is in one of four states:

* '''Automatic Off State''': The automatic mode FALSE rule applies
* '''Automatic On State''': The automatic mode TRUE rule applies
* '''Manual Override Off State''': The manual override FALSE rule applies (automatic mode rules are disabled)
* '''Manual Override On State''': The manual override TRUE rule applies (automatic mode rules are disabled)

The function key will indicate the current state of the boolean object as define in the respective ''Text'', ''Icon'' and ''LED'' properties.

=== Boolean Object Identification ===
The number and/or name of the monitored boolean object is configured here.

=== Manual State Toggling ===
If the '''Toggle State''' is set, the function key operates as a toggle key. Each keystroke switches from the current state of the addressed boolean object to the next state in the sequence ''Automatic Off/On State'' / ''Manual Override Off State'' / ''Manual Override On State''.

If there are no ''Text'', ''Icon'' and ''LED'' settings for both the ''Automatic Off State'' and ''Automatic On State'' state, the function key will toggle between the ''Manual Override Off'' and ''Manual Override On'' states only.

'''Note:''' Toggling works only if a number is configured for the Boolean Object.

If this check-mark is '''not''' set pressing the key sets up a connection to the Boolean Object. The state of the Boolean Object can be changed then by entering DTMF codes.

=== Subscribe for Dialog Info ===
If this check-mark is ticked, the function key will obtain the boolean object's state information through a dialog subscription rather than with group indications.

'''Note:''' In order to make both options '''Subscribe for Dialog Info''' and '''Toggle State''' works, the visibility should be also configured with option "note Calls" on the involved Boolean object, otherwise it will not work.

=== DTMF codes ===
Boolean objects can be controlled by calling them directly (i.e. without a function key). See ''Manual Override'' in [[{{NAMESPACE}}:PBX/Objects/Boolean]] for details.

Howto:Simple Linear ACD with Voicemail XML Script

2019-02-25T12:58:30Z

Seth Thomas:

This article describes how to setup a simple automated call distribution by using custom voicemail XML script.

==Applies To==
This information applies to

* innovaphone PBX, V7 hotfix 1

==More Information==
In most cases it is possible to distribute incoming calls on innovaphone PBX as desired by using PBX features like a broadcast call, waiting queue and user groups. But some scenarios require more complex call routing between user objects. For this purpose a custom XML voicemail script can be used to implement a desired call distribution scenario.

This script is based on an example for a simple call flow:
*route incoming call to agents one by one
*try next agent if
**agent is away(CFU is enabled) or not registered
**agent is busy
**agent is not responding after 15 sec.
*at the end, when all agents have been tried
**route call to VM if no busy agents
**disconnect with cause code "busy", if an agent in the call distribution is busy

The call distribution is intentional designed so that the first free agent gets the most calls.

<center>[[Image:Call Distribution Diagramm.png]]</center>

To make the script somewhat generic the numbers of agents and mailbox number are stored in separate files:

; 1.txt : 101
; 2.txt : 102
; 3.txt : 103
; vm.txt : 300

Please note, that this script is exemplary and free and can be modified to fulfill your special requirements.

===Configuration===
The outline for the following configuration scenario shall be as follows:
*Create a new folder on the compact flash card e.g. "acd".
*Place a files provided in the download section in this folder.
*Additionally place the text files with numbers of agents and voicemail box in this folder.
*Create a new voicemail object in the PBX with URL <code>http://127.0.0.1/drive/CF0/acd/acd.xml?$_pbxfwd=true</code>.
*In case an innovaphone voicemail is used instead of an external voicemail box:
**Create a dummy user with a CFU to <VM-Number>+<Box-Number>

===Known Problems===

*Don't forget to provide additional option to the script URL, since it is required for the executing of call forwards: <code>?$_pbxfwd=true</code>
*Make sure there are no administrative CFUs (using boolean, "only not for" etc.) configured on the PBX users/agents.
*Make sure the CFNR Timeout is longer than timeout defined in the ACD XML Script. CFNR defined on User Objects with no registered device are executed immediately.
*If "No Answer" on Trunk Object is configured, configure a CFNR on the ACD VoiceMail Object with "-" (minus sign) as number (see [[Reference7:Administration/PBX/Objects/Edit CFs]] for more information).

== Download ==
*[http://download.innovaphone.com/ice/wiki-src#linearacd http://download.innovaphone.com/ice/wiki-src#linearacd] - download the complete file package of scripts and files described in this article.

== Related Articles ==
[[Howto:How_to_Configure_the_innovaphone_Voicemail|How to Configure the innovaphone Voicemail]]

[[Category:Sample|{{PAGENAME}}]]