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

Owned by Peter Mironov (Unlicensed)
Last updated: Sept 25, 2019 by Сушенцева Виктория (Unlicensed)
10 min read

Описание

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


НаименованиеGetHistoryOfAgentSessions
НазначениеИстория сеансов в приложениях 1С-Коннект
Дневной лимит (опер/час)10
Ночной лимит (опер/час)50
Максимум объектов в пакете-

Запрос

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

ПараметрТипNULLОписание
PeriodFromДатаВремя
Нижняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались после этого момента.
PeriodToДатаВремя
Верхняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались до этой даты.
AgentTypeЧисло
Отбор по принадлежности приложения: 1 - сотрудник клиента, 2 - свой сотрудник (специалист). Если партнер вводит другое число, то отбор не устанавливается, ошибка не выводится.
AgentID4.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)

ПараметрТипОписание
AgentID4.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>