Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Hier finden Sie Information zur Konfiguration und Problemlösung rund um die primedocs-AddIns für Microsoft Office.Here you can find configuration and troubleshooting information about the primedocs add-ins for Microsoft Office

...

Table of Contents
minLevel1
maxLevel7

...

Move primedocs

...

ribbon

Der The primedocs -Ribbon ribbon in Microsoft Office positioniert sich immer an der ersten Stelle. Möchte man dieses Verhalten anpassen, so müssen in der Registry unter is always placed at the first position. If you want to adjust this behavior, the following registry keys must be set in the registry under HKEY_LOCAL_MACHINE\SOFTWARE\PrimeSoft AG\PrimeDocs, je nach eingesetzten Modulen, folgende Registry-Schlüssel geändert werden HKEY_CURRENT_USER\SOFTWARE\PrimeSoft AG\PrimeDocs or HKEY_CURRENT_USER\SOFTWARE\Policies\PrimeSoft AG\PrimeDocs, depending on the modules used:

Code Block
languagexml
"AddinWordRibbonPosition"=""
"AddinOutlookRibbonPosition"=""

...


"AddinCommonWordRibbonPosition"=""
"AddinCommonPowerPointRibbonPosition"=""
"AddinCommonExcelRibbonPosition"=""

The default setting implicitly applied in primedocs is:

Code Block
languagexml
"AddinWordRibbonPosition"="TabHome"

Möchte man, dass der primedocs-Ribbon ganz am Ende steht, muss der Wert leer If you want the primedocs ribbon to be at the very end, the value must be left empty ("") gelassen werden. Wird If TabInsert eingesetzt is used, wird der primedocs-Ribbon vor den angegebenen Ribbon gesetzt. Eine Übersicht der verfügbaren Tabs befindet sich hier.

primedocs-Button verschieben

Mithilfe des primedocs-Buttons in Microsoft Office kann das Client-Fenster in den Vordergrund gerückt werden. Er befindet sich im jeweiligen Office-Programm in primedocs sowie im Start-Ribbon ganz links. Im Moment ist es nicht möglich, den Button mittels primedocs-Einstellungen oder Registry-Anpassungen automatisiert bzw. gesteuert zu verschieben. Eine Option ist es jedoch, die Anpassungsmöglichkeiten von Office zu nutzen und den Button so nach ganz rechts zu verschieben:

...

Office schliessen

...

Die Datei Word.officeUI unter %localappdata%\Microsoft\Office umbenennen.

...

the primedocs ribbon will be placed before the specified ribbon. An overview of the available tabs can be found here.

...

Move primedocs button

The primedocs button in Microsoft Office can be used to bring the client window to the foreground. It is located in the respective Office program in primedocs as well as in the Start ribbon on the far left. At the moment it is not possible to move the button automatically or controlled by primedocs settings or registry adjustments. One option, however, is to use Office's customization options to move the button to the far right:

  1. Close Microsoft Office.

  2. Rename the file Word.officeUI in %localappdata%\Microsoft\Office.

  3. Insert the following file into the directory: Word.officeUI

View file
nameWord.officeUI

Gleiches gilt für alle anderen Office-AddIns. Mehr Informationen zu dieser Office-Funktionalität zum Anpassen des Menübandes finden Sie unter folgenden WebseitenThe same applies to all other Office add-ins. More information about this Office functionality to customize the ribbon can be found at the following websites:

...

Hide primedocs

...

elements

Via Registry-Schlüssel können primedocs-Ribbon-Elemente einzeln deaktiviert werden. Folgende Schlüssel steuern dies hier im Beispiel für Wordregistry keys primedocs ribbon elements can be disabled individually. In the following example for Word this is controlled by these keys:

Code Block
languagepowershell
[HKEY_CURRENT_USER\Software\Policies\PrimeSoft AG\primedocs]
"AddinWordHiddenRibbonElements"="ElementId1,ElementId2"

[HKEY_CURRENT_USER\Software\PrimeSoft AG\primedocs]
"AddinWordHiddenRibbonElements"="ElementId1,ElementId2"

[HKEY_LOCAL_MACHINE\Software\PrimeSoft AG\primedocs]
"AddinWordHiddenRibbonElements"="ElementId1,ElementId2"

