zetadocs express installation guidedownload.equisys.com/pub/express/documentation... · zetadocs...

12
Zetadocs Express for Microsoft Dynamics NAV - Installation Guide Version history Version: 7.1 Published: 24 th September 2015 Equisys Ltd Equisys House 32 Southwark Bridge Road London SE1 9EU United Kingdom Equisys Inc 30,000 Mill Creek Avenue Suite 335 Alpharetta GA 30022 USA Further Support and Information For further assistance and guidance on your Installation please refer to the support area of the Equisys website. Copyright Notice © Equisys Ltd. All rights reserved. No part of this document may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying, without the prior written permission of Equisys Ltd. All trademarks are acknowledged.

Upload: doanh

Post on 31-Mar-2018

244 views

Category:

Documents


0 download

TRANSCRIPT

Zetadocs Express for Microsoft

Dynamics NAV - Installation Guide

Version history

Version: 7.1

Published: 24th

September 2015

Equisys Ltd

Equisys House

32 Southwark Bridge Road

London SE1 9EU

United Kingdom

Equisys Inc

30,000 Mill Creek Avenue

Suite 335

Alpharetta GA 30022

USA

Further Support and Information

For further assistance and guidance on your Installation please refer to the support area of the Equisys

website.

Copyright Notice

© Equisys Ltd. All rights reserved.

No part of this document may be reproduced or transmitted in any form or by any means, electronic or

mechanical, including photocopying, without the prior written permission of Equisys Ltd.

All trademarks are acknowledged.

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 2

Technical Requirements

For the latest technical information please see our website.

Installation Pack Contents

Zetadocs®

Client Side Installer (Setup.exe) which installs the required client components.

Zetadocs SharePoint Extensions via a .WSP file to provide enhanced SharePoint functionality.

Zetadocs NAV Server Side Components in .fob files containing code/table objects to import into

NAV and the Web Client Document FactBox add-in.

Zetadocs Server Extensions which installs the Zetadocs NAV Server Extensions.

Zetadocs Archive Service installer and its prerequisite SQL Express files.

Zetadocs Express Installation Guide and Help files.

1. Client Installation

Zetadocs Express allows you to email and archive documents from within NAV, simply follow the steps

below to get your system up and running.

1.1 Install Steps

1. Navigate to your product download and open the Zetadocs Express Client folder and run the

setup.exe file.

2. You may be presented with a UAC warning depending on your settings, following that you will

receive a message asking if you wish to run the setup.exe installer.

3. You may be required to install the SharePoint Foundation 2010 Client Object Model

Redistributable, tick the I accept checkbox and click Next followed by OK to continue.

4. On returning to the Zetadocs installer, click Next to continue before reviewing the End User Licence

Agreement (EULA).

5. Once you have read and are satisfied with the EULA, select the I accept option and then Next to

continue.

6. On the next screen select Install to install the various components, you will then be asked to click

Finish once the install is complete.

2. Archive Setup

Zetadocs Express allows you to use either SharePoint Archiving or the Zetadocs Archive to archive your

documents.

Client Installation

Archive Setup

NAV Server Install and Configuration

System Testing

Further Client Machine System Rollout

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 3

2.1 SharePoint Archiving

Prerequisites

Before beginning the installation of the Zetadocs SharePoint Extensions you require the following

prerequisites.

Suitable SharePoint Site or Site Collection created for your archive.

Adding the Zetadocs SharePoint Extensions

You need to add the Zetadocs content type to your Site and later configure the Document Library to use it.

1. Log into SharePoint as a Site Collection Administrator using Internet Explorer 8 or later with

Javascript enabled.

2. On the Site Actions menu, click Site Settings.

3. In the Web Designer Galleries section, click Solutions, if this is not available ensure you are

looking at the settings for the correct level. Use the Go to top level site settings option to achieve

this.

4. Click Solutions on the ribbon and then Upload Solution.

5. Browse to the Zetadocs SharePoint Extensions folder of your product download and select the

Zetadocs SharePoint Extensions.wsp file.

6. In the Upload Document dialog box, click OK.

7. The Solution Gallery – Activate Solution dialog box appears, click on Activate.

8. Return to the Site Settings and select Manage Site Features from the Site Actions section.

9. Scroll down the list and activate the Zetadocs elements in the following order:

