tdrpa.tdworker

数字员工的命令工具包


写入行

<p>[TOC]</p> <h2>1.命令说明</h2> <p>从工作表中指定单元格开始向右写入数据</p> <h2>2.命令原型</h2> <pre><code>Excel.WriteRow(excelWorkBook, sheet=&amp;quot;Sheet1&amp;quot;, cell=&amp;quot;A1&amp;quot;, data=[1, &amp;quot;a&amp;quot;, 2, &amp;quot;b&amp;quot;, 3, &amp;quot;c&amp;quot;], strictlyWrite=True, isSave=False)</code></pre> <h2>3.命令参数</h2> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th style="text-align: left;">默认值</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">excelWorkBook</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Book</td> <td style="text-align: left;">无</td> <td>使用 &quot;打开Excel工作簿&quot;命令(Excel.OpenExcel) 或 &quot;绑定Excel工作簿&quot; 命令(Excel.BindBook)返回的工作簿对象</td> </tr> <tr> <td style="text-align: left;">sheet</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string/int</td> <td style="text-align: left;">&quot;Sheet1&quot;</td> <td>如果使用字符串,则表示指定工作表的名字;使用数字,则表示指定工作表的顺序(例如:0、1、2代表从左边开始正数第1、2、3个工作表;-1、-2、-3代表从右边开始倒数第1、2、3个工作表)。默认 &quot;Sheet1&quot;</td> </tr> <tr> <td style="text-align: left;">cell</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string/list</td> <td style="text-align: left;">&quot;A1&quot;</td> <td>指定的单元格,支持单元格名如&quot;A1&quot;与行列列表如[行号, 列号]两种格式,当使用单元格名时不区分大小写。默认&quot;A1&quot;</td> </tr> <tr> <td style="text-align: left;">data</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string/list</td> <td style="text-align: left;">[1, &quot;a&quot;, 2, &quot;b&quot;, 3, &quot;c&quot;]</td> <td>要写入的数据,支持写入公式。默认[1, &quot;a&quot;, 2, &quot;b&quot;, 3, &quot;c&quot;]</td> </tr> <tr> <td style="text-align: left;">strictlyWrite</td> <td style="text-align: left;">否</td> <td style="text-align: left;">bool</td> <td style="text-align: left;">True</td> <td>是否严格的写入标准。选True时,只能写入一行单元格数据,选False时,可写入多行多列的数据(此时的功能则与Excel.WriteRange类似)。默认True</td> </tr> <tr> <td style="text-align: left;">isSave</td> <td style="text-align: left;">否</td> <td style="text-align: left;">bool</td> <td style="text-align: left;">False</td> <td>操作完成立即保存。默认False</td> </tr> </tbody> </table> <h2>4.返回结果</h2> <p>无(None值)</p> <h2>5.运行实例</h2> <pre><code>&amp;quot;&amp;quot;&amp;quot; /*******************写入行******************* 入参: excelWorkBook:[必选参数]使用 &amp;quot;打开Excel工作簿&amp;quot;命令(Excel.OpenExcel) 或 &amp;quot;绑定Excel工作簿&amp;quot; 命令(Excel.BindBook)返回的工作簿对象 sheet:[可选参数]如果使用字符串,则表示指定工作表的名字;使用数字,则表示指定工作表的顺序(例如:0、1、2代表从左边开始正数第1、2、3个工作表;-1、-2、-3代表从右边开始倒数第1、2、3个工作表)。默认&amp;quot;Sheet1&amp;quot; cell:[可选参数]指定的单元格,支持单元格名如&amp;quot;A1&amp;quot;与行列列表如[行号, 列号]两种格式,当使用单元格名时不区分大小写。默认&amp;quot;A1&amp;quot; data:[可选参数]要写入的数据,支持写入公式。默认[1, &amp;quot;a&amp;quot;, 2, &amp;quot;b&amp;quot;, 3, &amp;quot;c&amp;quot;] strictlyWrite:[可选参数]是否严格的写入标准。选True时,只能写入一行单元格数据,选False时,可写入多行多列的数据(此时的功能则与Excel.WriteRange类似)。默认True isSave:[可选参数]操作完成立即保存。默认False 出参: 无 注意事项: 该命令不能单独使用,需配合 &amp;quot;打开Excel&amp;quot;命令(Excel.OpenExcel) 或&amp;quot;绑定Excel&amp;quot;命令(Excel.BindBook)一起使用才能正常使用,单独使用则会报错。 ************************************************/ &amp;quot;&amp;quot;&amp;quot; # 打开D:\1.xlsx excelWorkBook = Excel.OpenExcel(r'D:\1.xlsx', visible=True, appType=&amp;quot;Excel&amp;quot;, pwd=&amp;quot;&amp;quot;, writePwd=&amp;quot;&amp;quot;) # 在Excel对象Sheet1工作表的A1单元格向右写入1行(6个单元格)数据,且保存文档(严格写入标准) Excel.WriteRow(excelWorkBook, sheet=&amp;quot;Sheet1&amp;quot;, cell=&amp;quot;A1&amp;quot;, data=[1, &amp;quot;a&amp;quot;, 2, &amp;quot;b&amp;quot;, 3, &amp;quot;c&amp;quot;], strictlyWrite=True, isSave=True) # 在Excel对象Sheet1工作表的A2单元格开始,向右下写入2行4列(8个单元格)数据,类似Excel.WriteRange命令。不建议非严格写入标准,缺点:后期维护时,业务操作行为的可读性容易混淆) Excel.WriteRow(excelWorkBook, sheet=&amp;quot;Sheet1&amp;quot;, cell=&amp;quot;A2&amp;quot;, data=[['a', 'b', 'c', 'd'], ['e', 'f', 'g', 'h']], strictlyWrite=False, isSave=False)</code></pre>

页面列表

ITEM_HTML