Hands-on: Your first GraphNSF

With more people talking about the usage of Graph data modelling with data residing in IBM Notes documents there is still a threshold getting started writing your first XPages application using the concept or technology.

I had the opportunity to spend a day or two to setup a simple basic construction, document it and demonstrate and explain it to a couple of developers.

The document is available under the following link:

cover-document

 

Here is the table of content:

toc

The document walks through the setup of the implementation and several design elements for the application.

(Again) I have used the Teamroom application, because it’s common available for IBM Notes Domino. On top of the existing XPages application for a Teamroom I have added several XPages to have a simple app showing the Graph capabilities within the OpenNTF Domino API library.

The result of the tutorial is the option to import Notes data into a Graph DB and have a look and some interaction with it. Of course the end-goal is to get some insight in how to set up a basic construction and understanding of some core Graph terminology and how to translate this to an XPages application.

teamroom_graph

I hope it may help you and if you have questions or are interested exploring graph capabilities I am happy to hear from you!

Add 20 years of experience to your workforce

You can 20 years of experience within IBM Notes and Web development to your workforce by hiring me.

Interested? Read my curriculum vitae on LinkedIn: http://www.linkedin.com/in/patrickkwinten and get in contact.

I am happy to work WITH you !

 

 

Advertisements

JavaScript Internationalization & placeholders

Introduction

Some time ago I wrote about moving a Teamroom application up to IBM Bluemix. This month the XPages runtime is now general available.

In the post I mentioned I would come back on some design gotchas I saw while analyzing and preparing the Teamroom application for staging it to Bluemix. So here is (at least9 a first post.

What I noticed for example was the usage of the l18n library in SSJS and placeholders in properties files.

i18n formatting

This is a server script library with methods to format messages for localization, display dates in a locale-specific manner and miscellaneous Internationalization utilities.

So how does this works?

Create two or more strings properties file e.g.

  • strings.properties
  • strings_sv.properties

The strings.properties file content:

compliment=Handsome

hello.world=Hello {0}

The strings_sv.properties file content:

compliment=Snygging

hello.world=Hejsan {0}

Now create an XPage and place e.g. a Computed Field control on it and calculate it’s value:

<xp: text><xp: this.value><![CDATA[#{javascript:compliment = strings.getString(“compliment”);

return i18n.format(strings.getString(“hello.world”), compliment);}]]></xp: this.value></xp: text>

(Do not forget to enable Internationalization for your application in the Application Properties under section International Options)

Placeholders

Notice in the properties file the usage of a placeholder: hello.world=Hello {0} and how it is being referred: strings.getString(“hello.world”), compliment. Here the variable compliment (another string property value) is put in the placeholder.

As a result in the default language I get returned “Hello Handsome” and when I choose Swedish as default language in my browser I get returned “Hello Snygging”.

By wrapping it and formatting it with the L18n library you ensure it is fitted according the active language. This is very handy for dates, amounts etcetera.

Links of interest

More details about JavaScript Internationalization can be found in the IBM Notes Domino Application Development wiki.

 

Teamroom XL fix – Filter documents by subteam

Some may enjoy a longer vacation than others, most of us will land in the same nest again.

At the moment we are reviewing the Teamroom 8.5.3 XL template, to check if this is a more user-friendly mobile interface for document sharing solution than MS SP.

However I noticed a problem with Subteam filtering option in the ‘All documents’ view. The problem is that the xvwDocsByTeam view is not correct (the wrong field name is present in the view design)…

Here is the fix:

  1. Open xvwDocsByTeam view
  2. Change the “Team” column’s value to:

@If(form=”Status”; “Team Status”; SubteamInterest)

Now back to user-testing and acceptance =)

Using Teamroom 8.5.2 – recommended documentation?

I am currently looking at the 8.5.2 Teamroom template and if it will fit well in our application portfolio. Getting the application up and running is not a problem. Allthough I have noticed some technical problem areas the information I am more interested in is about:

  • The purpose of the application. What is it’s objective and how we should position the application in our portfolio.
  • How should the application be setup and what are the options?
  • How can daily users use the application, what is in it, what are the options to use it?

A lot of information on Teamroom is available on the web, but not all is of recent date or distributed by IBM. For example:

Unfortunately such information is not shipped with the template. In case you know where I can find good, more recent information please drop a reference here.