[ELMA3] Добавление версии в документ с помощью сценария

В статье приведены сценарии добавления новой версии (контекстная переменная "Файл" (Fayl) имеет тип Файл) в документ (контекстная переменная Документ (Document), в качестве типа которой выбран конкретный тип документа).

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

Примечание

Актуальная документация по PublicAPI доступна по ссылке.

Внимание!

Сценарии, указанные ниже, актуальны для версий системы ELMA до 3.15.38 включительно.

Контекстные переменные:

context.Document – переменная типа Документ;
context.Fayl – переменная типа Системные – Файл;
DocumentVersionStatus – необязательный параметр, если не указан, то для версии устанавливается статус Черновик.

Подключить пространство имен:

using EleWise.ELMA.API;

Текст сценария:

PublicAPI.Docflow.DocumentVersion.AddDocumentVersion(context.Document, context.Fayl, PublicAPI.Enums.Documents.DocumentVersionStatus.Current);	//Документ, файл, статус версии - текущая(необязательный параметр, если не указан, то для версии устанавливается статус ’Черновик’)

Далее приведен пример сценария для генерации файла-версии из шаблона, находящегося на физическом диске сервера.

Контекстные переменные:

context.Document - переменная типа Документ;
context.Fayl - переменная типа Файл.

Подключить пространство имен:

using EleWise.ELMA.Files;

context.Fayl = InterfaceActivator.Create<BinaryFile>();
context.Fayl.Name = "Name.docx"; //имя файла-версии (обязательно указывайте нужное расширение)
context.Fayl.CreateDate = DateTime.Now;
context.Fayl.InitializeContentFilePath();
System.IO.File.Copy(@"c:\BASA\Document.docx", context.Fayl.ContentFilePath); //1й параметр функции - путь до файла на физическом диске на сервере
PublicAPI.Services.DocumentGenerator.Generate(context.Fayl, context);
PublicAPI.Services.File.SaveFile(context.Fayl); //сохраняем полученный файл в контекст
PublicAPI.Docflow.DocumentVersion.AddDocumentVersion(context.Document, context.Fayl, PublicAPI.Enums.Documents.DocumentVersionStatus.Current); //Добавляем версию в документ со статусом Текущая

Внимание!

Сценарий, указанный ниже, актуален для версии системы ELMA ниже 3.8.

Подключить пространство имен:

using EleWise.ELMA.Files;
using EleWise.ELMA.Model.Services;
using EleWise.ELMA.Services;
using EleWise.ELMA.Runtime.Managers;
using EleWise.ELMA.Templates;

Текст сценария:

context.Fayl = InterfaceActivator.Create<BinaryFile>();
context.Fayl.Name="Name.docx"; //имя файла-версии (обязательно указывайте нужное расширение)
context.Fayl.CreateDate = DateTime.Now;
context.Fayl.InitializeContentFilePath();
System.IO.File.Copy(@"c:\BASA\Document.docx", context.Fayl.ContentFilePath); //1й параметр функции - путь до файла на физическом диске на сервере
var generator = Locator.GetServiceNotNull<DocumentGeneratorManager>().Create(context.Fayl.ContentFilePath); //создаем генератор
generator.Generate(context);
Locator.GetServiceNotNull<IFileManager>().SaveFile(context.Fayl); //сохраняем полученный файл в контекст
PublicAPI.Docflow.DocumentVersion.AddDocumentVersion(context.Document, context.Fayl, PublicAPI.Enums.Documents.DocumentVersionStatus.Current); //Добавляем версию в документ со статусом Текущая

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

Для работы сценария необходимо подключить сборки:

Elewise.ELMA.Documents

Elewise.ELMA.Documents.Docflow

Пространства имен:

using EleWise.ELMA.Documents.Managers;
using EleWise.ELMA.Documents.Models;
using EleWise.ELMA.Services; 
using EleWise.ELMA.Model.Services;

Текст сценария:

var version = InterfaceActivator.Create<DocumentVersion>();
version.Document = context.Document;
version.File=context.Fayl;
version.Status = DocumentVersionStatus.Current;//устанавливаем статус версии Текущая
context.Document.Versions.Add(version);
context.Document.Save();

Для работы сценария необходимо подключить сборки:
Elewise.ELMA.Documents
Elewise.ELMA.Documents.Docflow

Пространства имен:

using EleWise.ELMA.Documents;
using EleWise.ELMA.Documents.Docflow;
using EleWise.ELMA.Documents.Models;
using EleWise.ELMA.Files;
using EleWise.ELMA.Model.Services;
using EleWise.ELMA.Runtime.Managers;
using EleWise.ELMA.Services;
using EleWise.ELMA.Templates;

Контекстные переменные:

context.Dok - переменная типа Документ, в которую нужно добавить файл-версию;
context.Fayl - переменная типа Системные-Файл.

Текст сценария:

context.Fayl = InterfaceActivator.Create<BinaryFile>();
context.Fayl.Name="Name.docx"; //имя файла-версии (обязательно указывайте нужное расширение)
context.Fayl.CreateDate = DateTime.Now;
context.Fayl.InitializeContentFilePath();
System.IO.File.Copy(@"c:\Шаблон1.docx", context.Fayl.ContentFilePath); //1й параметр функции - путь до файла на физическом диске на сервере
var generator = Locator.GetServiceNotNull<DocumentGeneratorManager>().Create(context.Fayl.ContentFilePath); //создаем генератор
generator.Generate(context);
Locator.GetServiceNotNull<IFileManager>().SaveFile(context.Fayl); //сохраняем полученный файл в контекст
var version = InterfaceActivator.Create<DocumentVersion>(); //создаем версию документа
version.Document = context.Dok;
version.File=context.Fayl; //загружаем сгенерированный файл в версию
version.Status = DocumentVersionStatus.Current; //присваиваем версии статус Текущая
context.Dok.Versions.Add(version);
context.Dok.Save(); //сохраняем документ