198 Lotus blogs updated hourly. Who will post next? Home | Blogs | Search | About 
 
Latest 7 Posts
Generating and Downloading Files Using XPages’ Persistence Service
Wed, Sep 13th 2017 99
Bundle Inspector – Diagnosing XPages Plugin Resolution problems
Wed, Aug 2nd 2017 2
Swiper Official Version 2 Release
Fri, Jul 21st 2017 3
Auto-width Bootstrap Column XPages Controls
Tue, Mar 21st 2017 3
Swiper FP8 Version Beta Release
Thu, Mar 16th 2017 3
Swiper FP8 Integration Rollout
Wed, Mar 8th 2017 3
Markdown XPages UIControl
Sun, Mar 5th 2017 7
Top 10
Generating and Downloading Files Using XPages’ Persistence Service
Wed, Sep 13th 2017 99
Preventing Pasting of Images in CKEditor
Mon, Nov 14th 2016 12
Pasting Images into XPages CKEditor
Sun, Feb 12th 2017 12
Webmail UI – You must learn about MIME
Wed, Apr 20th 2016 8
Build Automation for XPages Presentation Slides - AUSLUG/Inform 2015
Thu, Jun 11th 2015 7
Tips for Creating a Webmail UI with XPages
Tue, Apr 19th 2016 7
Preventing pasting of remotely hosted images in CKEditor
Mon, Nov 14th 2016 7
Markdown XPages UIControl
Sun, Mar 5th 2017 7
Controlling the order of Script Resources (e.g. Jquery) with a Custom ViewRootRenderer
Mon, Sep 19th 2016 6
XPages webmail – Using Mime Inspector to debug Mime
Tue, Feb 14th 2017 6


XPages webmail – Using Mime Inspector to debug Mime
Twitter Google+ Facebook LinkedIn Addthis Email Gmail Flipboard Reddit Tumblr WhatsApp StumbleUpon Yammer Evernote Delicious
camerongregor    

In a previous post in this series I did a bit of an overview on how MIME works. We also did a little bit about how MIME works in XPages + Domino land. With this knowledge in hand we can now start to analyse the different ways a ‘Pretty words, pictures and attachments’ can be stored in the document.

During development of the ‘XPages Webmail’ interface, I encountered many problems which could only be solved by investigating the MIME content in detail.

To help me do this, I developed a simple control (Mime Inspector) that I could use during debugging, which allowed me to see details of Mime Entities and the relation between them.

Overview

To use the MIME Inspector, I just bind it to a “rich text/Mime” field, and then view the output in the XPage. There are 2 control properties that can be control the level of detail

  • showHeaders – will output the MimeHeader entries of each MimeEntity
  • showContent – will output the actual content of each MimeEntity

