Менеджер (из пространства имен Ultima) предназначен для работы с сервисом экспорта печатных форм.
Интерфейс менеджера IExportManager реализует следующие методы:
•Export(ExportFormat options, long printFormId, PrintFormParameters parameters) – экспортирует указанную печатную форму, не связанную с каким-либо объектом, в указанный формат:
▪options – формат, в который осуществляется экспорт, может принимать значения:
▪Pdf – формат pdf;
▪Xls – формат excel;
▪Xlsx – формат excel;
▪Rtf – формат rtf;
▪Html – формат html;
▪Image – изображение;
▪printFormId – идентификатор печатной формы;
▪parameters – дополнительные параметры печати;
•ExportDictionaryRecord(Type dictionaryType, long recordId, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null)– экспортирует печатную форму указанной записи справочника в указанный формат:
▪dictionaryType – тип справочника;
▪recordId – идентификатор записи справочника;
▪printFormId – идентификатор печатной формы;
▪options – формат, в который осуществляется экспорт;
▪parameters – дополнительные параметры печати (значение по умолчанию null);
Также существует типизированный вариант этого метода ExportDictionaryRecord<T>(this IExportManager manager, long recordId, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null);
•ExportDictionaryList(Type dictionaryType, long[] recordList, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null)– экспортирует печатную форму указанных записей справочника в указанный формат:
▪dictionaryType – тип справочника;
▪recordId – список идентификаторов записей справочника;
▪printFormId – идентификатор печатной формы;
▪options – формат, в который осуществляется экспорт;
▪parameters – дополнительные параметры печати (значение по умолчанию null);
Также существует типизированный вариант этого метода ExportDictionaryList<T>(this IExportManager manager, long[] recordList, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null);
•ExportDocument(long documentId, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null) – экспортирует печатную форму указанного документа в указанный формат:
▪documentId – идентификатор документа;
▪printFormId – идентификатор печатной формы;
▪options – формат, в который осуществляется экспорт;
▪parameters – дополнительные параметры печати (значение по умолчанию null);
•ExportDocumentList(long[] documentList, long printFormId, ExportFormat options, IDictionary<string, object> parameters = null) – экспортирует печатную форму указанных документов в указанный формат:
▪documentList – список идентификаторов документов;
▪printFormId – идентификатор печатной формы;
▪options – формат, в который осуществляется экспорт;
▪parameters – дополнительные параметры печати (значение по умолчанию null);
Примеры использования API экспорта:
// значения параметров long recordId = 1; long documentId = 1; long printFormId = 1; var parameters = new Dictionary<string, object>(); parameters["Param1"] = "test"; parameters["Param2"] = "parameter";
// экспортируем печатную форму записи справочника в формат pdf var action1 = new SaveFileAction("exp.pdf", ExportManager.ExportDictionaryRecord<Language>(recordId, printFormId, ExportFormat.Pdf, parameters));
// экспортируем печатную форму документа в формат rtf var action2 = new SaveFileAction("exp.rtf", ExportManager.ExportDocument(documentId, printFormId, ExportFormat.Rtf, parameters)); |