Out of Office Status Query Widget for Domino iNotes


To enable Out-of-Office web widget for your iNotes clients, please refer to below section for more information.


For Domino 9.0.x:
Steps to enable "My Widgets" sidebar panel of iNotes

1. Shutdown the iNotes Domino server.

2. Install the OpenSocial Component onto the Domino server.

3. Modify the Domino server's notes.ini as follows:
    • Add this entry: iNotes_WA_Widgets=1
    • Make sure both DOTS and HTTP are in the ServerTasks entry.

4. Make a copy of inotes_config.xml.template under C:\Domino\data\domino\html and rename to inotes_config.xml.

5. Start the Domino server.

6. Create a Widget Catalog (i.e. toolbox.nsf) on the Domino server if it is not already exist. Configure its ACL settings if necessary.

7. Create a Credential Store (OAuth Token Store) database by performing these steps:
    1. In the Domino Server console type: keymgmt create nek secretkey. The last parameter to the command (which is secretkey in the prior command) can be whatever you would like.
    2. In the Domino Server console type: keymgmt create credstore secretkey. The last parameter to this command must mach the last parameter from the command issued in the previous step.
    3. You should see some output in the console indicating the database was created successfully and there should now be a database called credstore.nsf in <Domino Data>/IBM_CredStore.
    4. Configure the ACL settings of the Credential Store database if necessary.

