История авторизаций в приложениях 1С-Коннект

История авторизаций в приложениях 1С-Коннект

Описание

Возвращает журнал авторизаций клиентских приложений за период. При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 35 календарных дней.



Наименование

GetHistoryOfAgentSessions

Назначение

История сеансов в приложениях 1С-Коннект

Дневной лимит (опер/час)

10

Ночной лимит (опер/час)

50

Максимум объектов в пакете

-

Запрос

Параметр, выделенный жирным, является обязательным к заполнению!

Параметр

Тип

Описание

Параметр

Тип

Описание

PeriodFrom

ДатаВремя



Нижняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались после этого момента.

PeriodTo

ДатаВремя



Верхняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались до этой даты.

AgentType

Число



Отбор по принадлежности приложения: 1 - сотрудник клиента, 2 - свой сотрудник (специалист). Если партнер вводит другое число, то отбор не устанавливается, ошибка не выводится.

AgentID

4.1.2.5. AccountID



Строка, содержащая UID сотрудника (своей организации или клиента). При заполнении этого параметра на журнал авторизации накладывается фильтр по аккаунту, который авторизовывался в периоде. 

Пример
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:par="http://buhphone.com/PartnerWebAPI2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:core="http://v8.1c.ru/8.1/data/core" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <soap:Header/> <soap:Body> <par:GetHistoryOfAgentSessions> <par:Params> <Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodFrom"> <Value xsi:type="xs:dateTime">2019-09-09T01:00:00</Value> </Property> <Property xmlns="http://v8.1c.ru/8.1/data/core" name="PeriodTo"> <Value xsi:type="xs:dateTime">2019-09-15T01:00:00</Value> </Property> <Property xmlns="http://v8.1c.ru/8.1/data/core" name="AgentType"> <Value xsi:type="xs:decimal">1</Value> </Property> <Property xmlns="http://v8.1c.ru/8.1/data/core" name="AgentID"> <Value xsi:type="xs:string">a0852003-2003-11e5-80d5-2003904f970e</Value> </Property> </par:Params> </par:GetHistoryOfAgentSessions> </soap:Body> </soap:Envelope>

Ответ (структура ResultData)

Параметр

Тип

Описание

Параметр

Тип

Описание

AgentID

4.1.2.5. AccountID

Идентификатор аккаунта 1С-Коннект (сотрудника своей организации или сотрудника организации клиента)

Started

ДатаВремя

Время начала сессии

AgentVersion

Строка(15)

Версия агента на момент запуска

IPv4

Строка(15)

IP-адрес устройства, с которого произведен запуск

MAC

Строка(18)

MAC адрес хоста, с которого произведен запуск агента

Ended

ДатаВремя

Время окончания сессии 

StartedFrom1CConf

Булево

Истина, если агент запустился из под кнопки 1С

AppType

Число(1)

Код типа сборки приложения. Значения:

  • 1 - Desktop Windows

  • 2 - WEB-версия

  • 3 - Android

  • 4 - iOS

  • 5 - Desktop Linux

  • 6 - Desktop Mac

Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"> <soap:Body> <m:GetHistoryOfAgentSessionsResponse xmlns:m="http://buhphone.com/PartnerWebAPI2"> <m:return xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Property name="ResultCode" xmlns="http://v8.1c.ru/8.1/data/core"> <Value xsi:type="xs:string">SUCCESS</Value> </Property> <Property name="ResultData" xmlns="http://v8.1c.ru/8.1/data/core"> <Value xsi:type="ValueTable"> <column> <Name>AgentID</Name> <ValueType> <Type>xs:string</Type> <Type>Null</Type> <StringQualifiers> <Length>0</Length> <AllowedLength>Variable</AllowedLength> </StringQualifiers> </ValueType> </column> <column> <Name>Started</Name> <ValueType> <Type>xs:dateTime</Type> <DateQualifiers> <DateFractions>DateTime</DateFractions> </DateQualifiers> </ValueType> </column> <column> <Name>AgentVersion</Name> <ValueType> <Type>xs:string</Type> <StringQualifiers> <Length>10</Length> <AllowedLength>Variable</AllowedLength> </StringQualifiers> </ValueType> </column> <column> <Name>IPv4</Name> <ValueType> <Type>xs:string</Type> <StringQualifiers> <Length>15</Length> <AllowedLength>Variable</AllowedLength> </StringQualifiers> </ValueType> </column> <column> <Name>MAC</Name> <ValueType> <Type>xs:string</Type> <StringQualifiers> <Length>18</Length> <AllowedLength>Variable</AllowedLength> </StringQualifiers> </ValueType> </column> <column> <Name>Ended</Name> <ValueType> <Type>xs:dateTime</Type> <DateQualifiers> <DateFractions>DateTime</DateFractions> </DateQualifiers> </ValueType> </column> <column> <Name>StartedFrom1CConf</Name> <ValueType> <Type>xs:boolean</Type> </ValueType> </column> <column> <Name>AppType</Name> <ValueType> <Type>xs:decimal</Type> <NumberQualifiers> <Digits>0</Digits> <FractionDigits>0</FractionDigits> <AllowedSign>Any</AllowedSign> </NumberQualifiers> </ValueType> </column> <row> <Value xsi:type="xs:string">a0852003-06ef-2003-80d5-0025904f970e</Value> <Value xsi:type="xs:dateTime">2019-09-11T16:31:05</Value> <Value xsi:type="xs:string">4.7.11.1</Value> <Value xsi:type="xs:string">192.168.0.100</Value> <Value xsi:type="xs:string">22:d7:f6:e2:33:e1</Value> <Value xsi:type="xs:dateTime">2019-09-11T20:14:01</Value> <Value xsi:type="xs:boolean">false</Value> <Value xsi:type="xs:decimal">1</Value> </row> </Value> </Property> </m:return> </m:GetHistoryOfAgentSessionsResponse> </soap:Body> </soap:Envelope>