Wenn mehrere Schlüssel definiert sind, ist obige Reihenfolge entscheidend und es wird immer nur genau ein Schlüssel beachtet. Für Word wird AddinWordHiddenRibbonElements verwendet, für Outlook analog AddinOutlookHiddenRibbonElements. Die einzelnen Elemente können mittels Komma oder Leerzeichen getrennt werden. Eine Liste mit allen Element-IDs für Word und Outlook finden Sie hier.

HINWEIS
Die AddIns laden die Werte aus der Registry jeweils beim Starten. Um Änderungen zu übernehmen, müssen daher alle Office-Applikationen neugestartet werden.

AddIn Startverhalten konfigurieren

Die Office-AddIns von primedocs können auch deaktiviert werden. Das ist häufig auf Terminalserver-Umgebungen notwendig, wenn nicht alle Benutzer primedocs sehen sollen. Der folgende Abschnitt enthält die notwendige Konfiguration für das Word AddIn, die gleichen Einstellungen sind mit den entsprechenden Registry Pfaden auch für Outlook möglichIf multiple keys are defined, the above order is determining whereas only exactly one key is observed at a time. For Word AddinWordHiddenRibbonElements is used, for Outlook AddinOutlookHiddenRibbonElements accordingly. The single elements can be separated by comma or space. A list with all element IDs for Word and Outlook can be found here.

HINWEIS
The add-ins load the values from the registry each time they are started. Therefore, to apply changes, all Office applications must be restarted.

...

Add-in startup configuration

The primedocs Office addins can be disabled if required. Usually, that is necessary at terminal server environments when not all users should see primedocs. The following chapter contains the necessary settings for disabling the Word AddIn, the same settings with apropriate paths apply to the Outlook Addin, too.

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#FFEBE6

ACHTUNG
Dies hat keinerlei Einfluss auf Berechtigungen. Hiermit wird nur das AddIn-Ladeverhalten über den Key LoadBehavior gesteuert.

Ein LoadBehavior mit Wert 3 bedeutet: AddIn immer laden. 0 bedeutet, dass das AddIn nicht geladen wird.

Systemweite Deaktivierung der AddIns:

...

CAUTION
This has no influence on permissions. It only controls the add-ins load behavior via the LoadBehavior key.

A LoadBehavior with value 3 means: always load add-in. 0 means that the add-in is not loaded.

System-wide add-in deactivation

To disable the add-in, the key must be configured as follows:

Code Block
languagepowershell
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Word\AddIns\PrimeDocs.Word.Addin]    
"LoadBehavior"="0" 

HINWEIS
Falls ein NOTE
When running a 32-bit - Office auf einem on 64-bit - Windows läuft, dann sind die Schlüssel unter folgendem Pfad zu finden, the keys can be found at this path: HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\...

Benutzerabhängige Aktivierung der AddIns:

Möchte man das AddIn nur für bestimmte Benutzer aktivieren, geht man wie folgt vor:

...

User-based add-in deactivation

Should you want to disable the add-in only for a certain user or group of users, follow these steps:

  1. At the HKEY_LOCAL_MACHINE-Ebene, den Standard-Eintrag des LoadBehavior auf 3 lassen. Somit ist das primedocs-AddIn für alle Benutzer erstmal aktiv.GPP erstellen, die via GPP-Update den Pfad und alle neuen benötigten Unterschlüssel anlegt branch, keep the default configuration for LoadBehavior at 3. That enables the primedocs add-in for all users.

  2. Create a new GPP, which writes the following path and all necessary keys: HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\OneOffixxprimedocs.Word.Addin (Prio GPP rule 1 in der GPP)

  3. Modify the GPP erweitern, die via GPP-Update einen neuen , to create a new 32-bit -DWord-Eintrag LoadBehavior auf den Wert 0 setzt, wenn der Benutzer nicht Mitglied der gewünschten Gruppe ist (via GPP Filtering) (Prio 2 in der GPP)Überprüfen, dass der Pfad dword value named LoadBehavior with a value 0. Use GPP filtering so that the rule only applies when the desired user is not member of a defined group. (GPP rule 2)

  4. Check that the path HKEY_CURRENT_USER\Software\Wow6432Node\Microsoft\Office\Word\Addins\PrimeDocs.Word.Addin keine Unterschlüssel oder Werte besitzt does not not contain any sub keys or values.

Ergebnis:

  • Ist der Benutzer Mitglied der via Filtering gewählten Gruppe, greift die systemweite Konfiguration und das AddIn ist aktiv.

  • Ist der Benutzer nicht Mitglied der via Filtering gewählten Gruppe, wird die GPP beim Login aktiv und der Wert LoadBehavior wird auf 0 gesetzt und somit wird das AddIn beim Word-Start nicht geladen.

