API Cisco Meeting Server. Когда необходимо его использовать. Использования API в скриптах python.

Cisco
Connect
Москва, 2017
Цифровизация:
здесь и сейчас

Часть 2. API Cisco Meeting
Server. Когда необходимо его
использовать. Использования
API в скриптах python. Пример
совместного использования с
In-room control.
© 2017 Cisco and/or its affiliates. All rights reserved.
Юцайтис Сергей
Консультант по технологиям
совместной работы

CMS использует API для
настройки не стандартных
конфигураций, для обеспечения
интеграции с другими решениями
и для предоставления
информации другим устройствам
и приложениям.
CMS поддерживает RESTful API
или ‘Rest API’ (сокр. от
англ. Representational State
Transfer — «передача состояния
представления»)
Практически все серверные приложения и
сервисы сегодня поддерживают ту или иную
форму API, но обычно API используют для
собственных нужд разработчиков (например
интеграции с другими продуктами
производителя). Поэтому использование API
может лицензироваться отдельно, либо он
может иметь ограниченные возможности.
Acano изначально приняло решение о
поддержки открытого APIs в котором любое
действие доступно без каких либо
лицензионных или других отчислений и
выплат, даже на демонстрационной VM. Эту
традицию мы продолжим с CMS.

Работа с API обычно выполняется
через выполнение вызовов (‘API
Call’)
Можно например сделать API вызов
для создания конференции (Space)
Множество API вызовов может быть
сделано одновременно, что
позволяет, например,
автоматизировать их запуск
скриптом. Последовательное
выполнение API вызовов в составе
скрипта может быть существенно
более быстрым чем в ручном
режиме.
Можно использовать разные языки
программирования для работы с
APIs, но так исторически сложилось,
что программисты Acano в основном
использовали Python.
Существуют примеры с
использованием Java, Powershell,
Curl, Ruby, HTTP, PHP, и многие
другие.
Вы можете выполнять API вызовы
прямо из браузера используя такие
расширения как POSTer, POSTman и
Advanced Rest Client.
API вызовы

Доступные API вызовы
• /accessQuery
• /callBrandingProfiles
• /callBrandingProfiles/<call branding profile id>
• /callBridges
• /callBridges/<call bridge id>
• /calls
• /calls/<call id>
• /calls/<call id>/callLegs
• /calls/<call id>/participants
• /callLegs
• /callLegs/<callLeg id>
/callLegs/<callLeg id>/callLegProfileTrace
/callLegProfiles
• /callLegProfiles/<call leg profile id>
/callLegProfiles/<call leg profile id>/usage
• /callProfiles
/callProfiles/<call profile id>
• /coSpaces
• /coSpaces/<coSpace id>
• /coSpaces/<coSpace id>/coSpaceUsers
• /coSpaces/<coSpace id>/coSpaceUsers/<coSpaceUser id>
• /coSpaces/<coSpace id>/messages
• /coSpaces/<coSpace id>/accessMethods
/coSpaces/<coSpace id>/accessMethods/<access method id>
• /dialTransforms
/dialTransforms/<dial transform id>
• /dtmfProfiles
/dtmfProfiles/<dtmf profile id>
• /directorySearchLocations
• /directorySearchLocations/<directory search location id>
• /forwardingDialPlanRules
• /forwardingDialPlanRules/<forwarding dial plan rule id>
• /inboundDialPlanRules
• /inboundDialPlanRules/<inbound dial plan rule id>
• /outboundDialPlanRules
• /outboundDialPlanRules/<outbound dial plan rule id>
• /ivrs
• /ivrs/<ivr id>
/ivrBrandingProfiles
/ivrBrandingProfiles/<ivr branding profile id>
• /ldapMappings
• /ldapMapping/<ldap mapping id>
• /ldapServers
• /ldapServers/<ldap server id>
• /ldapSources
• /ldapSources/<ldap source id>
• /ldapSyncs
• /ldapSyncs/<ldap sync id>
• /participants
• /participants/<participant id>
• /participants/<participant id>/callLegs
• /system/alarms
• /system/configuration/cluster
• /system/configuration/xmpp
• /system/database
• /system/status
• /system/profiles
• /system/cdrReceiver
• /tenants
• /tenants/<tenant id>
• /turnServers
• /turnServers/<turn server id>
• /turnServers/<turn server id>/status
/users
• /users/<user id>
• /users/<user id>/usercoSpaces
/userProfiles
/userProfiles/<user profile id>
/webBridges
• /webBridges/<web bridge id>
/webBridges/<web bridge id>/updateCustomization
• И другие ,,,,

coSpace
Uri
callId
Owner (Id, Jd)
Secret
defaultLayout
coSpaceUsers
User (Id, Jd)
callLegProfile
canDestroy
canAddRemoveMember
canChangeName
canChangeUri
canChangeCallId
canChangePasscode
canPostMessage
canRemoveSelf
canDeleteAllMessages
accessMethods
URI / passcode / callID
Secret
Scope
Call Leg Profile
needsActivation
defaultLayout changeLayoutAllowed participantLabels presentationDisplayMode
presentationContributionAllowed presentationViewingAllowed endCallAllowed
muteOthersAllowed videoMuteOthersAllowed muteSelfAllowed videoMuteSelfAllowed
joinToneParticipantThreshold leaveToneParticipantThreshold videoMode
rxAudioMute
txAudioMute
rxVideoMute
txVideoMute sipMediaEncryption audioPacketSizeMs deactivationMode
deactivationModeTime telepresenceCallsAllowed sipPresentationChannelEnabled
bfcpMode
system/profiles
callLegProfile
callProfile
dtmfProfile
Messages (post)
Message, from
(delete)
minAge, maxAge