The output starts with a summary of the status of the DominoRichTextItem (which is a wrapper for the RichTextItem. This is less useful but can still be helpful to know in some situations.

  • Are there Embedded Images that have not been saved yet
  • are there attachments that are not saved yet
  • is the wrapped field a MIME field (or otherwise still rich text)
  • Is the backend item discarded

Then the control will output the visual representation of the Mime Structure.

It does this in a ‘Nested List’ of MIMEEntities so that you can see sibling / parent / child relationship (which is very important when debugging MIME problems)

Each Mime Entity will output:

  • content type e.g. text/html
  • encoding details
  • mime headers (if set to do so with showHeaders)
  • content (if set to do so with showContent)

Demonstration Video

Here is as short demonstration video of the control in action

Installation / usage

You can either install the GregorbyteXspLibrary and use from that, or you can rip out the necessary files and use within an NSF

To do it via installing the library:

  • Download the GregorbyteXspLibrary from the project’s github releases page
  • Install the library to your Domino Designer (same method as IBM ExtLib)
  • Install the library to your Domino Server (same method as IBM ExtLib)
  • Enable the library in your NSF (Xsp Properties page, ‘Page Generation’ section choose ‘com.gregorbyte.xsp.library’
  • Drag the ‘Mime Inspector’ onto your page

To do it the ‘non-library’ way:

  • Copy the MimeUtil class and paste it in your java elements section (you will need to removeh/comment out all statements referencing the GregorbyteLogger
  • Copy the UIMimeInspector class and paste it in your java elements section
  • Copy the gregorbyte-mimeinspector.xsp-config file and put it in your WebContentWEB-INF directory in your NSF
  • There is no renderer because the control renders itself, so no need for renderer or faces-conig.xml entries

Here is an example of the code in the XPages Markup:

<gb:mimeInspector id="mimeInspector1" value="#{document1.Body}" 
		showHeaders="true" 
		showContent="true"></gb:mimeInspector>

Here is an example of some output with ‘showHeaders’ and ‘showContent’. In this example the mime being looked at is just a single text/html MimeEntity.

Let me know if you have any trouble, I hope this helps somebody!



---------------------
http://camerongregor.com/2017/02/14/xpages-webmail-using-mime-inspector-to-debug-mime/
Feb 14, 2017
7 hits



Recent Blog Posts
99
Generating and Downloading Files Using XPages’ Persistence Service
Wed, Sep 13th 2017 4:42p   Cameron Gregor
When developing an XPages application you may run into the need to generate files to be downloaded by the user. For example: Generating a PDF Report Exporting Data to Excel Spreadsheet Creating a Zip File of several attachments Achieving these tasks usually raises 2 main problems to solve; What temporary place can I use to generate the files? How do I allow the user to download the generated files? For the temporary place problem, some common solution is to either generate the files to some
2
Bundle Inspector – Diagnosing XPages Plugin Resolution problems
Wed, Aug 2nd 2017 12:26p   Cameron Gregor
A common task with XPages development is to installing some plugins that provide additional functionality. If you do any plugin development of your own, you end up doing this task a lot more as you create new plugins, install new versions etc. It is also common to encounter some problems after installing plugins to your Domino Server! Maybe your expected plugin doesn’t load up at all? maybe the wrong version is loading? The standard method of diagnosing these problems is to use the OSGi c
3
Swiper Official Version 2 Release
Fri, Jul 21st 2017 1:52p   Cameron Gregor
So I have finally posted Swiper version 2 to OpenNTF! (and Github of course) Swiper OpenNTF Project Page Swiper Github Releases The latest version is 2.0.1,  and is the same as 2.0.0beta but with a bug fix for the toolbar buttons. Swiper 2.0.0 beta has been available on the Github project site for a few months, and the core functionality of it works as planned. There was however a bug within the shortcut buttons that I added to the menu bar, and this is a bit of a nasty bug that can cause del
3
Auto-width Bootstrap Column XPages Controls
Tue, Mar 21st 2017 1:13p   Cameron Gregor
I’ve been stuck working with OneUI Version 3 for the past couple of years, due to a regretful decision made at the beginning of my major project. OneUI was better than nothing but very frustrating at times. Finally, I have moved on to my next project and I am now using bootstrap (version 3) A common task when laying out a page using bootstrap is to divide sections up into rows and columns, and use the appropriate css styles to do so. I’m going to assume you are familiar with bo
3
Swiper FP8 Version Beta Release
Thu, Mar 16th 2017 12:50p   Cameron Gregor
Last week I released the ‘alpha’ version of Swiper which was untested on FP8 but presumed to be ok. So far I have only had good reports from the pioneers who have gone ahead and installed FP8 + the alpha version. I have since managed to ugrade my home office setup to FP8 which unfortunately has broken my ability to launch designer from eclipse but I am seeking some advice on fixing this up. In the meantime I have to test the slow way of building plugins, import plugins, restart R
3
Swiper FP8 Integration Rollout
Wed, Mar 8th 2017 12:43p   Cameron Gregor
Notes Domino 9.0.1 FP8 is finally here and as far as I know (I have yet to download it) it includes the necessary changes which will allow Swiper to swipe whatever it wants, whenever it wants, which is good news for people who don’t like to have ‘Build Automatically’ turned on. Plan of Attack for release of Swiper version 2.0.0 So, I haven’t actually downloaded FP8 yet,  so I can’t say for sure that the updated version works perfectly. Here is a bit of backgrou
7
Markdown XPages UIControl
Sun, Mar 5th 2017 11:44a   Cameron Gregor
Often when I’m designing an xpage, there might be a section of the page in which I want to explain some instructions to the user. Some options here are to: write the Instructions using html and embed directly in the xpage markup write the Instructions directly in the design pane and format using designer’s ui e.g. bold, color, size etc use some native xpage controls to achieve the desired result. Write the instructions in a richtext field on a notes document that is loaded to dis
1
TextDiff XPages control – For visual comparison of text
Tue, Feb 28th 2017 12:00p   Cameron Gregor
A few years back I stumbled across Google’s diff-match-patch project which provides some handy algorithms for text manipulation. At the time of discovery I was doing ‘classic’ notes development. Although I probably could have implemented something that worked in lotuscript with RichText or Mime, it wasn’t a priority at the time and I never bothered. Since then, I have been doing mainly XPages, and now that I have been also doing a bit of XPages Control development. I was
7
XPages webmail – Using Mime Inspector to debug Mime
Tue, Feb 14th 2017 11:12a   Cameron Gregor
In a previous post in this series I did a bit of an overview on how MIME works. We also did a little bit about how MIME works in XPages + Domino land. With this knowledge in hand we can now start to analyse the different ways a ‘Pretty words, pictures and attachments’ can be stored in the document. During development of the ‘XPages Webmail’ interface, I encountered many problems which could only be solved by investigating the MIME content in detail. To help me do this, I
12
Pasting Images into XPages CKEditor
Sun, Feb 12th 2017 10:00p   Cameron Gregor
Programs like ‘Snipping Tool’ on Windows, are super useful for users to make a quick snapshot, do some quick markup on the image, paste into chat/email and send. Unfortunately when using the default configuration of CKEditor in XPages (the inputRichText control), support for pasting images is not available for all browsers, and even for the ones that do support it, the images are only pasted as a PNG data URI. I have explained data URI images in a previous post, so check that out if




Created and Maintained by Yancy Lent - About - Planet Lotus Blog - Advertising - Mobile Edition