54.2. CTIVO tables

54.2. CTIVO tables
	Chapter 54. CTIVO - Virtual Office

54.2.1. User table

The user table allows the definition of virtual office users.

[11:02:19] ABILIS_CPX:d user:test

Parameter:          | Value:
--------------------+----------------------------------------------------------
USER:                 test
REAL-NAME:            test
ID:                   3             <Read Only>
PWD:                  ***
ACT:                  YES
...
VO:                   YES
VO-CHANNELS:          1
VO-PS-NUM:            SYS
VO-CB-NUM:            SYS
VO-CB-CGO:            SYS
-------------------------------------------------------------------------------

Meaning of the parameters:

VO: Enable/disable Virtual Office for this user [NO, YES].
VO-CHANNELS: Maximum number of simultaneous bearer channels with the user [1..10].
VO-PS-NUM: The number that the CTIVO user should dial to access postselection service. "#" or "SYS" or from 1 up to 20 ['0'..'9'] optionally preceded by TON and/or NP [x, e, d, t, l, p] attributes. Omitted TON is set it to 'u', omitted NP is set to 'x'. When "#", the postselection is disabled for this user. See HELP ISDN ATTRIBUTES for details on attributes.
VO-CB-NUM: The number that the CTIVO user should dial to access callback service. "#" or "SYS" or from 1 up to 20 ['0'..'9'] optionally preceded by TON and/or NP [x, e, d, t, l, p] attributes. Omitted TON is set it to 'u', omitted NP is set to 'x'. When "#", the callback is disabled for this user. See HELP ISDN ATTRIBUTES for details on attributes.
VO-CB-CGO: Number to be used as calling number in callback calls. "#" or "SYS" or from 1 up to 20 ['0'..'9'] optionally preceded by TON and/or NP [x, e, d, t, l, p] attributes and/or PI [a, r, m, q] and/or SI [y, v, w, z] attributes. See HELP ISDN ATTRIBUTES for details on attributes.

54.2.2. Numbers table

The numbers related to the routings to/for the virtual user are specified in a proper table managed by the administrator.

[14:22:57] ABILIS_CPX:d ctivo numbers

- Not Saved (SAVE CONF) -------------------------------------------------------
Total:5/4000 Net-numbers:1 User-numbers:2

--------------------------+----------------------------+-----------------------
  NET-NUM:                |    USER-NUM:               |USER:
* = CUR                   |*   = Current               |
                          | A  = AbilisPhone           |
                          |  n = Contact order         |
--------------------------+----------------------------+-----------------------                   
                          |*   0211223344              |test                   
                          | A  34711223344             |test                   
* 888                     |                            |test                   
-------------------------------------------------------------------------------

Meaning of the parameters:

NET-NUM

NET side numbers assigned to the user.

Markers:

*: Number currently in use. It can be changed with S CTIVO commands by means of 'CUR:' parameter.

USER-NUM

USER side numbers assigned to the user. The value "Abilisphone" indicates VoIP-only entry without number and can be present only once per user.

Markers:

*: Number currently in use. It can be changed with S CTIVO commands by means of 'CUR:' parameter.
A: Number refers to an AbilisPhone. It can be set with S CTIVO commands by means of 'AP:' parameter.
1..3: Contact order. It can be changed with S CTIVO commands by by means of 'SEQ:' parameter.

USER

User name. From 0 up to 32 ASCII printable characters.

Net/User side numbers properties:

CUR: Sets number as current number [NO, YES]. Value YES is shown in D CTIVO commands with '*' mark.

User side numbers properties:

AP

Sets number to be used by a smartphone running Abilisphone [NO, YES]. Value YES is shown in D CTIVO commands with 'A' mark.

SEQ

Sets Contact order [0, 1..3]:

0: the number is not in use;

1..3: first, second, third choice number.

	Note
	Values `1`, `2`, `3` are shown in D CTIVO commands with '`1`' '`2`' '`3`' marks.

