Feedback Aide natively understands HTML and plain text input. However, we know that a lot of learner content is created in the DOCX format and so we have created a DOCX to HTML conversion utility available via the RESTful API endpoints.
Conversion capabilities
The conversion is optimised for extracting the core content and ignores extraneous content that is not used or relevant to Feedback Aide.
Supported features
- Headings
- Paragraphs
- Lists
- Tables including nested tables
- Bold, Italic, Underline, Superscript, Subscript
- Images (currently not enabled)
- Links (currently not enabled)
Known limitations
The following limitations are by design at this point as the focus is on the core content useful for Feedback Aide
- Styling
- Tables with merged cells are not supported
- Charts are not supported
- Comments and tracked changes
-
Footnotes are not supported
-
Header and footer content is ignored
Prerequisites
In addition to some developer skills, you'll need the following:
- An OAuth key and secret to generate a security token. See Feedback Aide Security Tokens.
- Familiarity with how the Advanced - Feedback Aide RESTful Mode works
Usage
With a valid security token - upload a valid docx file to the /api/docx_to_html endpoint.
It will return a HTML representation of this - which you can then use in as the response parameter in Getting Started with Feedback Aide API