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

Last modified by Bimit Administrator on 02.10.2024, 11:55

From version 5.1
edited by Bimit Administrator
on 15.02.2022, 14:21
Change comment: There is no comment for this version
To version 11.1
edited by Bimit Administrator
on 18.07.2023, 10:11
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,27 +1,44 @@
1 1  Это интерфейс создания и заполнения файлов отчет/смет
2 2  В нем доступны следующий функции:
3 3  
4 -* [[create>>||anchor="Hcreate"]] - функция конструктор, создает и подготавливает файл для приема данных
5 -* [[addTitle>>||anchor="HaddTitle"]] - добавление заголовка в документ MS Word (DOCX)
6 -* [[addParagraph>>||anchor="HaddParagraph"]] - функция создания нового параграфа в документе MS Word (DOCX)
7 -* [[addCenterParagraph>>||anchor="HaddCenterParagraph"]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
8 -* [[addRightParagraph>>||anchor="HaddRightParagraph"]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
9 -* [[addLeftParagraph>>||anchor="HaddLeftParagraph"]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
10 -* [[addTextBreak>>||anchor="HaddTextBreak"]] - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
11 -* [[addText>>||anchor="HaddText"]] - функция добавления строки с данным в документ MS Word (DOCX)
12 -* [[addHeaderRow>>||anchor="HaddHeaderRow"]] - функция которая формирует заголовок на странице эксель файла
13 -* [[addRow>>||anchor="HaddRow"]] - функция которая формирует строку на странице эксель файла
14 -* [[getDocument>>||anchor="HgetDocument"]] - получение интерфейса текущего документа XWPFDocument (docx) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFDocument.html), предоставляет полный доступ к инструментарию формирования документа MSWord
15 -* [[getParagraph>>||anchor="HgetParagraph"]] - получение интерфейса текущего параграфа XWPFParagraph (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFParagraph.html) документа MSWord
16 -* [[getWorkbook>>||anchor="HgetWorkbook"]] - получение интерфейса текущего табличного документа Workbook (XSSFWorkbook для xlsx и HSSFWorkbook для xls) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Workbook.html), предоставляет полный доступ к инструментарию формирования документа таблицы эксель
17 -* [[getSheet>>||anchor="HgetSheet"]] - получение интерфейса текущей страницы с таблицей (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Sheet.html) документа таблицы эксель
4 +* [[create>>path:#_Toc1]] - функция конструктор, создает и подготавливает файл для приема данных
5 +* [[addTitle>>path:#_Toc2]] - добавление заголовка в документ MS Word (DOCX)
6 +* [[addParagraph>>path:#_Toc3]] - функция создания нового параграфа в документе MS Word (DOCX)
7 +* [[addCenterParagraph>>path:#_Toc4]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
8 +* [[addRightParagraph>>path:#_Toc5]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
9 +* [[addLeftParagraph>>path:#_Toc6]] - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
10 +* [[addTextBreak>>path:#_Toc7]] - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
11 +* [[addText>>path:#_Toc8]] - функция добавления строки с данным в документ MS Word (DOCX)
12 +* [[addHeaderRow>>path:#_Toc9]] - функция которая формирует заголовок на странице эксель файла
13 +* [[addRow>>path:#_Toc10]] - функция которая формирует строку на странице эксель файла
14 +* [[insertRow>>path:#_Toc15]] - функция которая вставляет строку на указанную позицию на странице эксель файла
15 +* [[replaceRow>>path:#_Toc16]] - функция которая замещает строку на указанной позицию на странице эксель файла
16 +* [[deleteRow>>path:#_Toc17]] - функция которая удаляет строку с указанной позиции на странице эксель файла
17 +* [[autoSizeColumns>>path:#_Toc18]] - функция установки автоматической ширины колонок страницы эксель файла
18 +* [[getDocument>>path:#_Toc11]] - получение интерфейса текущего документа XWPFDocument (docx) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFDocument.html), предоставляет полный доступ к инструментарию формирования документа MSWord
19 +* [[getParagraph>>path:#_Toc12]] - получение интерфейса текущего параграфа XWPFParagraph (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFParagraph.html) документа MSWord
20 +* [[getWorkbook>>path:#_Toc13]] - получение интерфейса текущего табличного документа Workbook (XSSFWorkbook для xlsx и HSSFWorkbook для xls) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Workbook.html), предоставляет полный доступ к инструментарию формирования документа таблицы эксель
21 +* [[getSheet>>path:#_Toc14]] - получение интерфейса текущей страницы с таблицей (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Sheet.html) документа таблицы эксель
18 18  
23 +**Генерация документа с использованием шаблона**
19 19  
25 +* [[templateToPdf>>path:#_Toc19]] - генерация pdf документа из шаблона
26 +
27 +**Генерация отчета по коллизиям и атрибутам**
28 +
29 +* [[collisionsToPdf>>path:#_Toc20]] - генерация pdf по списку коллизий
30 +* [[attributesToPdf>>path:#_Toc21]] - генерация pdf по списку атрибутов
31 +
32 +[[Примеры использования в плагинах>>Примеры использования в плагинах]]
33 +
34 +
20 20  (% class="box infomessage" %)
21 21  (((
22 -**create** - функция конструктор, создает и подготавливает файл для приема данных, доступны варианта: таблица эксель (XLS, XLSX), текстовый файл(TXT), документ MS Word (DOCX)
37 +**{{id name="_Toc1"/}}create** - функция конструктор, создает и подготавливает файл для приема данных, доступны варианта: таблица эксель (XLS, XLSX), текстовый файл(TXT), документ MS Word (DOCX), документ PDF (PDF)
23 23  )))
24 24  
40 +* file.create(формат создаваемого файла)
41 +
25 25  **Пример использования:**
26 26  
27 27  
... ... @@ -32,11 +32,11 @@
32 32  
33 33  (% class="box infomessage" %)
34 34  (((
35 -**addTitle** - добавление заголовка в документ MS Word (DOCX)
52 +**{{id name="_Toc2"/}}addTitle** - добавление заголовка в документ MS Word (DOCX)
36 36  )))
37 37  
38 -* с базовыми настройками
39 -* с указанием размера шрифта, и указанием жирный/простой
55 +* file.addTitle(Текст) - с базовыми настройками
56 +* file.addTitle(Текст, Размер шрифта, жирный/не жирный) - с указанием размера шрифта, и указанием жирный/простой
40 40  
41 41  **Примеры использования:**
42 42  
... ... @@ -51,11 +51,11 @@
51 51  
52 52  (% class="box infomessage" %)
53 53  (((
54 -**addParagraph** - функция создания нового параграфа в документе MS Word (DOCX)
71 +**{{id name="_Toc3"/}}addParagraph** - функция создания нового параграфа в документе MS Word (DOCX)
55 55  )))
56 56  
57 -* с базовыми настройками
58 -* с указанием отступа, размера шрифта, и указанием жирный/простой
74 +* addParagraph("Текст") - с базовыми настройками
75 +* addParagraph("Текст", размер отступа, размер шрифта, жирный/не жирный) - с указанием отступа, размера шрифта, и указанием жирный/простой
59 59  
60 60  **Примеры использования:**
61 61  
... ... @@ -72,13 +72,14 @@
72 72  
73 73  (% class="box infomessage" %)
74 74  (((
75 -**addCenterParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
92 +**{{id name="_Toc4"/}}addCenterParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста посередине и с указанием размера шрифта, и указанием жирный/простой
76 76  )))
77 77  
95 +* addCenterParagraph("текст", размер шрифта, жирный/не жирный)
96 +
78 78  **Пример использования:**
79 79  
80 80  
81 -
82 82  {{code language="java"}}
83 83  addCenterParagraph("Текст", 10, true)
84 84  {{/code}}
... ... @@ -86,9 +86,11 @@
86 86  
87 87  (% class="box infomessage" %)
88 88  (((
89 -**addRightParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
107 +**{{id name="_Toc5"/}}addRightParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста справа и с указанием размера шрифта, и указанием жирный/простой
90 90  )))
91 91  
110 +* addRightParagraph("текст", размер шрифта, жирный/не жирный)
111 +
92 92  **Пример использования:**
93 93  
94 94  
... ... @@ -99,9 +99,11 @@
99 99  
100 100  (% class="box infomessage" %)
101 101  (((
102 -**addLeftParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
122 +**{{id name="_Toc6"/}}addLeftParagraph** - функция создания нового параграфа в документе MS Word (DOCX) с размещением текста слева и с указанием размера шрифта, и указанием жирный/простой
103 103  )))
104 104  
125 +* addLeftParagraph("текст", размер шрифта, жирный/не жирный)
126 +
105 105  **Пример использования:**
106 106  
107 107  
... ... @@ -112,9 +112,11 @@
112 112  
113 113  (% class="box infomessage" %)
114 114  (((
115 -**addTextBreak** - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
137 +**{{id name="_Toc7"/}}addTextBreak** - функция перевода каретки указателя на новую строку в документе MS Word (DOCX)
116 116  )))
117 117  
140 +* file.addTextBreak()
141 +
118 118  **Пример использования:**
119 119  
120 120  
... ... @@ -125,11 +125,11 @@
125 125  
126 126  (% class="box infomessage" %)
127 127  (((
128 -**addText** - функция добавления строки с данным в документ MS Word (DOCX)
152 +**{{id name="_Toc8"/}}addText** - функция добавления строки с данным в документ MS Word (DOCX)
129 129  )))
130 130  
131 -* с указанием размера текста и указанием жирный/простой
132 -* с опциями (file.addText(“Строка, которая появится в файле”))
155 +* file.addText(“Строка, которая появится в файле”, размер шрифта, жирный/не жирный)
156 +* file.addText(“Строка, которая появится в файле”)
133 133  
134 134  **Примеры использования:**
135 135  
... ... @@ -144,9 +144,11 @@
144 144  
145 145  (% class="box infomessage" %)
146 146  (((
147 -**addHeaderRow **- функция которая формирует заголовок на странице эксель файла (пример: file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”))
171 +**{{id name="_Toc9"/}}addHeaderRow **- функция которая формирует заголовок на странице эксель файла
148 148  )))
149 149  
174 +* file.addHeaderRow(“Заголовок 1”, “Заголовок 2”,....”Заголовок N”)
175 +
150 150  **Пример использования:**
151 151  
152 152  
... ... @@ -157,9 +157,11 @@
157 157  
158 158  (% class="box infomessage" %)
159 159  (((
160 -**addRow** - функция которая формирует строку на странице эксель файла (пример: file.addRow(“Данные 1”, “Данные 2”,....”Данные N”))
186 +**{{id name="_Toc10"/}}addRow** - функция которая формирует строку на странице эксель файла
161 161  )))
162 162  
189 +* file.addRow(“Данные 1”, “Данные 2”,....”Данные N”)
190 +
163 163  **Пример использования:**
164 164  
165 165  
... ... @@ -170,24 +170,81 @@
170 170  
171 171  (% class="box infomessage" %)
172 172  (((
173 -**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/)]]
201 +**{{id name="_Toc15"/}}insertRow** - функция которая вставляет строку на указанную позицию на странице эксель файла
174 174  )))
175 175  
204 +* file.insertRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)
205 +
206 +**Пример использования:**
207 +
208 +{{code language="java"}}
209 +file.insertRow(6, "Вставленная строка", 1 , 2.453, new Date(), Calendar.getInstance());
210 +{{/code}}
211 +
212 +
176 176  (% class="box infomessage" %)
177 177  (((
178 -**getParagraph** - получение интерфейса текущего параграфа XWPFParagraph (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFParagraph.html) документа MSWord  (полную документацию см. [[https:~~/~~/poi.apache.org/apidocs/4.1/)>>https://poi.apache.org/apidocs/4.1/)]]
215 +**{{id name="_Toc16"/}}replaceRow** - функция которая замещает строку на указанной позицию на странице эксель файла
179 179  )))
180 180  
218 +* file.replaceRow(индекс, “Данные 1”, “Данные 2”,....”Данные N”)
219 +
220 +**Пример использования:**
221 +
222 +{{code language="java"}}
223 +file.replaceRow(7, "Замещенная строка", 4 , 5.678, new Date(), Calendar.getInstance());
224 +{{/code}}
225 +
226 +
181 181  (% class="box infomessage" %)
182 182  (((
183 -**getWorkbook** - получение интерфейса текущего табличного документа Workbook (XSSFWorkbook для xlsx и HSSFWorkbook для xls) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Workbook.html), предоставляет полный доступ к инструментарию формирования документа таблицы эксель (полную документацию см. https:~/~/poi.apache.org/apidocs/4.1/)
229 +**{{id name="_Toc17"/}}deleteRow** - функция которая удаляет строку с указанной позиции на странице эксель файла
184 184  )))
185 185  
232 +* file.deleteRow(индекс)
233 +
234 +**Пример использования:**
235 +
236 +{{code language="java"}}
237 +file.deleteRow(3);
238 +{{/code}}
239 +
240 +
186 186  (% class="box infomessage" %)
187 187  (((
188 -**getSheet** - получение интерфейса текущей страницы с таблицей (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Sheet.html) документа таблицы эксель (полную документацию см. https:~/~/poi.apache.org/apidocs/4.1/)
243 +**{{id name="_Toc18"/}}autoSizeColumns** - функция установки автоматической ширины колонок страницы эксель файла
189 189  )))
190 190  
246 +* file.autoSizeColumns() - для всех колонок на странице
247 +* file.autoSizeColumns(индекс колонки) - для конкретной колонки на странице
248 +
249 +**Пример использования:**
250 +
251 +{{code language="java"}}
252 +file.autoSizeColumns()
253 +{{/code}}
254 +
255 +
256 +(% class="box infomessage" %)
257 +(((
258 +**{{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/)]]
259 +)))
260 +
261 +(% class="box infomessage" %)
262 +(((
263 +**{{id name="_Toc12"/}}getParagraph** - получение интерфейса текущего параграфа XWPFParagraph (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/xwpf/usermodel/XWPFParagraph.html) документа MSWord  (полную документацию см. [[https:~~/~~/poi.apache.org/apidocs/4.1/)>>https://poi.apache.org/apidocs/4.1/)]]
264 +)))
265 +
266 +(% class="box infomessage" %)
267 +(((
268 +**{{id name="_Toc13"/}}getWorkbook** - получение интерфейса текущего табличного документа Workbook (XSSFWorkbook для xlsx и HSSFWorkbook для xls) (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Workbook.html), предоставляет полный доступ к инструментарию формирования документа таблицы эксель (полную документацию см. https:~/~/poi.apache.org/apidocs/4.1/)
269 +)))
270 +
271 +(% class="box infomessage" %)
272 +(((
273 +**{{id name="_Toc14"/}}getSheet** - получение интерфейса текущей страницы с таблицей (https:~/~/poi.apache.org/apidocs/4.1/org/apache/poi/ss/usermodel/Sheet.html) документа таблицы эксель (полную документацию см. https:~/~/poi.apache.org/apidocs/4.1/)
274 +)))
275 +
191 191  **Общий пример:**
192 192  
193 193  {{code language="java"}}
... ... @@ -207,6 +207,66 @@
207 207  {{/code}}
208 208  
209 209  
295 +(% class="box infomessage" %)
296 +(((
297 +**{{id name="_Toc19"/}}templateToPdf** - генерация пдф документа из шаблона
298 +)))
299 +
300 +* [[template>>doc:API.Плагин API.template.WebHome]].add(“название тега в шаблоне”, переменная из плагина)
301 +* file.templateToPdf(template)
302 +
303 +**Пример использования:**
304 +
305 +{{code language="java"}}
306 +def project = bim.getProject()
307 +template.add("project", project)
308 +file.templateToPdf(template)
309 +{{/code}}
310 +
311 +
312 +(% class="box infomessage" %)
313 +(((
314 +**{{id name="_Toc20"/}}collisionsToPdf** - генерация пдф по списку коллизий
315 +)))
316 +
317 +* file.collisionsToPdf(template, list, params):
318 +* template - необязательный параметр (указывается в том случае, если таблицу коллизий необходимо добавить в конец какого-либо шаблона). Если не указывать, то создается новый пустой файл, в который заносится таблица коллизий
319 +* 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]]
320 +* params - необязательный параметр (описание ниже)
321 +
322 + Параметры при генерации отчета по коллизиям:
323 + pageSize - 1, 2, 3 или 4 (соответствует размеру страницы А1, А2, А3, А4)
324 + fontSize - int значение размера шрифта (в pt)
325 +
326 + **Пример использования:**
327 +
328 +{{code language="java"}}
329 + def param = [:]
330 + param.add("pageSize", 3)
331 + param.add("fontSize", 12)
332 +{{/code}}
333 +
334 + По умолчанию параметры принимают следующие значения:
335 + pageSize - 4
336 + fontSize - 8
337 +
338 +
339 +**Пример использования:**
340 +
341 +{{code language="java"}}
342 +def collisionList = bim.getCollisionsForReport()
343 + def param = [:]
344 + param.add("pageSize", 3)
345 + param.add("fontSize", 12)
346 + file.collisionsToPdf(template, collisionList, param)
347 +{{/code}}
348 +
349 +{{code language="java"}}
350 + def collisionList = bim.getCollisionsForReport()
351 + file.collisionsToPdf(collisionList)
352 +{{/code}}
353 +
354 +
210 210  **Наименование используемых строк row.get:**
211 211  
212 212  
... ... @@ -240,6 +240,7 @@
240 240  (% style="line-height:1.2" %)
241 241  (% style="background-color:#ffffff; color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Единицы измерений
242 242  )))
388 +|(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)unit|(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)Единица измерения
243 243  |(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)(((
244 244  (% style="line-height:1.2" %)
245 245  (% style="background-color:#ffffff; color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)quantityPerUnit
... ... @@ -254,6 +254,7 @@
254 254  (% style="line-height:1.2" %)
255 255  (% style="background-color:#ffffff; color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)Количество всего
256 256  )))
403 +|(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)quantity|(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)Количество
257 257  |(% style="border-bottom:1px solid #000000; border-left:1px solid #000000; border-right:1px solid #000000; border-top:1px solid #000000; padding:7px 7px 7px 7px; vertical-align:top" width="NaN" %)(((
258 258  (% style="line-height:1.2" %)
259 259  (% style="background-color:#ffffff; color:#000000; font-family:Arial; font-size:11pt; font-style:normal; font-variant:normal; font-weight:400; overflow-wrap:break-word; overflow:hidden; text-decoration:none; white-space:pre-wrap" %)priceAll