telephony/CorPolicies

Matrix of group access to telephony services, destinations, and calls between groups.

Applied in cases and calls where a CoS (class of service) is defined for the call initiator and a CoR (class of restrictions) is defined for the destination object. A detailed description of the group access concept is in the article CoS/CoR group access differentiation.

Each matrix record points to the initiator group code, the called subscriber group code, and the service requested with respect to the called subscriber. Each field either contains a specific code (of a CoS group, CoR group, or service feature) or the value 'any', suitable for any code.

Storage type: category.

Table 1. Class fields
Field Description

id

Identifier

comment

Arbitrary comment

src_cos

CoS group code of the call initiator (class of service). The value 'any' covers any code and is used by default.

It is assumed, but not required, that the specified code is contained in the CosProfiles collection.

dst_cor

CoR group code of the called subscriber (class of restrictions). The value 'any' covers any code and is used by default.

It is assumed, but not required, that the specified code is contained in the CorProfiles collection.

feature

Code of the feature requested by the initiator subscriber with respect to the called subscriber.

Possible values:

  • call — direct call to the subscriber. Also applied when checking access to 'vectorrule.opts.cor' and 'featurecode.opts.cor' rules.

  • call_redirect — redirect to the subscriber. 'src_cos' of the called subscriber for whom redirection is configured, and 'dst_cor' of the subscriber to whose number the call should be redirected.

  • call_forward — one-step transfer to the subscriber number. 'src_cos' of the subscriber who initiated the transfer, and 'dst_cor' of the subscriber to whose number the transfer is made.

  • callwaiting — subscriber service feature 'callwaiting' with the subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • pickup — subscriber service feature 'pickup' (call pickup) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • intercom — subscriber service feature 'intercom' (intercom call) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • barge — subscriber service feature 'barge' (intrusion to the subscriber with their current counterpart put on hold) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • replace — subscriber service feature 'replace' (leg replacement in the subscriber dialog with their current counterpart hung up) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • monitor — subscriber service feature 'monitor' (conversation eavesdropping) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • prompt — subscriber service feature 'prompt' (whispering during the conversation) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • mesh — subscriber service feature 'prompt' (connecting to the conversation in three-way mode) with the target subscriber number in the service number postfix. 'src_cos' of the subscriber who initiated the service feature call, and 'dst_cor' of the subscriber whose number is in the service number postfix.

  • any — any of the above features; used by default.

priority

Rule priority. Default 1000.

If the group access policy request context matches several records, they are sorted in descending priority order (increasing priority field value).

time_mask

Record validity schedule. Default 'all'.

Possible variants:

action

Action of the current record. Default 'allow'.

Possible variants:

  • allow — allow the call

  • deny — deny the call

By default the permissive scheme applies: if no matching record is found, the call is considered allowed. A prohibitive record is required to deny.

Available field values

Auxiliary collections for selecting field values in applications: an array {"code", "name"} sorted by code (name — code if no name is set). Collection GET only, domain type worker.

HTTP verb Endpoint Description

GET

/rest/v1/model/telephony/CorPolicies/src_cos/AvailableItems

any and CosProfiles codes

GET

/rest/v1/model/telephony/CorPolicies/dst_cor/AvailableItems

any and CorProfiles codes

GET

/rest/v1/model/telephony/CorPolicies/time_mask/AvailableItems

all, work, non-work, and platform/timetable/TimeTables schedule codes

Example response
GET /rest/v1/model/telephony/CorPolicies/src_cos/AvailableItems HTTP/1.1

HTTP/1.1 200 OK

[{"code": "any", "name": "*"}, {"code": "managers", "name": "Managers"}]