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 | ||||
---|---|---|---|---|
|
...
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 | ||
---|---|---|
| ||
"AddinWordRibbonPosition"="" "AddinOutlookRibbonPosition"="" |
...
"AddinCommonWordRibbonPosition"=""
"AddinCommonPowerPointRibbonPosition"=""
"AddinCommonExcelRibbonPosition"="" |
The default setting implicitly applied in primedocs is:
Code Block | ||
---|---|---|
| ||
"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:
Close Microsoft Office.
Rename the file Word.officeUI in %localappdata%\Microsoft\Office.
Insert the following file into the directory: Word.officeUI
View file | ||
---|---|---|
|
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:
https://www.ratzblog.com/2011/09/deploying-user-cutomizations-office.html
https://www.msoutlook.info/question/backup-ribbon-and-qat-customizations
https://docs.microsoft.com/de-de/previous-versions/office/ee704589(v=office.14)
...
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 | ||
---|---|---|
| ||
[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 | ||||||
---|---|---|---|---|---|---|
| ||||||
ACHTUNG |
Ein LoadBehavior
mit Wert 3
bedeutet: AddIn immer laden. 0
bedeutet, dass das AddIn nicht geladen wird.
Systemweite Deaktivierung der AddIns:
...
CAUTION |
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 | ||
---|---|---|
| ||
[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:
At the
HKEY_LOCAL_MACHINE
-Ebene, den Standard-Eintrag desLoadBehavior
auf3
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 forLoadBehavior
at3
. That enables the primedocs add-in for all users.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)Modify the GPP erweitern, die via GPP-Update einen neuen , to create a new 32-bit -DWord-Eintrag
LoadBehavior
auf den Wert0
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 namedLoadBehavior
with a value0
. Use GPP filtering so that the rule only applies when the desired user is not member of a defined group. (GPP rule 2)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 auf0
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 to0
, 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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
[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 | ||||
---|---|---|---|---|
| ||||
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 | ||
---|---|---|
| ||
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 |