История обмена файлами в чате по линиям

Owned by Peter Mironov (Unlicensed)
Last updated: Jun 10, 2024 by Емец Владимир
13 min read

Описание

Получения списка ссылок на скачивание файлов, переданных по линиям поддержки. При вызове операции в дневное время максимальное значение запрашиваемого периода не может превышать 90 календарных дней (7 дней без подписки на расширенный функционал).


НаименованиеGetHistoryOfServiceFileTransfer
НазначениеИстория обмена файлами в чате по линиям
Дневной лимит (опер/час)250
Ночной лимит (опер/час)1250
Максимум объектов в пакете-

Запрос

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

ПараметрТипNULLОписание
PeriodFromДатаВремяЧПЛК


Позволяет отбирать файлы, переданные после указанного времени. В дневное время обязательный параметр, ночью ограничения снимаются.
PeriodToДатаВремяЧПЛК
Позволяет отбирать файлы, переданные после указанного времени.
OwnerUserID4.1.2.5. AccountID
Уникальный идентификатор агента, получающего поддержку по линии.
ServiceID4.1.2.9. ServiceID
Линия (поддержки), по которой производился обмен файлами
Пример
<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:GetHistoryOfServiceFileTransfer>
         <par:Params>
            <Property name="PeriodFrom" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-21T01:00:00</Value>
            </Property>
            <Property name="PeriodTo" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:dateTime">2019-09-29T01:00:00</Value>
            </Property>
            <Property name="OwnerUserID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
            </Property>
            <Property name="ServiceID" xmlns="http://v8.1c.ru/8.1/data/core">
               <Value xsi:type="xs:string">fbe839ae-07ec-2003-80e6-0025904f970f</Value>
            </Property>                                    
         </par:Params>
      </par:GetHistoryOfServiceFileTransfer>
   </soap:Body>
</soap:Envelope>

Пример скачивания файла на 1С

Кодом поделился Фефелов Павел Сергеевич АСП Центр сопровождения


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

ПараметрТипОписание
FileIDСтрокаУникальный идентификатор файла
StatusСтрока

Текущее состояние файла. Значения:

  • DOWNLOADED – доступен для скачивания,
  • EXPIRED – истек срок хранения файла,
  • DELETED – файл удален
OwnerUserID4.1.2.5. AccountIDПолучатель поддержки
ServiceID4.1.2.9. ServiceIDЛиния
SourceAgentID4.1.2.5. AccountIDКто опубликовал (выложил) файл в чате
UploadedAtДатаВремяЧПЛКВремя публикации на сервере
FileNameСтрока(255)Имя файла
FileExtensionСтрока(7)Расширение файла
FileSizeЧисло(12)Размер файла в байтах
DownloadLinkСтрока

Адрес для скачивания файла

Требуется аутентификация Basic Auth
Логин и пароль такие же как и к SOAP

FileCheckSumMD5Строка(60) <MD5 Hash>Контрольная сумма MD5
Пример ответа
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
   <soap:Body>
      <m:GetHistoryOfServiceFileTransferResponse 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>FileID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>80</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>Status</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>10</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>OwnerUserID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>ServiceID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>SourceAgentID</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <Type>Null</Type>
                        <StringQualifiers>
                           <Length>0</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>UploadedAt</Name>
                     <ValueType>
                        <Type>xs:dateTime</Type>
                        <DateQualifiers>
                           <DateFractions>DateTime</DateFractions>
                        </DateQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileName</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>255</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileExtension</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>7</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileSize</Name>
                     <ValueType>
                        <Type>xs:decimal</Type>
                        <NumberQualifiers>
                           <Digits>12</Digits>
                           <FractionDigits>0</FractionDigits>
                           <AllowedSign>Any</AllowedSign>
                        </NumberQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>DownloadLink</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>119</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <column>
                     <Name>FileCheckSumMD5</Name>
                     <ValueType>
                        <Type>xs:string</Type>
                        <StringQualifiers>
                           <Length>60</Length>
                           <AllowedLength>Variable</AllowedLength>
                        </StringQualifiers>
                     </ValueType>
                  </column>
                  <row>
                     <Value xsi:type="xs:string">b59ba934-e59b-454e-9aa5-991a98267053</Value>
                     <Value xsi:type="xs:string">DOWNLOADED</Value>
                     <Value xsi:type="xs:string">0e0a9b78-2003-4f6c-bd33-ca248f7f9baf</Value>
                     <Value xsi:type="xs:string">fbe839ae-07ec-2003-80e6-0025904f970f</Value>
                     <Value xsi:type="xs:string">79d4067b-6f12-451a-2003-1ba1d6a61c1e</Value>
                     <Value xsi:type="xs:dateTime">2019-09-27T16:54:53</Value>
                     <Value xsi:type="xs:string">fileoftransfer.xml</Value>
                     <Value xsi:type="xs:string">xml</Value>
                     <Value xsi:type="xs:decimal">409</Value>
                     <Value xsi:type="xs:string">https://filetransfer.1c-connect.com/partner/api/v1/download/service/b59ba934-e59b-454e-9aa5-991a98267053</Value>
                     <Value xsi:type="xs:string">5cafc185241b416200312a1ac4046b77</Value>
                  </row>
                </Value>
            </Property>
         </m:return>
      </m:GetHistoryOfServiceFileTransferResponse>
   </soap:Body>
</soap:Envelope>