Ihrer Erweiterung QuickInfos hinzufügen

Abgeschlossen

Auch optimal gestaltete Benutzeroberflächen können zu Verständnisproblemen führen. Was genau Benutzer verwirrend finden, ist schwierig vorherzusagen. Aus diesem Grund enthält die Basisanwendung QuickInfos für alle Steuerelemente und Aktionen.

Über die QuickInfo-Eigenschaft wird festgelegt, ob QuickInfos für das angegebene Steuerelement bereitgestellt werden, z. B. ein Feld oder eine Aktion. Im Client werden QuickInfos angezeigt, wenn Sie auf die Beschriftung des Steuerelements zeigen.

Die QuickInfo-Eigenschaft muss folgendermaßen festgelegt werden:

  • Aktionen auf dem Menüband

  • Felder auf Seiten

  • Infoboxen

  • Aktivitätsschaltflächen

  • Aktionscontainer

Das Benutzerunterstützungsmodell für Business Central basiert auf den folgenden Prinzipien:

  • Los geht's – Standardwerte und Setup-Assistenten erleichtern den Einstieg in Business Central mit eigenen Daten. Im Produkt enthaltene Videos bieten neuen Benutzern eine kurze Einführung in die Funktionsweise des Produkts. Startseiten ermöglichen den schnellen Zugriff auf wichtige Aufgaben, sodass jeder Benutzer an jedem Tag mit seiner Arbeit starten kann.

  • Antworten auf Fragen – Die eingebettete Benutzerunterstützung, die als QuickInfo implementiert ist, beantwortet die häufigsten Fragen zu Feldern und Aktionen.

  • Mehr erfahren – Das Hilfe-Menü und die QuickInfos bieten über kontextbezogene Links Zugang zu Hilfeartikeln mit weiteren Informationen.

Apps, Erweiterungen und Anpassungen sollten demselben Modell folgen, indem sie QuickInfos auf Steuerelemente für Seitenobjekte anwenden und funktionsrelevante Hilfelinks bereitstellen.

Die Erweiterung Kundenbelohnungen enthält festgelegte QuickInfos in den Seiten‑ und Seitenerweiterungsobjekten, die in den vorherigen Modulen erstellt wurden.

Stellen Sie anhand der folgenden Codebeispiele sicher, dass Sie die QuickInfos festgelegt haben:

  • Seite Reward Level List:

    layout
    {
        area(content)
        {
            repeater(Group)
            {
                field(Level; Rec.Level)
                {
                    ApplicationArea = All;
                    Tooltip = 'Specifies the level of reward that the customer has at this point.';
                }
    
                field("Minimum Reward Points"; Rec."Minimum Reward Points")
                {
                    ApplicationArea = All;
                    Tooltip = 'Specifies the number of points that customers must have to reach this level.';
                }
            }
        }
    }
    
  • Seitenerweiterung Debitorenkartenerw.:

    layout 
    { 
        addafter(Name) 
        { 
            field(RewardLevel; RewardLevel) 
            { 
                ApplicationArea = All; 
                Caption = 'Reward Level'; 
                Description = 'Reward level of the customer.'; 
                ToolTip = 'Specifies the level of reward that the customer has at this point.';
                Editable = false; 
            } 
    
            field(RewardPoints; Rec.RewardPoints) 
            { 
                ApplicationArea = All; 
                Caption = 'Reward Points'; 
                Description = 'Reward points accrued by customer'; 
                ToolTip = 'Specifies the total number of points that the customer has at this point.';
                Editable = false;
            }
        }
    }
    
  • Seitenerweiterung Debitorenlistenerw.:

            action("Reward Levels")
            {
                ApplicationArea = All;
                Image = CustomerRating;
                Promoted = true;
                PromotedCategory = Process;
                PromotedIsBig = true;
                ToolTip = 'Open the list of reward levels.';
    
                trigger OnAction();
                var
                    CustomerRewardsExtMgt: Codeunit "Customer Rewards Ext Mgt";
                begin
                    if CustomerRewardsExtMgt.IsCustomerRewardsActivated() then
                        CustomerRewardsExtMgt.OpenRewardsLevelPage()
                    else
                        CustomerRewardsExtMgt.OpenCustomerRewardsWizard();
                end;
            } 
    

Das Benutzerunterstützungsmodell von Microsoft erfordert eine QuickInfo für alle Steuerelemente vom Typ „Aktion“ und „Feld“, die in Seitenobjekten vorhanden sind.

Befolgen Sie beim Erstellen von QuickInfos für Steuerelemente folgende Richtlinien:

  • Wenn das Steuerelement ein Feld ist, beginnen Sie mit dem Verb Gibt an.

  • Wenn das Steuerelement eine Aktion ist, beginnen Sie mit einem Verb im Imperativ, z. B. Berechnen oder Anzeigen.

  • Geben Sie die nützlichsten Informationen an, die Benutzer brauchen, um die von dem Feld oder der Aktion unterstützte(n) Aufgabe(n) auszuführen.

  • Stellen Sie die Relevanz sicher. Geben Sie für die Aktion Buchen z. B. nicht Beleg buchen ein. Geben Sie stattdessen Sachkonten mit den Beträgen und Mengen in den Belegs‑ oder Buchungsblattzeilen aktualisieren ein.

  • Beschreiben Sie komplexe Optionen in QuickInfos für Optionsfelder.

  • Verwenden Sie einen Doppelpunkt, um den Optionsnamen und seine Beschreibung aufzurufen.

  • Beschränken Sie sich auf 200 Zeichen einschließlich Leerzeichen. Dieser Ansatz vereinfacht die Überprüfung der QuickInfo, sodass die Verständnisprobleme der Benutzer schneller gelöst werden können. Die Benutzeroberfläche rendert jedoch einen längeren QuickInfo-Text, wenn Sie eine detailliertere Benutzerunterstützung bereitstellen möchten.

  • Vermeiden Sie Zeilenumbrüche im QuickInfo-Text.

  • Die Benutzeroberfläche kann keine Formatierungen oder Zeilenumbrüche in QuickInfos rendern.