smartyellow/docx-js
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Expanded documentation on the formulas a bit

Browse Source
This commit is contained in:
Paul de Groot
2021-05-05 15:11:11 +02:00
parent 79c1db9c91
commit a9e4c88804
1 changed files with 28 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/usage/fields.md
View File

@ -9,8 +9,8 @@ There are very complicated fields like the table of contents, but in many cases
Word uses field codes to identify what the result of the field should be. You can find these field codes by adding a field in a document (`Insert -> Quick Parts -> Field...`) and clicking the 'Field codes'-button. Some examples include: Word uses field codes to identify what the result of the field should be. You can find these field codes by adding a field in a document (`Insert -> Quick Parts -> Field...`) and clicking the 'Field codes'-button. Some examples include:
Field type | Example | Description Field type | Example | Description
----------- | ---------------- | --------------------------------------------------------- ----------- | --------------- | ---------------------------------------------------------
= (Formula) | `=2 * 21` | Calculates the result of a formula. You can also use bookmarks as variables. = (Formula) | `=2*21` | Calculates the result of a formula. You can also use bookmarks as variables, see below.
Author | `AUTHOR` | Includes the author mentioned in the document properties. Author | `AUTHOR` | Includes the author mentioned in the document properties.
CreateDate | `CREATEDATE` | Date the document was created. CreateDate | `CREATEDATE` | Date the document was created.
Date | `DATE` | Today's date. Date | `DATE` | Today's date.
@ -35,7 +35,24 @@ const paragraph = new Paragraph({
}); });
``` ```
## Mail merge fields ### Formulas
One type of field is the formula that can be used to do some basic calculations. This can be done with static values, e.g. `12 + 34`, but a value from a bookmark can also be used in a calculation. This can be seen in the following example:
```ts
const paragraph = new Paragraph({
children: [
new TextRun("Value one is: "),
new Bookmark({ id: "One", children: [new TextRun("451")]}),
new TextRun(". The second value is: "),
new Bookmark({ id: "Two", children: [new TextRun("886")]}),
new TextRun(". The sum of these values is: "),
new SimpleField("=One+Two"),
],
});
```
### Mail merge fields
Fields are often used in a mail merge where a template document is created and data from another source (Excel or a database) is inserted in the document. Fields are often used in a mail merge where a template document is created and data from another source (Excel or a database) is inserted in the document.