Описание

Модуль “Диск” в Битрикс24 предоставляет возможности для хранения и управления файлами. Данный раздел содержит примеры PHP-кода, демонстрирующие получение детальной информации о файлах и получение списка ID файлов из определенной папки на Битрикс24 Диске. Эти операции могут быть полезны для автоматизации процессов, связанных с анализом содержимого диска или обработкой файлов.

Примеры использования

Пример 1: Получение информации о файле

Этот пример демонстрирует, как получить метаданные файла с Битрикс24 Диска по его ID и передать их в переменную бизнес-процесса.

use Bitrix\Disk\File;
use Bitrix\Main\Loader;

Loader::includeModule('disk');

// ID файла, информацию о котором нужно получить
$fileId = 101; // Замените на реальный ID файла

$fileInfo = [];
$file = File::loadById($fileId);

if ($file) {
    $fileInfo = [
        'ID' => $file->getId(),
        'NAME' => $file->getName(),
        'SIZE' => $file->getSize(),
        'EXTENSION' => $file->getExtension(),
        'CREATE_TIME' => $file->getCreateTime()->toString(),
        'CREATED_BY' => $file->getCreatedBy(),
    ];
}

$rootActivity = $this->GetRootActivity();
$rootActivity->SetVariable("FileInfo", $fileInfo);

Пример 2: Получение ID файлов из конкретной папки

Этот пример показывает, как получить список ID всех файлов, находящихся в указанной папке на Битрикс24 Диске, и передать их в переменную бизнес-процесса.

use Bitrix\Disk\Driver;
use Bitrix\Disk\Folder;
use Bitrix\Main\Loader;

Loader::includeModule('disk');

// ID папки, из которой нужно получить файлы
$folderId = 123; // Замените на реальный ID папки

$fileIDs = [];
$folder = Folder::loadById($folderId);

if ($folder) {
    $files = $folder->getFiles();
    foreach ($files as $file) {
        $fileIDs[] = $file->getId();
    }
}

$rootActivity = $this->GetRootActivity();
$rootActivity->SetVariable("FileIDs", $fileIDs);

Параметры

  • $fileId (int): ID файла на Битрикс24 Диске для получения информации.
  • $folderId (int): ID папки на Битрикс24 Диске для получения списка файлов.

Возвращаемые значения

  • Получение информации о файле: Массив fileInfo, содержащий метаданные файла (ID, NAME, SIZE, EXTENSION, CREATE_TIME, CREATED_BY).
  • Получение ID файлов из папки: Массив fileIDs целых чисел, содержащий ID файлов.

Рекомендации по использованию

  • Всегда проверяйте наличие необходимых модулей (disk) с помощью Loader::includeModule().
  • Используйте актуальные ID папок и файлов. Их можно получить программно или из интерфейса Битрикс24.
  • Обрабатывайте возможные ошибки и исключения при работе с файлами.
  • Для больших папок рассмотрите возможность пагинации или использования более эффективных запросов, если это применимо.
  • Результаты операций передаются в переменные бизнес-процесса с помощью SetVariable().