In detail to specify how the virtual user is seen from remote parties it's needed to add one or more NET-NUM.

[14:22:57] ABILIS_CPX:a ctivo numbers net-num:888 user:test

COMMAND EXECUTED

To specify the number used as calling number for calls coming from virtual user just use CUR parameter: You will note an asterisk (*) nearby the current number.

[14:22:57] ABILIS_CPX:s ctivo numbers net-num:888 cur:yes

COMMAND EXECUTED

To set the numbers used by virtual office to actually reach the user it's needed to add the user numbers.

[14:22:57] ABILIS_CPX:a ctivo numbers user-num:0211223344 user:test

COMMAND EXECUTED

If a number is associated with an Abilisphone it's possible to declare it via the AP parameter.

[14:22:57] ABILIS_CPX:s ctivo numbers user-num:34711223344 ap:yes

COMMAND EXECUTED

To set the current user number just set the CUR parameter (it will be used if the user is contacted in current mode).

[14:22:57] ABILIS_CPX:s ctivo numbers user-num:0211223344 cur:yes

COMMAND EXECUTED

To set the number priority just set the SEQ parameter (it will be used if the user is contacted in sequence mode).

[14:22:57] ABILIS_CPX:s ctivo numbers user-num:34012121212 seq:1

COMMAND EXECUTED

It's also possible to set the way to call user numbers:

Current number (call the current user number).
Sequence (call the user numbers in sequence).
Fork (call the user numbers in parallel mode).

To set such value and the VoIP parameter it's needed to change user preferences.

Via the numbers specified in this table a couple of automatic lists are created:

NumVoNet
NumVoUser

Such lists are pretty special as they're INN lists. It means that the comparison in such list is TON normalized. So 34711223344 will match also i3934711223344 or 003934711223344. The country is specified in CTISYS parameters.

	Tip
	To change the CTIVO numbers from the web interface follows the chapter Section 61.5, “Virtual Office”

	Tip
	Interesting chapter: Chapter 78, Abilisphone - End user manual.

54.2.3. User Preference table

The preference table includes a Virtual Office section.

[15:20:35] ABILIS_CPX:d pref user:Test2

- Not Saved (SAVE CONF) -------------------------------------------------------
Parameter:          | Value:
--------------------+----------------------------------------------------------
USER:                 test2
ID:                   12                                            <Read Only>
LAST-CHANGE:          08/06/2015 13:19:23 CET                       <Read Only>
PWD:                     
- CTIP not active --
- CLUS not active --
- IAX not active ---
- SIP not active ---
--------------------
VO-CLIP:              TRANSP
VO-ACTION:            ADVANCED (No rules)
VO-CF-RULE:           ALWAYS
VO-CF-TOUT:           15
VO-CF-DLY:            10
VO-CF-FORK-TYPE:      STD
VO-CF-CDO:            #
VO-CF-CGO:            *
VO-VM:                NO
VO-VM-RULE:           NOANS,OTHERS
VO-VM-TOUT:           15
VO-PC-OFFER:          4
VO-PC-ACCEPT:         4
VO-CALL-WAITING:      NO
VO-CUR-NET-NUM:       888
VO-CUR-USER-NUM:      0211223344
VO-CONTACT:           CUR
VO-CONTACT-NUM1:      0211223344
VO-CONTACT-NUM2:      
VO-CONTACT-NUM3:      
VO-CONTACT-SEQ-TOUT:  30
VO-CONTACT-FORK-TOUT: 6
VO-AP-VOIP:           YES
VO-AP-VOIP-CONTACT:   NO
VO-AP-VOIP-CODERS:    SYS
VO-AP-CELL:           YES
VO-AP-PS:             YES
VO-AP-PS-SHORT:       YES
VO-AP-PS-DATA:        YES
VO-AP-CB:             NO
VO-AP-CB-BLIND:       YES
VO-AP-DATA-MOBILE:    YES
VO-AP-WIFI:           YES
VO-AP-SOS-CALLS:      NO
VO-AP-CHAT:           NO
VO-AP-CHAT-TLS:       SYS
VO-AP-CHAT-ROSTER:    ALL
VO-AP-CHAT-CHECK:     SYS
VO-AP-BOOT:           YES
VO-AP-CALL-MODE:      AUTO
VO-AP-ADDRBOOK-SRC:   CTISYS
VO-AP-ENC:            NO
VO-MAIL-FAIL:         NO
VO-MAIL-FWD:          NO
VO-MAIL-SEIZED:       NO
--------------------
...

