Изменить архив

Добавляет, заменяет и удаляет файлы в существующем tar-архиве

Параметры

Функция ИзменитьАрхив(Знач Архив, Знач ДобавляемыеФайлы = Неопределено, Знач УдаляемыеПути = Неопределено, Знач Настройки = Неопределено) Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
Архив	--src	Строка, ДвоичныеДанные	✔	Путь к архиву на диске или двоичные данные
ДобавляемыеФайлы	--additions	Соответствие Из КлючИЗначение	✖	Ключ: путь в архиве; значение: путь к файлу или двоичные данные
УдаляемыеПути	--deletions	Массив Из Строка	✖	Пути файлов в архиве для удаления
Настройки	--settings	Соответствие Из КлючИЗначение	✖	Настройки изменения. См. ПолучитьСтруктуруНастроекАрхивации

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

ДвоичныеДанные, Соответствие Из КлючИЗначение - Результат операции для архива на диске или новые двоичные данные архива

Расширенный вызов ?

Параметр	Описание
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

подсказка

Параметры с типом данных Двоичные данные могут принимать также пути к файлам на диске и URL

Пример использования для 1С:Предприятие/OneScript

    ПутьАрхива      = Параметры["Tar_ArchivePath"];
    ПутьНовогоФайла = Параметры["Tar_NewFilePath"];

    ДобавляемыеФайлы = Новый Соответствие;
    ДобавляемыеФайлы.Вставить("extra/info.txt", ПутьНовогоФайла);
    ДобавляемыеФайлы.Вставить("readme.txt"    , ПолучитьДвоичныеДанныеИзСтроки("Replaced readme content", "UTF-8"));

    УдаляемыеПути = Новый Массив;
    УдаляемыеПути.Добавить("config/settings.json");

    Результат = OPI_Tar.ИзменитьАрхив(ПутьАрхива, ДобавляемыеФайлы, УдаляемыеПути);

Bash

    # JSON данные также могут быть переданы как путь к файлу .json
    
    oint tar ИзменитьАрхив \
      --src "C:\Users\bayselonarrend\AppData\Local\Temp\\opi_tar_63920122775894/archive_buffer.tar" \
      --additions "{'extra/info.txt':'C:\\Users\\bayselonarrend\\AppData\\Local\\Temp\\\\opi_tar_63920122775894/extra_info.txt','readme.txt':'C:\\Users\\bayselonarrend\\AppData\\Local\\Temp\\ddekgpwp.k3t'}" \
      --deletions "['config/settings.json']"

CMD/Bat

    :: JSON данные также могут быть переданы как путь к файлу .json
    
    oint tar ИзменитьАрхив ^
      --src "C:\Users\bayselonarrend\AppData\Local\Temp\\opi_tar_63920122775894/archive_buffer.tar" ^
      --additions "{'extra/info.txt':'C:\\Users\\bayselonarrend\\AppData\\Local\\Temp\\\\opi_tar_63920122775894/extra_info.txt','readme.txt':'C:\\Users\\bayselonarrend\\AppData\\Local\\Temp\\ddekgpwp.k3t'}" ^
      --deletions "['config/settings.json']"

Результат

{
 "result": true
}