Freigeben über

Referenzinformationen zur E-Mail-Bildschirmvorlage in Canvas-Apps

  • Artikel

Für Canvas-Apps in Power Apps verstehen Sie, wie jedes wichtige Steuerelement in der E-Mail-Bildschirmvorlage zur allgemeinen Standardfunktionalität des Bildschirms beiträgt. Diese Vertiefung zeigt die Verhaltensformeln und die Werte anderer Eigenschaften, die bestimmen, wie die Steuerelemente auf Benutzereingaben reagieren. Eine allgemeine Beschreibung der Standardfunktionen dieses Bildschirms finden Sie in der E-Mail-Bildschirmübersicht.

Dieses Thema hebt einige wichtige Steuerelemente hervor und erklärt die Ausdrücke oder Formeln, denen verschiedene Eigenschaften (wie Element und OnSelect) dieser Steuerelemente eingestellt sind:

Voraussetzung

Vertrautheit mit dem Hinzufügen und Konfigurieren von Bildschirmen und anderen Steuerelementen Erstellen Sie eine App in Power Apps.

Textsuchfeld

TextSearchBox-Steuerelement

Einige andere Steuerelemente auf dem Bildschirm sind abhängig vom Steuerelement Text search box:

  • Wenn ein Benutzer anfängt, Text einzugeben, wird PeopleBrowseGallery angezeigt.
  • Wenn ein Benutzer eine gültige E-Mail-Adresse eingibt, wird AddIcon angezeigt.
  • Wenn ein Benutzer eine Person innerhalb von PeopleBrowseGallery auswählt, werden die Suchinhalte zurückgesetzt.

Symbol für „Hinzufügen“

AddIcon-Steuerelement

Mit dem Steuerelement Add icon können App-Benutzer Personen, die nicht in ihrer Organisation vorhanden sind, zur Empfängerliste der zu erstellenden E-Mail hinzufügen.

  • Eigenschaft Visible
    Wert: Logik, um das Steuerelement nur anzuzeigen, wenn ein Benutzer eine gültige E-Mail-Adresse in das Suchfeld eingibt:

    !IsBlank( TextSearchBox.Text ) &&
    IsMatch( TextSearchBox.Text, Match.Email ) &&
    Not( Trim( TextSearchBox.Text ) in MyPeople.UserPrincipalName )

    Zeile für Zeile sagt der vorhergehende Codeblock, dass das Steuerelement Add icon nur sichtbar ist, wenn:

    • TextSearchBox Text enthält.
    • Der Text in TextSearchBox ist eine gültige E-Mail-Adresse.
    • Der Text in TextSearchBoxexistiert noch nicht in der Sammlung MyPeople.

  • Eigenschaft OnSelect
    Wert: Wenn Sie dies auswählen, wird die gültige E-Mail-Adresse zur Sammlung MyPeople hinzugefügt. Diese Sammlung wird vom Bildschirm als Empfängerliste verwendet:

    Collect( MyPeople,
    { 
        DisplayName: TextSearchBox.Text, 
        UserPrincipalName: TextSearchBox.Text, 
        Mail: TextSearchBox.Text
    }
);
Reset( TextSearchBox )

    Dieser Codeblock fügt der Sammlung MyPeople eine Zeile hinzu und füllt drei Felder mit dem Text in TextSearchBox. Diese drei Felder sind DisplayName, UserPrincipalName und Mail. Anschließend wird der Inhalt von TextSearchBox zurückgesetzt.

Katalog zum Durchsuchen von Mitarbeitern

PeopleBrowseGallery-Steuerelement

  • Eigenschaft: Items
    Wert: Die 15 häufigsten Suchergebnisse des in das Steuerelement TextSearchBox eingegebenen Suchtextes:

    If( !IsBlank( Trim(TextSearchBox.Text ) ), 
    'Office365Users'.SearchUser( {searchTerm: Trim( TextSearchBox.Text ), top: 15} )
)

    Die Elemente dieses Katalogs werden mit Suchergebnissen aus dem Office365.SearchUser-Vorgang gefüllt. Der Vorgang nimmt den Text in Trim(TextSearchBox) als Suchbegriff auf und gibt die Top 15-Ergebnisse basierend auf dieser Suche zurück.

    TextSearchBox ist eingebunden in einer Trim()-Funktion, weil eine Benutzersuche nach Leerzeichen nicht gültig ist. Der Vorgang Office365Users.SearchUser ist in eine Funktion If(!IsBlank(Trim(TextSearchBox.Text)) ... ) eingebunden, was bedeutet, dass der Vorgang nur ausgeführt wird, wenn das Suchfeld vom Benutzer eingegebenen Text enthält. Dies verbessert die Leistung.

Leute durchsuchen Galerie Titelsteuerung

