Описание

Возвращает журнал авторизаций клиентских приложений за период. При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 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 - WindowsDesktop 2 - WEB-версия 3 - Android 4 - iOS

Пример ответа

<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>

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

Описание

Запрос

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

Related content