Hier finden Sie Information zur Konfiguration und Problemlösung rund um die primedocs-AddIns für Microsoft Office.

...

...

primedocs-Ribbon verschieben

Der primedocs-Ribbon in Microsoft Office positioniert sich immer an der ersten Stelle.

Möchte man dieses Verhalten anpassen , so müssen in gibt es zwei Varianten.

Über die Registry:

In der Registry unter HKEY_LOCAL_MACHINE\SOFTWARE\PrimeSoft AG\PrimeDocs, HKEY_CURRENT_USER\SOFTWARE\PrimeSoft AG\PrimeDocs oder HKEY_CURRENT_USER\SOFTWARE\Policies\PrimeSoft AG\PrimeDocs , je nach eingesetzten Modulen, folgende Registry-Schlüssel geändert werdensetzen:

"AddinWordRibbonPosition"=""
"AddinOutlookRibbonPosition"=""
"AddinCommonWordRibbonPosition"=""
"AddinCommonPowerPointRibbonPosition"=""
"AddinCommonExcelRibbonPosition"=""

Die Standardeinstellung, die in primedocs implizit angewendet wird, ist:

"AddinWordRibbonPosition"="TabHome"

Möchte man, dass der primedocs-Ribbon ganz am Ende steht, muss der Wert leer ("") gelassen werden. Wird TabInsert eingesetzt, wird der primedocs-Ribbon vor den angegebenen Ribbon gesetzt. Eine Übersicht der verfügbaren Tabs befindet sich hier .

Über die MSI-Parameter:

Diese Einstellungen können auch direkt bei der Installation angegeben werden.
Achtung: Um den primedocs-Ribbon ganz am Ende stehen zu lassen, muss der Wert ein (Leerschlag) enthalten. Siehe hierfür Client-Installation.

...

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:

1. Office schliessen

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

3. Folgende Datei in das Verzeichnis einfügen:

Gleiches gilt für alle anderen Office-AddIns. Mehr Informationen zu dieser Office-Funktionalität zum Anpassen des Menübandes finden Sie unter folgenden Webseiten:

...

Via Registry-Schlüssel können primedocs-Ribbon-Elemente einzeln deaktiviert werden. Folgende Schlüssel steuern dies hier im Beispiel für Word:

[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.

...

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öglich.

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

Systemweite Deaktivierung der AddIns

Um das AddIn zu deaktivieren, muss der Schlüssel wie folgt konfiguriert werden:

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

Benutzerabhängige Aktivierung der AddIns

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

1. Auf HKEY_LOCAL_MACHINE-Ebene, den Standard-Eintrag des LoadBehavior auf 3 lassen. Somit ist das primedocs-AddIn für alle Benutzer erstmal aktiv.

2. GPP erstellen, die via GPP-Update den Pfad und alle neuen benötigten Unterschlüssel anlegt: HKEY_CURRENT_USER\Software\Microsoft\Office\Word\Addins\OneOffixx.Word.Addin (Prio 1 in der GPP)

3. GPP erweitern, die via GPP-Update einen neuen 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)

4. Überprüfen, dass der Pfad HKEY_CURRENT_USER\Software\Wow6432Node\Microsoft\Office\Word\Addins\PrimeDocs.Word.Addin keine Unterschlüssel oder Werte besitzt.

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 aufzunehmen.

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 Microsoft.

Sicherheitseinstellungen: "RestrictToList"

Ist in der Umgebung über die 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:

Office 2016:

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

Das 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.

Sicherheitseinstellungen: "AdminSecurityMode"

Aktiviert man die Group-Policy-Sicherheitsrichtlinien über den AdminSecurityMode-Key, müssen folgende Optionen gewählt werden, um primedocs vollständig nutzen zu können:

[HKEY_CURRENT_USER\Software\Policies\Microsoft\office\16.0\outlook\security]
"AdminSecurityMode"=dword:00000003
"PromptOOMAddressBookAccess"=dword:00000003
"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.

...

Trust Center Einstellungen

Über die "Trust Center - Zugriffsschutzeinstellung" kann Word bzw. Outlook einen für die Verwendung von primedocs essentiellen programmatischen Zugriff verhindern. Folgende Optionen dürfen nicht aktiviert werden, da ansonsten der Zugriff vom primedocs-AddIn nicht funktioniert:

• Dokumente und Vorlagen im Format Word 2007 und später

  • Falls diese Option aktiviert ist, können keine Textbausteine verwendet werden oder Outlook Emails werden leer erstellt.

• Webseiten

  • Falls diese Option aktiviert ist, kann die Signatur nicht bei einem Profil- oder Empfängerwechsel geändert werden und eine leere Signatur wird eingefügt.

...

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.

Fehler bei Nutzung von Outlook E-Mail-Vorlagen

Kommt die Fehlermeldung “Das System kann die angegebene Datei nicht finden.“ während der Generierung von Outlook E-Mail Vorlagen, ist eventuell die Microsoft Office Installation defekt und muss repariert werden. Diese Fehlermeldung kann auftreten, wenn der Registry-Schlüssel HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\OUTLOOK.EXE fehlt oder unvollständig ist. Zur Behebung führen Sie eine Reparatur von Microsoft Office durch (siehe auch die Microsoft Dokumentation).

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.

Ausführung "Native Image Generator" (ngen):

Der Prozess ngen.exe befindet sich unter diesem Pfad: C:\Windows\Microsoft.NET\Framework\v4.0.30319\ngen.exe. Über "display" kann der Status geprüft werden, das sieht so aus:

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)\primedocs\primedocs.exe

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

Native Images:

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

Sollte primedocs als "pending" aufgeführt werden, sollte der Kompilierungsvorgang über "update" nochmals gestartet werden:

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

Dies wirkt sich positiv auf das Laden des AddIns aus.

Anti-Viren Lösung

Anti-Viren-Lösungen können ebenfalls die Performance beeinträchtigen. Hinterlegen Sie nach Möglichkeit als Ausnahme das Installationsverzeichnis und das Cache-Verzeichnis (Standardmässig %APPDATA%/primedocs).

Microsoft Defender Performance Analyzer

Es wird empfohlen, für Benutzer des Microsoft Defender eine Ausnahme für das Installationsverzeichnis sowie das Cache-Verzeichnis zu hinterlegen.
Microsoft bietet zudem einen Performance Analyzer für den Defender an, der dabei hilft, Performanceprobleme leichter nachzuvollziehen.

Verwenden Sie diesen Befehl um ein “Recording” zu starten:

New-MpPerformanceRecording -RecordTo recording.etl

Starten Sie danach das jeweilige Programm und beenden das “Recording”.

Mit dem folgenden Befehl können Sie eine CSV-Liste der Dateien generieren, die der Defender gescannt hat, sowie die dafür benötigte Zeit:
Idealerweise sollte in dieser Liste keine Datei aus dem primedocs-Installationsverzeichnis auftauchen.

(Get-MpPerformanceReport -Path .\recording.etl -Topscans 1000).TopScans | Export-CSV -Path .\recording.csv -Encoding UTF8 -NoTypeInformation