a. Zetadocs Content Type

b. Zetadocs Document Library

c. Zetadocs Workflow (Note: Do not activate this item. The workflows feature is not

available.)

2.2 Zetadocs Archive

The Zetadocs Archive Service runs on a server machine on your network and handles the archiving of

documents captured and sent using Zetadocs. The Zetadocs Archive Service makes use of a SQL database

to store the metadata and act as an index for the archive to allow searching for documents by any metadata

field.

Creating the Zetadocs Archive Folder

The archive requires a network folder into which captured documents are placed and to which users require

access permissions.

1. Create a folder with the name Zetadocs Archive, the Zetadocs Archive Service searches for this

exact name and will not work with any other naming.

2. Ensure this location has sufficient disk space, a technical note is available here should you need

assistance determining your requirements.

3. View its Properties and select the Share tab, followed by Advanced Sharing.

4. Check the Share this folder checkbox and add the share name Zetadocs Archive.

5. Select the Permissions button and add required users and groups:

a. All users of Zetadocs require Read permissions, add these individually or create a

Zetadocs group.

b. The Zetadocs Archive Service must have access to the folder, by default it runs as Local

System and for it to function correctly the system account requires FULL permissions.

6. Next return to the Properties for the folder and select the Security tab.

7. Select the Edit… button and in the window which appears select Add…

8. Add the users and groups you created earlier in steps 5a and b to grant your users and the

Zetadocs Archive Service access to the Zetadocs Archive folder.

Installing the Service

Note: If you are running on Windows Server 2003 you must carry out the additional steps in this technical

note before proceeding with the steps below.

1. Locate the Zetadocs Archive Service folder of your product download and run the setup.exe file,

please note the Zetadocs Archive Service installer may require you to reboot your server to

complete.

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 4

2. The installer performs the following actions:

a. Installs SQL Express (or adds a new instance if already installed)

b. Creates the SQL database for indexing and metadata

c. Installs the Zetadocs Archive Service

3. Proceed through the wizard following the on screen prompts to complete the installation.

Connecting a Zetadocs Archive Service and Zetadocs Archive folder on different machines

If you have setup the Zetadocs Archive folder on a different server to the Zetadocs Archive Service you now

need to carry out the steps below to ensure the service can access the folder.

Note: If they are on the same server machine these steps are not required.

1. Locate the Zetadocs Archive Service\Scripts folder of your product download and run the

SetArchiveFolderLocation.cmd file.

2. In the window which appears enter the server name where the Zetadocs Archive folder is located.

3. Next you need to ensure that the user the Zetadocs Archive Service is running as is a domain user.

4. To do this open Users and Groups, or the equivalent on the operating system you are using.

5. Select Users and then New User… from the Action menu.

6. Give the account a suitable user name, full name and description.

7. Enter a password for the account and ensure the Password never expires checkbox is selected

before clicking Create.

8. Next go to your Zetadocs Archive folder and view its Properties and select the Share tab, followed

by Advanced Sharing.

9. Select the Permissions button and add your newly created user account with FULL permissions.

10. Next return to the Properties for the folder and select the Security tab.

11. Select the Edit… button and in the window which appears select Add…

12. Add the users and groups you created earlier to grant your users and the Zetadocs Archive Service

access to the Zetadocs Archive folder.

13. Open the services list and locate the Zetadocs Archive Service, stop the service before right-

clicking and selecting Properties.

14. View the Log On tab and check the This account radio button, click Browse… and select your

recently created user account.

15. Enter the password details and click OK before restarting the service running as the new user.

3. NAV Server Install and Configuration

These steps will update NAV with the required object changes to operate with Zetadocs.

3.1 Prerequisites

Before continuing with your Zetadocs install you need to perform the following prerequisite actions.

Refreshing the NAV license

To successfully install Zetadocs Express you may need to refresh your NAV license, the Zetadocs Express

Granule (9041210) was added to licenses after June 2011. To refresh the license, log into PartnerSource and

use Voice to download an updated NAV license.

Once this is available:

1. Log into the NAV Development Environment (Classic Client) and select Tools License

Information

2. Next select Import or Upload (NAV 2013 and later) and choose the updated license to enable the

Zetadocs Express granule.

Backup of the Existing NAV objects

