Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Описание

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


Page Properties


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



Запрос

Info

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


ПараметрТипNULLОписание
PeriodFromДатаВремя
Нижняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались после этого момента.
PeriodToДатаВремя
Верхняя граница времени авторизации. Позволяет отбирать те авторизации, которые начались до этой даты.
AgentTypeЧисло
Отбор по принадлежности приложения: 1 - сотрудник клиента, 2 - свой сотрудник (специалист). Если партнер вводит другое число, то отбор не устанавливается, ошибка не выводится.
AgentID4.1.2.5. AccountID
Строка, содержащая UID сотрудника (своей организации или клиента). При заполнении этого параметра на журнал авторизации накладывается фильтр по аккаунту, который авторизовывался в периоде. 


Code Block
languagexml
titleПример
<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


Code Block
languagexml
titleПример ответа
<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>