7
Что было сделано и
что можно сделать
с использованием
CMS (ACANO) API?
• Проведено большое количество интеграций, решающих специфичные для
разных Заказчиков задачи или ориентированные на работу с их
собственными продуктами
• Что еще сделано:
– Созданы тысячи Spaces с использованием CSV файлов для Заказчиков
не использующих LDAP
– Реализованы проекты с автоматическим созданием Spaces по Multi-
way технологии
– Менялись PIN коды для каждого Space на сервере
– По нажатию клавиши менялись экранные раскладки для всех
подключенных участников конференции, за исключением презентора
– Интегрировались с SFDC, создавая Space для каждого пользователя
– Интеграция с Amazon Echo (Alexa) для управления конференции с
помощью голосовых команд
– Интеграция с Cisco Spark для управленияl Spaces через Spark
сообщения
– IFTTT интеграция с использованием различных каналов
– И многое другое…

В первых версиях Acano интеграция с
Amazon Echo позволяла пользователям
посредством голосовых команд начинать
встречи, выполнять исходящие вызовы,
управлять экранными раскладками,
выключать голос, видео и отключать
абонентов, завершать конференции.
Пример – Amazon Echo для управления
конференциями

Руководство по программированию CMS API
http://www.cisco.com/c/en/us/support/conferencing/meeting-
server/products-programming-reference-guides-list.html
http://www.cisco.com/c/dam/en/us/td/docs/conferencing/ciscoMeetingServ
er/Reference_Guides/Version-2-1/Cisco-Meeting-Server-API-Reference-
Guide-2-1.pdf
https://www.acano.com/support/documentation/
Рекомендуется использовать руководства API последней версии
продукта.
Руководство содержит все необходимые материалы и команды,
поддержанные в API CMS.
До сих пор не было изменений в правилах использования API или
планов изменить их. Полный набор команд доступен в демо версиях,
триальных версиях Acano и не лицензируется.
CMS API Guide

Нам необходимо оперировать 4-мя типами запросов:
GET – вывести (считать) информацию
POST – создать новую запись
PUT – изменить существующую запись
DELETE – удалить существующую запись

Инструменты
Bеб браузер
Лично я рекомендую Chrome : http://getchrome.com
Python 3.5+
https://www.python.org/downloads/release/python-351/
Редактор
Любой удобный Вам текстовый редактор (советую выбирать понимающий ключевые операторы языков
высокого уровня - например TextWrangler) или Integrated Development Environment (Я использую PyCharm)
Можно использовать IDLE, который устанавливает Python
Git
http://git-scm.com/
Postman
Скачайте из Chrome Web Store или (рекомендую именно этот вариант) – отдельно устанавливаемую
версию http://www.getpostman.com/

Можно скачать приложения, коллекцию postman для CMS2.1 и примеры кода с моего файла обменного ящика:
https://cisco.box.com/v/sergey

Postman – использование коллекций:

Находим CallProfile по умолчанию:

Включаем в нем messageBoard:

Проверяем сделанную запись:

dtmfProfile:
<?xml version="1.0"?>
<dtmfProfile id="722b45a2-1784-4060-bdf2-1d88df5c7818">
<muteSelfAudio></muteSelfAudio>
<unmuteSelfAudio>0</unmuteSelfAudio>
<toggleMuteSelfAudio></toggleMuteSelfAudio>
<lockCall></lockCall>
<unlockCall></unlockCall>
<muteAllExceptSelfAudio></muteAllExceptSelfAudio>
<unmuteAllExceptSelfAudio></unmuteAllExceptSelfAudio>
<endCall></endCall>
<nextLayout>8</nextLayout>
<previousLayout>2</previousLayout>
<startRecording>*1</startRecording>
<stopRecording>*0</stopRecording>
<startStreaming></startStreaming>
<stopStreaming></stopStreaming>
<allowAllMuteSelf></allowAllMuteSelf>
<cancelAllowAllMuteSelf></cancelAllowAllMuteSelf>
<allowAllPresentationContribution></allowAllPresentationContribution>
<cancelAllowAllPresentationContribution></cancelAllowAllPresentationContribution>
<muteAllNewAudio></muteAllNewAudio>
<unmuteAllNewAudio></unmuteAllNewAudio>
<defaultMuteAllNewAudio></defaultMuteAllNewAudio>
<muteAllNewAndAllExceptSelfAudio></muteAllNewAndAllExceptSelfAudio>
<unmuteAllNewAndAllExceptSelfAudio></unmuteAllNewAndAllExceptSelfAudio>
</dtmfProfile>

