Freigeben über

Deaktivieren Sie ggf. NavBar, wenn Sie Formulare oder Ansichten programmgesteuert öffnen

  • Artikel

Kategorie: Design, Leistung

Wirkungspotential: Mittel

Symptome

Das programmgesteuerte Öffnen von Formularen oder Ansichten mit einer URL kann zu langsamerer Clientleistung auf Latenznetzwerken führen, wenn die Navigationsleiste (NavBar) aktiviert ist.

Anleitung

Stellen Sie fest, ob Ihre Benutzer beim Erstellen von Anpassungen, mit denen Formulare oder Ansichten über eine URL geöffnet werden, über die vollständige Navigationsleiste verfügen müssen. In den meisten Fällen wählen Benutzende einen Link aus, um ein Formular zu öffnen, schnell zu arbeiten und dann den Datensatz zu schließen. Das Deaktivieren der Navigationsleiste senkt die Menge der zu ladenden Ressourcen. Dadurch wird die Anzahl der gestellten Netzwerkanforderungen gesenkt.

Implementieren Sie beim Erstellen von URLs zum Öffnen von Formularen oder Ansichten navbar=off innerhalb Ihrer Abfragezeichenfolge Parameter für die main.aspx Seite. Im folgenden Beispiel wird ein Kontoformular mit deaktivierter Navigationsleiste geöffnet.

function disableNavBar() {
    var globalContext = Xrm.Utility.getGlobalContext();
    return globalContext.getClientUrl() + "/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&etc=1&id={11112222-bbbb-3333-cccc-4444dddd5555}&pagetype=entityrecord&navbar=off";
}

Wichtig

Der navbar=off-Abfragezeichenfolgenparameter ist nur auf der main.aspx-Seite verfügbar.

Problematische Muster

Warnung

Diese Szenarien sollten vermieden werden.

Das die Navigationsleiste (NavBar) aktiviert bleibt, bedeutet nicht, dass Benutzende Leistungsprobleme bemerken. Dies bedeutet jedoch, dass mehr Ressourcen in das Formular oder die Ansicht geladen werden müssen, für die zusätzliche Netzwerkanforderungen erforderlich sind. In hochgradig latenten Netzwerken kann das Aktivieren der Navigationsleiste zu einer schlechten Benutzererfahrung führen.

Es folgt ein Beispiel einer konstruierten URL mit aktivierter NavBar

function enabledNavBar() {
    var globalContext = Xrm.Utility.getGlobalContext();
    // By default, NavBar is set to true if you do not include the parameter in the query string:
    return globalContext.getClientUrl() + "/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&etc=1&id={11112222-bbbb-3333-cccc-4444dddd5555}&pagetype=entityrecord";
}

function enabledNavBarExplicit() {
    var globalContext = Xrm.Utility.getGlobalContext();
    // Explicitly defining that the NavBar will be enabled
    return globalContext.getClientUrl() + "/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&etc=1&id={11112222-bbbb-3333-cccc-4444dddd5555}&pagetype=entityrecord&navbar=on";
}

Weitere Informationen

Wenn Sie weitere Datensätze aus den modellgesteuerten Apps öffnen, wird die Navigationsleiste mit den Bereichen und Unterbereichen geladen, die innerhalb der Siteübersicht definiert werden. Darüber hinaus wird das Office-App-Startprogramm gerendert, das die Office 365-Apps anzeigt, auf die der Benutzer Zugriff hat.
Vergleich der aktivierten und deaktivierten NavBar.

Siehe auch

Öffnen von Formularen, Ansichten, Dialogen und Berichten mit einer URL