Clarification regarding ActionItemType for OneNote 2010 format

AlexeiSo 81 Reputation points
2021-08-30T14:06:02.673+00:00

Hello!

By MS-ONE every note tag has a property ActionItemType(paragraph 2.3.85).
It is described as "an ActionItemType element (section 2.3.85) that specifies the identity of the note tag".
We cannot understand what does it mean...

For tasks tags the meaning of ActionItemType is clear:
But for normal tags it is just stated that the value must be from 0 till 99 and it means "a numeric identifier of the note tag."

I investigated our sample documents and found:

  1. There are two documents having a tag with 'Home' icon but with different ActionItemType from document to document: 7 in one of them and 8 in another one. That is ActionItemType is the same across the document but is different from document to document.
  2. There is a document having a few tags with 'BlueCheckBox' but with different ActionItemType: some have value of 0 but others have value of 99. That is ActionItemType is not the same across the document.

So it would be great to get clarification regarding the questions below:

  1. What does this property mean regarding normal tags?
  2. If we read a OneNote document with a tag and store this document without preserving tag's ActionItemType then what consequences can happen?
  3. Let's suppose we generate a new document with a normal tag. How we should choose a value for tag's ActionItemType?

Thanks!

Sincerely, Alexei.

Office Open Specifications
Office Open Specifications
Office: A suite of Microsoft productivity software that supports common business tasks, including word processing, email, presentations, and data management and analysis.Open Specifications: Technical documents for protocols, computer languages, standards support, and data portability. The goal with Open Specifications is to help developers open new opportunities to interoperate with Windows, SQL, Office, and SharePoint.
126 questions
{count} votes

Accepted answer
  1. Tom Jebo 1,991 Reputation points Microsoft Employee
    2021-09-03T18:56:28.443+00:00

    Hi Alexei,
    Here are my answers inline:

    What does this property mean regarding normal tags?

    • The 0-99 are considered custom ActionItemTypes used by OneNote when you create a new tag. They are assigned in a document but not unique or consistent between documents.

    If we read a OneNote document with a tag a store this document without preserving tag's ActionItemType then what consequences can happen?

    • If it’s already set, you should preserve it.

    Let's suppose we generate a new document with a normal tag. How we should choose a value for tag's ActionItemType?

    • The choice of custom AIT's is arbitrary and the only requirement is that they be unique at the paragraph level, i.e. don't use the same one more than once on a given paragraph.

    I hope this help guide your implementation.

    Tom


0 additional answers

Sort by: Most helpful