СallLegProfile:
https://10.100.1.227:9443/api/v1/callLegProfiles/ac0485e3-a3b7-47cf-91fe-ffa25ea5d795
<callLegProfile id="ac0485e3-a3b7-47cf-91fe-ffa25ea5d795">
<defaultLayout>onePlusFive</defaultLayout> - экранная раскладка
<participantLabels>true</participantLabels> - показывать имена участников
<sipMediaEncryption>optional</sipMediaEncryption>
<muteOthersAllowed>true</muteOthersAllowed> - разрешать выключать звук другим участникам
<videoMuteOthersAllowed>true</videoMuteOthersAllowed> - разрешать выключать видео другим участникам
<muteSelfAllowed>true</muteSelfAllowed>
<videoMuteSelfAllowed>true</videoMuteSelfAllowed>
<disconnectOthersAllowed>true</disconnectOthersAllowed> - разрешать отключать других участников
<telepresenceCallsAllowed>false</telepresenceCallsAllowed>
<sipPresentationChannelEnabled>true</sipPresentationChannelEnabled>
<changeLayoutAllowed>true</changeLayoutAllowed> - разрешать менять свою экранную раскладку
<bfcpMode>serverAndClient</bfcpMode>
</callLegProfile>

API Cisco Meeting Server. Когда необходимо его использовать. Использования API в скриптах python.

Управление участником конференции из видео окна приложения:

Планирование CMS 2.0 c TMS 15.3

Выполнение
исходящего вызова

Продление
конференции
Завершение/ удаление

GET https://10.100.1.227:9443/api/v1/Cospaces
<coSpace id="4a5d366d-1b73-4c55-baa1-c323e90d70cb">
<name>TMS_Scheduled_Meeting_5590001</name>
<autoGenerated>false</autoGenerated>
<uri>5590001</uri>
<callId>5590001</callId>
</coSpace>
POST https://10.100.1.227:9443/api/v1/Cospaces/4a5d366d-1b73-4c55-baa1-c323e90d70cb/coSpaceUsers
userJid = admin@domain
Установка для администратора или оператора прав
владельца конференции

Режим лектора
CMS
В текущей версии 2.0 на CMS не реализован режим лектора.
Но, если допускается подключения лектора и аудитории с
использованием разных номеров (URI) – его можно
реализовать через API (а с версии 2.1 – разных паролей (или
пароль/без пароля))
Лектор: звонит на URI 5500@example.com, раскладка - квадратор,
видит всех участников, микрофон активен
Гость: звонит на URI 5600@example.com, одно большое окно с
говорящим (лектором), микрофон выключен, если Лектор отключен
– видео и голос не принимается сервером

Режим лектора
1. Создайте новый space с аккаунтом лектора в профиле
2. Создайте профиль соединения для Лектора (Call Leg Profile): POST https://example.com/api/v1/callLegProfiles defaultLayout=allEqual
3. Создайте профиль соединения для гостя: POST https://example.com/api/v1/callLegProfiles
needsActivation=true&defaultLayout=speakerOnly&rxAudioMute=true&deactivationMode=deactivate
4. Узнайте идентификаторы профилей соединения (Call Leg Profile): GET https://example.com/api/v1/callLegProfiles
Допустим что Call Leg Profile ID лектора: 360b40bf-4c7d-41ff-a355-496c0e720649
Call Leg Profile ID гостя: 5546a47f-262a-4399-a799-0a03ddc2c66c
Узнайте идентификатор space (space ID): GET https://example.com/api/v1/coSpaces
Допустим что Space ID: 83b4f7d0-ffb7-4fbc-83c0-91ebe04f2af3
Создайте метод подключения Лектора (Access Method) с URI и Call ID 5500:
POST https:// example.com/api/v1/coSpaces/83b4f7d0-ffb7-4fbc-83c0-91ebe04f2af3/accessMethods
uri=5500&callLegProfile= 360b40bf-4c7d-41ff-a355-496c0e720649&callID=5500
(Access Method ID: f3a7cf1a-961f-4fec-b19d-5db558851305 )
Создайте метод подключения гостя (Access Method) с URI и Call ID 5600:
POST https://example.com/api/v1/coSpaces/83b4f7d0-ffb7-4fbc-83c0-91ebe04f2af3/accessMethods
uri=5600&callLegProfile=5546a47f-262a-4399-a799-0a03ddc2c66c&callID=5600 (Access Method ID: 056a58ee-12bc-404f-b863-834cba4707db)

Как в Python сделать REST
вызов

Библиотека Python requests
requests – HTTP библиотека Python. Ближайший аналог – urllib2.
Содержит в себе встроенную библиотеку urllib3.
Домашняя страница проекта – http://docs.python-requests.org
Установить requests можно с помощью PIP: $ pip install requests
>>> r = requests.get('https://api.github.com/events')
>>> r = requests.post('http://httpbin.org/post', data = {'key':'value'})
>>> r = requests.put('http://httpbin.org/put', data = {'key':'value'})
>>> r = requests.delete('http://httpbin.org/delete')
Cisco Connect 2017 © 2017 Cisco and/or its affiliates. All rights reserved. 31

from pprint import pprint
import paramiko
import time
import re
import requests
from requests.packages.urllib3.exceptions import InsecureRequestWarning # отключаем предупреждение о не
requests.packages.urllib3.disable_warnings(InsecureRequestWarning) # достоверных сертификатах
CMS_BASE='https://10.100.1.227:9443/api/v1/' # Задаем основные параметры (например IP)
CMS_HEADERS = {'Content-type': 'application/json', 'authorization': "Basic YWRtaW46QzFzY28xMjM="} # Задаем логин-пароль (берем из postman)
client = paramiko.SSHClient()
client.set_missing_host_key_policy(paramiko.AutoAddPolicy())
client.connect("10.100.1.147", username="admin", password="C1sco123") # соединение с сервером
channel = client.invoke_shell()
channel.send('xst SIP Registration 1 URIn')
time.sleep(0.5)
output = channel.recv(2000)
Number = ''.join(re.findall(r'w+@demo.cisco.ru', str(output)))
print('номер видеосистемы: ' + ''.join(Number)) # Номер своей видеосистемы нам понадобится для нахождения данных о ее подключении
# calls = requests.get(CMS_BASE + 'calllegs' + '?filter=' + Number, verify=False, headers=CMS_HEADERS)

