Journal In WorkPoint Add-in

1. Introduction

2. Requirements

3. Installation of add-in

4. Configuration

5. End User Guide

6. Removing the Journal in WorkPoint Add-in

7. Notes

8. Download

WorkPoint has now made it easier to journalize e-mails and attachments into one or separate folders automatically, based on file extensions. You can e.g. automatically journalize e-mails into an e-mails library on a solution and journalize .jpg image attachments from e-mails into a different folder, say a Documents library. This feature functions through the use of an Add-in which must be installed in the SharePoint administration.

This feature can be used from both the online version of Outlook and the desktop version of the app.

The add-in can be downloaded in various language versions from the Office Add-In downloads page.

Note that if you already have the Journal in WorkPoint add-in installed in your Microsoft 365 administration, and wish to install one of the versions in the Download section, you will need to first remove the version currently installed. For a guide on how to remove the Journal in WorkPoint add-in, please visit this section.

This feature requires a WorkPoint 365 solution as well as WorkPoint Express.  

Installing the add-in requires a user with administration privileges. The add-in is installed from the SharePoint administration, which can be accessed by following these steps:

1. On the solution, access the SharePoint panel by clicking the dotted box-icon.
2. Click the Admin button from the menu.

3. In the Microsoft 365 admin center, expand the Settings tab in the side menu.
4. From the Settings tab, click “Integrated apps”.

5. From the Services & add-ins interface, click “Deploy Add-in”.

6. In the Upload Apps to deploy panel, if you have multiple options for Host Product, select "Office Add-in".
7. Select "Upload manifest file (.xml) from device".
8. Click the "Choose File" button.

9. Browse to the downloaded JournalInWorkPoint.xml file (You can find this file in the Downloads section of this article) and click "Open".

10. Ensure that the manifest file is validated and click "Next".

11. Select whether this is a test deployment. If you want to deploy this to for production, set this to "No".
12. In the "Assign users" section, select who has access to the add-in. “Specific users/groups” refers to AD users or groups.
13. Click the "Next" button.

Please note that there may be a delay of up to 24 hours before the add-in becomes available in Outlook due to company policies.

14. Read the permissions that the Journal In WorkPoint add-in requires to function and click "Accept permissions".

15. Sign in with an account which can accept the aforementioned permissions.

16. Review the permissions required for the Journal In WorkPoint add-in to function and click "Accept".

17. Verify that the permissions have been accepted and click the "Next" button.

18. In the "Review and finish deployment" step, click "Finish deployment".

This begins the deployment for the selected users:

Once the deployment has finished, the following panel is displayed:

19. Click the "Done" button to return to the "Integrated apps" page of the Microsoft 365 Admin Center.

The list of integrated apps should now show the Journal in WorkPoint add-in:

For configuration of email journalizing, access the WorkPoint Express Settings menu by following these steps:

20. in WorkPoint Express, click the "Menu" button.
21. Click the “Settings” option to open the WorkPoint Express settings.

22. Open the "Advanced" tab
23. Type in your Solution ID. Alternatively you can email your main domain (e.g. workpoint.dk) to support@workpoint.dk, and we can type it in for you ahead of time.

24. In the WorkPoint Express settings window, click the “System” tab in the top menu.

25. In the System tab in the WorkPoint Express settings window, open the “Smart File Handling” tab.

As shown in the figure above, Redirect rules can now be set for the journalizing system to operate under. In the example from the figure above, any .msg files from e-mails sent to this solution is saved on the WorkPoint Internal site, on the business module “Companies” and in the list “Documents”.

The figure below is a focused view of the Redirect Rules interface:

26. If “Redirect msg files to Email Manager” is checked the system will take any msg from an e-mail and save it to Email Manager. This assumes that the system has Email Manager. If this setting is checked and the user has also defined where to journalize msg files in SharePoint, the Email Manager takes priority, and the msg file is saved in Email Manager.
27. To add a new configuration, the user can type in a file extension for the system to work with. Note that, under normal circumstances, a file extension begins with a dot, e.g. “.jpg”. This is not      the case in this interface. A file extension for a JPG image should be typed in simply as “jpg”. A file extension for a text file should be typed in simply as “txt”, etc. Typing "*" in this field indicates all file types that have not been specified. All file types that have not been defined will then be journalized in the specified location.
28. In the “Site” cell for the new configuration, the user can select which site to journalize the specified file types to.
29. The Business Module cell further specifies which business module to journalize the file(s) to.
30. The List URL name cell specifies which list or library to save the file to.

Next, we need to set the Azure Active Directory Tenant in the Miscellaneous settings:

31. In the "System" tab, open the "Miscellaneous" tab.
32. In the "Active Directory Tenant" field, type in the name of your tenant.
33. Click the Close" button to close the WorkPoint Express settings.

34. In the "Conform Restart" dialog, click "Yes" to save the settings and restart WorkPoint Express.

As previously mentioned, the add-in can be used from both online version of Outlook, and from the desktop version of the app. When working in the desktop version of Outlook, the add-in is located in the main ribbon, and can be accessed by clicking the “Journal in WorkPoint”-button:

35. The “Journal in WorkPoint”-button which opens the add-in can be accessed from the main ribbon.
36. he button opens the journal interface, which allows the user to control which items to journalize. You can choose whether to journalize all attachments, some of them, or none of them.

In the example from the figure above, two attachments are selected for journalizing, as well as a company to journalize to. Optionally, a submodule for the company could be selected for journalizing. The e-mail and attachments will be journalized once the “Journalize”-button is clicked.  

After having installed the add-in, when trying to run it for the first time, you need to grant the add-in a set of permissions. This query is shown in the figure below:

To journal an email in the desktop version of Outlook, follow these steps:

37. Open an email by double clicking it.

38. From the opened email window, click the Journal in WorkPoint-button from the mail ribbon
39. Make appropriate choices, including what to journalize and where to journalize to
40. Click the Journalize-button.

To journalize an email from the browser version of Outlook, follow these steps:

Select and open an email

41. Click the “More actions”-button on the email top panel
42. Click the “Journal in WorkPoint”-button from the menu

43. Make appropriate choices, including what to journalize and where to journalize to.
44. Click the journalize-button.

If you have recently journalized to specific locations, the 5 most recent locations will be shown in the dialogue box. Clicking any of these quickly selects that location so that journalizing to most recent locations can be done quickly without having to navigate to these locations again. An example is shown below. Note the green box containing 3 recent locations.

Removing the Journal in WorkPoint Add-in is done from the Microsoft 365 Admin Center:

45. In the Microsoft 365 Admin Center, expand the "Settings" menu and select "Integrated apps".

46. In the list of integrated apps, click the "Journal in WorkPoint" add-in.

47. In the side panel, click "Remove app".

48. To remove the Journal in WorkPoint add-in, check the confirmation checker and click the "Remove" button.

The Add-in should no longer be listed in the list of integrated apps.

Note that this feature can be used both from the online version of Outlook, as well as the desktop version of the app. It can also be used from the mobile app. The settings for the Redirect rules, however, can only be set from the WorkPoint Express settings interface.

Also note that this add-in does not currently support cloud-based email attachments. This means that if an email was sent with a file attachment that is a cloud link, the file is not directly transferred along with the email, and thus the file cannot be journalized.

Note that if you already have the Journal in WorkPoint add-in installed in your Microsoft 365 administration, and wish to install one of the versions from the Download section, you will need to first remove the version currently installed.

Download guide for the add-in file:

1. Go to the Office Add-in download page.
2. Download the appropriate language version for your scenario.