Before beginning the Zetadocs installation you may wish to perform a backup of the existing NAV objects to

ensure you can undo any changes to your NAV system if required.

NAV 2016

On a 64-bit version of a Windows operating system, the 64-bit version of the NAV Windows client runs by

default. The Zetadocs Windows client add-in is a 32-bit only component not supported by the 64-bit version

of the NAV Windows client. In this case, you must run the 32-bit version of the NAV Windows client on 64-bit

Windows. Please see the Microsoft Dynamics NAV 2016 Help topic "Running 32-Bit Microsoft Dynamics

Windows Client on 64-Bit Windows" for options on how to run the 32-bit version of the NAV Windows client.

Now follow the instructions for NAV 2013 and later below.

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 5

3.2 Importing the NAV Objects

1. Open NAV Development Environment (Classic Client) and in the Object Designer import the

relevant fob file e.g. for NAV 2009 R2, Zetadocs Express Objects – NAV6.10.fob file from the

Zetadocs NAV Server Components folder.

2. Next you need to modify the NAV pages which will display the Documents Factbox, to make this

process quicker and easier we have provided the Zetadocs Interface Modifier tool, this can update

the NAV v6.x, 7.x, 8.x and 9.x objects so that they can integrate with Zetadocs.

3. Download the Interface Modification Tool and extract it.

4. Open the object designer and choose the Page option.

5. Select the pages you wish to modify to work with Zetadocs and go to File Export and save the

interfaces as an XML file (NAV 6.x) or as a TXT file (NAV 7.x-9.x).

6. Open the ZdNAVInterfaceTool - Express.exe file and click on Load Items, you will be asked to

specify your NAV version.

7. Browse to the location of your exported Interfaces file and click Open, the tool will load your

exported items.

8. Click Start and the tool will ask you to either specify the reports IDs or the Use W1 defaults, see

appendix A for further information on report IDs.

9. Invalid items are reported in a message dialog after the load operation has completed and should

be processed manually using the steps in section 6.

10. The status column shows the conversion process. If an item cannot be modified, the reason will be

listed in this column, in which case follow the instructions in section 6 to manually modify the

pages instead.

11. The updated file name will be appended (Modified) and is available in the folder containing the

original interfaces file.

12. Re-import the modified pages into NAV and deal with any merge and conflict messages that may

appear, before compiling them (F11).

Importing the Language Module

If you are intending to use a language other than English, you will need to import the relevant language

module, otherwise continue from section 3.3 below.

Note: If you are using NAV 2013 R2 or later you must carry out the additional steps in this technical note

before proceeding with the steps below.

1. Select All objects in the object designer, then filter the list on the column Version List using the

value *ZDX*.

2. Navigate to ToolsLanguage moduleImport.

3. Browse to the Language Modules folder of your product download and import the relevant

language module.

3.3 Installing the Zetadocs for NAV Server Extensions

Note: This step is only required for NAV 2013 R2 systems or later. Install the Zetadocs NAV Server

Extensions on the NAV Server and where you compile the NAV objects.

The Zetadocs NAV Server Extensions setup program installs the Zetadocs NAV Server Extensions.

1. Locate the Zetadocs NAV Server Extensions folder of your product download and run the setup.exe

file.

2. Proceed through the wizard following the on screen prompts to complete the installation.

Note: Please restart the Microsoft Dynamics NAV Server to complete the installation.

3.4 Configuration Page

1. Return to the Object Designer, select the Zetadocs General Settings Page (9041210), and click

Run.

2. Click the Edit button.

3. Add your Zetadocs license, this was provided in your Zetadocs fulfilment email along with the

download link.

4. Select your Archiving method:

Off - Zetadocs will not attempt to archive items.

SharePoint

Zetadocs Archive

5. If you have installed the Web Client Document FactBox, check Load Document FactBox without

document list, so that NAV Web Client pages display more quickly on systems using slower data

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 6

stores (e.g. SharePoint Online). This option is also applied to the NAV Windows Client when using

Web Client Document FactBox in server only deployments.

6. If you are using SharePoint for your archive, input your SharePoint site or site collection address as

required, this is the bold section shown here:

https://equisys.SharePoint.com/sites/MicrosoftDynamics/default.aspx.

