Changes for page Интерфейс file

Last modified by Bimit Administrator on 02.10.2024, 11:55
From version 8.1
edited by Bimit Administrator
on 18.02.2022, 13:19
Change comment: There is no comment for this version
To version 16.4
edited by Bimit Administrator
on 27.08.2024, 09:58
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -11,24 +11,45 @@
11 11  * [[addText>>path:#_Toc8]] - функция добавления строки с данным в документ MS Word (DOCX)
12 12  * [[addHeaderRow>>path:#_Toc9]] - функция которая формирует заголовок на странице эксель файла
13 13  * [[addRow>>path:#_Toc10]] - функция которая формирует строку на странице эксель файла
14 -* insertRow - функция которая вставляет строку на указанную позицию на странице эксель файла
15 -* replaceRow - функция которая замещает строку на указанной позицию на странице эксель файла
16 -* deleteRow - функция которая удаляет строку с указанной позиции на странице эксель файла
17 -* autoSizeColumns - функция установки автоматической ширины колонок страницы эксель файла
14 +* [[insertRow>>path:#_Toc15]] - функция которая вставляет строку на указанную позицию на странице эксель файла
15 +* [[replaceRow>>path:#_Toc16]] - функция которая замещает строку на указанной позицию на странице эксель файла
16 +* [[deleteRow>>path:#_Toc17]] - функция которая удаляет строку с указанной позиции на странице эксель файла
17 +* [[autoSizeColumns>>path:#_Toc18]] - функция установки автоматической ширины колонок страницы эксель файла
18 18  * [[getDocument>>path:#_Toc11]] - получение интерфейса текущего документа XWPFDocument (docx) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFDocument.html), предоставляет полный доступ к инструментарию формирования документа MSWord
19 19  * [[getParagraph>>path:#_Toc12]] - получение интерфейса текущего параграфа XWPFParagraph (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFParagraph.html) документа MSWord
20 20  * [[getWorkbook>>path:#_Toc13]] - получение интерфейса текущего табличного документа Workbook (XSSFWorkbook для xlsx и HSSFWorkbook для xls) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Workbook.html), предоставляет полный доступ к инструментарию формирования документа таблицы эксель
21 21  * [[getSheet>>path:#_Toc14]] - получение интерфейса текущей страницы с таблицей (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Sheet.html) документа таблицы эксель
22 +* [[addAreaBreak>>path:#_Toc30]] - добавление разрыва области PDF документа
23 +* [[addImage>>path:#_Toc31]] - добавление изображения в документ Ms Word(DOCX) или PDF, ести тип файла другой, запись идет в поток
24 +* [[addDrawing>>path:#_Toc32]] - добавление чертежа в документ MS Word (DOCX) или PDF, метод принимает на вход массив байтов, содержащий чертеж и двумерный массив, содержащий координаты точек чертежа
25 +* [[addCell>>path:#_Toc22]] - создание ячейки в указанный столбец
26 +* [[replaceRow>>path:#_Toc23]] - замена значений указанной строки новыми значениями текущего листа таблицыи Excel (XLSX, XLS)
27 +* [[sortASC>>path:#_Toc24]] - сортировка таблицы документа Excel (XLSX, XLS) в порядке возрастания по значению в указанном столбце
28 +* [[sortDESC>>path:#_Toc25]] - сортировка таблицы документа Excel (XLSX, XLS) в порядке убывания по значению в указанном столбце
29 +* [[saveTempTable>>path:#_Toc26]] - сохранение значений из потока в таблицу Excel (XLSX, XLS), находящейся по указанному пути
30 +* [[xlsxToJSON>>path:#_Toc27]] - преобразование содержимого документа Excel (XLSX, XLS)
31 +* [[getResource>>path:#_Toc28]] - метод возвращает объект Ms Word (DOCX), PDF, текстовый файл (TXT) или Excel (XLSX, XLS)
32 +* [[makeGrandSmetaExelTable>>path:#_Toc29]] - создание документа Excel (XLSX, XLS) для отчета о гранд-смете
22 22  
34 +**Генерация документа с использованием шаблона**
23 23  
36 +* [[templateToPdf>>path:#_Toc19]] - генерация pdf документа из шаблона
37 +
38 +**Генерация отчета по коллизиям и атрибутам**
39 +
40 +* [[collisionsToPdf>>path:#_Toc20]] - генерация pdf по списку коллизий
41 +* [[attributesToPdf>>path:#_Toc21]] - генерация pdf по списку атрибутов
42 +
24 24  [[Примеры использования в плагинах>>Примеры использования в плагинах]]
25 25  
26 26  
27 27  (% class="box infomessage" %)
28 28  (((
29 -**{{id name="_Toc1"/}}create** - функция конструктор, создает и подготавливает файл для приема данных, доступны варианта: таблица эксель (XLS, XLSX), текстовый файл(TXT), документ MS Word (DOCX)
48 +**{{id name="_Toc1"/}}create** - функция конструктор, создает и подготавливает файл для приема данных, доступны варианта: таблица эксель (XLS, XLSX), текстовый файл(TXT), документ MS Word (DOCX), документ PDF (PDF)
30 30  )))
31 31  
51 +* **file.create(формат создаваемого файла)**
52 +
32 32  **Пример использования:**
33 33  
34 34  
... ... @@ -42,8 +42,8 @@
42 42  **{{id name="_Toc2"/}}addTitle** - добавление заголовка в документ MS Word (DOCX)
43 43  )))
44 44  
45 -* с базовыми настройками
46 -* с указанием размера шрифта, и указанием жирный/простой
66 +* **file.addTitle(Текст)** - с базовыми настройками
67 +* **file.addTitle(Текст, Размер шрифта, жирный/не жирный)** - с указанием размера шрифта, и указанием жирный/простой
47 47  
48 48  **Примеры использования:**
49 49  
... ... @@ -61,8 +61,8 @@
61 61  **{{id name="_Toc3"/}}addParagraph** - функция создания нового параграфа в документе MS Word (DOCX)
62 62  )))
63 63  
64 -* с базовыми настройками
65 -* с указанием отступа, размера шрифта, и указанием жирный/простой
85 +* **file.addParagraph("Текст")** - с базовыми настройками
86 +* **file.addParagraph("Текст", размер отступа, размер шрифта, жирный/не жирный)** - с указанием отступа, размера шрифта, и указанием жирный/простой
66 66  
67 67  **Примеры использования:**
68 68  
... ... @@ -82,10 +82,11 @@
82 82  **{{id name="_Toc4"/}}addCenterParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
83 83  )))
84 84  
106 +* **file.addCenterParagraph("текст", размер шрифта, жирный/не жирный)**
107 +
85 85  **Пример использования:**
86 86  
87 87  
88 -
89 89  {{code language="java"}}
90 90  addCenterParagraph("Текст", 10, true)
91 91  {{/code}}
... ... @@ -96,6 +96,8 @@
96 96  **{{id name="_Toc5"/}}addRightParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
97 97  )))
98 98  
121 +* **file.addRightParagraph("текст", размер шрифта, жирный/не жирный)**
122 +
99 99  **Пример использования:**
100 100  
101 101  
... ... @@ -109,6 +109,8 @@
109 109  **{{id name="_Toc6"/}}addLeftParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
110 110  )))
111 111  
136 +* **file.addLeftParagraph("текст", размер шрифта, жирный/не жирный)**
137 +
112 112  **Пример использования:**
113 113  
114 114  
... ... @@ -122,6 +122,8 @@
122 122  **{{id name="_Toc7"/}}addTextBreak** - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
123 123  )))
124 124  
151 +* **file.addTextBreak()**
152 +
125 125  **Пример использования:**
126 126  
127 127  
... ... @@ -135,12 +135,17 @@
135 135  **{{id name="_Toc8"/}}addText** - функция добавления строки с данным в документ MS Word (DOCX)
136 136  )))
137 137  
138 -* с указанием размера текста и указанием жирный/простой
139 -* с опциями (file.addText(“Строка, которая появится в файле”))
166 +* **file.addText(Object objectValue)** - добавление объекта в строковом представлении
167 +* **file.addText(“Строка, которая появится в файле”, размер шрифта, жирный/не жирный)**
168 +* **file.addText(“Строка, которая появится в файле”)**
169 +* **file.addText(long longValue)** - добавление числа типа long в строковом представлении
170 +* **file.addText(double doubleValue)** - добавление числа типа double в строковом представлении
140 140  
141 141  **Примеры использования:**
142 142  
143 143  {{code language="java"}}
175 +{{/code}}
176 +{{code language="java"}}
144 144  file.addText("Строка, которая появится в файле"), 10, false)
145 145  {{/code}}
146 146  
... ... @@ -148,12 +148,20 @@
148 148  file.addText("Строка, которая появится в файле")
149 149  {{/code}}
150 150  
184 +{{code language="java"}}
185 +{{/code}}
151 151  
187 +{{code language="java"}}
188 +{{/code}}
189 +
190 +
152 152  (% class="box infomessage" %)
153 153  (((
154 -**{{id name="_Toc9"/}}addHeaderRow **- функция которая формирует заголовок на странице эксель файла (пример: file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”))
193 +**{{id name="_Toc9"/}}addHeaderRow **- функция которая формирует заголовок на странице эксель файла
155 155  )))
156 156  
196 +* **file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”)**
197 +
157 157  **Пример использования:**
158 158  
159 159  
... ... @@ -164,9 +164,12 @@
164 164  
165 165  (% class="box infomessage" %)
166 166  (((
167 -**{{id name="_Toc10"/}}addRow** - функция которая формирует строку на странице эксель файла (пример: file.addRow(“Данные 1”, “Данные 2”,....”Данные N”))
208 +**{{id name="_Toc10"/}}addRow** - функция которая формирует строку на странице эксель файла
168 168  )))
169 169  
211 +* **file.addRow(Object... inp)**
212 +* **file.addRow(Map<Object, Object>... inp)**
213 +
170 170  **Пример использования:**
171 171  
172 172  
... ... @@ -174,9 +174,69 @@
174 174  file.addRow( row.get("code"), row.get("title"), row.get("units"), row.get("quantityAll"));
175 175  {{/code}}
176 176  
221 +{{code language="java"}}
222 +{{/code}}
177 177  
224 +
178 178  (% class="box infomessage" %)
179 179  (((
227 +**{{id name="_Toc15"/}}insertRow** - функция которая вставляет строку на указанную позицию на странице эксель файла
228 +)))
229 +
230 +* **file.insertRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)**
231 +
232 +**Пример использования:**
233 +
234 +{{code language="java"}}
235 +file.insertRow(6, "Вставленная строка", 1 , 2.453, new Date(), Calendar.getInstance());
236 +{{/code}}
237 +
238 +
239 +(% class="box infomessage" %)
240 +(((
241 +**{{id name="_Toc16"/}}replaceRow** - функция которая замещает строку на указанной позицию на странице эксель файла
242 +)))
243 +
244 +* **file.replaceRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)**
245 +
246 +**Пример использования:**
247 +
248 +{{code language="java"}}
249 +file.replaceRow(7, "Замещенная строка", 4 , 5.678, new Date(), Calendar.getInstance());
250 +{{/code}}
251 +
252 +
253 +(% class="box infomessage" %)
254 +(((
255 +**{{id name="_Toc17"/}}deleteRow** - функция которая удаляет строку с указанной позиции на странице эксель файла
256 +)))
257 +
258 +* **file.deleteRow(индекс)**
259 +
260 +**Пример использования:**
261 +
262 +{{code language="java"}}
263 +file.deleteRow(3);
264 +{{/code}}
265 +
266 +
267 +(% class="box infomessage" %)
268 +(((
269 +**{{id name="_Toc18"/}}autoSizeColumns** - функция установки автоматической ширины колонок страницы эксель файла
270 +)))
271 +
272 +* **file.autoSizeColumns()** - для всех колонок на странице
273 +* **file.autoSizeColumns(индекс колонки)** - для конкретной колонки на странице
274 +
275 +**Пример использования:**
276 +
277 +{{code language="java"}}
278 +file.autoSizeColumns()
279 +{{/code}}
280 +
281 +
282 +(% class="box infomessage" %)
283 +(((
180 180  **{{id name="_Toc11"/}}getDocument** - получение интерфейса текущего документа XWPFDocument (docx) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFDocument.html), предоставляет полный доступ к инструментарию формирования документа MSWord (полную документацию см. [[https:~~/~~/poi.apache.org/apidocs/4.1/)>>https://poi.apache.org/apidocs/4.1/)]]
181 181  )))
182 182  
... ... @@ -214,6 +214,196 @@
214 214  {{/code}}
215 215  
216 216  
321 +(% class="box infomessage" %)
322 +(((
323 +**{{id name="_Toc19"/}}templateToPdf** - генерация pdf документа из шаблона
324 +)))
325 +
326 +* **[[template>>doc:API.Плагин API.template.WebHome]].add(“название тега в шаблоне”, данные)**
327 +* **file.templateToPdf(template)**
328 +
329 +**Пример использования:**
330 +
331 +{{code language="java"}}
332 +def project = bim.getProject()
333 +template.add("project", project)
334 +file.templateToPdf(template)
335 +{{/code}}
336 +
337 +
338 +(% class="box infomessage" %)
339 +(((
340 +**{{id name="_Toc20"/}}collisionsToPdf** - генерация pdf по списку коллизий
341 +)))
342 +
343 +* **file.collisionsToPdf(template, list, params):**
344 +* **template** - необязательный параметр (указывается в том случае, если таблицу коллизий необходимо добавить в конец какого-либо шаблона). Если не указывать, то создается новый пустой файл, в который заносится таблица коллизий
345 +* **list** - список коллизий. Обязательное поле. Получить данный лист необходимо командой [[bim.getCollisionsForReport()>>https://wiki.bimit.ru/bin/view/API/%D0%9F%D0%BB%D0%B0%D0%B3%D0%B8%D0%BD%20API/%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81%20bim/#_Toc26]]
346 +* **params** - необязательный параметр (описание ниже)
347 +
348 + Параметры при генерации отчета по коллизиям:
349 + pageSize - 1, 2, 3 или 4 (соответствует размеру страницы А1, А2, А3, А4)
350 + fontSize - int значение размера шрифта (в pt)
351 +
352 + **Пример использования:**
353 +
354 +{{code language="java"}}
355 + def param = [:]
356 + param.add("pageSize", 3)
357 + param.add("fontSize", 12)
358 +{{/code}}
359 +
360 + По умолчанию параметры принимают следующие значения:
361 + pageSize - 4
362 + fontSize - 8
363 +
364 +
365 +**Пример использования:**
366 +
367 +{{code language="java"}}
368 +def collisionList = bim.getCollisionsForReport()
369 + def param = [:]
370 + param.add("pageSize", 3)
371 + param.add("fontSize", 12)
372 + file.collisionsToPdf(template, collisionList, param)
373 +{{/code}}
374 +
375 +{{code language="java"}}
376 + def collisionList = bim.getCollisionsForReport()
377 + file.collisionsToPdf(collisionList)
378 +{{/code}}
379 +
380 +
381 +(% class="box infomessage" %)
382 +(((
383 +**{{id name="_Toc21"/}}attributesToPdf** - генерация pdf по списку атрибутов
384 +)))
385 +
386 +* **file.attributesToPdf(template, list, params)**
387 +
388 +(% class="box infomessage" %)
389 +(((
390 +**{{id name="_Toc30"/}}addAreaBreak** - добавление разрыва области PDF документа
391 +)))
392 +
393 +* **file.addAreaBreak() **
394 +
395 +**Пример использования:**
396 +
397 +{{code language="java"}}{{/code}}
398 +
399 +(% class="box infomessage" %)
400 +(((
401 +**{{id name="_Toc31"/}}addImage** - добавление изображения в документ Ms Word(DOCX) или PDF, ести тип файла другой, запись идет в поток
402 +)))
403 +
404 +* **file.addImage(byte[] imageFile) **
405 +
406 +**Пример использования:**
407 +
408 +{{code language="java"}}{{/code}}
409 +
410 +(% class="box infomessage" %)
411 +(((
412 +**{{id name="_Toc32"/}}addDrawing** - добавление чертежа в документ MS Word (DOCX) или PDF, метод принимает на вход массив байтов, содержащий чертеж и двумерный массив, содержащий координаты точек чертежа
413 +)))
414 +
415 +* **file.addDrawing(byte[] drawingPage, double[][] arr) **
416 +
417 +**Пример использования:**
418 +
419 +{{code language="java"}}{{/code}}
420 +
421 +(% class="box infomessage" %)
422 +(((
423 +**{{id name="_Toc22"/}}addCell** - создание ячейки в указанный столбец
424 +)))
425 +
426 +* **file.addCell(int indexColumn, int indexRow, Object value) ** - создание ячейки в указанный столбец и строку текущего листа таблицы Excel (XLSX, XLS) с указанным значением
427 +* **file.addCell(int indexColumn, Object value) ** - создание ячейки в указанный столбец в конец строки текущего листа таблицы Excel (XLSX, XLS) с указанным значением
428 +
429 +**Пример использования:**
430 +
431 +{{code language="java"}}{{/code}}
432 +
433 +(% class="box infomessage" %)
434 +(((
435 +**{{id name="_Toc23"/}}replaceRow** - замена значений указанной строки новыми значениями текущего листа таблицыи Excel (XLSX, XLS)
436 +)))
437 +
438 +* **file.replaceRow(int indexRow, Object... inp) **
439 +
440 +**Пример использования:**
441 +
442 +{{code language="java"}}{{/code}}
443 +
444 +(% class="box infomessage" %)
445 +(((
446 +**{{id name="_Toc24"/}}sortASC** - сортировка таблицы документа Excel (XLSX, XLS) в порядке возрастания по значению в указанном столбце
447 +)))
448 +
449 +* **file.sortASC(int indexColumn) **
450 +
451 +**Пример использования:**
452 +
453 +{{code language="java"}}{{/code}}
454 +
455 +(% class="box infomessage" %)
456 +(((
457 +**{{id name="_Toc25"/}}sortDESC** - сортировка таблицы документа Excel (XLSX, XLS) в порядке убывания по значению в указанном столбце
458 +)))
459 +
460 +* **file.sortDESC(int indexColumn) **
461 +
462 +**Пример использования:**
463 +
464 +{{code language="java"}}{{/code}}
465 +
466 +(% class="box infomessage" %)
467 +(((
468 +**{{id name="_Toc26"/}}saveTempTable** - сохранение значений из потока в таблицу Excel (XLSX, XLS), находящейся по указанному пути
469 +)))
470 +
471 +* **file.saveTempTable(String tablesTempLocation) **
472 +
473 +**Пример использования:**
474 +
475 +{{code language="java"}}{{/code}}
476 +
477 +(% class="box infomessage" %)
478 +(((
479 +**{{id name="_Toc27"/}}xlsxToJSON** - преобразование содержимого документа Excel (XLSX, XLS)
480 +)))
481 +
482 +* **file.xlsxToJSON(int page, int pageSize) ** - преобразование содержимого документа Excel (XLSX, XLS) с указанной страницы, с указанным количеством строк в формат JSON
483 +* **file.xlsxToJSON(String tablesTempLocation, int page, int pageSize) ** - преобразование содержимого документа Excel (XLSX, XLS), находящегося по указанному пути в формате JSON, с учетом указанной страницы и указанных количество строк
484 +
485 +**Пример использования:**
486 +
487 +{{code language="java"}}{{/code}}
488 +
489 +(% class="box infomessage" %)
490 +(((
491 +**{{id name="_Toc28"/}}getResource** - метод возвращает объект Ms Word (DOCX), PDF, текстовый файл (TXT) или Excel (XLSX, XLS)
492 +)))
493 +
494 +* **file.getResource() **
495 +
496 +**Пример использования:**
497 +
498 +{{code language="java"}}{{/code}}
499 +
500 +(% class="box infomessage" %)
501 +(((
502 +**{{id name="_Toc29"/}}makeGrandSmetaExelTable** - создание документа Excel (XLSX, XLS) для отчета о гранд-смете
503 +)))
504 +
505 +* **file.makeGrandSmetaExelTable() **
506 +
507 +**Пример использования:**
508 +
509 +{{code language="java"}}{{/code}}
510 +
217 217  **Наименование используемых строк row.get:**
218 218  
219 219