Meaning of the parameters:

VO-CLIP

VO interface Caller Identification Presentation [RESTRICTED, ALLOWED, TRANSP].

VO-ACTION

VO interface action [ADVANCED, DND, CF, CF-ALWAYS, CF-FORK].

VO-CF-RULE

VO interface call forward rule [ALWAYS, BUSY, NOANS, OTHERS, FORK]. Values [BUSY, NOANS, OTHERS, FORK] can be joined using ',' character. Read Only for VO-ACTION equal to 'CF-ALWAYS' or 'CF-FORK'.

VO-CF-TOUT

VO interface call forward time-out for the 'NOANS' rule [5..180 sec]. Read Only for VO-ACTION equal to 'CF-ALWAYS' or 'CF-FORK'.

VO-CF-DLY

VO interface call forward delay for the 'FORK' rule [0..180 sec]. Read Only for VO-ACTION equal to 'CF-ALWAYS'.

VO-CF-FORK-TYPE

VO interface call forward type of the 'FORK' rule [STD, TWIN]. Read Only for VO-ACTION equal to 'CF-ALWAYS'.

VO-CF-CDO

VO interface call forward output called number. From 1 up to 20 digits in the range ['0'..'9'] or "#" optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes. See HELP ISDN ATTRIBUTES for details on attributes. See HELP ISDN VALUES for details on meaning of special values.

VO-CF-CGO

VO interface call forward output calling number [*, USER].

VO-VM

VO interface voice mail activation/deactivation [NO, YES].

VO-VM-RULE

O interface voice mail rule [ALWAYS, BUSY, NOANS, OTHERS]. Values [BUSY, NOANS, OTHERS] can be joined using ',' character.

VO-VM-TOUT

VO interface voice mail time-out for the 'NOANS' rule [5..180 sec].

VO-PC-OFFER

VO interface Precedence Call Priority Level used when generating a Precedence Call toward CTIR [0..4]. Value '0' is the higest one.

VO-PC-ACCEPT

VO interface Precedence Call Priority Level to be checked for Precedence Call acceptance: the PC is accepted only if the priority is higher (lower value) than currently active call [0..4]. Value '0' is the higest one.

VO-CALL-WAITING

VO interface enable/disable Call Waiting [NO, YES].

VO-CUR-NET-NUM

VO interface NET number currently in use. It must be one of the numbers already configured in CTIVO.

VO-CUR-USER-NUM

VO interface USER number currently in use. It must be one of the numbers already configured in CTIVO.

VO-CONTACT

VO interface rule of contact [CUR, SEQ, FORK]:

CUR: the VO calls the 'VO-CUR-USER-NUM' number;
SEQ: the VO calls simultaneously the sequence of numbers specified in 'VO-CONTACT-NUM1'..'VO-CONTACT-NUM3';
FORK: the VO calls simultaneously both 'VO-CONTACT-NUM1' and 'VO-CONTACT-NUM2'. The third choice number is ignored.

VO-CONTACT-NUM1

VO interface first choice number in case of VO-CONTACT:SEQ and VO-CONTACT:FORK. It must be one of the numbers already configured in CTIVO. From 1 up to 20 digits in the range ['0'..'9'] optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or "#".

VO-CONTACT-NUM2

