Open Documentation Menu

Distributing the add-in for d.3one in Microsoft Outlook using Active Directory software distribution

Once you have completed the installation of d.velop documents in Microsoft Outlook, you can automatically distribute the add-in within your organization using AD software distribution.

This is how it works

  1. Create a new folder in the domain controller, e.g. <Installation path>\Software distribution.

  2. Copy the setup file for d.velop documents in Microsoft Outlook (d.3one_microsoft_outlook_integration*.msi) and add the file to the new folder.

  3. Share the folder.

  4. Give everyone read access to the folder.

You then have to create a security group with a group policy and create the new MSI package with the setup for the d.velop documents in Microsoft Outlook add-in.

If you want to install an MSI package with AD software distribution with an English-language server operating system, you must enable the switch Ignore language when deploying this package under Advanced Deployment Options.

Defining settings for d.3one using Active Directory software distribution

If you have created a group policy for AD software distribution for the add-in for a group of users, you can create a registry item for using d.velop documents.

The registry item is read out from HKEY_CURRENT_USER. If a value is unavailable, the item from HKEY_LOCAL_MACHINE is used.

Let’s assume you want to create a registry item for using d.velop documents with a latency of 30 seconds.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Hive, select the entry HKEY_CURRENT_USER or HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Value name, specify the entry ServerAddressMailSystem.

  9. Under Value type, select REG_SZ.

  10. Under Value data, specify the entry https://<d.velop documents server>|30|30 and save your entries.

Creating a security group for AD software distribution for the add-in

To distribute the MSI package software, you must create a new security group containing the users for Active Directory software distribution.

This is how it works

  1. Open Control Panel > Administrative Tools > Active Directory Users and Computers.

  2. Select the domain.

  3. Choose Action > New > Group to create a new group.

  4. Enter a name for the security group under Group name.

  5. Under Group scope, select the option Global.

  6. Under Group type, select the option Security. Save your entries.

Creating a group policy for AD software distribution for the add-in

If you have created a security group for the MSI package setup, you must define a group policy for the group in the domain controller.

This is how it works

  1. Open Control Panel > Administrative Tools > Group Policy Management.

  2. Select the domain.

  3. Select Action > Create a GPO in this domain, and link it here.

  4. Enter a name for the group policy.

  5. Select the created policy.

  6. Enter the created group under Security Filtering and save your entries.

Creating a software package for AD software distribution for the add-in

If you have created a security group and a group policy for a group of users, you must create a new software package for the MSI package setup in the Group Policy Management Editor.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Policies > Software Settings > Software Installation to select the software installation.

  4. Click Action > New > Package to add the setup. It must be possible to reference all the packages as UNC paths.

  5. Select the package and open the package properties.

  6. Go to the Software Deployment tab.

  7. Under Deployment type, select the option Assigned.

  8. Under Deployment options, select the options Uninstall this application when it falls out of the scope of management and Install this application at logon.

  9. Under Installation user interface options, select Basic.

  10. Log into the client PC again.

Enabling synchronization with the Offline Store using the AD software distribution for the add-in

If you have created a group policy for a group of users for AD software distribution for the add-in, you can use a registry item to enable the synchronization of items to be stored locally with the Offline Store. You can use the Offline Store to define a local path for the items, for example, or exclude folders from the synchronization.

To enable synchronization, create an appropriate registry item.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Tree, select the entry HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Name, enter OFFLINESTOREENABLED.

  9. Under Value type, enter REG_DWORD 1/0. Save your entries.

Synchronization is now enabled and you can set additional configurations using registry items if necessary.

See also:

Excluding Microsoft Outlook folders from synchronization with the Offline Store using the AD software distribution for the add-in

If you have created a group policy for a group of users for AD software distribution for the add-in and synchronization with the Offline Store is enabled, you can use a registry item to define Microsoft Outlook folders that you want to exclude from the synchronization with the Offline Store.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Hive, select the entry HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Name, enter OFFLINESTOREEXCLUDEFOLDERS.

  9. Under Value type, select REG_MULTI_SZ.

  10. Under Value data, enter the Microsoft Outlook folders to be excluded. Save your entries.

See also: Detailed information about the Offline Store

Defining the local path for storage with the Offline Store using the AD software distribution for the add-in

If you have created a group policy for a group of users for AD software distribution for the add-in, you can use a registry item to define a local path for the items to be stored for the Offline Store.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Hive, select the entry HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Name, enter OFFLINESTOREPATH.

  9. Under Value type, select REG_SZ.

  10. Under Value data, specify the local directory and save your entries.

See also: Detailed information about the Offline Store

Defining the maximum age of items for local storage with the Offline Store using the AD software distribution for the add-in

If you have created a group policy for AD software distribution for the add-in for a group of users, you can use a registry item to define the maximum age for items. Items that exceed this age are no longer stored locally by the Offline Store.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Hive, select the entry HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Value name, specify the entry OFFLINESTOREMAXAGE.

  9. Under Value type, select REG_DWORD.

  10. Under Value data, specify the maximum age for the items to be stored in days and save your entries.

See also: Detailed information about the Offline Store

Defining a maximum memory space limit for the Offline Store using the AD software distribution for the add-in

If you have created a group policy for AD software distribution for the add-in for a group of users, you can use a registry item to define a maximum storage limit for items on the local disk. When the limit is reached, synchronization stops.

Note

Specify the maximum storage limit in bytes. The value is displayed in MB on the configuration interface.

To define a storage limit, you create a registry item.

This is how it works

  1. Select the created group policy in Group Policy Management.

  2. Click Action > Edit to open the Group Policy Management Editor.

  3. Click User configuration > Settings > Windows Settings > Registry to select the registry.

  4. Click Action > New > Registry Item to create a new registry item.

  5. Under Action, select the entry Replace.

  6. Under Hive, select the entry HKEY_LOCAL_MACHINE.

  7. Under Key Path, specify the entry Software\d.velop\dvelop.Client.Outlook.Integration.

  8. Under Value name, specify the entry OFFLINESTOREMINFREEDISCSPACE.

  9. Under Value type, select REG_QWORD.

  10. Under Value data, specify the local directory and save your entries.

See also: Detailed information about the Offline Store