Note: Please ensure that you have only included the site collection address and not the specific page

reference which appears at the end.

a. Once you have added a site address click the test button at the end of the field to verify it.

7. If you are using the Zetadocs Archive, enter the server name on your network where the Zetadocs

Archive Service has been installed into the Service Address field e.g. http://example-

server/ZetadocsArchive ensuring there are no spaces in the name.

a. Once you have added the service address click the test button at the end of the field to

verify it, this will open a browser window and if successful in connecting to the service it

will display a page titled ArchiveService Service with the confirmation message You have

created a service below it.

8. Next import the Zetadocs configuration by selecting Actions and then Import Configuration Data.

9. On the import dialog, select the Zetadocs Express Configuration.xml file from the Zetadocs

Express folder.

10. Click Import and you should be notified when the import has finished successfully.

3.5 Installing the Help Files

Help provision is handled differently depending on the version of NAV and the client that is being used,

please follow the steps below relating to your NAV version.

NAV2013 R2 or later and Help Server

If you have installed the help server please follow the steps below to integrate the Zetadocs Express help

with the main NAV help files.

To integrate the Zetadocs help files with the Microsoft Dynamics NAV Help you need to copy the Zetadocs

help files into the main NAV help file folder and update the table of contents file to enable your users to

locate the help they need.

1. Locate your product download and select all of the files present from the folder below:

\Zetadocs Express\Documentation\<language>\Zetadocs NAV Help

2. Copy these to the NAV Help Server folder:

Typically: C:\inetpub\wwwroot\DynamicsNAVxxHelp\Help\<languagecode>

3. This adds the help files into the server where they can be accessed by pressing F1 on a Zetadocs

field, a further step is required to add them to the Table of Contents so the content can be easily

browsed for.

4. Open the ToC_Additions.xml in file in a suitable editor and copy the contents and paste them into

the ToC.xml file near the bottom, above the second last </Node> tag and Save the changes.

NAV2013 and earlier - Windows Client/Role Tailored Client

The Zetadocs for NAV help file needs to be copied to the Microsoft Dynamics NAV help folder so they are

available to users.

The addin_a.hh file should be copied from:

\Zetadocs Express\Documentation\<language>\

To the following locations, for NAV 2013:

Program Files\Microsoft Dynamics NAV\70\Service\ENG

For NAV 2009 R2:

Program Files\Microsoft Dynamics NAV\60\Service\ENG

Substitute ENG for the language pertinent to the install e.g. ENU for US systems.

You may need to restart the Microsoft Dynamics NAV server service to get the help files to appear as

expected.

3.6 User and Permissions Setup for NAV 2013 and later

1. Open the NAV Windows Client.

2. In the search bar, search for Configuration Packages and open the Configuration Packages page.

3. Select Import Package… from the Process group on the Home tab and select the Zetadocs Express

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 7

Permission Sets and Permissions - NAV7.xx-NAV9.00.RAPIDSTART file from your product

download.

4. In the Process group, click on Apply Package to complete import of the settings.

5. Setup the required users as per the steps in section 3.7 of the Zetadocs Express Installation Guide.

3.7 Permissions Setup for NAV 2009 R2

The ZETADOCSEXPRESS role grants access to the standard Zetadocs Express tables and allows users to use

Zetadocs Express.

1. Run the Data Migration form (8614).

2. Select Functions and then Import from XML.

3. Browse to the Zetadocs Express folder and select the Zetadocs Express Roles.xml file.

4. Next, select the Migration button and then Apply Migration Data.

5. Repeat 1 - 4 to import and apply the Zetadocs Express Permissions.xml file.

6. Next select Tools Security Synchronize All Logins.

3.8 Setting up Users

Once the standard permission set and permissions have been imported you will need to assign the role to

your users.

1. In the NAV Windows Client type User Setup in the search bar and navigate to that page.

2. Select the NAV user to enable for Zetadocs and choose Edit from the Home tab.

3. In the User Permission Sets fast tab, select an empty row and add the ZETADOCSEXPRESS

Permission Set.

4. Click OK when finished and the user is now set up to use Zetadocs Express.

4. System Testing

To ensure that the features have been correctly configured we recommend that you run a number of simple

tests of the Zetadocs functionality.

4.1 Authentication

Windows Live ID Authentication for SharePoint on Office 365