8. Configure the Credential Store database by performing these steps:
    1. Open the “OAuth Token Store” (credstore.nsf) database and select the Configuration view.
    2. Click the button called Create Encryption Key at the top of the view.
    3. Click OK to the New Encryption Key dialog and OK to the Create Encryption Key dialog. Note, there is no real indication in the database that the encryption key was successfully created so do not worry if you don’t see any changes visually.
    9. Configure the Widget Catalog by performing these steps:
      1. Open the widget catalog.
      2. Select the Configuration view in the Administration folder.
      3. In the Configuration view click the Configure Credential Store button.
      4. In the Configure Credential Store dialog enter your server's canonical name (e.g. myserver/mydominodomain), and the path to the Credential Store database (which should be IBM_CredStore\credstore.nsf). Alternatively you can use the Browse button to pick the server and database.
      5. With the Widget Catalog open in the Domino Administrator client go to View -> Agents. This should open Domino Designer to the Agents view. Alternatively you can open the Widget Catalog in Domino Designer and then navigate to the Agents view yourself.
      6. Right click the PushToCredStore agent and select Enable. When you enable an agent you will be asked which server to run the agent on. Enter your servers canonical name (e.g. myserver/mydominodomain) and press OK.

    10. Create a Desktop Settings document by performing these steps:
      1. From the HCL Domino Administrator client, open an existing Desktop Settings document or create a new one.
      2. From the Desktop Settings document, click the Widgets tab.
      3. Configure the following settings:
        NameValue
        Widget catalog server:The canonical name of your server, e.g. myserver/dominodomain.
        Widget catalog application name:The name of the widget catalog NSF, e.g. toolbox.nsf.
        Widget catalog categories to install:iNotes
        Show the My Widgets panel in the sidebar:Yes
        Install widgets from catalog:Enable
    10. Create a Mail Settings document by performing these steps:
      1. From the HCL Domino Administrator client, open an existing Mail Settings document or create a new one.
      2. From the Mail Settings document, click the Widgets tab.
      3. Configure the following settings:
        NameValue
        Show the Widgets folder in the Mail outline:Enable
        Allow users to create widgets from XML:Enable

    11. Assign the newly updated Desktop Settings and Mail Settings to the appropriate Policy document(s).

    12. In order to have the mail policies apply immediately, you may go to the Domino console and enter command: tell adminp process mailpolicy


    Steps to enable the Out-of-Office Status Query widget for iNotes

    1. Add the Out-of-Office Status Query widget to the Widget Catalog by performing:
        Method 1:
        i. Open the Out-of-Office Manager database (i.e. ooo.nsf).
        ii. Click on the "Install Out-of-Office Status Query Widget" link to open the installation page.
        iii. Detach the Web Widget ooo_web_widget.xml onto your file system.
        iv. Open the Widget Catalog database (i.e. toolbox.nsf).
        v. Click the Import button at the top of the view.
        vi. Browse to attach the ooo_web_widget.xml from the file system. A new Widget document will be created in the Widget Catelog.
        vii. Click on the Edit button, then specify the word "iNotes" to the Category field.
        viii. Click on the Approve button at the bottom of the document to approve the widget.
        ix.
        Method 2:
        i. Make sure the Widget preferences in your standard Notes client have been setup properly (File => Preferences => Widgets).
        ii. Open the Out-of-Office Manager database (i.e. ooo.nsf).
        iii. Click on the "Install Out-of-Office Status Query Widget" link to open the installation page.
        iv. Drag the Web Widget ooo_web_widget.xml to the My Widgets sidebar panel of your standard Notes client. This will add the widget to there.
        v. Right click on the Web Widget from the My Widgets sidebar panel, then select Publish to Catalog. A new Widget document will be created in the Widget Catalog.
        vi. Specify the word "iNotes" to the Category field.
        vii. Click on the Review button and then the Approve button at the bottom of the document to approve the widget.

    2. Log into your iNotes mailbox.

    3. Launch the My Widgets sidebar panel from the iNotes.

    4. The Out-of-Office Status Query widget is supposed to be listed in there. If you do not see that, try right-clicking on the My Widgets sidebar panel and then select Update Widgets to refresh its content.

    For Domino 8.5.3:
    Steps to enable the "Widgets" folder of iNotes

    1. Create a Mail Settings document by performing these steps:
      1. From the HCL Domino Administrator client, open an existing Mail Settings document or create a new one.
      2. From the Mail Settings document, click the HCL iNotes tab, and then click the Configuration tab.
      3. Configure the following settings:
        NameValue
        Show the Widgets folder in the Mail outline:Enable
        Allow users to create widgets from XML:Enable

    2. Assign the newly updated Mail Settings to the appropriate Policy document(s) if it is not already done.

    3. In order to have the mail policies apply immediately, you can go to the Domino console and enter command: tell adminp process mailpolicy

    If you do not want to use policies to enable this feature, instead of performing Step 1-3 mentioned above, you can use the notes.ini file setting iNotes_WA_Widgets=1 to enable the feature server-wide. Using this setting overrides any policy setting.

    4. (Optional) Make a copy of inotes_config.xml.template under <Domino Data>\domino\html and rename to inotes_config.xml. This file contains the widget configuration information. The file may include one of both of the following elements:
      • A <toolboxCatalog> element specifying the toolbox catalog database name and the comma delimited list of categories containing widgets. iNotes users are able to select widgets in these categories when they select the Browse Widgets Catalog context menu item on the Widgets folder in the mail outline.
      • Zero or more <webcontextConfiguration> elements containing widget definitions. Widgets specified here appear in the Widgets folder of all users and cannot be removed by the user. The XML for a widget can be obtained from the extension.xml file included as an attachment in the document defining the widget in the toolbox catalog.

    5. Restart the Domino server.


    Steps to enable the Out-of-Office Status Query widget for iNotes
      Method 1 (Add the widget by configuring the inotes_config.xml file):
          1. Open the Out-of-Office Manager database (i.e. ooo.nsf) with your standard Notes client.
          2. Click on the "Install Out-of-Office Status Query Widget" link to open the installation page.
          3. Detach the Web Widget ooo_web_widget.xml onto your file system.
          4. On the Domino server, use a text editor to open the inotes_config.xml file under <Domino Data>\domino\html.
          5. Use a text editor to open the ooo_web_widget.xml file.
          6. Copy and paste the entire <webcontextConfiguration>...</webcontextConfiguration> block from the ooo_web_widget.xml into the inotes_config.xml.
          7. Restart the Domino server.
        Method 2 (Add the widget from the iNotes Widgets folder):
          1. Open the Out-of-Office Manager database (i.e. ooo.nsf) with your standard Notes client.
          2. Click on the "Install Out-of-Office Status Query Widget" link to open the installation page.
          3. Detach the Web Widget ooo_web_widget.xml onto your file system.
          4. Log into your iNotes mailbox.
          5. Right click on the iNotes Widgets folder, and then select Create.
          6. Use a text editor to open the ooo_web_widget.xml file.
          7. Copy and paste the entire content of the ooo_web_widget into the Enter widget XML dialog box and press Save.

        Method 3 (Add the widget through Widgets Catelog):
          1. Make sure the Widget preferences in your standard Notes client have been setup properly (File => Preferences => Widgets).
          2. Open the Out-of-Office Manager database (i.e. ooo.nsf).
          3. Click on the "Install Out-of-Office Status Query Widget" link to open the installation page.
          4. Drag the Web Widget ooo_web_widget.xml to the My Widgets sidebar panel of your standard Notes client. This will add the widget to there.
          5. Right click on the Web Widget from the My Widgets sidebar panel, then select Publish to Catalog. A new Widget document will be created in the Widget Catalog.
          6. Specify the word "iNotes" to the Category field and then save the document.
          7. Log into your iNotes mailbox.
          8. Right click on the iNotes Widgets folder, and then select Browse Widgets Catalog.
          9. Select the Out-of-Office Status Query widget from the list of available widget.



        Support:

        Enjoy using the program and please report any problems or feature suggestions to us.

        Email: support@extracomm.com


        Share with your friends:




        Related Links





        Other Extracomm Products: