From 081251bcea3fd928f8aee9490987f007e1359d21 Mon Sep 17 00:00:00 2001 From: Safija Hubljar Date: Tue, 20 Aug 2024 12:56:19 +0200 Subject: [PATCH 1/4] Docs regarding email picker --- .../Controls/emailpickercontrolshared.png | Bin 0 -> 6888 bytes .../applications/controls/emailpicker.md | 245 ++++++++++++++++-- 2 files changed, 225 insertions(+), 20 deletions(-) create mode 100644 src/.vuepress/public/.attachments/applications/Controls/emailpickercontrolshared.png 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 0000000000000000000000000000000000000000..6fa650f90c5346460319ae0a6e77465876a3b10e GIT binary patch literal 6888 zcmb7}WmFWoqqzyPC-op1EW5X=*|N7pC)iuG4#T~pkn{e!hEaEhQ`343x2Dl zpzCjXuuQB;ZnuJuu05I;&Jn`SnI#DRajE1${9Yp5lmB@auN$0;ZXw_LC!JXWHZNnL zu2#kC;jdyQjW0B5WGqq4jy^>P}a7aUz@b zG70<{llpq&NVw7Va-My@8x@?ptd?zKD-U4agx(W9zWW#XwDQS7QSw}x1k6g$Dayel zEF^@wAOI-<_XRT;0LJ=G0>S}>{maBEkY@*zglYc2=}Fvl<-u(Rkmylt%B#*ieps!z z*+XpYcu%!qb?k?NbbeN_DzFHD7xh8Y9bW+TI?eZl_08{S@`i#P%A>^7x<@DGLh?&X zHyDhR%Ja!R*vz;#z=*SnR99V^5!%%JaAH=(-W~0D*5Aey!WW+jjfmJ&Os$s%p;~&v#ci`PRYWB%6_Xqx`Xjg)2TJR zpm?I89WgDf?E(CnIVC->-{%p%xGdbY<8(idtexy%*|;6S=WVt-qbfuf3E~L9sCz(F ziz+ORIn>lOki?Jct#(wo*x&w+t9@TsvsE@{6MZ(_W%of*d?wN7`hl%S$sKkdqTv+U=qQ1wLb0HK>Z{C1w0g*?) z&#QCA-)P+S==WY4`LC`GT&?irSe5TcbdPj%f|*=Kj)h+nuUmA91$^2zpYT*7$^}pV zwhP~BDT%ZLx#@`N;(i)jsx}{CiutN>v^78qD($GpeW8@pe+b?R>3(PDFb0vWX<3Rp zQB7i*=G$cODP-|rW(*Oci0RD{_m7wvkj_=|4*z`;B1}lMXi=8-5R2q7`8+_SY#F?( zUe0%kDMw@@>a@pB3>rKW>zB8|DopNK&UTcHI?<5Sx({KbH;Bur*QRP^-K$z6!u3nx zV8a)kyV{G|EgGC>aQKld3^$QY3m?@8SfjmU?0Q&E~ENM|DNJ>8y02aaDI@@s_!|Tv;V`G2kc7j!XOVryb-rcBjTgm zpfp4Lt9iyflZUr!cl8y9jTf*7K>B;>dhhS&A03XuRHUy*+`(REt_JQDU0FIWx4=m| zZb4y=US5P9sY&y%)|8(Iyuzoh^vXZ8s=t|e-DG0&`6;DjwhDTyEMuOEtuwO!8^s`_ zUBN=7Vwp5_vb;jrU^{OPlX7A)>+p_GWqCXOMvaVeGnpM>FBX5`UY9#%=Z! z{=v_|pf zpF?HRJq-C_!(!^rH&~_{8l1#p(M}&oKe`NP{BrA0yfS&n5_3BV29pTYw?Vd{bX2+i z3{}+5An$E{bPWe#VB8%}r~ISN;O(3nIz*B51vD5}x{2Tue<$INaY#79#e^d9aq!rG z+>*nP=fq2&Wv=By0?+GyZ2iP5kSGL8j!D5S2AN|FPjib)e@m((bT!BNA6Hk4Ws|q5b?04W!LausYpH z8~Nk>853eH=Ra~X>AW5bV7?p`A)4kZ52cUly$mbA-{J~Y3!e*%ql^) z_F&xRl_Q2_^R5`ERRoRH&WSrrE1-leINp6{Voa}^xyrAgM5%_w?4A)$Q$1a[d! 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 I1(}Ec7q5d!y#N3J literal 0 HcmV?d00001 diff --git a/src/en/developer-guide/applications/controls/emailpicker.md b/src/en/developer-guide/applications/controls/emailpicker.md index b6ff15bc8..25f8dc0ad 100644 --- a/src/en/developer-guide/applications/controls/emailpicker.md +++ b/src/en/developer-guide/applications/controls/emailpicker.md @@ -1,31 +1,236 @@ --- -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, +
+ "buttons": [], +
+ "deleteButtonProps": { + "key": "remove", + "showOnlyOnHover": true, +
+ "iconProps": { +
+ iconName: "ChromeClose" + } + }, +
+ "key": "test@hotmail.com", +
+ "name": "test@hotmail.com", +
sf + "status": "unverified", +
+ "verifiedOn": null +
+ } +] +

+ 		[{"email":"test@hotmail.com",
"status":"unverified"}]		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 + accountid + 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

+
    +
  • Changed PCF to use latest shared component
    • +
\ No newline at end of file From 7fdbd6991503cc22342a2768aefc80583ceba6bf Mon Sep 17 00:00:00 2001 From: Safija Hubljar Date: Tue, 20 Aug 2024 13:05:09 +0200 Subject: [PATCH 2/4] Bug fix --- src/en/developer-guide/applications/controls/emailpicker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/en/developer-guide/applications/controls/emailpicker.md b/src/en/developer-guide/applications/controls/emailpicker.md index 25f8dc0ad..a04df3235 100644 --- a/src/en/developer-guide/applications/controls/emailpicker.md +++ b/src/en/developer-guide/applications/controls/emailpicker.md @@ -79,7 +79,7 @@ Provides features that extend the native Email field control. This includes chec Primary key of the record the EmailPicker is on. Required if verification feature is on. SingleLine.Text - accountid + 5b34e4fd-a937-ef11-8409-0022489d8923 N/A input From 3594ee2e76ec5a2d0ddf616b280d6086411b88b4 Mon Sep 17 00:00:00 2001 From: Safija Hubljar Date: Wed, 21 Aug 2024 09:38:56 +0200 Subject: [PATCH 3/4] Bug fixes --- .../applications/controls/emailpicker.md | 20 +++---------------- 1 file changed, 3 insertions(+), 17 deletions(-) diff --git a/src/en/developer-guide/applications/controls/emailpicker.md b/src/en/developer-guide/applications/controls/emailpicker.md index a04df3235..e7673274b 100644 --- a/src/en/developer-guide/applications/controls/emailpicker.md +++ b/src/en/developer-guide/applications/controls/emailpicker.md @@ -35,31 +35,17 @@ Provides features that extend the native Email field control. This includes chec
"asyncJobInstanceId": null,
- "buttons": [], -
- "deleteButtonProps": { - "key": "remove", - "showOnlyOnHover": true, -
- "iconProps": { -
- iconName: "ChromeClose" - } - }, -
- "key": "test@hotmail.com", -
- "name": "test@hotmail.com", -
sf "status": "unverified",
"verifiedOn": null
+ "lastVerifiedEmail":"test@hotmail.com" } ]

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

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

+

undefiend

bound true From fc46b0389c2585500b68f55d43d33aece441cd45 Mon Sep 17 00:00:00 2001 From: Safija Hubljar Date: Wed, 21 Aug 2024 09:44:18 +0200 Subject: [PATCH 4/4] Minor changes --- src/en/developer-guide/applications/controls/emailpicker.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/en/developer-guide/applications/controls/emailpicker.md b/src/en/developer-guide/applications/controls/emailpicker.md index e7673274b..00b398c2b 100644 --- a/src/en/developer-guide/applications/controls/emailpicker.md +++ b/src/en/developer-guide/applications/controls/emailpicker.md @@ -39,7 +39,7 @@ Provides features that extend the native Email field control. This includes chec
"verifiedOn": null
- "lastVerifiedEmail":"test@hotmail.com" + "lastVerifiedEmail":"test_test@hotmail.com" } ]