It is recommended that users initially sign in using their web browser at https://login.microsoftonline.com

with their username and password details. On first logging in users are asked to change their password

from its default value, once this has been done you are ready to connect via NAV.

1. Open NAV and proceed to one of the Zetadocs enabled pages e.g. Sales Order page.

2. The Zetadocs Documents FactBox will display a login box requesting their Office 365 username and

password.

3. Add these and select OK to continue, this establishes the connection between Zetadocs and

SharePoint.

4. These details will be stored locally in Windows Credential Manager meaning that the user will only

be requested to provide them again should they be changed or a problem connecting occurs.

5. This should be repeated on all required user accounts.

4.2 Document Capture Testing

1. Open the NAV Windows Client and navigate to and open a Sales Quote record, or other supported

record type.

2. Locate a suitable test file and drag and drop this into the Drag Files Here area in the Documents

FactBox.

3. Ensure this appears in the Related Document List and is archived.

4.3 Web Client Document FactBox Testing

1. Open the NAV Web Client and navigate to and open a Sales Quote record, or other supported

record type.

2. Select Add from the Documents FactBox Menu (…) actions and browse for an item to add to the

archive using Windows Explorer or the equivalent on the device.

3. Ensure this item appears in the Related Document List and is archived.

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 8

4.4 Save and Send Testing

1. Open the NAV Windows Client and navigate to and open a Sales Quote record, or other supported

record type.

2. Click the Save and Send button and then Select the Save and Send option.

3. On selecting OK an Outlook email message should open with an attachment and with customer

addressing information already populated.

Note: On selecting Save and Send for the first time you will be presented with up to four warnings such

as:

o Server has requested to run Scriptcontrol object

o Server has requested to run OApplication class

o Server has requested to run OSendMail class

o Server has requested to run BSTRConverter class

These are to be expected and you should simply select Always Allow in each instance, they will not appear

again on this machine.

For NAV 2013 an additional security warning will occur every session, you can simply select Allow for this

session each time, alternatively you can follow these steps alter the security configuration.

4. Locate and open the ClientUserSettings.config file, this can be found here:

C:\Users\<username>\AppData\Roaming\Microsoft\Microsoft Dynamics NAV\70

5. Find the line <add key="ServicePrincipalNameRequired" value="false" /> and change false to

true

6. Next find or add the line <add key="UnknownSpnHint"

value="(net.tcp://example.equisys.com:7046/DynamicsNAV70/Service)=NoSpn;" /> and

change NoSpn to Spn.

7. Save your changes and test the save and send feature the warning should no longer appear.

8. To test Save and Send adjust the email address to one you have access to, so the customer doesn’t

receive the email, and send the email.

9. Check it was delivered as expected and that the document appears in the Documents FactBox.

5. Further Client Machine System Rollout

Now that we have made the necessary modifications to NAV we can roll Zetadocs out across the other client

machines. To do this simply log onto client machine in question with an account with admin rights and

follow the instructions in section 1.1 to run the Zetadocs Express Installer program. This will add all of the

necessary components onto the machine to enable it to utilize the Zetadocs functionality. You should

perform the brief tests in section 4.34 to process the four warnings describe above, it is also recommended

that you perform the other tests in section 4.1 to confirm that Zetadocs is operating as expected.

6. Appendix A - Manually Modifying NAV Pages

The Documents FactBox can be implemented throughout NAV by editing the pages using the Zetadocs

Interface Modification tool, which can be found on our website, or by following the manual steps below.

Equisys has tested many of the most common pages but cannot guarantee these steps will work in all

circumstances. For systems with existing Sales and Purchase modified pages it is possible to use these

steps to install Zetadocs without importing the Interfaces fob file.

6.1 Feature Availability

Save and Send Functionality is available for reports that can be saved as PDF using the NAV

SAVEREPORTASPDF function.

The Documents FactBox with drag and drop support can be added throughout NAV on pages which

support FactBoxes.

The ability to retrieve related documents for a record after posting is restricted to the Sales and

Purchase pages by default, to add Zetadocs functionality to other areas of NAV please see this

technical note for further details.

Note: That save and send and drag and drop support are not available from the Web Client Document

FactBox.

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 9

6.2 Adding the Document FactBox

