mirror of
https://github.com/Bayselonarrend/OpenIntegrations.git
synced 2025-03-27 21:48:56 +02:00
166 lines
6.4 KiB
Plaintext
166 lines
6.4 KiB
Plaintext
---
|
|
sidebar_position: 5
|
|
---
|
|
|
|
import Tabs from '@theme/Tabs';
|
|
import TabItem from '@theme/TabItem';
|
|
|
|
# Отправить файл
|
|
Отправляет файл диска в чат по ID
|
|
|
|
|
|
|
|
`Функция ОтправитьФайл(Знач URL, Знач IDЧата, Знач IDФайла, Знач Описание = "", Знач Токен = "") Экспорт`
|
|
|
|
| Параметр | CLI опция | Тип | Обяз. | Назначение |
|
|
|-|-|-|-|-|
|
|
| URL | --url | Строка | ✔ | URL внешнего вебхука или адрес Bitrix24 при использовании токена |
|
|
| IDЧата | --chat | Строка, Число | ✔ | ID чата |
|
|
| IDФайла | --fileid | Строка, Число | ✔ | ID файла, загруженного при помощи ЗагрузитьФайлВКаталог |
|
|
| Описание | --description | Строка | ✖ | Описание файла |
|
|
| Токен | --token | Строка | ✖ | Токен авторизации, если используется не вебхук |
|
|
|
|
|
|
Возвращаемое значение: Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrxi24
|
|
|
|
<br/>
|
|
|
|
:::tip
|
|
Метод в документации API: [im.disk.file.commit](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=11485)
|
|
:::
|
|
<br/>
|
|
|
|
|
|
```bsl title="Пример использования для 1С:Предприятие/OneScript"
|
|
URL = "https://b24-ar17wx.bitrix24.by/rest/1/ps5...";
|
|
IDЧата = "1598";
|
|
Файл = "https://api.athenaeum.digital/test_data/document.docx"; // Двоичные данные, URL или путь к файлу
|
|
Описание = "Очень важный файл";
|
|
|
|
Каталог = OPI_Bitrix24.ПолучитьКаталогФайловЧата(URL, IDЧата);
|
|
IDКаталога = Каталог["result"]["ID"];
|
|
|
|
ЗагруженныйФайл = OPI_Bitrix24.ЗагрузитьФайлВКаталог(URL, "Важный документ.docx", Файл, IDКаталога);
|
|
IDФайла = ЗагруженныйФайл["result"]["ID"];
|
|
|
|
Результат = OPI_Bitrix24.ОтправитьФайл(URL, IDЧата, IDФайла, Описание);
|
|
|
|
URL = "b24-ar17wx.bitrix24.by";
|
|
Токен = "a8e65667006e9f06006b12e400000001000...";
|
|
IDЧата = "1600";
|
|
|
|
Каталог = OPI_Bitrix24.ПолучитьКаталогФайловЧата(URL, IDЧата, Токен);
|
|
IDКаталога = Каталог["result"]["ID"];
|
|
|
|
ЗагруженныйФайл = OPI_Bitrix24.ЗагрузитьФайлВКаталог(URL, "Важный документ.docx", Файл, IDКаталога, Токен);
|
|
IDФайла = ЗагруженныйФайл["result"]["ID"];
|
|
|
|
Результат = OPI_Bitrix24.ОтправитьФайл(URL, IDЧата, IDФайла, Описание, Токен);
|
|
```
|
|
|
|
|
|
<Tabs>
|
|
|
|
<TabItem value="bash" label="Bash" default>
|
|
```bash
|
|
oint bitrix24 ОтправитьФайл \
|
|
--url "b24-ar17wx.bitrix24.by" \
|
|
--chat 1652 \
|
|
--fileid 22514 \
|
|
--description "Очень важный файл" \
|
|
--token "***"
|
|
```
|
|
</TabItem>
|
|
|
|
<TabItem value="bat" label="CMD/Bat" default>
|
|
```batch
|
|
oint bitrix24 ОтправитьФайл ^
|
|
--url "b24-ar17wx.bitrix24.by" ^
|
|
--chat 1652 ^
|
|
--fileid 22514 ^
|
|
--description "Очень важный файл" ^
|
|
--token "***"
|
|
```
|
|
</TabItem>
|
|
</Tabs>
|
|
|
|
|
|
```json title="Результат"
|
|
{
|
|
"result": {
|
|
"FILES": {
|
|
"upload12494": {
|
|
"id": 12494,
|
|
"chatId": 980,
|
|
"date": {},
|
|
"type": "file",
|
|
"name": "Важный документ.docx",
|
|
"extension": "docx",
|
|
"size": 24071,
|
|
"image": false,
|
|
"status": "done",
|
|
"progress": 100,
|
|
"authorId": 1,
|
|
"authorName": "Антон Титовец",
|
|
"urlPreview": "",
|
|
"urlShow": "/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=12494&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
|
|
"urlDownload": "/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=12494&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
|
|
"viewerAttrs": {
|
|
"viewer": null,
|
|
"viewerType": "cloud-document",
|
|
"src": "/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=12494&fileName=%D0%92%D0%B0%D0%B6%D0%BD%D1%8B%D0%B9%20%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.docx",
|
|
"viewerTypeClass": "BX.Messenger.Integration.Viewer.OnlyOfficeChatItem",
|
|
"viewerSeparateItem": true,
|
|
"viewerExtension": "im.integration.viewer",
|
|
"objectId": "12494",
|
|
"imChatId": 980,
|
|
"title": "Важный документ.docx",
|
|
"actions": "[{\"type\":\"download\"},{\"type\":\"copyToMe\",\"text\":\"Сохранить на Битрикс24 Диск\",\"action\":\"BXIM.disk.saveToDiskAction\",\"params\":{\"fileId\":\"12494\"},\"extension\":\"disk.viewer.actions\",\"buttonIconClass\":\"ui-btn-icon-cloud\"}]"
|
|
}
|
|
}
|
|
},
|
|
"DISK_ID": [
|
|
"12494"
|
|
],
|
|
"FILE_MODELS": {
|
|
"upload12494": {
|
|
"id": 12494,
|
|
"name": "Важный документ.docx",
|
|
"createTime": {},
|
|
"updateTime": {},
|
|
"deleteTime": null,
|
|
"code": null,
|
|
"xmlId": null,
|
|
"storageId": 6,
|
|
"realObjectId": 12494,
|
|
"parentId": 12490,
|
|
"deletedType": 0,
|
|
"createdBy": "1",
|
|
"updatedBy": "1",
|
|
"deletedBy": "0",
|
|
"typeFile": 4,
|
|
"globalContentVersion": 2,
|
|
"fileId": 8608,
|
|
"size": 24071,
|
|
"etag": "2b187abc4e0ad8f0dddca6137313bc3f",
|
|
"links": {
|
|
"download": "/bitrix/services/main/ajax.php?action=disk.file.download&SITE_ID=s1&fileId=12494",
|
|
"showInGrid": "/bitrix/tools/disk/focus.php?objectId=12494&action=showObjectInGrid&ncc=1"
|
|
}
|
|
}
|
|
},
|
|
"MESSAGE_ID": 17618
|
|
},
|
|
"time": {
|
|
"start": 1728409854.91573,
|
|
"finish": 1728409855.01136,
|
|
"duration": 0.0956261157989502,
|
|
"processing": 0.0702199935913086,
|
|
"date_start": "2024-10-08T20:50:54+03:00",
|
|
"date_finish": "2024-10-08T20:50:55+03:00",
|
|
"operating_reset_at": 1728410454,
|
|
"operating": 0
|
|
}
|
|
}
|
|
```
|