Outlook-AddIn Konfiguration

Outlook hat neben dem LoadBehavior Registry Schlüssel, welcher ähnlich funktioniert wie bei Word, noch weitere Einstellungsmöglichkeiten.

"Resiliency":

Outlook überwacht das Ladeverhalten von AddIns und kann diese unter Umständen automatisch deaktivieren. Um dies zu verhinden, empfiehlt es sich, das "primedocs Outlook AddIn" in die "Managed AddIn"-Liste aufzunehmenResult:

  • Is the user a member of the chosen group which gets filtered, the system-wide configuration applies and the add-in is activated.

  • Is the user not a member of the choosen group which gets filtered, the newly created GPP turns active, changes the LoadBehavior entry to 0, thus disabling the add-in when Word gets started.

...

Outlook add-in configuration

Besides the LoadBehavior registry key, which works similarly to Word, Outlook has further setting options.

Resiliency

Outlook monitors the loading behavior of add-ins and might disable them automatically. To prevent this, it is recommended to add the "primedocs Outlook Add-in" to the "Managed AddIn" list.

Code Block
languagepowershell
Office 2016:

[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\Outlook\Resiliency\AddinList]   
"PrimeDocs.Outlook.Addin"="1"

Weitere Information findet man in der Dokumentation von Further information can be found in the Documentation from Microsoft.

...

Security settings: "RestrictToList"

Ist in der Umgebung über die If the RestrictToList key is set to 1 in the environment via the Group-Policy der RestrictToList-Key auf 1, so werden nur "Managed AddIns" von Outlook geladen.Um die Funktionalität von primedocs zu gewährleisten, muss mindestens folgende Einstellung in der Registry hinterlegt sein, only "Managed Add-Ins" are loaded by Outlook.

To ensure the functionality of primedocs, at least the following setting must be stored in the registry:

Code Block
languagepowershell
Office 2016:

[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\16.0\Outlook\Resiliency\AddinList]   
"PrimeDocs.Outlook.Addin"="1"
"Microsoft.VbaAddinForOutlook.1"="2"

Das The Microsoft.VbaAddinForOutlook.1-AddIn ist eine notwendige Abhängigkeit und darf daher nicht deaktiviert sein. Mit dem Wert 2 wird das AddIn nicht geladen, aber auch nicht blockiert.

...

add-in is a necessary dependency and must therefore not be disabled. With the value 2 the add-in is not loaded, but also not blocked.

Security settings: "AdminSecurityMode"

Aktiviert man die If the Group-Policy -Sicherheitsrichtlinien über den AdminSecurityMode-Key, müssen folgende Optionen gewählt werden, um primedocs vollständig nutzen zu könnensecurity policies is enabled via the AdminSecurityMode key, the following options have to be selected to fully use primedocs:

Code Block
languagepowershell
[HKEY_CURRENT_USER\Software\Policies\Microsoft\office\16.0\outlook\security]
"AdminSecurityMode"=dword:00000003
"PromptOOMAddressBookAccess"=dword:0000000300000002
"PromptOOMAddressInformationAccess"=dword:00000003

primedocs greift unter Anderem für die Erzeugung von E-Mails oder bei der Nutzung des Adressbuchs auf Outlook zu und durch diese Einstellung wird der Zugriff nicht unterdrückt.

Andere Einstellungen, wie z. B. level für Makros, haben keinen Einfluss auf primedocs.

Troubleshooting

primedocs-AddIns in Microsoft Office starten nicht:

Falls sich die primedocs-AddIns nicht starten lassen, d. h., wenn in Office kein primedocs-Ribbon zu sehen ist, kann das folgende Ursachen haben:

  • Das primedocs-AddIn ist nicht installiert:
    Sollte das primedocs-AddIn unter "Datei – Optionen – AddIns" unter den COM-AddIns nicht auftauchen, ist es eventuell nicht installiert. Prüfen Sie, ob das entsprechende AddIn bei der Installation ausgewählt wurde.

  • Office ist in der 64-bit-Variante installiert, aber es wurde der 32-bit-primedocs-Installer benutzt:
    Sollte eine 64-bit-Office-Installation benutzt worden sein, muss auch der 64-bit-Installer von primedocs genutzt werden. Gleich verhält es sich mit der 32-bit-Office-Installation und dem 32-bit-Installer.

  • Das Outlook-AddIn ist blockiert oder wird immer deaktiviert:
    Überprüfen Sie die Sicherheitseinstellungen für Outlook.

