From c513d570b1c655b56d8bcad2f83675e8077a8675 Mon Sep 17 00:00:00 2001 From: Jason Woods Date: Fri, 7 Feb 2025 17:00:00 +0000 Subject: [PATCH] feat: Add documentation for new segment building status --- .../images/contact-segment-building.png | Bin 0 -> 29971 bytes docs/segments/manage_segments.rst | 58 ++++++++++-------- 2 files changed, 31 insertions(+), 27 deletions(-) create mode 100644 docs/segments/images/contact-segment-building.png diff --git a/docs/segments/images/contact-segment-building.png b/docs/segments/images/contact-segment-building.png new file mode 100644 index 0000000000000000000000000000000000000000..6ce322f27e982a9c1297352b0ac6f853a52b9607 GIT binary patch literal 29971 zcmeGERahLswmuHSFu>pwf(9ErxVsZ95FogFfB?bWJvb!6U4naXcL^Tc83^vqAOZf9 zeQfXF_ne!3^lIXx3r2k4I zSitikNT|Je`xbswGjlRGw{!kz@8X>=R}a5{<{+ozjDSEu`*%ltt4ebQf7ZN}y0(k9 z;yXbzds|kM5B8?!tRA)wf9pXI_7H?8ZOvUwARe}#?3@KXM5z9eLlB<+dzp<2@{cSo zHX>BoitizB?48UZysYf3>{O!Y5C}xr>4Sx!s+7!s7KfjSP|0DnZ&z=8y;y;zt{-2VZJiOfhT=buA{l7&uoXwry*xSON=_2|+wk~%T?{}F&M6C@rsHp=B-A|+k229R6t|xTJ8yjHh0LHBi}*Dkm=;y7awXN(Bk>Yd zOJ0Y5qfvNzt2#Fo_nz_t)?#D1$){fJfir*6iR);~lNIkB*51*~J0GK}RPUr+;a!1K z=Tqkik=;w5j*=ucBR>swJVtd88zwFU@!#44!8BhYgSx=NHlH}rz99TNThoj17r?m+ zy?I-F%eMhQxqoYu3`IZ=%ylYUQ2Mu;fr#q>5tqn8BCVwQH~Zl|rMQG~aRx&}{J+@( zQqX(w9zs~zzt?^_h&sGH5u;_~G0nf%0z^~*9#F7rgYn<&KoCB>{O93RQ=xxz5W525 zLx}Cr6!~v<;Qvj5|C<8;Ck6gb3jE(f@c-`%fvRwzIf?R6DU0QY-f_^K<*9%Go}Wr= zh|#yQ$k9Zm+ljMe@qw!nTJNMf)zbHL3P+#92b#l_t}_(D|Lgi78S{7S-3As6 z|Cco^5KkKN=Uu`(qd(cBI&S)Y2F{YKG6ru|2D6D!(*<1_tu*N4R@B(C>)NTaw!rBb zhB2`Z^sF1^)32JhCwGvyIj#r)_p0)hAVX*X*ohbe)7(+Kfp^@?v4wB;XJI~y!ba6z;HZz}2!f1ZwOHb&7Fokb;Yvc;GtwH_6468L;& z7*Yk&6UM(8kiXVeP1|C@lLswm;z9yR-a)9SB;k0BUN)BWYdpQOe5HPKzIY%&wL+I? zD2ZhmYfY$({+}^MV1k12Znqrq-J>6|&_j-X5H&<9z=|^>fBcJ6?#dB$r;`fJeH#IK z569W!jr3M?Y=3^fJj>|++t$D>dE?E27^nLytGCIlnKP9JLe1oKaZ!JV`x{Rn4K=6@ z51&P?!-(41?@qSzmf_=t+h^4xd0N<-feQJ)M{B-vm0cRA93&OIKj{;?#>#j<(3xjUW2c@cz zQBTsFgzB<2ih6BEt=AA1l4L^R8M%@dn9s%&zLFeJ_w{@qKJQ@e=GtiWDpmg6(nRx- zq@kZ*sjqF+)zve+&Z(>Y9`C1$lqnux6^SEY5U}dMetdx87>_ii`e#3=g-0lSsH^S?x}JWof6IFYPb8~&1^A5SqXlO%4L`L z1k8)9D#_mqobCV@7M(lacv;knZhOC($I}Hept=vMktDzUaJ5ac)I}eelsK7q@V1Z} zZ<<`#N4IcnDJQf)b6M+UtC4Qar{w6{-|oJwYvjKqOV!WVe1EC2`LfBzO3M{EA#bf} z>8<^8wq`VHJkP--e-ayt7mA7|SyP$Hf4kQAh6*x%nK<&T$#kJ&I4!)KmfILbott4%3hi6XUQ)#V&Fi z!pX@=Kyns*T*@Be_X{*DbX7}KXAq-q?ppWTBC5Y;5Rq zSDOuDx5uUN*vMxIpX2xqxcNWb6@6N5(O}f7WOhBAOC%M@K%Ngg6Msx*6M`zUX;o(U zWz%z$%q8Cf&vf>t3Zm@fq6k>>op;A0pv8C#LE;Z+{0Waw52rP@%e*DpKk`=m9*)0> z`9A^aiR7R`GAYNJmHH*4gsKYdUf21Oq3B*qC10N|_#J_er9O5i{88X(kO)l&6AcYp`+UxB^Am|i1hZDO`?GOGM!)lM zxBPg|C-|kO^WW0mU7E*BBG)Kv00i>&_kDE#kQ5o?8nF9};@+9{ldra5SCsuU%e3yR zMMr?Q&_NlCqysKM8%`S4ZcyUg3exr&N{d3wqk zcp{xt%=B#%b5u|z7rW1c#E*_gW!w>&#*c0XOa4{U$vn)-}Ia^Pz|e$<@Z7obiW zOa`8AyIHcixSCd8j=FYX7mmbdBB1^ju6ACJY~*)m9<-W#(SXCMObYNgU2l)uTln$a z=YGE^V)_eS%RGEGhkIoE-sq(A*d(o!E}i$iRQ~ye@=d~v=oUk4&Y*ogx8o&R7}UR$ zRM>-ElW91Cfg0-n+%9`Al_UJiC=cp_4oauY`j9US;6L?XOWT{T%5J-wQn297nePJw z$pxIGO0}vgLmL)r%;P(spY+-cWPvX4$$5Kt2BV4Rv#3iYUVR2Mi+G1M1iC z+Ea(5e5L&beD7VFceA|fHp0BkaDywnN%*s`(8{%cNVd2gGtw((MbByz_2d|N?xb3p zvh2Q_qW`iN)a9>HI<|{4hL;cXRYoHoP8dzknQ=Q3Wkp)cDw;0!yKvKE(B!uan)9b- z?ENSvmB^@JCv{!UC56U}CdRC&^~5|W%I`+IMR|i=_L`b$_PS)aSKep#GVONQD!4kY zIp2Qbvuc|hYmw<&i`A63Bj!(ewk;w!?!~N`OZpT#FUnst6G`Yo0^E+Vk~{22lk_eu z5+}s=z8tM0ZoGQf!hn{LplH!L7rJn6#G}%heLmzv3)-MKYIYa&M@?YbhRf!kZOD3c z!8F4im+}h79*0(~cTo+)DR2Gdj}Q8{W_Qy(7;#T)GKJjb;j8^-yTF0E%0M*n_PmjQ z;#7fx5Wcg1So%+>FD%n6^;XmEV1{8FYx}lg!|Pu#og6yw-ls-UW^AE~JHXo5PmuT~HyDLn)JL1J_mSko=Z{NuCGDxu zX$(SEJYl>+Kd>BwcAJOe@o#frwClmlSNo1T8HjP+=JmW$oa1~TsQS}ljh7HLqZA$b z3N_~oOq?cK2{4fn`?8czh@`s+a$tn}3E-ICVH_eDpuj?9Ii7K!#dXiepG$etw26Ip zvuq#ibc0!FFJZI-$3g;LSH*TX8SxNPZpkBDTKS*wwStIRMmksA(^yZL%9^3xRRN zyR{2eXnp}Q%~|Nh5hKMN?3HN&(X>F$YSBivlWCXpHKx%oX1=@H{q!U*Q)PI{S7qe2 zS69mNYg@xwl$F##PuKD3rgF#y*;t{VWvJ~3DzH2$J+*p>su=&#FKe#*sYSEqyByS2 zQ*g0A16|nD-;x$^y$|}d<|d_-TMnuhMiTS*V2UC?b@ttgzZ^^@WAeCo<+cWYIMRPBCK8RppoT{=8S&k6S&Su5e!vv(QuN<9tw|GgwkrrKu_#+px^r zj@CWJYpyBynxUh=&q_UR^mVhSs>ta|y;IGA&v$k9^)?<6CGk|jw;zv;a>)c){$;CI zZjNCz4oGmbfCo~}{rl~+jb8JGYLk{N47RqMX#`1duy(a^ARGf3jAx6nHLf^CDbbf} z=|6;db2*d+o#E_fm1&d}uGW7MB&yW)NWt15*9UGY2z{EjQGRn4_Lw2yEK@`i;*3xJ zN-`kaTgaiL`;8SacJs#|dDJ55zV`-s_{W*zuWmU~kt6NiFzXjIC(05>;ac$o+(hIK zeHx zSD$Rgi6w=Rdx7E+rP+Nk^tHbhpd1Gs(r`l8+j(6N)Q|H*P;w_irMq2r000!BjaKFj| zVEZ%;{Gk42spCe5#<5zcND`Rd$QRZXvVeLhw+4h<1v`+zSBS0jCnQPtw$Am)bP;d2 z?s}h`PReh5-T9s_5v-u2r{69DUVqA?J<1e=3eeqTV`jS9+D@GMUcok8TlHa1Z%xRJ zrkcW~e&vZWWPHt^{QTqDE-{NFnO58EqF|yJ*-!C;;2T%+_YWKA!3U>bq!>4Hi^Q8l z>-D^J@oiFBKt4IP8v84iy5-lC!v)8dv@Wms%nJ;&*pvx~h5q=xjTdy8ra)#w$B_9# zfKiFV^-LD^3p>_fBv{C}`_H290;4A(+Gqdj-8GU$M>Wl#zs*~(4n~rzK7OUJ$N&av z+xKOSy-G^7%r1_T79FI|_Mw6gm0iXK5ko9VosiqnukS2u1}%6+(M8Br9rvZeuodSl z&AU2GzG#j#hA&;On=HoCkZTwk|3yOyl%fXv(a8(8cc>6lh){l$iFh&Pp;VRf5v$Hk z_^H73LMloa*Y&Pc_V0(nm#KK}6u*H!_&`Y@;>PUL znlSNYb{=GKL~8vi=NYjKxkQC}}3-t!Vn z@)PP=qvNG|kw^mwdmtFaq{wNl(LQ^oR6~Kye>cc~s`2cE}?Mnw=2@13NUBa-* zMj1Pev?_FIsbynl{NYPaY`usS8jsD~41frRSAm3zJu@NNg<)spd1*NDs@@xBXZsDI zNc`bR6^>1cZI>I~!c`TQ2M_4$IV*V%t|t)SWuDPOhi~f%;ThynChFbGywlKXLMs6{ zz%T9ZLAx6O)n&7nuwmdc=J$_)`O~}Hk%2JBSpbIG^X4~Rhaqit=!H<8 z?D=w?+5?G~{BD@?;?JApIHI>XUD9I-{a*AE#*$Z)C$?w2ah9H7YuXS9c;3WAnUvo_ zT&S+c@f(2Mek*>^N%%R`j1Pr$aejSgj~z0^Z`rfX`~~V&$l9@{4}iaDpJ2CAnZxG~ z=W!)p`zlqs(PAJ6PIWFmPBrr(OrA2E&(j@o> zEdBEo{3+65)fndnf$_r_L)2m2w?D))NGMF2nSylgRT*qWY~BQa{!CW~8|xK?D}z5a zklmCxmFU&WPWTDdW#Td5H5!JaQW^_6a;nytk3m8cJXkWF@T1vS_1l;~4&Gs?FiLx{ z4yE-!#PI9?3Msq)kxjbDweOpgeMbLDB_(s}`ZmJZY3pN%_*M8-TT{RlUI+SA-uJ4# zO+n|IJObrqD|?aIL#xFr0soPN)A_w)%AOlqh+J^7V2qP2bBb8HeCuImkpXnknb6gn zP1Y#!&s~lDNyfR@=mpH@R&UKNJC*kjQ!-nQ+J&h=tY@;I1;3;ucZ7OxR*xvm9_J&a z2BU|22!Dk>9S()Scj!pyqr<6QjZbnk(L?K+uTM~ynAT}LOortf=Kl2X%#XNR<~nI> zr09WxI3A&+$tdku70Qk!@gjv}CA~OQXNiw?_Y1a>_OHa=%f^wD8F5tptF?$mcKuQZ zHGe)#FOezdel?vn%sP7)`sJL*r@y#H^}GHN)M%H@FtPpF;M-~#>u_=E;D?Q+@Y_;H zeF~0U-l4Ri>tC+-_C@*A;Q7-B9s9%t-s@j(UyXr*YX|P1)bq;Km10%o$Vget44K(P zPNT$XCG)uBg=hmIXnpjcKHpHdq>^uyOHo%{pv_o)#b?J%;d3UDf!a}PG4>5E7;H8m zSxo`IL%U&QqS+oeLdYG|P>)S4olZaB zcR%3R+G@~HKUo5}^%nf`9@hu^%aZ%A9Ep2kT;PBQxo&|xzDRYh=jD#z7~j3HzJKn7 zR8CxX{mZA7?Ci7_j_NL@;OOH~!J~PoAK|h$IyI=zne%F}X%6`EFOW9Y52o5Ah{cG0 zQ8>{!f-)tGdf)CaZ{Tj_E?0*Hb-(TSf!e&TORiJ~>YaG0H|=-D<}vdzjDZvN>MbmoQuS|uL0f1saiS_ zzc&%k^2e25!N%JR-@4W=EeranlI6Iy5sK&T{n9%IJ|lwleH+n>NA?GD7fZa#%-fbHz&RQ+gxb-aNnj5@+(26 zy%DM_)gr2`hF*O94$^;;^0qQ+CvbuHIC)#CqGPQlfM(eM+i{yZ6 zJDmBX131W+=BSeSqFJJk=n0!m;uskN#%_ms`eUR>sDGAA=dD-r_11cv5)A#pKmtAd z5=St6fb~#dZg!oMr?AT3zme~C|FP@z_Y_;C~*fZudDSSS#^K) z&`TJ#*x|WbjnibwsOIJr>Bsn+)Nh{KDv5=+4f2k%GsZ&x<6)iKV~&YznMQ_(%XsO7 zAscaSl(vtz_L@TjEMXdvmA7$=qOdh!;4>q+M^)9b2fIbKr?chP(nO56yEn76%9RT^ z2d3x->1VQF4@qA`a{uvJEuSk35(fOF!FIv8%bRegRs_G>1ZJHn!+hD4%{&~wT0_rm ze5HC&h`i7AyUVC6jn~@o6%TxCnu&4(8^CqI1uA9mtE}HxNcm*xPBlAQ28vH$3$4ED zvjHQ$GRZQ)9@q6C%4E{2OzHQK(<|5J5P{a)Xh}S*AnAZ14R5-xhx0R~TLzL?^bX#E zPL@+Vg~j`k429Jjd+UgCbSO{uCclTZ>q6tZe*Bi;o8rk^%_1#xXagT_bRWR&cJ;mQ z$|HR;e)Q8dOlSLMqgJw>P|>JE%e2^7)|uhz2Qy+oT71$rh;ZD%{s>s%cdWwuJqNdl$`(ysN)aGs zpF6B#hXW^Jl)ng@Fqk2r5IsgfsyYOZ`DCe}-dt&;|oy~qn#S$xJK17>O;n;{r;0uQsTFTSHOVdNa>W>BIAV9* zdFQS1j)Fk0lcbEwW&i}B3?I)BsO_*r;Hs`g3MO(`jpE#UcsIx5E@7PG>yiV- zXv%tHw8?U2FkPZX-@X*Vg6=UwXK^sV^+s6e1C25O?EAYV$LspwzSf3z*CJuo5v%@7W4LzZ#{Z%g1=0_+0Vu(PO9ak6=%>dN%C?ut`9g+kBS z6dHysUslFN27=jj1s1zQaS+cpv?$yo9ebT|{T2_`mr%nbl>=QV7{6-1;B)7vmb;__ zWt<%wab8-UYOXwHS<$%9Fm6~S|45S1zTM-3%7r+c9A1cHSwR^qo2KiK0WwW=Jq#0S z+_vv!yu>_ZGc>{ykk*(^pJ^+_Jvxw4NKN@*$i(7>R zq%`(Ub1d(!#Y4c^VTh+5yNKOz`>LKdzLx1T9D6&)o}TjR6dXs+{T|R%WLgMYcYVd@ z>2SV7P9(4+8cE9M<|{QHu8V0C(qs5 zW!3(F%mJBQH8Dl`Lzgz&RDL~$6D3aq821^kK4Abh*4$5e@JnD%oHUWh^wjhWYW zsc2ryOjXe3AS7^0y6Y_%G|wmeMOwbTD9cM;EI(A+{`z3{K9Hf$2oz4YZfM#QemE)& z#BZ7p;B+wP?$w+LbWqm8kA{G+Hv(U;WSk+8+A%nI1wueD{AfKgpv_6FmRmYyP4EJa z)#my_2yd?~4ggDdK}P&4%$wDXXpoKGUAVPvy6&-yAc$|%3kFx=0mUE%LU(b#@{n zkIlg2v!`GW)WFMV*xclI*=t`m;WMdw#r!8T8Y6&GkT|Jp&STIEO(G|csy9T@6J#MY z;O=$jI8khz1zSg(oF1Gbre7U|%Poz>d4%C*UvEgM2tf*?mV~Unmpfy<7C)#&-P^Q7 z$t>EgUoHTB4=N2>UHmyrdP4Z?#s7rNdG^Ujb^9~CNP3NA^{ z&6o2k3BRZ4NIz>wmw*6`9U#FYug1wbkb;Khg71lQ-*$~3al4=Bv&@CYlab#4f|)=7 zm1QeP`^M+KK3hLuw4)w)wQ?y!1{J&gndZ ztI9c_Sb4lv?cAYn!s{fxrH1nIelsC=3av_Sy${Dc$@N}5JwQqR__cY0@NVg|z=u+6 z%dU9&6khucg2n2)FKs0mAjKBFrs8fztV=eL)%SK~+H%dPk#^IKT=NRl+d=bfD$OZo zu73qiHDU%bg|(3)L^N3Ze7-<)DZ&z*GyZ$;=X!mfvcV0X7*uU?k@@#qX?Y_R} zXx3|~uD|@_WK)I{keNk5LvWjC`25s6(TQjUJOOJ`tKu?Od1jLT^I3h!cu@%rn^Ju= zf9kkWzg9VO9!oHWE97hN15Yx#xgAHkwbnl%&F%zgGW~!B*{fi;UXdRr?W&?=wZ12- z$boXwBJ0PV!;a_WN{xT|-tZJudO@i&*;c^xjD*r4R+2duT3>J8aFY$ujW`H+`Nqrh zvv|s4xrvVF4VvXS+wdk8HnpNi4EX`varm_H*$L#$&12V-lHRBtmd@1#s-sp+j1|C96*>dEX_AkbWSPSKoS%&FG^dqma4#4U$_ z0sJ6@^XeJwBMh9{b1>mx5bpwv`-u0A9I6R1x#Tip7!hdnjGaJILYTY0*CL2}#N!u% zoVYRY1v>ffV2TXgXp-FHwAl*1#*{EG3$X?Vgb^S7mDFQjUotU2pXjpW<9A3!5aCa< z3z9PJ>q}yw5=g1!XeyU1MoMMH#qIAtB$8+{Ax%U7N7uMzQ_4OJFjh+^eVbhuKBX)~ z6fPtF3Qh#jJ%9Mr(M&Qp(HO$hV~|5qeD+4G@CmLJn(DQVftPc9PagSVd#_p@U?J0) zWOCDYa4*i=YNVcaxWr6$AhJX0n zsJpP?D$+dYHdfl@XhEfwV%eOEn!3J>Q#E*y9^`Yko$PvGR4dX~0bYL76crF~6vfsN zP8-R)|KkVwL-lHoq8NTQ9S6M``Km-ZZ1`g3f>S#4|CQpTJBu_MjZ6PlOHZ3N2Z5^<&}VR6blRnyiI-!KyUq* z_BIfM$UY_a4MWR`n2`@hoqDT;BO;A>@d7;Q{W^ARaI2HY`ILF;{ifI5c~Oj4?FA#t z@k3R!ozL;Izv?|^T1m3yNScHwu~YVzN{NP|R0&??<60V%_mitgz}|9gF0NYQOqr~I z{X2p`h2&YqDf|}_Ly6S!SvOZWk`?q>*@aqnjA>4P1tLWKX!RKTSn16Nps!$iK#JTB5|DJ*Dkl z|D{^Yyw;!h-QmjifnV>iNO)(ga2z&C#OT0Hjy6SG-HM+sdw*7rD21frV8xt$<3s_8e&EAkR0KM^g3AC8VkWrfG@H>W@cCp@>UlSWV zrg3cNd!>$gwQQz)e;A-Bx^juBN!_lR7~bE1`C{^0(JItyDgA6>`9gSc+M0t37_inu z09WV+4Mle+rk(5!w3bZOEEAkWKRpcC-B}eJHr1Fbv8bUYeVMDTO{XF^BI&GqLr^7l z=$NUDQS};edmFSrm6!9*r~aFAdNmj=1UK*&ZXAn629So!or&W!fZC)UeX$2WL2wf1F({@T)(Bz#P#94GM#c3 zGu#tCy)V5g&7TEFpQB0`M_E%ZVN{d^+$YfvC_%qoP|-SsL~Rr(ux{`j3?Lnb5cG8W z;=tnJDrhcho@DjMSXVfgXR6cR-&gx&TxdsIh5RH2WE2t)hfHBCpmKxO1~=uNhnKN} z9yxL1x^Kb(=N)D=Vt{irKxXVhi4l7bdfO|L7=z?vCA8#sdQzn2XT582BF8hZybLQY zsW-Qn9$v+9SAzqy_4d#Xz>hdI(AP<}?^TZO4m{>Qo~{S<)$N%Vc-RI_u;_<{!}+Rt zyGlANf#IHOJV0g$c2NiNc;sL#*|c3PSkM!l+T%i+pO^w?#vT|b;Jh);DRtm7fw5UPcRzVwHSSC5ghWv07W8fR| zkf=Ct=VF;L^hY1ieXsQU77mS`iUCrkK|E ze6+asc{)NlAgHTP4E2X@fD7X7*Vq6ode$Q%hV(89`dGPOv0YkFh%82O(vSv;;GBln zxyvH{ev79a;Srgpii~Ed4O=9aEe2qOk-pVB5#x|^mx_&Xw@GfX?KoU2qrEtJTRpE` zVuJ50C++3_T?8Y~N!+~Z=FPraQP=*22n5CFi6@z{Jx!iW__mtsIr7ZpygTs_@Nl`=6@mcJmf(8%&`_pF1Jdf19w3x`>RVyzqbN5y6;)7WI+2-w>FQ3Z!QMd=f|e2WW{I}MM!HK8&V!OuCH?b$P)1lglWMaMVkQB}_HlJ+3zAkC6l}}Jx ze{u&yB3>5HnkD|J*LcKMF3Nza6=0XvH$bYDPLFFIyO0^u*xE5Y*gJ)1v}daT48hK; zutq7vw!B^YdXtX8{|*jl;FV_qSe-LVdw0_ETkRf%$TGM zooQoEx^X6ySueXp+Xn*}qp9XCm!pPbv>*e|h-I>dQJ4t8or;mz?yD4YNB_7EM5|dA4EI8yj#8m}{d%yAk#q!$2 zDO~H7VfQaQay|h$QW}>rWm!OL!pP*-o0R+jNviyL$#q2bK4$P22rb3QBP#Akwka~| z!(cv3#t%;7#783{>kY`eMDacD%MG?@_m}{xTv>8YsdcGv^`u(MiCEg2T4_-^A-c$JaM?Y{Ku!_tD@~H?qUFjSNTyCHV#Q>-vlMKX-Q*rbh+xb?e`j2hox|H z?vgoDYHXE#APKW-rJ#UgZVZ^emjMgb*dAIXj7=e0{-EwtmBYptc&gVll_vta%FPPN zDik(~#|gZ<+{NG&p@eIarP=c--+Lbbb|WCr+8W&ST`O;7v>}LrNUsonEfUHWB(9t% zGJ{;vTW7`UOyHwrJ8xb-2z&U8cHTac*;?jsJ|+~kWX|QX7Wok#iiEa8epMpPS2e}< zyHaFeDq65S+%LdIk1_?>5loUjNL)XiRi{R3)6u=|x-WX<8$F_r*7e@xoAnE{4GO72 zB4Oh^pSz1C-)~Tk&vGBzRKY2I<1hWf&HAta!xv!`e*6*jU&fjjf!GG&2|b-kieFZD z|>Fx#=pZ4IPi6#pep<8>d27q|Si|xi!a7H$9MfwdMz7cF#?`@|qVkO- zmvXaF3GH-kXj3TI?Qpks>foV5(&+ve9Y@v3(-QTF=J6~;@>j1#hNQ|R>RwR;D!E0W z<0x4Xg6lbg)-x@64*>-<_7~aMw)E2I+X)r&XSX%-aZybQ1$urRvMVa9+I(tgqV%sf z=zs55UgzH#RFe2TW#Rab2$3aE3$DJuo)F!cJZ*^2W4z|-S#FjU{FEUkm8GA$Jv3f_ zUH5oesz1AnG?I1bSH#^xU5P+&_y-?2p7PN6E~`Ukg^W}sxu{E;Om(CQ)$WT4H=c}< zDIT7T!^QyKQ-jJIp36HMe6v7Wzdy_3`62T~Fs)b7?MMyID#^Kg0z2rm(C)OX5ufxLH zGeu%9kxgh|gvSMNJ|z>4bBU0|T$x`D@SX7c+drqu!Oe^P5Yg z1hWGu`M-{*?|RW0H=JMdboljDTCOxXwoC+x<1oCVbdY59{7@Zuxi%C}Zw_}g3iemG z8?aAzT(QuRv7?LzCl-lA0f8la=M9Sk6yz2pFs<;U_4iThwdU@EL+%}x6Iu877_y*^ z630y*+2{!@faDK2;UJ}diQ^W|%9*}&IOgeTO99N&jqa`vQT~emh?D;2&=`fn0~h#P z_a_m}#w*TTU?3cgJe;R`x=TQ&3WIjfHwWwa(X&~mQO7fdw1lvh=LfU0Qjw=*=?fuX zyVWK`DS2&7=I$J9xTEneUzr8`Ir!u5c;@w~P!rl45QeOA_}B{%i#Fr#Anl&31Zl>r z*rcE?8n^K?kQh0OWkTfeLB;0xq&RnxAA zdDd^QU0?QzOy$eddcP8bNOO4+jHX_|m&z`dMWCHyc-^p0g+n(ft|oUf0b?ls7@2Hw z*j1BUJVy6YqZx&U74y4_A4U&lb=}KuWYbox7Cy7I0}zi3(_0st^2zgy}cS{$qpT8D$MmW;e zsU3U0%omwG^%ijA?y2lK=v96T=L-{yT0|&W3SVE!3Mc(Te*ERJH!(0> z=OMO}D6GEfuYY|WtW0=lZa`5?d917PgD)c0@E-*DlUHc4E?rW}~xx)a^SmrK&iWVpdogEVHQk@YRJAMst0h4NX~5jrM1km6t^oNv863 z{PGcmzGy4_66l0L)~zocDAeeVxt6jX9!(v4z3%aBfhzMv2HEceUu>_oy2ojd*?}mJ zvHmsIMlw}AO{S9(F+wotsySE`(+C)7#Kuoq^;%`UdsD^BpHCHhYuG4xQR74}^=Zvp zqLhhGlpl}kv#5?7itv{1ZWZKglUQ~;l!KKp!7H)mXN~gkf#7-78B%)P&k3ck8F~dm zq9s%0yCYvUW5*pHEizjr3&_apge+Qf=vXt~cjijvCA0e~y(evU{6=FecIH9|?1|Zf znL_2=Yc!=4%>|rlPDnMA}|1%mBPaz z>wTch&!(!7fL5v-6aD^CQAitC$v|5HQo|wKoyOmqDtPt^6Q`B@-J5qGRK-ybJa!D} zcjF2EYF~jj80Qg(86gbaAThwPx1;87n_2;9BDq+LN)Ro>Sd*h;grD9;rCYA$=sFZYa&NQo2~#v z1L;vfWOj?G_$WGxdQhZkS9L%*6-Z9TX*~7mws zxx3w}3tNRqLI&$Wt>RA=j2eyg%Z*FL+Ze}2>nCj7x{LC!6uvVum5xlo@;t|7GHmRNL zYm0fqxgI5vTtog7E$CRCA5zEpgg4Z&kZh?*x8XA~_3;96tVW6{G(s9PVXQ(m`jS~eJ@Vqqk`T-|B4w>BRn)0xH@-gD)+ zZzaCj3a}3zs$KElZ4j7IveTp|6U9yHs%TuFr7$`fC!P_5p=DcN=KXqrWMgu-JroJFn| z^NOb&uA4M`oTN(UvW)fiwO8g^z1z*UpAf!$m*(f`c>(w7>NMJ|PL2K!B{Zyd9$&on zljr(E4}t_B0RH2PCPMs2lF`C=rk%MO=ksxL=GY?V1xSJ6#E-r8X3JZ_cK_gbu3Cmc zs8WU4W{dnRw6TC16fKxW(u!z{Z*j#%;(A?GoQ9s)_ zTny1K!z0xGG>5<$x3iTU_ts1r*7J9b@k)Y2h057>aD^;ChBVbnN$w>Mx$r_|=aZLM zHax-ts>Ht$;*cdF3s>E2;fO}F(aykmo;_%-!F+_EOo!`wWwf8r=o6gPgcgQOh9h$I zMdW%$?P(t#)^jjnv^NB&M19gS^ei~_?|UJ;@I6k{+6zbzGHtP6xdr+JKo&{ zM`%C3#|jQ-Gc_MpwjK?T*w?{L$%{vewa0Kyf8$?0gosBk&St){K9)>qsW0N?<87SS zQ;2{Cw`Eoj6pg`#T zJA%Gvqgmv}8bznVxd}Y)2xp)!!DAXeJ)E>wJ;HzQ%@BQd$~f)eQo&ra)AsP>WbM)T zi6hkrar2AMn8c=VGE*i6Pv=^rfI!2F+p_J=L0Q%Pgjgm?oS0IDZv8L?Mtu+*2sDz5 zc-^|jJPj$w!R@5C6AA{q!xLuSF24J$`T#F6L&tu6zk(~@GJ{sPea-h!lAwvZvdWfW za*uUHv2l1**Rj3-L;C65!{1d}k*~rl!~3N9X4M^f2WyE%oJ^YiAyxIjx8~8SoOh^j z&VloH^;>o5#qzsFrSLIk(X9hnW-qpJkrWbta9hD51kbs9A~FKb+hTW4RmH- z`+09ZqAjM;5tZyxQ}xcDZv)*(&isM3@W|3R;zOc-3S9=s|$-i%It_q$1nT& zo=7m2U`-zTOAF3bJ`^_YZx7Ck9}AGoZ02pT2T4RMWcag?7R_q z!|lK|F?lBlqu2A1Q{dQ!ZPMrT^fHyA)4fwA0)_r)*N=Yyn|~d?;=|t%W&UxqIFX$& zILEU42V8cuG}mG0A7+KL3~Wg#?J#V32y8 z@No$3U#8Tjec651YdFRfz;3^QabF%@{LFAzsF__h?N@qU#Cf*5|6Kj-2^&K%64*&A zF?q(fX$*S|^J^45^55jTubdXZN}#5`nQ>t1me-E$Zw#$W(4lDX?9S zI1z@LaaoLlk{_VY7Cy0@g1*1n;d69B$1)RN=@bwiB+=|eD&pnB&z8A46t}~=HCU=q zwzGT43LePYiP$*>h(9(h4MwD4WL@>HD(38?>^6oGfUjKz(onGR&a~BLgdJ zcYC2M^+WymMv#6O#w+ysZiCyn$II;JtBKW^^~uSa+05xpDNQbshojoZ7E<4<$)^<; z_`Ko~E*d1TRd$HgeGuqqCOPZffcm9BrM>m@{_DWoxX|xX{c~{UgM;V5$A9a464YgS zIB)5rIJ=s#F(~xstk>)wyWsz8?>nQK?6!3!5I|5t1nK3|kB<(D6zM?)1VNErLQx34 zNtG4|sE9OMh}2M|_g+F31tIhn0)!&cJ4g))_jT{Pb>DOLxZ~_!=gs@Qj zwbp!|Ip>pwFsn9P)IF*<>9O>W_vg4hzy7h@-nnAp32^WcSdY#>2X%fP-4SgT{f`o7 z6M7UX9wlnpbr7WJBNgiw5}i-#Yxz3wPMe4xHZe8e?0XVfE`)r4qw#5vA+SESfh*IC zSjQ-8RRS(r1+zjKe`pbnP-3B|$BQKFkjPjIOGrBA2OT6wO; zjR=i9H2iB*mHy^yD(a~kr)vG^x`9 zv1$R%?UhfhcN+TC$FG5xoJ*Tc&%+zyYkY0iU7r=)cq6FWA;eZnRsHW<&Q0z-ZNuo1vx>^zt$m3*%TbnF{2TA}??={Q&JGoo zzyX?mhIBBEb~EX}ts)=JdpFT)Yfh3a71yz(c{D@AMuG4*gauGBLe5b9{Db(!=iyRw znoUhbb`4@11e>OKbKxTYMi_ceI^HLzJv`sk0D>h&A&o=mJ zK&(l{@7iD;ehrGA{-RkvP7qtSqPFGAX(%LZ|LS>!Ewk=xG#1J-^!(c)pB(BuzfsP8 z?vVQ}Fip)0e{nCZr?dSqZB4+c;pC&m57@8s9i4rlkREdiK6%+R`r&%b>*LJcbNPJF zRxh8w@5K&oBa0{9^OjUWC%M%Nai!uyTO2&puUT2V@9R8bO36F|_9;*CP&k9~2fLIT z0pH36+o6Au8jXx0?!U z*gQ=uT3+T0uV2^`$>VeV&R3r*Et&A1ho8$HS-synRH>xTcc}ak_cdE*`4USW8q2k8 zB_KYxlp0wY;bwRdOeLJ~2Y>jxKeMhD)EUz^ENjtNNp5pa@aT)Bhq-eXj8yx@9w(7X zGIZnVyYF>cBk7Is)>S0o_hkZsHTU$t;l5#;3Drl zCL=fWTeAO;2fB|<+AKq|D|n^6dg%(xolln>niR|i_w&Vj3VR%5f={Eh+MKMtO%4hk zl<6npwuh)f;!7s2W%sz8R%Kka8&iYQEE1W@*^z~YrnW^GGquI-yL}Z!PV=5*e>ZY% z-?i1C9?t3~Lo%3?PjiKYgk|h8^{VHVDoascaERaXMpTyRu*ha~4a18EJETPJ;8KGB zZ6~cKdr#9g1vyW#K`Po=p@vL1$J=$1-5HeSx(pJILbZrvp#t(RvhqFaRXpY4r54+; zgerLJwdS4!jH`Gm$u)L^c&ImcpnRN1l7yuT-0VYAZHzB}5Y(u~c$rDoW{T)E`mA2S z7J7SSJTEwTMNcioI&5#B>Ysg{>t;U^YA62BDOt@YFF-TOiSMK_u~Qj!tC!Ipx9$gCwcI zcWA3lCbhLzY{7&WH^Ww+p`LM;&xra#p1T;s1F==&_@YSBYNl5(ezx^s^uj&L#Y)>P zu~Sp);0VzwR`)zd<7DJ9(R@CN(?aHpQQb~kmfoxJj>gq7M~y6UZ_m&5SDiXKdILBA zAt16asKR(d>(pGK zZ`YohmbtVg3{2l`!7PK+D%8t*l^0!rVYCI<>>vDM9dW#yI0($$uuIxOSaU)AW+LXM z1E3lrjdJZp#U;wRr{Kdwr8E^Hy9SF)%08ir1NQOu z7VP^Li}y46!!7Ktd8zu$ddv4cYzp%KiG?>e%e{{t9lt}pZB4XXP4hGpZe)={Y8stg zSd(I%c_i$*QapV)U}$GdmW*+;x+Z}X93|8D4xHmvo+kLg-BI53g^SPFR&2OnMShb>o<_V1D4X+_=GCx2uP zMjZW*XxkHuf4gJ)GAa@tz!AwD0$vyQn0w0s2NNGlwl%*crWh z*Y!07@Il}gcRUff%UWzS*u^J(jQvCi&Sv;WfPQ3ObRt%FIWB^u80Wa9bQfJG-j92b z-Dig6H;#l_TphfIWE~~m)|qb&-(+ZtAif(Z`xAeU+F4Gym5^ zS-TXxzwD)<(~$!BgbDPP`yJtFqQQ2=9`G=6vpKN|0H;lpby&V-tP&=Aiu@s`51qzb z*`B#B2NIUpaD!}de#A8@JMSrJ=`_>tVN|EnhYx$#*xxQNP#~Ur7=s0Peq2SrfHbto zim*Iw52Xqh_BVY88L|HgD z%}~+CVO*2oWjrQ;)+xJgV^4gfA*0kEFcp+YWYQlV#Xv9{r{pnky=#>?cU<+QxB^!g z_T$)s*u;7VdcmxDQ9pz>WwJ1q;MpUzQ2rHv&po!vCa&-i9aNvsYqz z3<5U>b_)YWf`k3+5LN?^68rE)9HtXD5)aeVjpawDNK35xXOhe?qY-2CDRH}mR$i29 z??SiLeE9cNcy2gS*i@0tw(tD$lsa6lN2MeHB8T}5MskmSOkCHm{wUPHwOf)y+*=P` zG&L&B#em+b5f5z8Y^QN4Hm$*f-?D613vgLYXrV+O*@UFphfi_4ua2%p**|RFtYjGZ z+xgrSf6>L*jsn3^5`YX|FQ<>Iy3J{f9hF(#+w(Y;kj}I4()3cugxzjl4^TenGaTK0 z^JYQo!D?R0+RWdXpi^w&;E_`mdMX^D8mc-uM8O7_#<<%9bgB z?^D68VjSD@n=sLVF*wE2u+0nP+QC8J&hzfXoVYsDP^sIzwQe=f9>1l^;P6lKB;*_X zl%y{)2^M&82~4#@m4Dy2R$-b{3BYe@KjXyB-aeIqOT4W?XKBy<`Si};Jv_k8yK9Gl zZ}wJfoXQfwl<}Ub2-t3=&_HO*131)X7v)-U+Zk1E!x=9P22-!&QkFmKh=iK3vcL8a*U4o3|aVsK-0Aa@jhg8wdR*r_O9h3#O?~M`KXDlh!yIns^t*3 zvcC3`s(6j}71>pj`{WXqJCK?8C{FXa#60ZN??wE|jQucODZl1)2Cd|+4)uu@;XfAZ zT>V;~E6AEpuX2v{q&O}3`*xo}G~a4LI#q<6%<-P3tgBS6f0~>2%Ax=Hu}F(65TIMp z#sO3#Onm625ae1jC8(+i(EM<#hvi4O84QEnjLmQianw{m;c1W6+68fsjy?#hoOG<2 zB_&9j0jws>DC8hc87J*JF7-5Vc@99!b^t-v>7Bd;Axtip;|`;6;#V^P2T+u&&?~9)nuE&HxUt>o!}E9H*+-k!@8E7xvLF1pPtxEy$==SDp?E zDFG6=>ORw)`OECX6ixkD@VH}67JD*k?v@>b#q91+i=1i-4kQ9B)^I}cGN~}B*5_Ol zHI>unNuEGySEJR!CmB63DoJCGewvtqX1BlmOph`$ZO2kjbI)Q^GsgpZv(hwEzNIZIi?gGHz9mvM8h#0vr;CGZlZjg6ETP~m)zga@AbMENjyb}_3qCzJ2xqZnj zCC88$25QShs|vB#M|U3B{nQE@%}|R1nO?Y|@jX$2?i@8nJ1Z?fnX^PN7#U1t3Huhj%VQNa%|TT9RJ}VWO(9JL`(8I+vQ= z31UN^73W~gwN?gS`OB#**RP}b{$6Xuz-*k-jqxT_qJnO2YdZTA<87~s`4D#;EpE8Ny`Q$v3da#d%b^%QS-%=RgjdVf$P zy_ss#CuRVASu$z#P?cN<0tZ4v@;k3M$PswuxUH~ft3@h8A&nQ_n@T*yIwY~&2_RYU zK6`hPNxC>%*H&D}9I5!Do>1?KnXXCH#WPtg4P8&}h`0)`K)A=zqwR+u<{LZ-Ts#tY zq!ziIDJdIvq;|6({PzluEOB;)~XHX!zxMuV|5EWD} zi)o$zIC7RX<&MzHctJj0zua0qK5*I1g~(rCY-o$yr9-ztCug4_s)-Erfl&Rnz446Y zed8+}j2{LnFWI}5?`|Zmm(OR}mAiYLH0^hWW5V{CbWkawEvc-ARW#xSm+wz)HfD{I z>cIOt&Bwlj>3Qt5ZHOn_;ERlG=XImalSAt5+AajzElFaC^TX3OBHKIb(F$+Me5$Zd z9c1#SANqbucXXfZ3J7S2q;1g(h9`$fFb8GOhdBXOSoxEwqN!R|R1MO<%uImZwEg;e z>&hDtFVxg5B>gUl#es#Fk*&uiGYZvpmu;GPE5~b|PM*H}yIRM<5k0ujk$c$tp%(TD z|71{_`90L0t{7kvi(M}1g}wu!au!=g9*L4xwM;>9;v6NYqM|o3q*4sv(P;*kuH=`? z2w}8*lgiiY^nCE#1bb&7qqEXgJ|Z(omL-%)3U<{0yeXF3FC~iZ#qvW|gpbax9^~07 zASCd`PvAIH)TI6{TZ0i(%%%05=+Lfc7FT&(X3HJ05?E(6inLvR^~B#OTS$j z9Ih6w%EFj;MhC1?zf;(n@l^XU1*~=rs8bAC7rB&`2(qh0vm9o$)ZYPIK`=Kji)hBo z2;j5I5(-(?a%L__8z&O%8=_)Ax_qcFB?Dai^G24Zncb-YB|xn_AfU1g0(k|ljod0X zTl7%7!ad;CPDy>P6p)%ydto=3fSY@!e4CjqH}qrL@(uN=;|48es;s`45YnpEtd#r( zVK(8+c$7`lLS7mKyy_@7ZYd2uzx*M?<|*U3T(bXm|Kdw!i7JAs9(#|zPDz6P1Empr zJp)}u*S^dBi^WZxLMFx|yea?*CMtWABQ3k{aqwRSLTLumLqFKrNkIl%Ns{}*#Pag? z<-oybXD}(fDp0zD0HiIA4V#UKawjSS_?TID@ zq|8YQWZ7Nma{pv1jv4DYfWH^ty3&k#$Gb}eA~YmaP)`&j;)Ib))M8z-3@Owo0&aNWKHkvtV0Vw<#t>De(3v9N9@1L7o4}EFXluiJ@YZ}y z`?07S-Q5djawz}J==k%{>{gpkp4A*O3(Xbl+xE>nnM&goI*Hb`)*nC^X3@h*5tUle zAo@?C65ykh$%bMJFUQ?$F9-UTLPFka7I#p#oyg=G2WdX?Z`daHiR;f8pdU%duajA@ zV|B$`uFj|g@umiM?}jvU3YXJ*g}skcQNaqPS)?xN@Dm%xn>nJ-I=C#`Xc*KFRHad> zn_W?{yKRHoZ2mhDBBYZr`ub!UFVm0iPWwv89#?pGv2}~}v*eAqvt`teXis0SVfWYH6Shd(&_CAtg zS(7oZgKSET$e8^=m#gn$6#e>(3&{1{W7yh(e^OEBe4Z@s{JNolD1XpwxYyeHK*7nl z(OAw0Qhzf-+SBxC@`0)Ti%(t~2{7V&aVH6a*-)=aT}B=HYg3U4hCm$)b*%B#vas8f zy*!~rsZY5pnHZu@sv@g)&WKGsHmaKY)4UNLLGXXX61eng#Z)VGki@Y0cK&6gx<>*< z4~$k3W6ICDZ?f{d>Q3eW1HzU`_pd5I9*%%=GGtUc0Z-nU$Z+(&nl7%ldc{lX%$0$| zqmc)u?<$MsRnoif3ezN}Wbe9md8daqnu(v$VXddn5bD?AuNh|6z4U%o_$7=#F-LqQ z|6~#nhYX4wNP|K%o`l2etYm2HB)w~cq2L#3a&g`_qfve);;a(46y2=w`EK+zg> z$NC-tMyns*`FF$>XuAhA3YusjrsytY{_&cXA~<9yP%V;|L)wWs{%j9cF<~^w_uFKU zN-uUXY;rGH18dll6MHc-ET>{zg{~B*$P6th-^a`C+etroA%F^f`)SEbr-KHJwL9=L z@^qb_Dyt6hhs;z^HrG68PPDT}kB*TO(w@QKYcCcpJi0tk7qwMy0O=H0RP0QxcXj1^ z0hO+fJ}VeUh9i;QCB2&saZ4~wI}pH=lE^f}7b-{%!@SAD@p2YUm)UR9%8>i2?E_2= z+e5-vC!saxkmZK{Gx~ikRq8 zMBRh-`?9cZnG~oy`Ok~8ep5GTa7mE}E|4f@v1o7S7!mn+wp?2(?r%FC?U1lds%#p! z1K6JI&NY`^I^!n)ED@YJ9&BRt)f(-P{QTbNan$1grKP=WZTQj14~`X2lDYEB>P^z3 z3Bk;tz7(hVTw$a3YJ-Sk#ok(fdU!KYSwUb_GUTkF;A?~U3ixP?v+ z8J7;uuKymo;dd)?$L-SKskrFU`gq9nHzPdqFs3eKXkoKU5IHnIs>t^RC1BK#mZYcF zK_F-hwYHnj=k!i%#p4Aq8{;J z{Wxb4qm9TjeHIkwa{A<9+{9?D0;k`YSB+G8!36jFbs_eP6jb{cC}1NGvsJ+_mfE|* z=oGspbW#}PXP;d<`C2S_x32Zo-LSbhMg39%WpWXWKWOd~7}+e!XBFYJ5e`!BF^ejbn*a*$zzK zeNcWmTg9c@9njz93XsW!9Pi5W2FtPn7Z;Bqff9>iCdwjZhkfu?XdNT z9L{I&;*zQd;tR(Y?wzf1HJUP*GI1Tv5Hl)SeV=SE67A}Rr@$R)zwDbH9TS(UFsl`n zXM|X9vgk$*_NkmszISw=X+bn4+W^G~!Ofp62g?B9AmcW9(|Nk7ac_C3WBPsF!G>lv z7oyR8W*%j=pXKhO$O*^+b^H|PRRRP{pK~k#+B(%h?f4PrINE=K9l(!<>6TVT7ycF) z`#F3E#I1{rxq1<&@DqKa>&j!RTiZY4&j&$nH;xmDZ)4Hd z{RACkbHi!%Xz_{LKyvr1Cl`STo08rPaocNcAV-5(Ue%`tEsc$sf^-uAlrjJpU0gjI>)JEwksC>g)j`vo7X60nN1gh#+>x0h% zGS-SqhJw6)Yh#a;0)CWk5HRL|b^-moe7W8~wr|S@vmi4CVtl4(!gp--HoQDeCFL8I zxIh!u#du1J{>yj!NW)x9YbB-m=(^Pc0>Ey6R)p%2rpYbW6e^!cuTIW>y=Iaa+VXv} zKtEfeOm-^C+V#G(i&$(CGMTg0?CP%+F}~1H)(>UYnS}i{-u>AcEc99$X36Za6|R|9 z{<(S!%zd(Y6in$><11iP-BD8HzQ>T!;FXS7Dx?L4ltG%|Bo_cm0BXx}yi{X=z@YQs z$4;vTBT*h;+P^ln02!O>*-38Y0Hbr%(gFxq&EHPLKW5oGh`utfX2LtgT+fyZtlv@W2&fSNFt^z3yU)+ zjUx-4b8Pm_Xk@s4ed*72KNJDOlN;JM{2jAnIGP8)fa*D+Q3XNQWb4UD;%5nk>NXfP zbTN#=Z)~|^&At&cQZdINV*T!)5;%TiV#q9$pf|uKM@3Yr{VblV! zE@OL(Jhrl_RzoWWeniB-9@if%e0-&^H`t5-WBtd`_Pd2py~>I&*f>R9f}VXe{VJQ9 zCO_IE@w8Y)%nx*()g$k1%l2u{p5MBZ@s-+pt4^aMq?|wg$+mtCN_PxQODnn-_;T;| z?>YO`8Y=)B6%y>iH6+U7n$6v;PAUhh1#S3>AmH~Gx7O^4<`b8ZMU5htps?omAPb%w z8o!?Wr~S>>OhrrEEupy({;Su2dJ_l*eUPkURSYS(h$Lx~qLWb3dbxP)ag?!3)d%y9 z-jw5e*gQzy`;2OL{5K;U5>)J`%dSukmve^S^>M40Ve6L30d6? z??lZ1()yDTxKAnQeqANM=llQH`cH5FePRDIlmFE)|6?Wpv66pvJpRA``;V3U?^_8i zC8)r-B-Q%bzj+Tp_}GD)PWwgUXZfF=(Et4EdHo#1#yHmCzbmQ^yY_E9_p=jbBjBo| mUrl}VZ@%nTM9V3q)^dmS=~P4;@Dq_|G}Z3kDZXVL_J06>2Fecr literal 0 HcmV?d00001 diff --git a/docs/segments/manage_segments.rst b/docs/segments/manage_segments.rst index 41606770..ab5680f5 100644 --- a/docs/segments/manage_segments.rst +++ b/docs/segments/manage_segments.rst @@ -9,12 +9,16 @@ Segments in Mautic are lists or groups of Contacts. Use Segments to send Emails, Segments provide ways to easily organize your Contacts. There are a variety of fields available for configuring these Segments. -When viewing all Segments, the **# contacts** column on the right shows the number of Contacts included in that particular Segment. +When viewing all Segments, the **# contacts** column on the right shows the number of Contacts included in that particular Segment. If the segment is new and has not been built it will show **Building** until the segment is rebuilt. If a segment has its filters changed it will show **Building (# contacts)** until the segment finishes rebuilding to reflect the new filters. .. image:: images/contact-segment.png :width: 700 :alt: Screenshot showing Contacts matching that particular Segment. +.. image:: images/contact-segment-building.png + :width: 700 + :alt: Screenshot showing Contacts matching that particular Segment. + .. note:: Mautic renamed ``lead lists`` to ``Segments`` in Mautic :xref:`1.4.0 release`. @@ -26,7 +30,7 @@ Creating a Segment .. vale on 1. To create a new Segment, navigate to Segments in the menu, and click the **+New** button. - + 2. In the **Details** tab, add a **Name**, **Public name** and **Description** to your Segment. .. image:: images/create-segment.png @@ -113,7 +117,7 @@ Adding individual Contacts .. vale on 1. Navigate to the Contact record you want to change. - + 2. Click the arrow in the top right, next to **Edit/Send Email/Close**. 3. Select **Preference**. @@ -148,7 +152,7 @@ Inside a :ref:`Campaign`, you can add or remove Contacts fro :alt: Screenshot Campaign builder connector. 2. Select **Action**. - + 3. In the list of actions, select **Modify Contact's Segments**. 4. Choose from the list of existing Segments you want to add or remove your Contact from. @@ -202,10 +206,10 @@ Once a Contact has accrued an assigned number of Points, the system can add them 5. Decide if you'd like to add all Contacts with at least that number of Points to the Segment: -.. tip:: - +.. tip:: + * If you only want to add new Contacts who reach the threshold to this Segment, select **No** - default. - + * To add all existing Contacts with at least a certain number of Points to the Segment, toggle the switch to **Yes**. 1. Click **Events**. @@ -270,29 +274,29 @@ Configuring Segment filters 3. Click the **Filters** tab to add filters. -4. Click the **Choose one**… menu and search for the field you'd like to Segment by. +4. Click the **Choose one**… menu and search for the field you'd like to Segment by. -.. attention:: +.. attention:: Listed below are three types of fields: * Contact fields - + * Set Fields to **Available for Segments = Yes** in your Custom Field manager to display here. * Contact behavior and actions * Primary Company fields - + * Set Fields to **Available for Segments = Yes** in your Custom Field manager to appear here. - + * Contacts associates with multiple Companies, but Mautic adds them to Segments based on fields for the primary Company. 5. Add more filters, using the **And** and **Or** operators. An **Or** operator creates a new group of filters which can include And operators. 6. Click **Save and close**. -.. note:: - +.. note:: + Segments are rebuilt according to how frequently you fire your :ref:`cron jobs`. * If a Segment fails to rebuild for a predetermined length of time, Mautic displays a notification alerting you of an error. For information on defining this time period, see :ref:`Segment settings` @@ -307,8 +311,8 @@ Using Date Filters You can create dynamic Segments by using date filters. -.. note:: - +.. note:: + The date format for values stored in the database is ``YYYY-MM-DD``. For example, December 11, 2020 is stored as 2020-12-11 and November 12, 2020 is stored as 2020-11-12. To update the display format for dates, go to **Settings > Configuration > System Settings > System Defaults**. However, this doesn't alter the storage format in the database. .. vale off @@ -357,14 +361,14 @@ Once you've selected a date field as your filter, such as the default **Date las *For example, A value of 1 matches anyone whose field value is on the 1^st, 21^st, or 31^st of any month but a value of 01 matches the 1 st of a month. A value of 01-01 finds Contacts whose value is for January 1 of any year.* -* **Contains** - Segment includes Contacts with the specified filter value anywhere in the field value. +* **Contains** - Segment includes Contacts with the specified filter value anywhere in the field value. .. image:: images/operators-2.png :alt: Screenshot showing Operators. Once you have selected the field you can then choose the type of operation to perform. These vary depending on the way you wish to filter your Contacts. -.. vale off +.. vale off Matching part of a string ========================= @@ -385,18 +389,18 @@ First three filters match strings as you enter it. ``like`` filter is for advanc A few notes for text filters: * You should use ``starts with``, ``ends with``, ``contains`` rather than ``like`` as they're more specific, and therefore can be more effective. - + * A ``%`` character in the middle of the string has no special meaning. A ``contains`` filter with ``my % string`` searches for a string with ``%`` in the middle. The same is TRUE for a ``like`` filter with ``%my % string%`` value. There is no need to escape this character. * Mautic searches for the ``%`` character in a value for the ``like`` filter, if finding at least one ``%`` Mautic doesn't perform any modification. -You can use regular expressions in a ``regexp`` filter. Mautic recognises all common operators like ``|`` for OR - for example ``first string|second string``, character sets including ``[0-9]``, ``[a-z0-9]`` and so forth, repetitions (``+``, ``*``, ``?``) and more. +You can use regular expressions in a ``regexp`` filter. Mautic recognises all common operators like ``|`` for OR - for example ``first string|second string``, character sets including ``[0-9]``, ``[a-z0-9]`` and so forth, repetitions (``+``, ``*``, ``?``) and more. -You have to escape special characters with ``\`` if you want to use them as matching character. +You have to escape special characters with ``\`` if you want to use them as matching character. -Learn more about :xref:`Regex`. +Learn more about :xref:`Regex`. -.. note:: +.. note:: MySQL (and Mautic) uses ``POSIX`` regular expressions, which could behave differently from other types of regular expressions. @@ -427,7 +431,7 @@ Example - Consider that today is ``2022-03-05``: * ``Date identified equals -1 months`` returns all Contacts identified on 2022-02-05. * ``Date identified greater or equal -1`` year returns all Contacts identified 2021-03-05 and after. * ``Date identified greater than -1`` year returns all Contacts identified after 2021-03-05. - + Beside this you can specify your date with text. These formulas are **translatable**, so make sure you use them in correct format. * ``birthday`` / ``anniversary`` @@ -487,11 +491,11 @@ Deleting thousands of Contacts this way in one Segment becomes a tedious task. L 2. Use the :ref:`Delete contact action`. -This way the ``mautic:campaign:update`` and ``mautic:campaign:trigger`` commands delete all the Contacts in the Segment, and all the Contacts added to the Segment in the future. +This way the ``mautic:campaign:update`` and ``mautic:campaign:trigger`` commands delete all the Contacts in the Segment, and all the Contacts added to the Segment in the future. It's all done automatically in the background. It's necessary to configure the :ref:`cron jobs`. -.. danger:: +.. danger:: You can't recover deleted Contacts unless you restore your entire Mautic database backup. **Use with extreme caution**. @@ -511,4 +515,4 @@ Since :xref:`Mautic 4` there is a step when deleting or deactivating a Segment t :width: 300 :alt: Screenshot deleting or deactivating a Segment -If you attempt to delete or deactivate a Segment which is in use by a filter in another Segment, an alert prompts you to edit the other Segment, removing the dependency before you delete the Segment. \ No newline at end of file +If you attempt to delete or deactivate a Segment which is in use by a filter in another Segment, an alert prompts you to edit the other Segment, removing the dependency before you delete the Segment.