diff --git a/src/.vuepress/public/.attachments/applications/Controls/emailpickercontrolshared.png b/src/.vuepress/public/.attachments/applications/Controls/emailpickercontrolshared.png new file mode 100644 index 000000000..6fa650f90 Binary files /dev/null and b/src/.vuepress/public/.attachments/applications/Controls/emailpickercontrolshared.png differ diff --git a/src/en/developer-guide/applications/controls/emailpicker.md b/src/en/developer-guide/applications/controls/emailpicker.md index b6ff15bc8..00b398c2b 100644 --- a/src/en/developer-guide/applications/controls/emailpicker.md +++ b/src/en/developer-guide/applications/controls/emailpicker.md @@ -1,31 +1,222 @@ --- -Author: Jan Losenicky +Author: Safija Hubljar --- # Email Picker -# Visual Example +Provides features that extend the native Email field control. This includes checking the format of the entered email and also provides an optional verification feature. If verification is enabled, the control will check whether the entered email is verified and the verification status will be displayed directly in the control. Additionally, the control allows the user to initiate the verification process directly through the control if the email is not verified. -![Email Picker Displayed On Form](/.attachments/applications/Controls/emailpickercontrol.png) +![Email Picker Displayed On Form](/.attachments/applications/Controls/emailpickercontrolshared.png) -# Description -This control is used to enter an emails in field. It is checking the format of email and also there is a function to verify the email. +## Bindings -![Email Picker Displayed On Form](/.attachments/applications/Controls/emailpickerverifying.png) + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Property NameDescriptionOf TypeInputOutputUsageRequired
dataBinding field containing array of e-mail objects. +

SingleLine.Text

+
+

[ + { +
+ "asyncJobInstanceId": null, +
+ "status": "unverified", +
+ "verifiedOn": null +
+ "lastVerifiedEmail":"test_test@hotmail.com" + } +] +

+

[{"email":"test@hotmail.com",
"status":"unverified"}]

+

undefiend

boundtrue
entityName

Entity name of the record the EmailPicker is on. Required if verification feature is on.

SingleLine.Text + account + N/Ainputfalse
recordIdPrimary key of the record the EmailPicker is on. Required if verification feature is on.SingleLine.Text + 5b34e4fd-a937-ef11-8409-0022489d8923 + N/Ainputfalse
contactSuggestionFetchXmlFetchXml that will replace default for filtering contact email suggestions.SingleLine.Text +

<fetch> + <entity name="contact"> + <attribute name="firstname" /> + <attribute name="lastname" /> + <attribute name="emailaddress1" /> + <filter> + <condition attribute="emailaddress1" operator="like" value="{{text}}%" /> + </filter> + <link-entity name="talxis_connection" from="talxis_record1id" to="contactid"> + <attribute name="talxis_record1id" /> + <filter type="and"> + <condition attribute="talxis_interceptor_placeholder" operator="ne" value="$contactsInAccount$" /> + </filter> + </link-entity> + </entity> +</fetch>

+
N/Ainputfalse
accountSuggestionFetchXmlFetchXml that will replace default for filtering account email suggestions.SingleLine.Text +

<fetch> + <entity name="account"> + <attribute name="emailaddress1"/> + <attribute name="name"/> + <filter> + <condition attribute="emailaddress1" operator="like" value="{{text}}%"/> + </filter> + <order attribute="emailaddress1"/> + </entity> +</fetch>

+
N/Ainputtrue
minEmailCountField that represents the number of required emails.Whole.None +

2

+
N/Ainputfalse
maxEmailCountField that represents the maximum number of emails that can be inputted.Whole.None +

5

+
N/Ainputfalse
minVerifiedCountField that represents the number of emails required to be verifiedWhole.None + 3

+
N/Ainputfalse
verificationFeatureEnable the functionality for verification email. +

Enum

0

+

1

N/Ainputtrue
emailEditEnable the email editing.Enum +

0

+ 1

+
N/Ainputfalse
emailSuggestionsEnable suggest emails from existing accounts and contacts.Enum +

false

+ true

+
N/Ainputfalse
clickToCopyEnabledEnable click to copy button.Enum +

false

+ true

+
N/Ainputfalse
plainEmailBinding field returning first email from `E-mail Data Field` in plain text.

SingleLine.Email

+

SingleLine.Text

+
+

test@hotmail.com

+
test@hotmail.comboundfalse
-# Binding Field +## Changelog -Control can be binded to any field on form of type SingleLine.Text. - -# Inputs - -- Min Mail Count - Minimum of emails imputed -- Max Mail Count - Maximum of emails that can be imputed -- Verification Feature - - Disabled (default) - - Enabled - -Using Verifying -- Entity Name - Entity name of the record the EmailPicker is on. Required if verification feature is enabled. -- Record Id - Primary key of the record the EmailPicker is on. Required if verification feature is enabled. \ No newline at end of file +

2024-08-16

+

Changed

+ \ No newline at end of file