Documentation Tool problems with Document export

I’m a new H5P user just getting started with the Documentation Tool, and am encountering what look like a couple of bugs. I’m seeing these problems when creating interactions on h5p.org, and with the WordPress plugin, and with the Moodle plugin. Anyone should be able to verify these behaviors by using the interaction at https://h5p.org/node/206392, or by creating their own Documentation Tool interaction.

I’ve attached images to show the problems. DocToolBug_image1.png shows a display problem with the Standard Page: Special characters like apostrophes aren't rendered properly in placeholder text of Standard Page text entry screen.

DocToolBug_image2.png shows the source for a problem that is evident in Image 3 and Image 4: After entering Goals on a Goals Page, all of those show up in the proper order on the Goals Assessment Page, and are available to rate. The Goals Assessment Page does not report any errors when a user declines to enter a rating for that entry. (Personally, I don’t see a problem with that, for my intended usage of the Documentation Tool.) In my example, I rated my first Goal entry as “learned a lot”, my fourth Goal entry as “learned something” and my fifth Goal entry as “learned little.” I chose not to rate my second, third, and sixth Goal entries.

DocToolBug_image3.png shows the problem: On the Documentation Export Page, only Goal entries to which I've assigned ratings will appear. The order of presentation is “Learned little” first, “Learned something” second, and “Learned a lot” last. Unless I'm misunderstanding the intended use of the Documentation Tool, the omission of Goals entries that have not been assigned a rating seems like a bug. (If for some reason that's actually the intended behavior, it might be a good idea to clarify that in the editing screens.)

DocToolBug_image4.png: Likewise, in the version that is downloaded as a Word document (.docx) extension when “Export text” is clicked, only the Goal entries to which I’ve assigned ratings are displayed (my first, fourth, and fifth entries). As an additional point of confusion, the order of presentation is reversed from the screen’s display: for the downloaded file, “Learned a lot” entries appear first, then “Learned something” entries, and finally “Learned little” entries. This seems to me to be the preferable order for pedagogical purposes.

As someone whose goal is to create learning interactions that encourage thoughtful open-ended responses, the Documentation Tool seems to hold a lot of promise. I’m very happy to read on Falcon’s recent update (https://h5p.org/feb-2018-status-update) that improving it is a current priority. Likewise, I’m happy to see that the Interactive Video interaction will soon have capabilities both for saving open-ended answers, and for providing an “end screen” where all a user’s responses on an Interactive Video activity will be displayed. I see that all these improvements were anticipated for “late February or early March” and am hoping the dev teams are just about ready to roll them out.

I’d also like to mention that some ideas for the Documentation Tool that were discussed in another thread about a year ago (https://h5p.org/node/49815) also look very good to me. I’d love to see the capability for asking users to set goals for themselves before completing an activity, then assessing afterward how well they did in achieving those goals. For this and related purposes, I think it'd be great for the Documentation Tool to save responses to the user's record, in addition to writing them into a file as is currently possible.

Thanks to the dev team for all you're doing, and to the entire H5P community for working together toward the ongoing improvement of this great learning content tool!

Jim

Content types: 
BV52's picture

Hi Jim,

Welcome to H5P!

Thank you for the well written review/report it helps a lot :-)

I'll try to answer these one by one.

  1. Apostrophe issue - Filed a bug report here.
  2. Goals not exported - This is a known issue and I have reported this here.
  3. Order of the report and doc - Filed a bug report here.
  4. For the updates I'll get back to you on this. I'll ask feedback from the Core team.

Furthermore thanks a lot for contributing your ideas on how to make H5P better! We’re now working on something called the H5P supporter program allowing the H5P community to vote for and fund the top voted H5P features. Also there are developers in the community who every now and then works on a feature they find interesting or useful.

Thank you for the kind words we really appreciate it :-)

-BV52

 

BV52's picture

Hi Jim,

Just a few updates:

3. should be resolved now.

4. We are still testing both features and we should be able to release them next month. In terms of re-doing everything you actually don't have to. You would just need to insert the new feature wherever in the video it is needed. We make sure that all updates are backward compatible and can be used immediately as to not affect contents that were made prior to the update.

-BV52

Hello,

I love the idea behind the documentation tool as it enables students to work on their authentic problems. So far it works well. I just discovered one issue: the "export" function doesn't generate a usable pdf or docx-file. I can see the text to export in the window (and copy & paste it from there). When clicking on export a zip-file is generated. UNpacking this results in several folders with xml-files and other stuff. But no usable file with the actual content.

I attached screenshots anmd the h5p file for your understanding.

Thanks for your support!

H5P file: 
BV52's picture

Hi wiebkewetzel,

I'm not sure where the problem is coming from but let me help you isolate the issue. I uploaded your content here and I was able to download a docx file. If you can download a docx file then I would assume it is some settings in your site, if it is the same thing then it might be the browser that you are using.

-BV 

HI BV,

thanks so much for your support! I forgot to test the browser before posting this. I can indeed download a docx file from my site and your link when using Safari, but not when using Firefox. Since Firefox is no uncommon browser I am wondering if this has not been reported before.

Could it be a setting in Firefox? I am using the latest version for Mac (8.4.0.2) and have set it to block dangerous and deceptive content as well as dangerous downloads.  But a normal docx-file should not be classified as dangerous.

- Wiebke 

BV52's picture

Hi Wiebke,

I just tried it in FF and I was able to download it in docx. We have the same settings in Firefox but then again I am using Windows so there is a possibility that the 2 may not behave the same way 100% of the time. If anyone have other suggestions feel free to post your commnents.

-BV

otacke's picture

Hi BV!

I am running Firefox on Linux and on H5P.com it suggests zip, too. Might be some server-side MIME type configuration that's not optimal (Firefox can be strict), might be a bug in Firefox. Workaround: Since docx files in fact are zip files, you can simply change the file's extension from .zip to .docx.

One more thing that suggests it might be a server side issue: Using Firefox on Linux, when you download H5P files, Firefox also suggests zip. I assume Firefox requires the value "application/x-h5p" as HTTP content type header.

Best,
Oliver

BV52's picture

Hi Oliver,

I'll invetigate this further and report it to the H5P core team if needed.

-BV

I have the same Firefox issue on Win10.  I can't ask all my students to change .zip into .docx (well I can but it seems not very user friendly)  is there any new development planned ?

BV52's picture

Hi Michael,

No plans yet. I have reached out to the H5P core team and I should have a clearer answer before the end of the week.

-BV

Hello,

I have experienced the same issue (export to .zip instead of .docx). After reading your posts, I have run a test on three different browsers and it appears that the problem only occured in Firefox. By using the tool in Edge and Chrome, I came up with a .docx file when clicking the Export button ; and I had no problem to open that file in Word afterwards.

Thanks you for the help !

BV52's picture

Hi All,

Bug report has been filed. To help the H5P core team isolate the issue please provide the OS version and Firefox versions.

-BV

otacke's picture

Hi BV!

For me, it's Ubuntu 20.04.1 LTS with Firefox 84.0.2. (not 85 yet).

Cheers,
Oliver

BV52's picture

Thanks! I've updated the ticket.

For me, it's Windows 10 and Firefox 85.0.

eGBO

BV52's picture

Thanks eGBO!

For me its Mac OS 10.15.7 and Firefox 8.5.0

BV52's picture

Thanks wiebkewetzel! I assume it's 85.0 not 8.5.0?

-BV

Sure 85.0. Too many dots in the rythm of typing.

BV52's picture

Thanks! 

Hi, I'm using the Documentation Tool in Wordpress. I've followed all instructions re setting up text input boxes etc. within my content and have placed an export page at the end with the purpose of collating all text input within the project. However, contrary to the images in the guidance, each page remains separate and doesn't show a line linking the various aspects of the tool. 

BV52's picture

Hi Warren,

In the screenshot you provided you are creating the Documentation Tool inside Interactive Book. I suggest that for the time being create a stand alone Documentation Tool so that you will get used to its interface to avoid confusion.

-BV 

Hi - TY for your swift response, much appreciated. The document tool is embedded in a much bigger course in interactive book. The text boxes are positioned in various places on different pages. As a workaround, I have decided to add several export pages so users only download one reflection at a time (instead of all of the reflections at the end of the course). It's not ideal but can still do the job if the document tool doesn't collate into one file at the end. 

Does anyone know whether it is possible to export text in readable form via iPhone? Initial tries have resulted in chasing a zipped file that I'm unable to extract from.