Adding the Document FactBox is handled differently depending on the version of NAV and the client that is

being used, please follow the steps below relating to your NAV version.

NAV2013 R2 or later

1. Open the object designer (Shift + F12) and select the page that needs to be modified and click the

Design button, in this example we will be looking at the Employee card.

2. Add the following entry at the top of the FactBox area

Name: WebClient

Caption: Documents

Type: Part

Subtype: Page

3. Once you’ve added the line select it and open the properties (shift+F4) for it.

4. Scroll down to the PagePartID field and select Zetadocs Web Rel. Docs. Page, ID: 9041211.

5. Then scroll up to the Visible field and type ZDWebAddinVisible.

6. Close the Properties dialog.

7. Add the following entry below the WebClient entry in the FactBox area

Name: Zetadocs

Caption: Documents

Type: Part

Subtype: Page

8. Once you’ve added the line select it and open the properties (shift+F4) for it.

9. Scroll down to the PagePartID field and select Zetadocs Rel. Docs. Page Part, ID:9041209.

10. Then scroll up to the Visible field and type ZDWinAddinVisible.

11. Close the Properties dialog.

12. Select ViewCA/L Globals and select the Variable tab, create four new global variables with the

values:

----

Name: ZdRecRef

DataType: RecordRef

----

Name: ZDWinAddinVisible

DataType: Boolean

----

Name: ZDWebAddinVisible

DataType: Boolean

----

Name: ZDSaveAndSendVisible

DataType: Boolean

----

Name: ZdPrevRecID

DataType: RecordID

13. Close the CA/L Globals dialog.

14. Click ViewC/AL Code or press F9 to open the C/AL Editor, scroll down to the

OnAfterGetCurrRecord section and append the following:

IF GUIALLOWED THEN

BEGIN

ZdRecRef.GETTABLE(Rec);

IF ZdRecRef.GET(ZdRecRef.RECORDID) AND (ZdRecRef.RECORDID <> ZdPrevRecID) THEN

BEGIN

ZdPrevRecID := ZdRecRef.RECORDID;

IF ZDWinAddinVisible THEN

BEGIN

CurrPage.Zetadocs.PAGE.SetRecordID(ZdRecRef.RECORDID);

CurrPage.Zetadocs.PAGE.ACTIVATE(TRUE);

END;

IF ZDWebAddinVisible THEN

BEGIN

CurrPage.WebClient.PAGE.SetRecordID(ZdRecRef.RECORDID);

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 10

CurrPage.WebClient.PAGE.UPDATE;

END;

END;

END;

15. Scroll up to the OnInit section.

16. Select ViewCA/L Locals and select the Variables tab, create a new local variable with the values:

Name: ZDAddin

DataType: Codeunit

Subtype: Zetadocs-Capture Addin

17. Close the CA/L Locals dialog.

18. In the OnInit section enter the following:

ZDWinAddinVisible := ZDAddin.IsWebClient OR ZDAddin.IsWinClientAddinPresent;

ZDWebAddinVisible := ZDAddin.IsWebClient OR (NOT ZDWinAddinVisible);

ZDSaveAndSendVisible := ZDAddin.IsWinClientAddinPresent;

19. Close the page and compile it. The Document FactBox can now be used in the NAV Windows client

(RTC) or NAV Web Client.

NAV2013 and earlier - Windows Client/Role Tailored Client

1. Open the object designer (Shift + F12) and select the page that needs to be modified and click the

Design button, in this example we will be looking at the Employee card.

2. Add the following entry at the top of the FactBox area

Name: Zetadocs

Caption: Documents

Type: Part

Subtype: Page

3. Once you’ve added the line select it and open the properties (shift+F4) for it.

4. Scroll down to the PagePartID field and select Zetadocs Rel. Docs. Page Part, ID:9041209.

5. Close the Properties dialog.

6. Select ViewCA/L Globals and select the Variable tab, create a new global variable with the

values:

Name: ZdRecRef

DataType: RecordRef

----

Name: ZdPrevRecID

DataType: RecordID

7. Close the CA/L Globals dialog.

8. Click ViewC/AL Code or press F9 to open the C/AL Editor , scroll down to the OnAfterGetRecord

section and enter the following:

For NAV 2009 R2

ZdRecRef.GETTABLE(Rec);

