XIQS Create SIP Device Group

From IQsimWiki

(Difference between revisions)
Jump to: navigation, search
(Created page with "{{XIQS Command|XIQS Create SIP Device Group|SIP Device Group Management| cmdname=createXIQSVoipDvcGroup| cmdparams=''String'' name , [ ''Long'' id_device ] , ''Integer'' devicety...")
 
(One intermediate revision not shown)
Line 1: Line 1:
 +
{{XIQS Command|XIQS Create SIP Device Group|SIP Device Group Management|
{{XIQS Command|XIQS Create SIP Device Group|SIP Device Group Management|
cmdname=createXIQSVoipDvcGroup|
cmdname=createXIQSVoipDvcGroup|
-
cmdparams=''String'' name , [ ''Long'' id_device ] , ''Integer'' devicetype|
+
cmdparams=''String'' name , [ ''Long'' id_device ] , ''Integer'' devicetype [, ''Long'' '''id_partition''' ]|
-
description=Create a SIP device group
+
description=Create device group. This command will create empty group. Devices are added into group using [[ XIQS Add Device to SIP Device Group| addXIQSVoipDvcGroup ]] function<br>
}}
}}
{{XIQS Parameters|
{{XIQS Parameters|
;''String'' name
;''String'' name
-
:the group name
+
:Group name
;[ ''Long'' id_device ]
;[ ''Long'' id_device ]
:''Optional'': an ISC/ICM id to link this group. Not mandatory when group type is "ISC cluster" (9)
:''Optional'': an ISC/ICM id to link this group. Not mandatory when group type is "ISC cluster" (9)
;''Integer'' devicetype
;''Integer'' devicetype
-
:the group type. Can be one of <ul><li>Gateway - 1</li><li>Endpoint - 3</li><li>Trunk - 5</li><li>ISC cluster - 9</li></ul>''Note'': when no ''id_device'' is specified, the ''devicetype'' can only be "ISC Cluster" (9).
+
:Group type. Can be one of <ul><li>Gateway - 1</li><li>Endpoint - 3</li><li>Trunk - 5</li><li>ISC cluster - 9</li></ul>''Note'': when no ''id_device'' is specified, the ''devicetype'' can only be "ISC Cluster" (9).
 +
;[ ''Long'' '''id_partition''' ]
 +
:Partition Id - Mandatory when current user is administrator.
}}
}}
Line 20: Line 23:
}}
}}
-
{{XIQS See Also|
+
{| class="wikitable collapsible" style="width: 100%;background-color:#EFEEFE;" border="1"   
-
}}
+
! See Also  
 +
|-   
 +
 +
[[ XIQS Add Device to SIP Device Group| addXIQSVoipDvcGroup ]]<br> 
 +
|}
 +
 
 +
{| class="wikitable collapsible" style="width: 100%;background-color:#EFEEFE;" border="1"   
 +
! Example
 +
|-   
 +
 +
<font color="blue">Create GSM Device Group<br>
 +
This command will create group of gsm devices (type=1), whose name is GsmDeviceGroupName which will use ISC with ID=21 on partition 3</font><br>
 +
<?xml version="1.0" encoding="UTF-8"><br>
 +
<command tid="0001" name="<b> createXIQSVoipDvcGroup </b>"><br>
 +
&nbsp;&nbsp;<param type="string">GsmDeviceGroupName</param><br>
 +
&nbsp;&nbsp;<param type="long">21</param><br>
 +
&nbsp;&nbsp;<param type="integer">1</param><br>
 +
&nbsp;&nbsp;<param type="long">3</param><br>
 +
</command><br><br>
 +
<font color="green">[ANSWER (OK)]<br>Group created with ID=25</font><br>
 +
<?xml version="1.0" encoding="UTF-8"?><br>
 +
<event type="return" tid="0001"><br>
 +
&nbsp;&nbsp;<meta-data><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;<meta-value><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<name>id</name><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<pos>1</pos><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;</meta-value><br>
 +
&nbsp;&nbsp;</meta-data><br>
 +
&nbsp;&nbsp;<param type="long">25</param><br>
 +
</event><br>
 +
<br>
 +
<font color="blue">Create Endpoint Group<br>
 +
This command will create group of endpoints (type=3), whose name is EndpointGroupName. ISC ID is not important for this group type, so it is set to 0. Group is created on partition 3</font><br>
 +
<?xml version="1.0" encoding="UTF-8"><br>
 +
<command tid="0002" name="<b> createXIQSVoipDvcGroup </b>"><br>
 +
&nbsp;&nbsp;<param type="string"> EndpointGroupName </param><br>
 +
&nbsp;&nbsp;<param type="long">0</param><br>
 +
&nbsp;&nbsp;<param type="integer">3</param><br>
 +
&nbsp;&nbsp;<param type="long">3</param><br>
 +
</command><br><br>
 +
<font color="green">[ANSWER (OK)]<br>Endpoint Group created with ID=17</font><br>
 +
<?xml version="1.0" encoding="UTF-8"?><br>
 +
<event type="return" tid="0002"><br>
 +
&nbsp;&nbsp;<meta-data><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;<meta-value><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<name>id</name><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<pos>1</pos><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;</meta-value><br>
 +
&nbsp;&nbsp;</meta-data><br>
 +
&nbsp;&nbsp;<param type="long">17</param><br>
 +
</event><br>
 +
<br>
 +
<font color="blue">Create VoIP Trunk Group<br>
 +
This command will create group of VoIP Trunks (type=5), whose name is VoIPTrunkGroupName. ISC ID is not important for this group type, so it is set to 0. Group is created on partition 3</font><br>
 +
<?xml version="1.0" encoding="UTF-8"><br>
 +
<command tid="0003" name="<b> createXIQSVoipDvcGroup </b>"><br>
 +
&nbsp;&nbsp;<param type="string"> VoIPTrunkGroupName </param><br>
 +
&nbsp;&nbsp;<param type="long">0</param><br>
 +
&nbsp;&nbsp;<param type="integer">5</param><br>
 +
&nbsp;&nbsp;<param type="long">3</param><br>
 +
</command><br><br>
 +
<font color="green">[ANSWER (OK)]<br>VoIP Trunk Group created with ID=7</font><br>
 +
<?xml version="1.0" encoding="UTF-8"?><br>
 +
<event type="return" tid="0003"><br>
 +
&nbsp;&nbsp;<meta-data><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;<meta-value><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<name>id</name><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<pos>1</pos><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;</meta-value><br>
 +
&nbsp;&nbsp;</meta-data><br>
 +
&nbsp;&nbsp;<param type="long">7</param><br>
 +
</event><br><br>
 +
<font color="blue">Create ISC Cluster<br>
 +
This command will create ISC Cluster (type=9), whose name is IscClusterName. ISC ID is not important can be set to 0 or this second parameter can be skipped. Group is created on partition 3<br>
 +
Example with second parameter set to 0</font><br>
 +
<?xml version="1.0" encoding="UTF-8"><br>
 +
<command tid="0004" name="<b> createXIQSVoipDvcGroup </b>"><br>
 +
&nbsp;&nbsp;<param type="string"> IscClusterName </param><br>
 +
&nbsp;&nbsp;<param type="long">0</param><br>
 +
&nbsp;&nbsp;<param type="integer">9</param><br>
 +
&nbsp;&nbsp;<param type="long">3</param><br>
 +
</command><br>
 +
<font color="blue">Example without second parameter</font><br>
 +
<?xml version="1.0" encoding="UTF-8"><br>
 +
<command tid="0004" name="<b> createXIQSVoipDvcGroup </b>"><br>
 +
&nbsp;&nbsp;<param type="string"> IscClusterName </param><br>
 +
&nbsp;&nbsp;<param type="integer">9</param><br>
 +
&nbsp;&nbsp;<param type="long">3</param><br>
 +
</command><br><br>
 +
<font color="green">[ANSWER (OK)]<br>ISC Cluster created with ID=22</font><br>
 +
<?xml version="1.0" encoding="UTF-8"?><br>
 +
<event type="return" tid="0004"><br>
 +
&nbsp;&nbsp;<meta-data><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;<meta-value><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<name>id</name><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<pos>1</pos><br>
 +
&nbsp;&nbsp;&nbsp;&nbsp;</meta-value><br>
 +
&nbsp;&nbsp;</meta-data><br>
 +
&nbsp;&nbsp;<param type="long">22</param><br>
 +
</event><br><br>
 +
<br>
 +
|}