calls = requests.get(CMS_BASE + 'calllegs' + '?filter=' + Number, verify=False, headers=CMS_HEADERS)
if calls.status_code == 200:
pprint("это то, что выдал request.get:" + calls.text)
# Это наш callleg:
calleg = ''.join(re.findall(r'<callLeg id="(w+-w+-w+-w+-w+)', calls.text))
if len(calleg) > 0:
# Здесь мы подключены к конференции, узнаем все о подключении и конференции
callid = ''.join(re.findall(r'<call>(w+-w+-w+-w+-w+)', calls.text))
pprint("Идентификатор подключения: " + calleg)
channel.send('xCommand UserInterface Extensions Widget SetValue WidgetId: "info3" Value: "Идентификатор соединения:' + calleg + '"n')
pprint("Идентификатор соединения: " + callid)
channel.send('xCommand UserInterface Extensions Widget SetValue WidgetId: "info4" Value: "Идентификатор конференции:' + callid +
'"n')
def confinfo(a) : return requests.get(CMS_BASE + 'calls/' + a, verify=False, headers=CMS_HEADERS)
confinf = confinfo(callid)
pprint("Информация о конференции: " + confinf.text)
client.close()

Кодировка
<callLegs total="4">
<callLeg id="9132036b-148f-49a6-9960-7bc90fabbbad">
<name>SX10 UGLICH 40210</name>
<remoteParty>40210@demo.cisco.ru</remoteParty>
<call>ce4a7f5f-4670-4ed8-b822-3e28a0475678</call>
</callLeg>
<callLeg id="ee4d87a6-f56e-41d5-bd7f-154f672e348d">
<name>SX20 KRASNODAR 40220</name>
</callLeg>
<callLeg id="990a91a7-f571-40ac-8c58-55eb4edab6cf">
<name>Елена Волкова</name>
</callLeg>
<callLeg id="668bffaa-e813-4898-9088-2f671c9a4435">
<name>Петр Петров</name>
</callLeg>
</callLegs>