PeopleBrowseGallery-Titelsteuerung

  • Eigenschaft: Text
    Wert: ThisItem.DisplayName

    Zeigt den Anzeigenamen der Person aus ihrem Office 365-Profil an.

  • Eigenschaft OnSelect
    Wert: Code zum Hinzufügen des Benutzers zu einer Sammlung auf App-Ebene, und wählt dann den Benutzer aus:

    Concurrent(
    Set( _selectedUser, ThisItem ),
    Reset( TextSearchBox ),
    If( Not( ThisItem.UserPrincipalName in MyPeople.UserPrincipalName ), 
        Collect( MyPeople, ThisItem )
    )
)

Wenn Sie dieses Steuerelement auswählen, werden drei Dinge gleichzeitig ausgeführt:

  • Legt die Variable _selectedUser auf das ausgewählte Element fest.
  • Setzt den Suchbegriff in TextSearchBox zurück.
  • Fügt das ausgewählte Element zur Sammlung MyPeople hinzu, eine Sammlung aller ausgewählten Benutzer, die der E-Mail-Bildschirm als Gruppe von Empfängern verwendet.

EmailPeopleGallery-Steuerelement

  • Eigenschaft: Items
    Wert: MyPeople

    Dies ist die Sammlung von Personen, die durch Auswahl von PeopleBrowseGallery-Titelsteuerung initialisiert oder ergänzt wurden.

  • Eigenschaft: Height
    Wert: Logik zum Festlegen der Höhe basierend auf der Anzahl der aktuell im Katalog befindlichen Elemente:

    Min( 
    ( EmailPeopleGallery.TemplateHeight + EmailPeopleGallery.TemplatePadding * 2) *
        RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0 ),
    304
)

    Die Höhe dieses Katalogs richtet sich nach der Anzahl der Elemente im Katalog mit einer maximalen Höhe von 304.

    Er verwendet TemplateHeight + TemplatePadding * 2 als die Gesamthöhe einer einzelnen Reihe von EmailPeopleGallery und multipliziert sie dann mit der Anzahl der Zeilen. Seit WrapCount = 2 ist die Anzahl der wahren Zeilen RoundUp(CountRows(EmailPeopleGallery.AllItems) / 2, 0).

  • Eigenschaft: ShowScrollbar
    Wert: EmailPeopleGallery.Height >= 304

    Wenn die Höhe der Galerie 304 erreicht, ist die Scrollleiste sichtbar.

EmailPeopleGallery-Titelsteuerung

  • Eigenschaft OnSelect
    Wert: Set(_selectedUser, ThisItem)

    Legt die Variable _selectedUser auf das in EmailPeopleGallery ausgewählte Element fest.

MonthDayGallery-Titelsteuerung

  • Eigenschaft OnSelect
    Wert: Remove( MyPeople, LookUp( MyPeople, UserPrincipalName = ThisItem.UserPrincipalName ) )

    Schlägt die Aufzeichnung in der Sammlung MyPeople nach, wo UserPrincipalName zum UserPrincipalName des ausgewählten Elements passt und entfernt diesen Datensatz aus der Sammlung.

E-Mail-Symbol

  • Eigenschaft OnSelect
    Wert: Logik zum Senden der E-Mail-Nachricht des Benutzers:

    Set( _emailRecipientString, Concat( MyPeople, Mail & ";" ) );
'Office365'.SendEmail( _emailRecipientString, 
    TextEmailSubject.Text,  
    TextEmailMessage.Text, 
    { Importance:"Normal" }
);
Reset( TextEmailSubject );
Reset( TextEmailMessage );
Clear( MyPeople )

    Das Senden einer E-Mail-Nachricht erfordert eine durch Semikolons getrennte Zeichenfolge von E-Mail-Adressen. Im obigen Code:

    1. Die erste Codezeile enthält das Feld Post aus allen Zeilen in der Sammlung MyPeople, verkettet sie zu einer einzigen Folge von E-Mail-Adressen, die durch Semikolons getrennt sind, und legt die Variable _emailRecipientString auf diesen Zeichenfolgenwert fest.

    2. Der Vorgang Office365.SendEmail wird dann zum Senden der E-Mail an die Empfänger verwendet. Der Vorgang hat drei erforderliche Parameter: An, Betreff und Textkörper und ein optionaler Parameter--Bedeutung. Im vorhergehenden Code sind dies _emailRecipientString, TextEmailSubject.Text, TextEmailMessage.Text und Normal.

    3. Schließlich werden die Steuerelemente TextEmailSubject und TextEmailMessage zurückgesetzt und die Sammlung MyPeople gelöscht.

  • Eigenschaft: DisplayMode
    Wert: If( Len( Trim( TextEmailSubject.Text ) ) > 0 && !IsEmpty( MyPeople ), DisplayMode.Edit, DisplayMode.Disabled ) Damit eine E-Mail gesendet werden kann, muss die Betreffzeile der E-Mail Text enthalten und die Empfängersammlung (MyPeople) darf nicht leer sein.

Nächste Schritte

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).