VO interface second choice number in case of VO-CONTACT:SEQ and VO-CONTACT:FORK. It must be one of the numbers already configured in CTIVO. From 1 up to 20 digits in the range ['0'..'9'] optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or "#".

VO-CONTACT-NUM3

VO interface third choice number (ignored in case of VO-CONTACT:FORK). It must be one of the numbers already configured in CTIVO. From 1 up to 20 digits in the range ['0'..'9'] optionally preceded by TON [u, i, n, o, s, h, c] and/or NP [x, e, d, t, l, p] attributes or "#".

VO-CONTACT-SEQ-TOUT

VO interface maximal time to wait prior to contact the next number when VO-CONTACT:SEQUENCE [10..180 sec].

VO-CONTACT-FORK-TOUT

VO interface time to wait prior to start the forked call when VO-CONTACT:FORK [0..180 sec].

VO-AP-VOIP

VO interface globally enable/disable VoIP calls, incoming and outgoing [NO, YES].

VO-AP-VOIP-CONTACT

VO interface use Abilisphone VoIP channel to reach the user, if available [NO, YES].

VO-AP-VOIP-CODERS

VO interface VoIP coders [SYS, NONE or G.711, Spirit, G.729A, G.711A, G.711u]. Values can be joined using "," operator. The position in the list defines the preference order. The right-most value is the one with the lowest preference.

VO-AP-CELL

VO interface globally enable/disable CELL calls, incoming and outgoing [NO, YES].

VO-AP-PS

VO interface enable/disable PostSelection [NO, YES].

VO-AP-PS-SHORT

VO interface enable/disable PostSelection short delay [NO, YES].

VO-AP-PS-DATA

VO interface enable/disable fast PostSelection [NO, YES].

VO-AP-CB

VO interface enable/disable Callback [NO, YES].

VO-AP-CB-BLIND

VO interface enable/disable blind Callback [NO, YES].

VO-AP-DATA-MOBILE

VO interface enable/disable data over mobile [NO, YES].

VO-AP-WIFI

VO interface enable/disable WiFi [NO, YES].

VO-AP-SOS-CALLS

VO interface enable/disable emergency calls [NO, YES].

VO-AP-CHAT

VO interface enable/disable the user to CHAT [NO, YES].

VO-AP-CHAT-TLS

VO interface CHAT server requires tls [SYS, NO, YES].

VO-AP-CHAT-ROSTER

VO interface allow to hide/show offline contacts [ALL, ONLINE].

VO-AP-CHAT-CHECK

VO interface interval to force CHAT message download [SYS, 0..240 min].

VO-AP-BOOT

VO interface enable/disable Start-At-Boot-Time [NO, YES].

VO-AP-CALL-MODE

VO interface call mode [AUTO, MANUAL].

VO-AP-ADDRBOOK-SRC

VO interface used address book [ENFORCE-PHONE, CTISYS, PHONE, BOTH]:

ENFORCE-PHONE: disable access to CtiSys address book, allowed to administrator only. If set the Abilisphone user cannot set 'CTISYS' or 'BOTH' values.
CTISYS: use CtiSys address book.
PHONE: use phone local address book.
BOTH: use both CtiSys and phone local address books.

VO-AP-ENC

VO interface enable/disable encryption [NO, YES].

VO-MAIL-FAIL

Enable/disable email notification when a call directed to the user fails [NO, YES].

VO-MAIL-FWD

Enable/disable email notification when a call directed to the user is forwarded [NO, YES].

VO-MAIL-SEIZED

Enable/disable email notification when a call directed to the user is seized [NO, YES].

In detail the user may change autonomously the current net and user number (specifying one of the allowed ones).

The user may specify the way to contact the user (VO-CONTACT) and the sequence of numbers is SEQUENCE mode is selected. The user may also specify if the user may be contacted via VoIP/Abilisphone call.

	Tip
	Interesting chapter: Chapter 78, Abilisphone - End user manual.


54.1. CTIVO resource		54.3. CTIVO routings