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

Last modified by Bimit Administrator on 02.10.2024, 11:55

From version 10.5
edited by Bimit Administrator
on 18.07.2023, 09:57
Change comment: There is no comment for this version
To version 16.2
edited by Bimit Administrator
on 27.08.2024, 09:50
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -19,6 +19,17 @@
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  
23 23  **Генерация документа с использованием шаблона**
24 24  
... ... @@ -29,7 +29,6 @@
29 29  * [[collisionsToPdf>>path:#_Toc20]] - генерация pdf по списку коллизий
30 30  * [[attributesToPdf>>path:#_Toc21]] - генерация pdf по списку атрибутов
31 31  
32 -
33 33  [[Примеры использования в плагинах>>Примеры использования в плагинах]]
34 34  
35 35  
... ... @@ -38,7 +38,7 @@
38 38  **{{id name="_Toc1"/}}create** - функция конструктор, создает и подготавливает файл для приема данных, доступны варианта: таблица эксель (XLS, XLSX), текстовый файл(TXT), документ MS Word (DOCX), документ PDF (PDF)
39 39  )))
40 40  
41 -* file.create(формат создаваемого файла)
51 +* **file.create(формат создаваемого файла)**
42 42  
43 43  **Пример использования:**
44 44  
... ... @@ -53,8 +53,8 @@
53 53  **{{id name="_Toc2"/}}addTitle** - добавление заголовка в документ MS Word (DOCX)
54 54  )))
55 55  
56 -* file.addTitle(Текст) - с базовыми настройками
57 -* file.addTitle(Текст, Размер шрифта, жирный/не жирный) - с указанием размера шрифта, и указанием жирный/простой
66 +* **file.addTitle(Текст)** - с базовыми настройками
67 +* **file.addTitle(Текст, Размер шрифта, жирный/не жирный)** - с указанием размера шрифта, и указанием жирный/простой
58 58  
59 59  **Примеры использования:**
60 60  
... ... @@ -72,8 +72,8 @@
72 72  **{{id name="_Toc3"/}}addParagraph** - функция создания нового параграфа в документе MS Word (DOCX)
73 73  )))
74 74  
75 -* addParagraph("Текст") - с базовыми настройками
76 -* addParagraph("Текст", размер отступа, размер шрифта, жирный/не жирный) - с указанием отступа, размера шрифта, и указанием жирный/простой
85 +* **file.addParagraph("Текст")** - с базовыми настройками
86 +* **file.addParagraph("Текст", размер отступа, размер шрифта, жирный/не жирный)** - с указанием отступа, размера шрифта, и указанием жирный/простой
77 77  
78 78  **Примеры использования:**
79 79  
... ... @@ -93,7 +93,7 @@
93 93  **{{id name="_Toc4"/}}addCenterParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
94 94  )))
95 95  
96 -* addCenterParagraph("текст", размер шрифта, жирный/не жирный)
106 +* **file.addCenterParagraph("текст", размер шрифта, жирный/не жирный)**
97 97  
98 98  **Пример использования:**
99 99  
... ... @@ -108,7 +108,7 @@
108 108  **{{id name="_Toc5"/}}addRightParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
109 109  )))
110 110  
111 -* addRightParagraph("текст", размер шрифта, жирный/не жирный)
121 +* **file.addRightParagraph("текст", размер шрифта, жирный/не жирный)**
112 112  
113 113  **Пример использования:**
114 114  
... ... @@ -123,7 +123,7 @@
123 123  **{{id name="_Toc6"/}}addLeftParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
124 124  )))
125 125  
126 -* addLeftParagraph("текст", размер шрифта, жирный/не жирный)
136 +* **file.addLeftParagraph("текст", размер шрифта, жирный/не жирный)**
127 127  
128 128  **Пример использования:**
129 129  
... ... @@ -138,7 +138,7 @@
138 138  **{{id name="_Toc7"/}}addTextBreak** - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
139 139  )))
140 140  
141 -* file.addTextBreak()
151 +* **file.addTextBreak()**
142 142  
143 143  **Пример использования:**
144 144  
... ... @@ -153,8 +153,10 @@
153 153  **{{id name="_Toc8"/}}addText** - функция добавления строки с данным в документ MS Word (DOCX)
154 154  )))
155 155  
156 -* file.addText(“Строка, которая появится в файле”, размер шрифта, жирный/не жирный)
157 -* file.addText(“Строка, которая появится в файле”)
166 +* **file.addText(“Строка, которая появится в файле”, размер шрифта, жирный/не жирный)**
167 +* **file.addText(“Строка, которая появится в файле”)**
168 +* **file.addText(long longValue)** - добавление числа типа long в строковом представлении
169 +* **file.addText(double doubleValue)** - добавление числа типа double в строковом представлении
158 158  
159 159  **Примеры использования:**
160 160  
... ... @@ -166,13 +166,19 @@
166 166  file.addText("Строка, которая появится в файле")
167 167  {{/code}}
168 168  
181 +{{code language="java"}}
182 +{{/code}}
169 169  
184 +{{code language="java"}}
185 +{{/code}}
186 +
187 +
170 170  (% class="box infomessage" %)
171 171  (((
172 172  **{{id name="_Toc9"/}}addHeaderRow **- функция которая формирует заголовок на странице эксель файла
173 173  )))
174 174  
175 -* file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”)
193 +* **file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”)**
176 176  
177 177  **Пример использования:**
178 178  
... ... @@ -187,7 +187,7 @@
187 187  **{{id name="_Toc10"/}}addRow** - функция которая формирует строку на странице эксель файла
188 188  )))
189 189  
190 -* file.addRow(“Данные 1”, “Данные 2”,....”Данные N”)
208 +* **file.addRow(“Данные 1”, “Данные 2”,....”Данные N”)**
191 191  
192 192  **Пример использования:**
193 193  
... ... @@ -202,7 +202,7 @@
202 202  **{{id name="_Toc15"/}}insertRow** - функция которая вставляет строку на указанную позицию на странице эксель файла
203 203  )))
204 204  
205 -* file.insertRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)
223 +* **file.insertRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)**
206 206  
207 207  **Пример использования:**
208 208  
... ... @@ -216,7 +216,7 @@
216 216  **{{id name="_Toc16"/}}replaceRow** - функция которая замещает строку на указанной позицию на странице эксель файла
217 217  )))
218 218  
219 -* file.replaceRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)
237 +* **file.replaceRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)**
220 220  
221 221  **Пример использования:**
222 222  
... ... @@ -230,7 +230,7 @@
230 230  **{{id name="_Toc17"/}}deleteRow** - функция которая удаляет строку с указанной позиции на странице эксель файла
231 231  )))
232 232  
233 -* file.deleteRow(индекс)
251 +* **file.deleteRow(индекс)**
234 234  
235 235  **Пример использования:**
236 236  
... ... @@ -244,8 +244,8 @@
244 244  **{{id name="_Toc18"/}}autoSizeColumns** - функция установки автоматической ширины колонок страницы эксель файла
245 245  )))
246 246  
247 -* file.autoSizeColumns() - для всех колонок на странице
248 -* file.autoSizeColumns(индекс колонки) - для конкретной колонки на странице
265 +* **file.autoSizeColumns()** - для всех колонок на странице
266 +* **file.autoSizeColumns(индекс колонки)** - для конкретной колонки на странице
249 249  
250 250  **Пример использования:**
251 251  
... ... @@ -293,6 +293,196 @@
293 293  {{/code}}
294 294  
295 295  
314 +(% class="box infomessage" %)
315 +(((
316 +**{{id name="_Toc19"/}}templateToPdf** - генерация pdf документа из шаблона
317 +)))
318 +
319 +* **[[template>>doc:API.Плагин API.template.WebHome]].add(“название тега в шаблоне”, данные)**
320 +* **file.templateToPdf(template)**
321 +
322 +**Пример использования:**
323 +
324 +{{code language="java"}}
325 +def project = bim.getProject()
326 +template.add("project", project)
327 +file.templateToPdf(template)
328 +{{/code}}
329 +
330 +
331 +(% class="box infomessage" %)
332 +(((
333 +**{{id name="_Toc20"/}}collisionsToPdf** - генерация pdf по списку коллизий
334 +)))
335 +
336 +* **file.collisionsToPdf(template, list, params):**
337 +* **template** - необязательный параметр (указывается в том случае, если таблицу коллизий необходимо добавить в конец какого-либо шаблона). Если не указывать, то создается новый пустой файл, в который заносится таблица коллизий
338 +* **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]]
339 +* **params** - необязательный параметр (описание ниже)
340 +
341 + Параметры при генерации отчета по коллизиям:
342 + pageSize - 1, 2, 3 или 4 (соответствует размеру страницы А1, А2, А3, А4)
343 + fontSize - int значение размера шрифта (в pt)
344 +
345 + **Пример использования:**
346 +
347 +{{code language="java"}}
348 + def param = [:]
349 + param.add("pageSize", 3)
350 + param.add("fontSize", 12)
351 +{{/code}}
352 +
353 + По умолчанию параметры принимают следующие значения:
354 + pageSize - 4
355 + fontSize - 8
356 +
357 +
358 +**Пример использования:**
359 +
360 +{{code language="java"}}
361 +def collisionList = bim.getCollisionsForReport()
362 + def param = [:]
363 + param.add("pageSize", 3)
364 + param.add("fontSize", 12)
365 + file.collisionsToPdf(template, collisionList, param)
366 +{{/code}}
367 +
368 +{{code language="java"}}
369 + def collisionList = bim.getCollisionsForReport()
370 + file.collisionsToPdf(collisionList)
371 +{{/code}}
372 +
373 +
374 +(% class="box infomessage" %)
375 +(((
376 +**{{id name="_Toc21"/}}attributesToPdf** - генерация pdf по списку атрибутов
377 +)))
378 +
379 +* **file.attributesToPdf(template, list, params)**
380 +
381 +(% class="box infomessage" %)
382 +(((
383 +**{{id name="_Toc30"/}}addAreaBreak** - добавление разрыва области PDF документа
384 +)))
385 +
386 +* **file.addAreaBreak() **
387 +
388 +**Пример использования:**
389 +
390 +{{code language="java"}}{{/code}}
391 +
392 +(% class="box infomessage" %)
393 +(((
394 +**{{id name="_Toc31"/}}addImage** - добавление изображения в документ Ms Word(DOCX) или PDF, ести тип файла другой, запись идет в поток
395 +)))
396 +
397 +* **file.addImage(byte[] imageFile) **
398 +
399 +**Пример использования:**
400 +
401 +{{code language="java"}}{{/code}}
402 +
403 +(% class="box infomessage" %)
404 +(((
405 +**{{id name="_Toc32"/}}addDrawing** - добавление чертежа в документ MS Word (DOCX) или PDF, метод принимает на вход массив байтов, содержащий чертеж и двумерный массив, содержащий координаты точек чертежа
406 +)))
407 +
408 +* **file.addDrawing(byte[] drawingPage, double[][] arr) **
409 +
410 +**Пример использования:**
411 +
412 +{{code language="java"}}{{/code}}
413 +
414 +(% class="box infomessage" %)
415 +(((
416 +**{{id name="_Toc22"/}}addCell** - создание ячейки в указанный столбец
417 +)))
418 +
419 +* **file.addCell(int indexColumn, int indexRow, Object value) ** - создание ячейки в указанный столбец и строку текущего листа таблицы Excel (XLSX, XLS) с указанным значением
420 +* **file.addCell(int indexColumn, Object value) ** - создание ячейки в указанный столбец в конец строки текущего листа таблицы Excel (XLSX, XLS) с указанным значением
421 +
422 +**Пример использования:**
423 +
424 +{{code language="java"}}{{/code}}
425 +
426 +(% class="box infomessage" %)
427 +(((
428 +**{{id name="_Toc23"/}}replaceRow** - замена значений указанной строки новыми значениями текущего листа таблицыи Excel (XLSX, XLS)
429 +)))
430 +
431 +* **file.replaceRow(int indexRow, Object... inp) **
432 +
433 +**Пример использования:**
434 +
435 +{{code language="java"}}{{/code}}
436 +
437 +(% class="box infomessage" %)
438 +(((
439 +**{{id name="_Toc24"/}}sortASC** - сортировка таблицы документа Excel (XLSX, XLS) в порядке возрастания по значению в указанном столбце
440 +)))
441 +
442 +* **file.sortASC(int indexColumn) **
443 +
444 +**Пример использования:**
445 +
446 +{{code language="java"}}{{/code}}
447 +
448 +(% class="box infomessage" %)
449 +(((
450 +**{{id name="_Toc25"/}}sortDESC** - сортировка таблицы документа Excel (XLSX, XLS) в порядке убывания по значению в указанном столбце
451 +)))
452 +
453 +* **file.sortDESC(int indexColumn) **
454 +
455 +**Пример использования:**
456 +
457 +{{code language="java"}}{{/code}}
458 +
459 +(% class="box infomessage" %)
460 +(((
461 +**{{id name="_Toc26"/}}saveTempTable** - сохранение значений из потока в таблицу Excel (XLSX, XLS), находящейся по указанному пути
462 +)))
463 +
464 +* **file.saveTempTable(String tablesTempLocation) **
465 +
466 +**Пример использования:**
467 +
468 +{{code language="java"}}{{/code}}
469 +
470 +(% class="box infomessage" %)
471 +(((
472 +**{{id name="_Toc27"/}}xlsxToJSON** - преобразование содержимого документа Excel (XLSX, XLS)
473 +)))
474 +
475 +* **file.xlsxToJSON(int page, int pageSize) ** - преобразование содержимого документа Excel (XLSX, XLS) с указанной страницы, с указанным количеством строк в формат JSON
476 +* **file.xlsxToJSON(String tablesTempLocation, int page, int pageSize) ** - преобразование содержимого документа Excel (XLSX, XLS), находящегося по указанному пути в формате JSON, с учетом указанной страницы и указанных количество строк
477 +
478 +**Пример использования:**
479 +
480 +{{code language="java"}}{{/code}}
481 +
482 +(% class="box infomessage" %)
483 +(((
484 +**{{id name="_Toc28"/}}getResource** - метод возвращает объект Ms Word (DOCX), PDF, текстовый файл (TXT) или Excel (XLSX, XLS)
485 +)))
486 +
487 +* **file.getResource() **
488 +
489 +**Пример использования:**
490 +
491 +{{code language="java"}}{{/code}}
492 +
493 +(% class="box infomessage" %)
494 +(((
495 +**{{id name="_Toc29"/}}makeGrandSmetaExelTable** - создание документа Excel (XLSX, XLS) для отчета о гранд-смете
496 +)))
497 +
498 +* **file.makeGrandSmetaExelTable() **
499 +
500 +**Пример использования:**
501 +
502 +{{code language="java"}}{{/code}}
503 +
296 296  **Наименование используемых строк row.get:**
297 297  
298 298