[Index]
Fully automated on boarding of a Shared Architecture Customer
Model ref.: view/AddSharedCustomer
The full URL would include the host-proxy name: https://[host-proxy].
Variables are enclosed in square brackets.
{
"$schema": "http://json-schema.org/draft-03/schema",
"type": "object",
"properties": {
"name": {
"description": "Customer name. Can only use characters between A-Z, a-z, 0-9, _ and -",
"title": "Name",
"pattern": "^[A-Za-z0-9_-]{1,60}$",
"required": true,
"type": "string"
},
"domain": {
"required": true,
"type": "string",
"description": "Customer domain",
"title": "Domain"
},
"admin_firstname": {
"type": "string",
"description": "First name of the customer administrator",
"title": "Customer Admin First Name"
},
"admin_lastname": {
"type": "string",
"description": "Last name of the customer administrator",
"title": "Customer Admin Last Name"
},
"admin_email": {
"required": true,
"type": "string",
"description": "Email of the customer administrator",
"title": "Customer Admin Email"
},
"admin_telephone_number": {
"type": "string",
"description": "Telephone number of the customer administrator",
"title": "Customer Admin Telephone Number "
},
"customer_id": {
"type": "string",
"description": "Unique identifier for this Customer",
"title": "Customer ID"
},
"address1": {
"type": "string",
"description": "Address 1",
"title": "Address 1"
},
"address2": {
"type": "string",
"description": "Address 2",
"title": "Address 2"
},
"city": {
"type": "string",
"description": "City",
"title": "City"
},
"state": {
"type": "string",
"description": "State or Province",
"title": "State or Province"
},
"postal_code": {
"type": "string",
"description": "Postal Code",
"title": "Postal Code"
},
"country": {
"target": "/api/data/Countries/choices/?field=country_name&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"description": "Customer country",
"required": true,
"target_attr": "country_name",
"title": "Country",
"type": "string",
"target_model_type": "data/Countries",
"choices": []
},
"ucprepProfile": {
"type": "string",
"description": "UCPrep Profile to optionally push per customer",
"title": "UCPrep Profile"
},
"sites": {
"items": {
"type": "object",
"properties": {
"name": {
"title": "Name",
"pattern": "^[A-Za-z0-9_-]{1,60}$",
"required": false,
"displayable": true,
"type": "string"
},
"site_id": {
"type": "string",
"description": "Unique identifier for this Site",
"title": "Site ID"
},
"address1": {
"type": "string",
"description": "Address 1",
"title": "Address 1"
},
"address2": {
"type": "string",
"description": "Address 2",
"title": "Address 2"
},
"city": {
"type": "string",
"description": "City",
"title": "City"
},
"state": {
"type": "string",
"description": "State or Province",
"title": "State or Province"
},
"postal_code": {
"type": "string",
"description": "Postal Code",
"title": "Postal Code"
},
"country": {
"target": "/api/data/Countries/choices/?field=country_name&format=json&hierarchy=[hierarchy]&auth_token=[authtoken],
"format": "uri",
"description": "Site country",
"required": false,
"target_attr": "country_name",
"title": "Country",
"type": "string",
"target_model_type": "data/Countries",
"choices": []
},
"area": {
"required": false,
"type": "string",
"title": "Area"
},
"area_code": {
"pattern": "^[0-9]+$",
"required": false,
"type": "string",
"title": "Area code"
},
"number_allocation": {
"default": "Automatic",
"choices": [
{
"value": "Automatic",
"title": "Automatic"
},
{
"value": "Manual",
"title": "Manual"
},
{
"value": "None",
"title": "None"
}
],
"type": "string",
"title": "Number Allocation"
},
"number_range_length": {
"title": " Number Range Required",
"default": "10",
"required": true,
"choices": [
{
"value": "10",
"title": "10"
},
{
"value": "100",
"title": "100"
},
{
"value": "1000",
"title": "1000"
}
],
"type": "string"
},
"valid_range": {
"required": false,
"type": "string",
"title": "Number range"
},
"e164_range_start": {
"pattern": "^$|^(\\\\\\+)?[0-9]+$|^\\+?[0-9]+$",
"required": false,
"type": "string",
"title": "DID (E164) Range Start"
},
"dn_range_start": {
"required": false,
"type": "string",
"title": "Internal (DN) Range Start"
},
"published_number": {
"is_password": false,
"description": "The site published number is the default E164 mask when a line is associated to a phone, device profile, or remote destination profile at a particular site. The default CUCM phone line E164 mask, default CUCM device profile line E164 mask, and the default CUCM remote destination profile line E164 mask in the site default doc are updated with this number, unless those default values in the site defaults doc have been manually updated to some other number. Furthermore, if any existing subscribers are using the site published number in their phone line E164 mask, device profile line E164 mask, or remote destination profile line E164 mask, that value is updated as well.",
"title": "Published number",
"pattern": "^$|^(\\\\\\+)?[0-9]+$|^\\+?[0-9]+$",
"required": false,
"displayable": false,
"readonly": false,
"maxLength": 1024,
"type": "string"
},
"emergency_number": {
"is_password": false,
"description": "The site emergency callback number is the calling number when initiating an outgoing emergency call. If you change the emergency callback number, the following calling party transformation patterns are updated to use the new value: *{{ macro.HcsDpSiteId}}*! and *{{ macro.HcsDpSiteId}}*\\+!",
"title": "Emergency number",
"pattern": "^$|^(\\\\\\+)?[0-9]+$|^\\+?[0-9]+$",
"required": false,
"displayable": false,
"readonly": false,
"maxLength": 1024,
"type": "string"
},
"iniStart": {
"type": "string",
"description": "Site Internal Number Inventory Start",
"title": "Site Internal Number Inventory Start"
},
"iniEnd": {
"type": "string",
"description": "Site Internal Number Inventory End",
"title": "Site Internal Number Inventory End"
},
"dialPlanData": {
"items": {
"type": "object",
"properties": {
"scustID": {
"type": "string",
"title": "Custom Site ID"
},
"seBO": {
"type": "string",
"title": "External Breakout Number"
},
"spNum": {
"type": "string",
"title": "Published Number"
},
"seNum": {
"type": "string",
"title": "Emergency Call Back Number"
},
"siteAreaCodes": {
"items": {
"type": "object"
},
"type": "array",
"title": "Site Local Area Codes"
}
}
},
"type": "array",
"title": "Site Dial Plan Data"
}
}
},
"type": "array",
"description": "List of Customer sites",
"title": "Sites"
},
"IntegrateVM": {
"default": "false",
"type": "boolean",
"title": "Integrate Voicemail for Tenant"
},
"vm-cucmSecondary": {
"type": "string",
"title": "Call Manager Subscriber for VM Integration"
},
"vm-DPProfile": {
"type": "string",
"title": "Dial Plan Profile"
},
"vm-unityRedundant": {
"default": "true",
"type": "boolean",
"title": "Provision In Unity Redundancy"
},
"vm-phoneSystem": {
"type": "string",
"title": "Unity Phone System"
},
"vm-cucmUsername": {
"type": "string",
"description": "Authentication for sip trunk establish",
"title": "Call Manager Username"
},
"vm-cucmPass": {
"is_password": true,
"type": "string",
"title": "Call Manager Password"
},
"vm-unityPorts": {
"type": "string",
"description": "Total available ports configured per server. Not total number. ",
"title": "Unity Port Count (Per Server)"
},
"vm-Pilot": {
"type": "string",
"title": "Voicemail Pilot Number"
},
"vm-Mask": {
"type": "string",
"title": "Voice Mail Box Mask"
},
"vm-unityTrunkDestP": {
"type": "string",
"description": "The trunk from unity to Call Manager Destination ",
"title": "Call Manager Destination from Unity Primary"
},
"vm-unityTrunkDestS": {
"type": "string",
"title": "Call Manager Destination from Unity Secondary"
},
"vm-cucmCMG": {
"type": "string",
"title": "Call Manager Group"
},
"integrateDialPlan": {
"default": "false",
"type": "boolean",
"title": "Integrate Dial Plan"
},
"dpProvResModel": {
"type": "string",
"title": "Reseller Dial Plan Model"
},
"dpCustModel": {
"type": "string",
"title": "Customer Dial Plan Model"
},
"dpSiteModel": {
"type": "string",
"title": "Site Dial Plan Model"
},
"targetCUCM": {
"type": "string",
"title": "Target Call Manager"
},
"targetCUC": {
"type": "string",
"title": "Target Unity Connection"
},
"cdialplandata": {
"items": {
"type": "object",
"properties": {
"custCustID": {
"type": "string",
"title": "Custom Customer ID"
},
"ceBO": {
"type": "string",
"title": "External Breakout Number"
},
"cpNum": {
"type": "string",
"title": "Published Number"
},
"ceNum": {
"type": "string",
"title": "Emergency Call Back Number"
},
"csipdestprim": {
"type": "string",
"title": "Primary SIP Trunk Destination IP"
},
"csipdestprimport": {
"type": "string",
"title": "Primary SIP Trunk Destination Port"
},
"csipdestsec": {
"type": "string",
"title": "Secondary SIP Trunk Destination IP"
},
"csipdestsecport": {
"type": "string",
"title": "Secondary SIP Trunk Destination Port"
}
}
},
"type": "array",
"title": "Global Dial Plan Data"
},
"cucmCustomerOption": {
"default": "false",
"type": "boolean",
"title": "Add Call Manager Customer ( CUCM 12.5+ ) "
}
}
}
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Get the GUI Add form. | GET | /api/view/AddSharedCustomer/add/ |
|
The GUI Add form of view/AddSharedCustomer as JSON |
The API call to the /add/ URL can only be made from a hierarchy that allows the model type to be added. The actions in the response shows the url for the POST API call to create an instance.
| Task | Call | URL | Parameters | Payload |
|---|---|---|---|---|
| Create | POST | /api/view/AddSharedCustomer | hierarchy=[hierarchy] |
|
tool/Transaction/[trans pkid]shows the View resource has no instance pkid, because a view model stores no instances.
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Tag | PATCH | /api/view/AddSharedCustomer/+tag/ |
|
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Configuration Template | GET | /api/view/AddSharedCustomer/configuration_template/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/ConfigurationTemplate/?hierarchy=[hierarchy]
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Field Display Policy | GET | /api/view/AddSharedCustomer/field_display_policy/ | hierarchy=[hierarchy] |
|
POST http://[host-proxy]/api/data/FieldDisplayPolicy/?hierarchy=[hierarchy]
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| List | GET | /api/view/AddSharedCustomer/ |
|
The view/AddSharedCustomer schema and all instances as JSON. |
(The list will return 0 to 3 view/AddSharedCustomer instances)
{
"pagination": {
"skip": 0,
"limit": 3,
"maximum_limit": 2000,
"total": 0,
"total_limit": null,
"order_by": null,
"direction": "asc",
"current": "/api/view/AddSharedCustomer/?skip=0&limit=3&order_by=None&direction=asc&traversal=down"
},
"operations": [
"add",
"help",
"configuration_template",
"field_display_policy",
"export_bulkload_template",
"transform"
],
"meta": {
"model_type": "view/AddSharedCustomer",
"summary_attrs": [
{
"name": "hierarchy_friendly_name",
"title": "Located At",
"allow_filtering": true
}
],
"tagged_versions": [],
"tags": [],
"title": "",
"business_key": {},
"api_version": "21.2",
"cached": true,
"references": {
"children": [],
"parent": [
{
"href": "/api/data/HierarchyNode/6t0ggef2c0deab00hb595101",
"pkid": "6t0ggef2c0deab00hb595101"
}
],
"device": [
{
"href": "",
"pkid": ""
}
],
"foreign_key": []
},
"model_specific_actions": [
"add"
],
"schema_version": null,
"actions": [
{
"add": {
"method": "GET",
"class": "add",
"href": "/api/view/AddSharedCustomer/add/?hierarchy=[hierarchy]",
"support_async": false,
"title": "Add"
}
},
{
"tag": {
"method": "PATCH",
"class": "tag",
"href": "/api/view/AddSharedCustomer/+tag/?hierarchy=[hierarchy]",
"support_async": true,
"title": "Tag",
"view": "/api/view/TagNameForm/add/?auth_token=[authtoken]
}
},
{
"configuration_template": {
"method": "GET",
"class": "config",
"href": "/api/view/AddSharedCustomer/configuration_template/?hierarchy=[hierarchy]",
"support_async": false,
"title": "Configuration Template"
}
},
{
"field_display_policy": {
"method": "GET",
"class": "display_policy",
"href": "/api/view/AddSharedCustomer/field_display_policy/?hierarchy=[hierarchy]",
"support_async": false,
"title": "Field Display Policy"
}
},
{
"list": {
"method": "GET",
"class": "list",
"href": "/api/view/AddSharedCustomer/?hierarchy=[hierarchy]",
"support_async": false,
"title": "List"
}
},
{
"help": {
"method": "GET",
"class": "help",
"href": "/api/view/AddSharedCustomer/help?hierarchy=[hierarchy]",
"support_async": false,
"title": "Help"
}
}
]
},
"resources": []
}
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Get the on-line Help for view/AddSharedCustomer. | GET | /api/view/AddSharedCustomer/help | hierarchy=[hierarchy] | On-line help of Model ref.: view/AddSharedCustomer as HTML |
| Task | Call | URL | Parameters | Payload |
|---|---|---|---|---|
| Tag | PATCH | /api/view/AddSharedCustomer/[pkid]/+tag | hierarchy=[hierarchy] | If payload required: |
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Get | GET | /api/view/AddSharedCustomer/[pkid] | hierarchy=[hierarchy] | The view/AddSharedCustomer instance with [pkid]. |
| Task | Call | URL | Parameters | Response |
|---|---|---|---|---|
| Help | GET | /api/view/AddSharedCustomer/[pkid]/help | hierarchy=[hierarchy] | The on-line Help for view/AddSharedCustomer. |