IF ZdRecRef.GET(ZdRecRef.RECORDID) THEN

BEGIN

CurrPage.Zetadocs.FORM.SetRecordID(ZdRecRef.RECORDID);

END;

For NAV 2013

ZdRecRef.GETTABLE(Rec);

IF ZdRecRef.GET(ZdRecRef.RECORDID) AND (ZdRecRef.RECORDID <> ZdPrevRecID) THEN

BEGIN

ZdPrevRecID := ZdRecRef.RECORDID;

CurrPage.Zetadocs.PAGE.SetRecordID(ZdRecRef.RECORDID);

CurrPage.Zetadocs.PAGE.ACTIVATE(TRUE);

END;

9. The Document FactBox can now be used in the NAV Windows client (RTC).

6.3 Save and Send Functionality

Zetadocs Express supports Sales and Purchase Order Processing reports out of the box, for reports based

on other tables you will need to add some code to one of our Zetadocs Save and Send Integration codeunit

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 11

(9041223). To add Save and Send functionality to a page you need to do the following, after you have

added the Documents FactBox to it.

1. Locate the page you wish to modify using the object designer and select Design.

2. Scroll to the bottom empty row and select View Control actions.

3. View the control actions and under Action Items add a new row.

4. Enter the Caption: Save and Send and Type: Action.

5. Select the row and view the properties for it.

6. Set the values as follows:

ToolTip: Save document to the archive and/or Send it via Outlook

Image: Invoice

Promoted: Yes

PromotedisBig: Yes

PromotedCategory: Process

Visible: ZDSaveAndSendVisible

Note: Only set the Visible value for NAV 2013 R2 systems or later.

7. Close the dialog and make a note of the name value corresponding to the caption Save and Send.

8. Next we need to add the relevant code for the page, press F9 to view the code and then locate the

row which matches the name value for Save and Send.

9. In this row add the following code for NAV 2009 R2: CurrPage.Zetadocs.Form.SaveAndSend(ID);

where ID is the value for the report you wish to run. E.g.

CurrPage.Zetadocs.Form.SaveAndSend(204);

For NAV 2013 and later: CurrPage.Zetadocs.Page.SaveAndSend(ID); where ID is the value for the

report you wish to run. E.g. CurrPage.Zetadocs.Page.SaveAndSend(204);

10. The tables below displays the tables supported out of the box and the default report IDs for the W1

database. For instructions on reports based on other tables, please see the installation notes page

on our website.

Sales

Page FactBox Save & Send Default Report*

41 Sales Quote Y Y 204 Sales Quote

42 Sales Order Y Y 205 Order Confirmation

507 Blanket Sales Order Y Y 210 Blanket Sales Order

43 Sales Invoice Y N N/A

132 Posted Sales Invoice Y Y 206 Sales Invoice

44 Sales Credit Memo Y N N/A

134 Posted Sales Credit Memo Y Y 207 Sales - Credit Memo

130 Posted Sales Shipment Y Y 208 Sales - Shipment

6630 Sales Return Order Y Y 6631 Return Order Confirmation

6660 Posted Sales Return Receipt Y Y 6646 Sales - Return Receipt

*SQL Reporting Services only

Purchases

Page FactBox Save & Send Default Report

Zetadocs Express for Microsoft Dynamics NAV Installation Guide

This edition 24th

September 2015 © Equisys Ltd All trademarks acknowledged All rights reserved Page 12

49 Purchase Quote Y Y 404 Purchase Quote

50 Purchase Order Y Y 405 Order

509 Blanket Purchase Order Y Y 410 Blanket Purchase Order

51 Purchase Invoice Y N N/A

138 Posted Purchase Invoice Y Y 406 Purchase - Invoice

52 Purchase Credit Memo Y N N/A

140 Posted Purchase Credit Memo Y Y 407 Purchase - Credit Memo

6650 Posted Return Shipment Y Y 6636 Purchase - Return Shipment

6640 Purchase Return Order Y Y 6641 Return Order

136 Posted Purchase Receipt Y Y 408 Purchase - Receipt

*SQL Reporting Services only

7. Appendix B

For information on performing other activities such as Security Hardening, System Backup and Restore or

performing an uninstall of Zetadocs please see the installation notes page on our website for more details.