# OneNote Sections
Adds sections to a OneNote notebook in a SharePoint document library by processing rows from an Excel file.
Filename pattern: filename must contain OneNoteSections (case-insensitive).
Example: 20240115 OneNoteSections setup.xlsx
# Columns
| Name | Required | Description |
|---|---|---|
| ClientCode | No | Client code used together with MatterCode to identify the matter. |
| MatterCode | Conditional | Matter code used to resolve the matter site. Required when Url is not provided. When used, the handler targets the SiteAssets library of the matter site. |
| Url | Conditional | Server-relative URL of the document library containing the OneNote notebook. Required when MatterCode is not provided. |
| SiteSet / siteset | Conditional | Name of a SiteCfg configuration entry. When provided, the sections to add are read from SiteCfg.OneNoteSections. Required when Section is not provided. |
| Section / Sections | Conditional | Comma-separated list of section names to add to the notebook. Required when SiteSet is not provided. |
Either Url or MatterCode must be provided. Either SiteSet or Section / Sections must be provided.
# Behavior
When SiteSet is provided, the handler looks up the named SiteCfg and reads section names from its OneNoteSections list. Inline Section / Sections values override or supplement this when SiteSet does not define sections.
When MatterCode is used (without Url): the handler targets the SiteAssets library at the root of the matter site.
When Url is provided: the handler targets that library directly.
Additional columns (other than url, siteurl, siteset) are collected as properties and passed as template substitution tokens to the SiteCfg.
# Related links
- Add One Note handler — add a OneNote notebook to a document library
- Report One Note handler — report on existing OneNote notebooks