Latest revision as of 11:36, 15 January 2019

XIQS Create SIP Device Group - SIP Device Group Management

Description
createXIQSVoipDvcGroup ( String name , [ Long id_device ] , Integer devicetype [, Long id_partition ] )
Create device group. This command will create empty group. Devices are added into group using addXIQSVoipDvcGroup function
Parameters
String name
Group name
[ Long id_device ]
Optional: an ISC/ICM id to link this group. Not mandatory when group type is "ISC cluster" (9)
Integer devicetype
Group type. Can be one of
  • Gateway - 1
  • Endpoint - 3
  • Trunk - 5
  • ISC cluster - 9
Note: when no id_device is specified, the devicetype can only be "ISC Cluster" (9).
[ Long id_partition ]
Partition Id - Mandatory when current user is administrator.
Return Values
Integer ok (=1) -
Error Data structure ( Error Management )
Possible failure code returns
See Also

addXIQSVoipDvcGroup

Example

Create GSM Device Group
This command will create group of gsm devices (type=1), whose name is GsmDeviceGroupName which will use ISC with ID=21 on partition 3

<?xml version="1.0" encoding="UTF-8">
<command tid="0001" name=" createXIQSVoipDvcGroup ">
  <param type="string">GsmDeviceGroupName</param>
  <param type="long">21</param>
  <param type="integer">1</param>
  <param type="long">3</param>