Das Starten von Microsoft Office ist seit der Installation des primedocs-AddIns stark verzögert:

Falls Office langsam starten sollte, kann es daran liegen, dass der "Native Image Generator"-Prozess (ngen) noch nicht vollständig durchgelaufen ist. Dieser Prozess wird nach der Installation automatisch angestossen und ist ein Bestandteil des .NET Frameworks.

...

00000002

primedocs accesses Outlook for generating emails or using the address book for example. This setting does not suppress the access.

Other settings, such as level for macros, have no influence on primedocs.

...

Trust Center Settings

Via the "Trust Center - File Block Settings", Word or Outlook can prevent programmatic access which is required for primedocs. The following options must not be enabled, otherwise the access from the primedocs AddIn will not work:

  • Word 2007 and later Documents and Templates

    • If this option is enabled, no text modules can be inserted and Outlook emails are generated empty.

  • Websites

    • If this option is enabled, the signature cannot be changed when changing profiles or recipients, and a blank signature will be inserted.

In addition, the certificate used by primedocs can be added as a ‘Trusted Publisher’.
To do this, use the ‘Public Key’ from this page: Client Installation

...

Troubleshooting

primedocs add-ins in Microsoft Office do not start

If the primedocs add-ins cannot be started, i.e. if no primedocs ribbon is visible in Office, this may have the following causes:

  • The primedocs add-in is not installed:
    If the primedocs add-in does not appear under "File – Options – Add-ins" in the COM Add-ins list, it may not be installed. Check whether the respective add-in was selected during installation.

  • Office is installed in the 64-bit option, but the 32-bit primedocs installer was used:
    If a 64-bit Office installation was used, the 64-bit primedocs installer must be used as well. The same applies to the 32-bit Office installation and the 32-bit installer.

  • The Outlook add-in is blocked or always disabled:
    Check the security settings for Outlook.

Error when using Outlook e-mail templates

If the error message "The system cannot find the specified file." appears during the generation of Outlook e-mail templates, the Microsoft Office installation may be defective and must be repaired. This error message can occur if the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\OUTLOOK.EXE is missing or incomplete. To fix this, carry out a repair of Microsoft Office (see also the Microsoft Documentation).

Starting Microsoft Office is severely delayed since installing the primedocs add-in

If Office starts slowly, it may be because the "Native Image Generator" process (ngen) has not yet run completely. This process is automatically started after installation and is component of the .NET framework.

Execution "Native Image Generator" (ngen):

Der Prozess The ngen.exe befindet sich unter diesem Pfadprocess is located at this path: C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe. Über "display" kann der Status geprüft werden, das sieht so ausVia display the status can be checked. This looks like this:

Code Block
breakoutModewide
languagepowershell
C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe display "C:\Program Files (x86)\primedocs\primedocs.exe"
Microsoft (R) CLR Native Image Generator - Version 4.6.1087.0
Copyright (c) Microsoft Corporation.  All rights reserved.

NGEN Roots:

C:\Program Files (x86)\primedocs\primedocs.exe

NGEN Roots that depend on "c:\Program Files (x86)\OneOffixxprimedocs\primedocs.exe

C:\Program Files (x86)\primedocs\primedocs.exe

Native Images:

primedocs, Version=2.3.40190.0, Culture=neutral, PublicKeyToken=null

Sollte If primedocs als is shown as "pending" aufgeführt werden, sollte der Kompilierungsvorgang über , the compilation process should be started again via "update" nochmals gestartet werden:

Code Block
languagenone
C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe update

Dies wirkt sich positiv auf das Laden des AddIns aus.

Es können keine Textbausteine eingefügt werden bzw. Outlook Emails werden leer erzeugt

Über die "Trust Center - Zugriffsschutzeinstellung" kann Word bzw. Outlook einen für die Verwendung von primedocs essentiellen programmatischen Zugriff verhindern. Die Optionen bei "Dokumente und Vorlagen im Format Word 2007 und später" dürfen nicht aktiviert werden, da ansonsten der Zugriff vom primedocs-AddIn nicht funktioniert.

...

This has a positive effect on the add-in loading behaviour.

Anti virus solution

Anti virus solutions can also affect the performance. If possible, save the installation directory and the cache directory as an exception (%APPDATA%/primedocs by default).

Tip

TIP
If you have any questions or problems, we are happy to help – simply contact our support team.