Кодировка
Кодировка ['SX10 UGLICH 40210', 'SX20 KRASNODAR 40220', 'Ðx95Ð»ÐµÐ½Ð°
Ðx92Ð¾Ð»ÐºÐ¾Ð²Ð°', 'Ðx9fÐµÑx82Ñx80 Ðx9fÐµÑx82Ñx80Ð¾Ð²']
activelegs = requests.get(CMS_BASE + 'calls/' + callid + '/callLegs', verify=False, headers=CMS_HEADERS)
activelegs.encoding = 'utf-8'
['SX10 UGLICH 40210', 'SX20 KRASNODAR 40220', 'Елена Волкова', 'Петр Петров']

calls = requests.get(CMS_BASE + 'calllegs' + '?filter=' + Number, verify=False, headers=CMS_HEADERS)
calls.encoding = 'utf-8' # задаем кодировку
if calls.status_code == 200:
pprint("это то, что выдал request.get:" + calls.text)
# Это наш callleg:
if len(calleg) > 0:
# Здесь мы подключены к конференции, узнаем все о подключении и конференции
pprint("Идентификатор подключения: " + calleg)
channel.send('xCommand UserInterface Extensions Widget SetValue WidgetId: "info3" Value: "Идентификатор соединения:' + calleg + '"n')
pprint("Идентификатор соединения: " + callid)
channel.send('xCommand UserInterface Extensions Widget SetValue WidgetId: "info4" Value: "Идентификатор конференции:' + callid + '"n')
def confinfo(a) : return requests.get(CMS_BASE + 'calls/' + a, verify=False, headers=CMS_HEADERS)
confinf = confinfo(callid)
pprint("Информация о конференции: " + confinf.text)
client.close()
Библиотека Python requests - кодировка

<callLegs ' 'total="1"><callLeg id="bdac73d6-ec81-422a-bdb3-eadefb234353">
<name>SX20 ' 'Room - ' 'Москва</name><remoteParty>40220@demo.cisco.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg></callLegs>')
Наш Callleg ID: bdac73d6-ec81-422a-bdb3-eadefb234353
Наш Call ID: 32a41a3a-076d-4a25-b485-db9f1f1ea067
'Информация о конференции: <?xml version="1.0"?><call ' 'id="32a41a3a-076d-4a25-b485-db9f1f1ea067"><coSpace>202a6e1c-b65b-
4c29-a2eb-234925419eb2</coSpace><callCorrelator>0704eef6-4c7c-4215-8903-
2459d1a1efb5</callCorrelator><durationSeconds>2428</durationSeconds><numCallLegs>15</numCallLegs><maxCallLegs>15</maxCallLegs
><numParticipantsLocal>15</numParticipantsLocal><locked>false</locked><recording>false</recording><streaming>false</streaming><all
owAllMuteSelf>false</allowAllMuteSelf><allowAllPresentationContribution>false</allowAllPresentationContribution><messagePosition>mi
ddle</messagePosition><messageDuration>0</messageDuration></call>')
requests.get(CMS_BASE + 'calls/' + callid, verify=False, headers=CMS_HEADERS)
Что мы узнали о подключении?

Автоматизация рутинных операций, например подключение большого количества
участников в конференцию с известным call ID
Virtual = ['1000', '1001', '1002', '1003', '1004', '1005', '1006', '1007', '1008', '1009', '1011', '1014', '1017'] # Создаем объект, тип список с номерами абонентов
def autoconnect(action) : # Определяем функцию, которую будет удобно вызывать для подключения / отключения всех абонентов списка
global callid
if action == "on" : # подключаем абонентов из списка
for element in Virtual :
pprint (element) # отслеживаем работу скрипта
connect = requests.get(CMS_BASE + 'calllegs?filter=' + element, verify=False, headers=CMS_HEADERS) # проверяем не подключен ли он уже к серверу?
if ''.join(re.findall(r'callLegs total="(d)', connect.text)) == '0' :
# операция подключения
requests.post(CMS_BASE + 'calls/' + callid + '/calllegs', data="remoteParty=" + element + "@str.ru", verify=False, headers=CMS_HEADERS)
if action == "off": # отключаем абонентов из списка
for element in Virtual:
pprint (element)
connect = requests.get(CMS_BASE + 'calllegs?filter=' + element, verify=False, headers=CMS_HEADERS)
if ''.join(re.findall(r'callLegs total="(d)', connect.text)) != '0':
calllegidcurrent = ''.join(re.findall(r'callLeg id="(w+-w+-w+-w+-w+)', connect.text))
pprint(calllegidcurrent)
requests.delete(CMS_BASE + 'calllegs/' + calllegidcurrent, verify=False, headers=CMS_HEADERS)
autoconnect("off") # Можно ждать команды из CLI, но я не стал этого делать для минимизации кода

def findlegs():
offset = 0
print (activelegs.text)
collegstotal = int(''.join(re.findall(r'callLegs total="(d+)', activelegs.text)))
calllegs = re.findall(r'callLeg id="(w+-w+-w+-w+-w+)', activelegs.text)
if len(calllegs) < collegstotal :
offset = offset + 10
activelegs = requests.get(CMS_BASE + 'calls/' + callid + '/callLegs?offset=' + str(offset), verify=False, headers=CMS_HEADERS)
calllegs = calllegs + re.findall(r'callLeg id="(w+-w+-w+-w+-w+)', activelegs.text)
print(calllegs)
findlegs()
Автоматизация рутинных операций, например установка режима для участников в
конференции с известным call ID

<?xml version="1.0"?><callLegs total="15"><callLeg id="0d20279c-d792-4032-9206-
8bf3786fca04"><name></name><remoteParty>1000@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call></callLeg><callLeg
id="0e8d0458-0172-4a6a-bf3d-c26e8f0863b8"><name></name><remoteParty>1004@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg><callLeg id="113ef87c-8925-4929-bf10-
467649f53ed7"><name></name><remoteParty>1001@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call></callLeg><callLeg
id="3105f6b5-d3ca-4c3b-9e6c-2e6159284fa4"><name></name><remoteParty>1007@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg><callLeg id="80737b65-1385-463d-aa90-
64a52f03e60f"><name></name><remoteParty>1011@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call></callLeg><callLeg
id="aefb65b6-6043-4603-b6a9-7cd0182095a2"><name></name><remoteParty>1005@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg><callLeg id="af961c3b-e8e3-4daa-884d-
89e29a32a4d8"><name></name><remoteParty>1009@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call></callLeg><callLeg
id="b882fdf6-3d4c-46e7-b3b6-9d0f0b87475f"><name></name><remoteParty>1014@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg><callLeg id="c28d8918-c516-405f-a9db-
382db87de3b0"><name></name><remoteParty>1003@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call></callLeg><callLeg
id="c45016cf-7812-4c9f-8b95-a0eb024ebc4c"><name></name><remoteParty>1017@str.ru</remoteParty><call>32a41a3a-076d-4a25-b485-
db9f1f1ea067</call></callLeg></callLegs>
['0d20279c-d792-4032-9206-8bf3786fca04', '0e8d0458-0172-4a6a-bf3d-c26e8f0863b8', '113ef87c-8925-4929-bf10-467649f53ed7', '3105f6b5-d3ca-4c3b-
9e6c-2e6159284fa4', '80737b65-1385-463d-aa90-64a52f03e60f', 'aefb65b6-6043-4603-b6a9-7cd0182095a2', 'af961c3b-e8e3-4daa-884d-89e29a32a4d8',
'b882fdf6-3d4c-46e7-b3b6-9d0f0b87475f', 'c28d8918-c516-405f-a9db-382db87de3b0', 'c45016cf-7812-4c9f-8b95-a0eb024ebc4c', 'd7cebcb4-799f-4ef8-9090-
1ed25b0e2b7d', 'e73cb349-1281-4f47-a9e2-b228dbedceb5', 'f7749b16-6173-46b1-ab1d-4a85451269fc', 'bdac73d6-ec81-422a-bdb3-eadefb234353',
'0373aa04-8c1f-40d0-8f9a-b5f78f98fa21']
Автоматизация рутинных операций, например установка режима для участников в
конференции с известным call ID

Получение информации о подключениях к конференции с известным call ID и операции с ними,
например – для установки всем определенной конфигурации экрана
def findlegs():
offset = 0
print (activelegs.text)
collegstotal = int(''.join(re.findall(r'callLegs total="(d+)', activelegs.text)))
if len(calllegs) < collegstotal :
offset = offset + 10
calllegs = calllegs + re.findall(r'callLeg id="(w+-w+-w+-w+-w+)', activelegs.text)
print(calllegs)
return calllegs # Необходимо использовать, чтобы получить доступ к значению переменной из другой функции
def setlayout(L):
calllegs = findlegs()
Layout = ['speakerOnly', 'telepresence', 'stacked', 'allEqual', 'onePlusN', 'automatic', 'allEqualQuarters','allEqualNinths', 'allEqualSixteenths', 'allEqualTwentyFifths',
'onePlusFive', 'onePlusSeven', 'onePlusNine'] # Создаем список всех существующих конфигураций экранов
# Применяем экранную раскладку
# Организуем цикл и перебираем все calllegs, не забывая сравнить со своим (ведь надо поменять всем, кроме себя)
pprint("Устанавливаем всем раскладку, кроме себя - " + Layout[L])
i = 0
for element in calllegs:
if calllegs[i] != calleg: # Здесь мы проверяем что callleg с которым мы будем проводить операцию не совпадает с callleg нашего терминала
requests.put(CMS_BASE + 'calllegs/' + calllegs[i], data="defaultLayout=" + Layout[L], verify=False, headers=CMS_HEADERS)
pprint(calllegs[i])
i = i + 1
setlayout(3)

 Зачем это нужно?
 Методы парсинга
 Не парсить
 Если информация представляется в легко читаемом Вами виде
 Do-It-Yourself (DIY) строковый парсинг (то что мы делали до сих пор)
 Полезно в случае если требуемая Вам информация реально просто находится
 Создание или использование Фреймворк / библиотек
 Множество уже готовых библиотек и инструментов на все случаи жизни доступно
Parsing контент

Парсинг и выделение информации
Основы
Контент
Что представлено – Пользователи? Книги? Записи логов? Образец данных? Точки доступа?
Схема – Какой порядок, форма, и требования к данным?
Размер – Насколько велик объем выводимой информации? Может это ее размер создать проблемы?
Что Вам нужно
Имена пользователей и их почтовые адреса, X и Y координаты, ID и номера пациентов
Сколько Вам нужно получить записей
Вам надо посчитать количество записей, получить репрезентативную выборку, или все?
Знайте, что обычно существует несколько способов получения и обработки
контента..
Различные WEB библиотеки (urllib, urllib2, Requests, и т.д.)
Различные JSON парсеры (JSON, SimpleJSON, UltraJSON, и т.д.)
Различные XML парсеры (xml.etree.ElementTree, lxml, xml.dom.minidom и т.д.)
Синтаксический анализ и обработка результатов

Как данные конвертируются по умолчанию
Python <-> JSON

https://{{mmpHost}}/api/v1/calllegs
<?xml version="1.0"?><callLegs total="14"><callLeg id="14076e5e-
72fb-42ec-998a-
7f0602687e41"><name></name><remoteParty>1011@str.ru</re
moteParty><call>41b79d90-9358-4b4d-952e-
c4f6d0df2c09</call></callLeg><callLeg id="1bee0f35-7250-479a-
b3de-
3c026d3c1498"><name></name><remoteParty>1005@str.ru</re
c4f6d0df2c09</call></callLeg><callLeg id="28dfbd95-a81a-40dc-
849f-
0c0efaec6b72"><name></name><remoteParty>1003@str.ru</rem
oteParty><call>41b79d90-9358-4b4d-952e-
c4f6d0df2c09</call></callLeg><callLeg id="467772e0-f676-4784-
b9bb-
393a3a6e8a20"><name></name><remoteParty>1001@str.ru</re
c4f6d0df2c09</call></callLeg><callLeg id="609e2fe9-0577-4884-
9eab-
72f8165a58c1"><name></name><remoteParty>1008@str.ru</rem
oteParty><call>41b79d90-9358-4b4d-952e-
c4f6d0df2c09</call></callLeg><callLeg id="9338fa97-e95a-49e4-
af04-
34fc596ccf30"><name></name><remoteParty>1002@str.ru</rem
oteParty></callLeg></callLegs>
<callLegs total="14">
<callLeg id="14076e5e-72fb-42ec-998a-7f0602687e41">
<name></name>
<remoteParty>1011@str.ru</remoteParty>
<call>41b79d90-9358-4b4d-952e-c4f6d0df2c09</call>
</callLeg>
<callLeg id="1bee0f35-7250-479a-b3de-3c026d3c1498">
<name></name>
</callLeg>
<callLeg id="28dfbd95-a81a-40dc-849f-0c0efaec6b72">
<name></name>
</callLeg>
<callLeg id="467772e0-f676-4784-b9bb-393a3a6e8a20">
<name></name>
</callLeg>
<callLeg id="609e2fe9-0577-4884-9eab-72f8165a58c1">
<name></name>
</callLeg>
<callLeg id="9338fa97-e95a-49e4-af04-34fc596ccf30">
<name></name>
</callLeg>
</callLegs>
Parsing XML

def findlegs():
offset=0
calllegs = ET.fromstring(activelegs.text)
if len(calllegs.findall("callLeg")) < int( calllegs.attrib["total"] ) :
offset=offset+10
calllegs.extend( ET.fromstring(activelegs.text) .findall("callLeg") )
return calllegs
https://docs.python.org/2/library/xml.etree.elementtree.html
Парсинг XML с помощью xml.etree.ElementTree

Получение информации о подключениях к конференции с известным call ID и операции с ними,
например – для установки всем определенной конфигурации экрана
def findlegs():
offset = 0
print(calllegs)
def findlegs():
calllegs = ET.fromstring(activelegs.text)
pprint(calllegs)
all_legs = calllegs.findall("callLeg")
pprint(all_legs)
<Element 'callLegs' at 0x105666a48>
[<Element 'callLeg' at 0x10573b9a8>, <Element 'callLeg' at
0x105675728>, <Element 'callLeg' at 0x105675408>,
<Element 'callLeg' at 0x105675638>, <Element 'callLeg' at
0x1057cd5e8>, <Element 'callLeg' at 0x1057d8d68>,
<Element 'callLeg' at 0x1057d8ea8>, <Element 'callLeg' at
0x1057dd048>, <Element 'callLeg' at 0x1057dd188>,
<Element 'callLeg' at 0x1057dd2c8>]
['0d20279c-d792-4032-9206-8bf3786fca04', '0e8d0458-0172-4a6a-
bf3d-c26e8f0863b8', '113ef87c-8925-4929-bf10-467649f53ed7',
'3105f6b5-d3ca-4c3b-9e6c-2e6159284fa4', '80737b65-1385-463d-
aa90-64a52f03e60f', 'aefb65b6-6043-4603-b6a9-7cd0182095a2',
'af961c3b-e8e3-4daa-884d-89e29a32a4d8', 'b882fdf6-3d4c-46e7-
b3b6-9d0f0b87475f', 'c28d8918-c516-405f-a9db-382db87de3b0',
'c45016cf-7812-4c9f-8b95-a0eb024ebc4c', 'd7cebcb4-799f-4ef8-9090-
1ed25b0e2b7d', 'e73cb349-1281-4f47-a9e2-b228dbedceb5',
'f7749b16-6173-46b1-ab1d-4a85451269fc', 'bdac73d6-ec81-422a-
bdb3-eadefb234353', '0373aa04-8c1f-40d0-8f9a-b5f78f98fa21']

name : callLegs
text : None
attr total : 14
name : callLeg
text : None
attr id : 0d20279c-d792-4032-9206-8bf3786fca04
name : name
text : None
name : remoteParty
text : 1000@str.ru
name : call
text : 32a41a3a-076d-4a25-b485-db9f1f1ea067
<callLegs total="14"> - ‘total ’ аттрибут верхнего уровня XML (calllegs.attrib)
<callLeg id="0d20279c-d792-4032-9206-8bf3786fca04"> – атрибут callLeg ‘id’ -
свойства:
<name></name>
<remoteParty>1000@str.ru</remoteParty> - remoteParty.text текст
<call>32a41a3a-076d-4a25-b485-db9f1f1ea067</call>
- текст (отсутствует)
</callLeg>
</callLegs>
def printElement(element, shift=0): # Функция, печатающая элементы структуры XML
shifttab = "t" * shift; # сдвижка
print(shifttab, "name : ", element.tag) # Имя корневого элемента
print(shifttab, "text : ", element.text) # Текст корневого элемента
for attrname in element.keys(): # Печать всех атрибутов ключей корня
print(shifttab, "attr ", attrname, " : ", element.attrib[attrname])
for subelement in element: # Для каждого элемента нижнего уровня
printElement(subelement, shift + 1) # Напечатать его с помощью этой
# функции, увеличивая сдвижку
Понимание структуры, формируемой xml.etree.ElementTree

Xpath синтаксис для xml.etree.ElementTree
calllegs=findlegs()
print ("Callleg ID: " + calllegs.find( "./callLeg[remoteParty='40220@demo.cisco.ru']" ) .attrib["id"] )
print ("Имя терминала: " + calllegs.find( "./callLeg[remoteParty='40220@demo.cisco.ru']/name" ).text)
print ("Идентификатор конференции: " + calllegs.find( "./callLeg[remoteParty='40220@demo.cisco.ru']/call" ).text)
client.close()
Callleg ID: 8646379f-fb0d-4dff-aae1-7ac02b65c59b
Имя терминала: SX20 Room – Москва
Идентификатор конференции: 32a41a3a-076d-4a25-b485-db9f1f1ea067
Синтаксис Выполняет
tag
Выбирает все дочерние элементы с этим тегом. Например ’spam’ выбирает все дочерние элементы с именем spam,
а ’spam/egg’ выбирает все дочерние элементы с именем egg дочерних элементов spam.
* Выбирает все дочерние элементы. Например, */egg выбирает все дочерние элементы egg, всех дочерних элементов.
. Выбирает текущий уровень. Наиболее полезно в начале пути, для обозначения уровней, относительно текущего
// Выбирает все поделементы на уровне ниже выбранного элемента. Например, .//egg выбирает все элементы дерева.
.. Выбирает родительский элемент
[@attrib] Выбирает все элементы с этими атрибутами
[@attrib='value']
Выбирает все элементы у которых указанный атрибут равен указанному значению. Значение не может включать одинарные
кавычки.
[tag] Выбирает все элементы, у которых есть дочерние с именем tag. Работает только на один уровень.
[tag='text'] Выбирает все элементы у которых есть дочерние полностью соответствующие полю text на всех уровнях вложенности
[position]
Выбирает элемент. ‘position’ может быть цифрой (1 – первый в списке), выражением last() (для последнего элемента), или
задавать относительный уровень (т.е. last()-1). Например /callLegs/callLeg[2] - вернет второй callLeg

Ресурсы с открытым исходным кодом
CDR ресивер
https://github.com/jasonneurohr/acano_cdr_receiver
Canopy, Python SDK для Cisco CMS
https://github.com/gnisbetcisco/canopy

Планы развития
Cisco Meeting Server 2.x

Cisco Meeting Server версии 2.2
Планируется на апрель – май 2017
Удобство работы,
гибкость и качество
Новые возможности
конференцсвязи
Максимальная
масштабируемость
Большее количество
подключений и
балансирование нагрузки
Лучшая в индустрии
совместимость
Поддержка нескольких
профилей качества с S4B и
O365

 Позволяет выводить изображения
участников на 2 экрана
 Требуется CMS 2.2 (май этого года)
 Требуется CE9.1 (июнь этого года)
 Поддерживается на: SX80, MX800
Dual, MX700 Dual, Spark Kit, Spark Kit
Plus
Поддержка работы с живым видео на двух экранах
Возможно только с решениями Cisco Collaboration

Cisco Meeting Server 2000
Лучшая масштабируемость в индустрии
 На старте продаж емкость 500 HD
подключений
 Требует получение разрешения на
ввоз (ПО предустановлено,
шифрование трафика – встроенная,
не блокируемая ключом
возможность)
 Высоко производительный сервер, основанный
на шасси UCS 5108 и 6 B200 лезвиях
 Полностью сконфигурированное шасси продается
как единый сервер
 GPL : 200,954 USD
 PID: CTI-CMS-2K-BUN-K9

Поддержка O365 с OBTP
совместимость без дополнительных усилий
 Планирование конференций с
помощью привычных для
пользователей Skype инструментов
Microsoft (Skype плагина)
 Cisco устройства могут использовать
OBTP
 O365 клиенты могут участвовать в
dual-home конференциях
 Требует TMS15.5 и XE5.5

Расширенные возможности работы группы Call Bridge
Лучшая масштабируемость в индустрии
 Улучшите масштабируемость, без
ухудшения качества восприятия,
посредством многопоточного
каскадирования
 CMS 2.1 умел балансировать только
входящие SIP соединения
 CMS 2.2 добавляет механизмы
балансирование и для исходящих
SIP вызовов

Возможность задания «важного» участника
(Important Participant Pane Placement)
Наилучшие возможности для работы с конференциями Cisco
 Фокусируйте внимание участников
конференции на важных участниках
 Идеально для лекций, выступления
руководителей и других конференциях,
где важно выделить определенные окна
 Не зависит от выбранной экранной
раскладки
 В версии 2.2 будет доступно через CMS
API.
 Планируется в дальнейшем добавить
уровни важности и поддержку с CMA/
CMM

Другие новые возможности
 Упрощения обслуживания:
Упрощение процесса сбора логов
 Пауза для DTMF: Посылка с
задержкой, определяемой символом
запятой – “ , ”
 Качество подключения:
Администратор сможет фиксировать
качество подключений на SD, HD, full
HD, и т.д. для обеспечения
гарантированного качества для
пользователей и более гибкого
управления ресурсами.

Новые
инструменты
Cisco для
управления

Cisco Meeting Manager
(White Glove Meeting Manger Tool)
Новый инструмент для оперативного управления конференциями
Самостоятельный инструмент – не требует для работы TMS
Будет поставляться в виде виртуальной машины
Web интерфейс управления (Firefox, Chrome, Safari)
Возможности, планируемый в первой версии:
Список всех активных конференций, из которого можно перейти к управлению
выбранной конференцией
Список всех участников конференции, выключить звук от одного или всех,
отключить участника, закончить конференцию
Отказоустойчивость для CMM (active-active)

Внешний вид
• Единый портал в который
интегрированы различные
компоненты
• Унифицированный
интерфейс пользователя
(UX и UI) и
информационная
архитектура (IA) с
порталом управления
облачными сервисами
Cisco.

Список активных конференций

Установки конференции и ее участники

Детали подключения участника конференции

Планы по развитию CMM
• Провижионинг
пользователей и PMP
• Портал самообслуживания
• Управление терминалами
• Тонкая настройки
конференций и
дополнительные
возможности управления
• Большее колличество
виджетов
• Монитор лицензий
• Конфигурация CMS
• Дополнительные
возможности управления
Дальнейшие планы
• Управление
конференцией (Meeting
Manager)
• Портал Администратора
• Основные виджеты
CMM 1.0 CMM 1.1
TMS планируется продолжить использовать для планирования и других ролей

#CiscoConnectRu#CiscoConnectRu
Спасибо за внимание!
Оцените данную сессию в мобильном приложении
© 2017 Cisco and/or its affiliates. All rights reserved.
Контакты:
Тел.: +7 495 9611410
www.cisco.com
www.facebook.com/CiscoRu
www.vk.com/cisco
www.instagram.com/ciscoru
www.youtube.com/user/CiscoRussiaMedia

API Cisco Meeting Server. Когда необходимо его использовать. Использования API в скриптах python.

More Related Content

What's hot (20)

Similar to API Cisco Meeting Server. Когда необходимо его использовать. Использования API в скриптах python. (20)

More from Cisco Russia (20)

API Cisco Meeting Server. Когда необходимо его использовать. Использования API в скриптах python.