</command>

[ANSWER (OK)]
Group created with ID=25

<?xml version="1.0" encoding="UTF-8"?>
<event type="return" tid="0001">
  <meta-data>
    <meta-value>
      <name>id</name>
      <pos>1</pos>
    </meta-value>
  </meta-data>
  <param type="long">25</param>
</event>

Create Endpoint Group
This command will create group of endpoints (type=3), whose name is EndpointGroupName. ISC ID is not important for this group type, so it is set to 0. Group is created on partition 3

<?xml version="1.0" encoding="UTF-8">
<command tid="0002" name=" createXIQSVoipDvcGroup ">
  <param type="string"> EndpointGroupName </param>
  <param type="long">0</param>
  <param type="integer">3</param>
  <param type="long">3</param>
</command>

[ANSWER (OK)]
Endpoint Group created with ID=17

<?xml version="1.0" encoding="UTF-8"?>
<event type="return" tid="0002">
  <meta-data>
    <meta-value>
      <name>id</name>
      <pos>1</pos>
    </meta-value>
  </meta-data>
  <param type="long">17</param>
</event>

Create VoIP Trunk Group
This command will create group of VoIP Trunks (type=5), whose name is VoIPTrunkGroupName. ISC ID is not important for this group type, so it is set to 0. Group is created on partition 3

<?xml version="1.0" encoding="UTF-8">
<command tid="0003" name=" createXIQSVoipDvcGroup ">
  <param type="string"> VoIPTrunkGroupName </param>
  <param type="long">0</param>
  <param type="integer">5</param>
  <param type="long">3</param>
</command>

[ANSWER (OK)]
VoIP Trunk Group created with ID=7

<?xml version="1.0" encoding="UTF-8"?>
<event type="return" tid="0003">
  <meta-data>
    <meta-value>
      <name>id</name>
      <pos>1</pos>
    </meta-value>
  </meta-data>
  <param type="long">7</param>
</event>

Create ISC Cluster
This command will create ISC Cluster (type=9), whose name is IscClusterName. ISC ID is not important can be set to 0 or this second parameter can be skipped. Group is created on partition 3
Example with second parameter set to 0

<?xml version="1.0" encoding="UTF-8">
<command tid="0004" name=" createXIQSVoipDvcGroup ">
  <param type="string"> IscClusterName </param>
  <param type="long">0</param>
  <param type="integer">9</param>
  <param type="long">3</param>
</command>
Example without second parameter
<?xml version="1.0" encoding="UTF-8">
<command tid="0004" name=" createXIQSVoipDvcGroup ">
  <param type="string"> IscClusterName </param>
  <param type="integer">9</param>
  <param type="long">3</param>
</command>

[ANSWER (OK)]
ISC Cluster created with ID=22

<?xml version="1.0" encoding="UTF-8"?>
<event type="return" tid="0004">
  <meta-data>
    <meta-value>
      <name>id</name>
      <pos>1</pos>
    </meta-value>
  </meta-data>
  <param type="long">22</param>
</event>


Personal tools
Namespaces
Variants
Views
Actions
Navigation
XIQS XML Protocol
XIQS Framework Libraries
XIQS Command List