From e4a15fced2e4efa0e2352777f11908edabd94fa6 Mon Sep 17 00:00:00 2001 From: fiver-watson Date: Mon, 10 Jul 2017 22:05:50 +0000 Subject: [PATCH] Update import xml docs --- .../maintenance/cli-import-export.rst | 135 ++- .../images/bulk-import-cli-options.png | Bin 63963 -> 28952 bytes .../add-edit-content/authority-records.rst | 20 +- .../images/eac-match-options.png | Bin 0 -> 8249 bytes .../images/ead-import-options-new.png | Bin 0 -> 7438 bytes .../import-export/images/xml-import-page.png | Bin 0 -> 33877 bytes user-manual/import-export/import-xml.rst | 837 +++++++++++++++++- 7 files changed, 954 insertions(+), 38 deletions(-) create mode 100644 user-manual/import-export/images/eac-match-options.png create mode 100644 user-manual/import-export/images/ead-import-options-new.png create mode 100644 user-manual/import-export/images/xml-import-page.png diff --git a/admin-manual/maintenance/cli-import-export.rst b/admin-manual/maintenance/cli-import-export.rst index 642bb77c..770c2b52 100644 --- a/admin-manual/maintenance/cli-import-export.rst +++ b/admin-manual/maintenance/cli-import-export.rst @@ -43,8 +43,28 @@ Bulk import of XML files While XML files can be imported individually via the :term:`user interface` (see: :ref:`import-xml`), it may be desireable to import multiple -XML files through the command line. Below is the basic syntax for the bulk XML -import task: +XML files through the command line. The ``import:bulk`` command-line task can +be used to import the following types of XML data: + +* MODS and EAD 2002 (for :term:`archival description` data) +* SKOS RDF XML (for :term:`term` data import into a :term:`taxonomy`) +* EAC-CPF XML (for :term:`authority record` data) + +The primary documentation on preparing for XML imports, and on how matching +behavior is handled for some of the import options, is maintained in the User +Manual. See: + +* :ref:`import-xml` +* :ref:`import-export-skos` + +.. WARNING:: + + You can only import one type of XML at a time with this task. For example, + do not attempt to import EAC CPF and EAD 2002 XML at the same time. + Instead, you should import one :term:`entity` type first, and then the + other with a separate ``import:bulk`` command + +Below is the basic syntax for the bulk XML import task: .. code:: bash @@ -55,7 +75,7 @@ Using the import:bulk command .. image:: images/bulk-import-cli-options.* :align: center - :width: 85% + :width: 90% :alt: An image of the options available in the import:bulk command By typing ``php symfony help import:bulk`` into the command-line without @@ -90,6 +110,15 @@ identifiers used internally in AtoM to manage the various taxonomies, which can be found in AtoM in ``/lib/model/QubitTaxonomy.php`` (see on GitHub :at-gh:`here `). +.. TIP:: + + SKOS imports can also be completed via the user interface from a remote URL + or a local file. In the user interface, multiple SKOS serializations can be + used, while only SKOS XML can be imported with this task. See the primary + SKOS import documentation in the User Manual: + + * :ref:`import-export-skos` + **Example use:** Importing terms to the Places taxonomy .. code-block:: bash @@ -119,16 +148,19 @@ Taxonomy name ID =================================== === The ``--completed-dir`` option is used to automatically move files (e.g. XML -files during an import) into a completed directory after they have imported. This -can be useful during troubleshooting, to determine which files have imported and -which have failed. The option takes a file path to the chosen directory as its -parameter. You must manually create the directory first - the task will not -automatically generate one at the specified location. Example use: +files during an import) into a completed directory after they have imported. +This can be useful during troubleshooting, to determine which files have +imported and which have failed. The option takes a file path to the chosen +directory as its parameter. You must manually create the directory first - the +task will not automatically generate one at the specified location. Example +use: .. code-block:: bash php symfony import:bulk --completed-dir="/path/to/my/completed-directory" /path/to/my/importFolder +The ``--schema`` option is deprecated and should not be used. + The ``--output`` option will generate a simple CSV file containing details of the import process, including the time elapsed and memory used during each import. To use the option, you mush specify both a path and a filename for the @@ -185,6 +217,93 @@ number and [z] is the total number of files to be imported. :width: 80% :alt: an example of the verbose output after an import via the CLI +The ``--update`` option can be used when you want to use an XML import to +update existing archival descriptions, instead of creating new records. There +are 2 modes, but only the ``--update="delete-and-replace`` mode is supported +for XML imports. When used, AtoM will attempt to identify matching records, +and then delete the match before proceeding with the XML import as a new +record. For more information on how AtoM attempts to match incoming XML +imports to existing records, see: + +* :ref:`xml-description-matching` +* :ref:`actor-xml-matching` + +.. IMPORTANT:: + + The ``--update`` option will **only** work with EAC-CPF and EAD 2002 XML + imports. It cannot be used for MODS or SKOS XML imports via the + command-line. Only the "Delete and replace" mode will work with the update + option. + + Related :term:`enities ` that were linked to the matched and + deleted records are **not** also deleted - if you want them removed, they + must be manually deleted separately. Simliarly, on import of the + replacement record(s), recreating the previous links to other related + entities is not guaranteed - AtoM proceeds with the replacement import as + if it were new, and uses the matching and linking criteria described in the + links above to determine if it should link to existing related entities or + create new ones. + + We strongly recommend you review the User Manual documentation, as it + contains further details: + + * :ref:`ead-delete-replace` + * :ref:`delete-replace-actor-xml` + +The ``--limit`` option can be used with ``--update`` to increase the +likelihood of a successful match by limiting the match criteria to either +records belonging to a specific repository, or matching a specific existing +top-level description (for :term:`archival description` imports). For more +information on how entities can be linked to a repository, see: + +* :ref:`link-archival-institution` +* :ref:`link-repo-actor` + +The ``--limit`` option takes the :term:`slug` of the related :term:`repository` +or top-level :term:`archival description` as its value. For example, to +import a folder of EAD 2002 XML descriptions called "*my-updates*", deleting +any existing matches but limit the matching criteria to those descriptions +linked to a repository with the slug "*my-repository*", your command might +look like this: + + +.. code-block:: bash + + php symfony import:bulk --update="delete-and-replace" --limit="my-repository" /path/to/my-updates + +.. IMPORTANT:: + + The ``--limit`` option can only be used in conjunction with the + ``--update="delete-and-replace"`` option. This means it can only be used + for EAD 2002 and EAC-CPF XML. When importing EAC-CPF + :term:`authority record` data, you can only use a repository slug as the + limiter. See the links above to the primary User Manual documentation for + more information. + +Normally, when attempting to match records, if AtoM fails to find a match +candidate, it will proceed to import the row as a new record. However, you can +use the ``--skip-unmatched`` option with ``--update`` to change this default +behavior. When ``--skip-unmatched`` is used, then any records that do not +match will be ignored during the import, and reported in the console log shown +on the :ref:`Job details ` page of the related import job (see: +:ref:`manage-jobs` for more information). This is recommended if you are +intending to only import updates to existing records. Note that +``--skip-unmatched`` will not work if it is not used in conjunction with the +``--update`` option. + +Similarly, with new imports, you can use the ``--skip-matched`` option to skip +any records that AtoM identifies as matching those you have already imported. +This can be useful if you are uncertain if some of the XML records +have been previously imported - such as when passing records to a portal site +or union catalogue. Any XML data that appear to match records will be ignored +during the import, and reported in the console log shown on the +:ref:`Job details ` page of the related import job. For more +information on how AtoM attempts to match incoming imports to +existing records, see: + +* :ref:`xml-description-matching` +* :ref:`actor-xml-matching` + :ref:`Back to top ` .. _cli-bulk-export: diff --git a/admin-manual/maintenance/images/bulk-import-cli-options.png b/admin-manual/maintenance/images/bulk-import-cli-options.png index b0b322b5f97856ff1913209f55055a55ff3afdae..837a98f6d66545d147d841667d6ca85e2494159a 100644 GIT binary patch literal 28952 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 B;+X&d literal 63963 zcmce;by!=$y8laCCD^NU0aEe2LKq0slD-JF07F;X17I$cIch}+$E$+cx3L#jK zU)t`y&p!9=bM9Zio9E#HX3bh_X5M$?{mgd~@><25`56clO{S@3Ih zcY}i^H*Z4IJM>@22cy$x8Dio)8oP>OXe_P8X`yMe%B^a`!b&1T$2LGpqs?E!8*kKw zUss?23J7_f@ngPxkrUsu<6A(C!Vt!4i3bM^b3blc3~yeaCtnMX33Ed|GLl!MHdir21LYe~`{mYI%4#4<*{XeE)!nXa z{{3=SM}5lEzt`s<-2O9XkQUaTH0ra5I7B8tE1M*DuUR^URo7TuH$zTy#;i8%0D!gl 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 )~PbK-Dv| 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 TVp9kD=SgHF6hS2)KKcI#A~8yf diff --git a/user-manual/add-edit-content/authority-records.rst b/user-manual/add-edit-content/authority-records.rst index 056137b4..41b339be 100644 --- a/user-manual/add-edit-content/authority-records.rst +++ b/user-manual/add-edit-content/authority-records.rst @@ -181,26 +181,26 @@ overall) in the application, AtoM behaves in several specific ways: * :ref:`Create a new authority record ` * :ref:`Edit an existing authority record ` -* :ref:`Link an existing authority record to an archival description - ` -* :ref:`Create a relationship between two authority records - ` -* :ref:`Create a relationship between an authority record and a function - ` -* :ref:`Delete an authority record ` +* :ref:`link-authority-to-description` +* :ref:`link-repo-actor` +* :ref:`link-two-authority-records` +* :ref:`link-authority-record-function` +* :ref:`delete-authority-record` .. TIP:: + For more information on using the specific :term:`fields ` within the Authority record template, see: :ref:`ISAAR template ` -.. seealso:: +.. SEEALSO:: * :ref:`add-term-fly` * :ref:`add-custom-links` * :ref:`entity-types` * :ref:`Exit edit mode ` * :ref:`term-name-vs-subject` - + * :ref:`import-actor-xml` + * :ref:`csv-import-authority-records-gui` .. _create-authority-record: @@ -825,6 +825,8 @@ improve import matching, see: * :ref:`csv-actor-matching` * :ref:`csv-update-actors` +* :ref:`actor-xml-matching` +* :ref:`delete-replace-actor-xml` .. SEEALSO:: diff --git a/user-manual/import-export/images/eac-match-options.png b/user-manual/import-export/images/eac-match-options.png new file mode 100644 index 0000000000000000000000000000000000000000..4a442a0273a0e173d995b0d1a4b08b3407ae0e01 GIT binary patch literal 8249 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�PzK_`zFBJLx8btTE!{F?1kCes6?58K-GgmCZ>KHJIfI+d;{O7dQYJHtfQr-@VnIw*N=$r@=!S^nauGaFk$QX;hsD{dKse0HdnjK`}6x-Y@}DI}`2cwjVkYyfWsV?%L7o==Io)tKova+EmGk3g5*-iKe5{M(^Kw686sg z+*WS{E;P)pG+8?mzu;0@U&bC$a+?b@8XjfXCrCe7jY_tf<4%97Z~eYtXDt+t=4lz9 zQNswkL7NvPoXu2XgIJr#Ed%hB$eW&o25deN7f$1TpE_M~(7d8oRpL~x-wW+jetael zB6@c^Q`pJpx+^8HIzWpP<$`%yPyJR@8jn(`9MeK0h$=gAOu28@HPsN{zID}LTe9{S zhjrSW`PJbEyFO`dR}99k9WsTI7ItrbG@Lbgv?h`q`S}|3THxYGI*EX!{lo7eELp>J z2aAOsPyA~f)Q9&R#*$~QdG5g;?3pYR@7eQbErWf7zYtDUkfsQiQmy$UTD!n;WS9RW z<0S7+&tUN^nNFX==}GqTrU!=M(S}jpY`mMSk^R_WC32a?yWJCdBi8a5^9bVHs-vwe zY|*nHbYGpVE4%kJYqONr;(_+Uo~QN6JO7^8fP+m^X|%~-uRZ%V8X|}}chAhk@2OJn z$90h9jk8^cMgEC9QRxol>k76fR$HxNU)-+IE_^=ST>D%x^>B3U(?OtKsF2B)s5-?L z3Dhgme(bkF4)dv84Q4s)sd*!2xXOEH6Ek((`mX+BPKX`9mXoBW zQiR4P!JIZ*MfL=0tUIVm{Q&%~({#i{;UV6lt%;488Y4yv&k{lqZ`Aw4IAHb|Q8nB#^*S*_ zxu91(wGi&>J;Jj$&n*bk0Hg^V{YV1Exm{3L{~6H{ko5xiz1Qn8$t<*Ou(m6lFNj*}`b}UVR_p zbMzCidSN7Y1ZC`!%a-CL;d^O6Jf%oMd;NIhgo|PL)$)cUdphJ*hz>SdG3XrVe(f!R zo5AL`PCF{gS?P1wQWk&1Ygqvsvd*pf~(nBshme9XE z8_{POR|gM8ZNfEMWGK-iYAD@6g^hMJb%u~M-m<7dE5gt#$?W6)>I@towUKO-et1Xp zTT9Yz<98UDX`)bpWG0u=L8Ty{UJirr9f4p8-vClL&P^ZVUEKMy;GMCQC!|AfQyC}z z4yZumLj%Tp<1D?H;e7QoD=zhsc`Bpk6w!dF_7mHxxAb*0s|K&2U;VOd&Ky?v_k0w4 z`2z?9xYsibp_!qj>f=#d_}35{RO653p{52wu@y`2`p-vw1v+j^w~IQrw2&^-LElSX zuN}#OuXH(|u#gYKo)d#tNXs84e$33tF8u06BjBs)A|P!GBPnoB`F-b5whIenugT+K zpz0`>v7m|0YoMR<(AN_kqRz4}fsy&UV1Nid1h_8f2FH0=J)}WVQc~jT>iRc*J7;Cp ziG>jWXCo(%YV=;eO;Syu5wL6pN|f_RvDK#4U!d1CypGWNSF1y`TGH&~k?m|0x(Yr% zhm$q-OG8YtZ*P$Ss)1etOjnbinVD%-=?jp@>S~DD;{+PcVC{O(B~*X9*b-a0j1dT= zegD3G=?gbEL2@!Hr3AhLfYX8go!dXs{7)fmQACq3Znn`|y=WL9n?_Ah0Qr43F)>m6 ztW<^7KVKp8YWrVdu)8V|&f}Fb_?0{-_|%Z)#&sagrj3o46$XI|ov~ePp=Jzpmmu=8 z-vjRIrM#~I=@ATgXwvak}V`JkQy}*@J z+Dni*R5C9>QsF+?7eL=H?)C~IrFVYN9%)iYNJua;GUfwoV`cS(4mt?m;x!PS);i~^ zRw}>~WPLt%SNVSy8hn7XVK6P?KNAxZ%Y)Cona8Vz5rJH<=V5?FW1!Qi7q;~*Xacq( z)01YLXr3%tDWlSL-GTj-LFjqhBJu~K6|R-#&0-?EwO^yxVk+Gy0|LQHzh%-;p@VwQ zRHuu{LMnuHI~!<=1msS1_e_S~JD?vp&f{}qW1$w)bc5brc~5$q%`1YH)n9n!5N5~J zgd}BFY$~vUpvMy0b$VgalrE0V{w0R|NiAPs+R6n%8}M2@w0DmO@Qt+JCU3&-E?+?A zv83>?trtGRq^Hvea7A4I>|f)y5u*veYFFO>Cd=N$=c#eshIT+orebtfUKh2Co;nR{ zcGFV&pXAWRGV=iy!3hpFDUO zTx{?lPZFwmnS8H?yRHmwA5f&mEI8X(Q9D1wt?asOtuPYNz^s+uYwOe^jTIi8+RPkm-xSwUDD#s$ye(B^L{-gbw>C-CyPv2xl zb5n=D)U#r$MHV>dSyWrRrz@dl@(=fBeNj~=t5cz}pKeT6HJCiht|zCbZU2kIhiU8D z=(;dOvU_2Ne0P%!1giv2U~!et=Xj!kd$b||zaLWNLK`c~w>YqST9en(Rd}F#FYHB- zd6UG~(S3E9LiB-iL4%j)(kJRvnfbHH7|qXN&}dbPt((g-9UP~Y9r9QCrKgzJt%(^L*9J@KEc#roON8xW?$-T7xgZaQj7N-rdIeLm4oPOKFWjGC~ zmTi^FrW`iR{#dCmhU5-3yPyqYmfzt;h$U7AKP?B8RFNXqV!vDUbasR? z_msm&Ed3b|*st%T;JwxgUDaC@r(mVZ(UWdwy{hBB=!9#I!^2>5a(Jt=MjUz}v#K->8#u%6$((!Y>BPZy)++#*9imT?GzVDq4e^yH6xX5t% zm~eM^QAprgi2d^mn?+9u!XkV^fJ1a-&VPhnwVtTrQ!(3?cu-*@ANiypfv7t6glkvw3>{MTMx&I+Jx8 z#JB9ZU(q$yvY3z{gf`UO($Y=C;-mE_$BIekRNLlJok63m0anz5T9a>s(Ql*R^~2z) z#$t6m*(DInYUwU`v5^6Xb)L1MT~vQ%J8zlfXzyE;c6Pr*A?$^tU5XN|zYe6WxHyvO zCv#&hM!g6fFBc*J_)BfPNmp4Q0U7NI(Yw@1zRc7Xp&j!ZEtk2N2rcV3Uunp?7UX$` z=dO4ee=U(|5D{>7Ay%(zR_#+>U$gcMzXH;BP0ohpAlqfe@W6PBFzrinEgS0tZ zQI3?WLbChXexEl9n-mr(wl{r0M$@;(`;FXWNmR)!_FYBZXZo|izd$@Ss8>+&rcgpv zyr|32pgccX?)|mSsH`!pAsV^cQt#t_q;as!&o=eUmSm=|{MG%;@Xi4m{6qGkYhd?! zry*ijn9-Eq>DP@@jpOaM8XD&KlXQrDmK`DZ?9bGsMVxNun~8_C2GV~*A47JZyz9C% z-Lu{aF98ToqD=r5sdVX8M_?udxn^eWWbB|5dS=Na%v&2s8w*YK5YTYOtrb6%zIEe< zR6+DY=Ex6!o6b%tjr)=SeY2l7LKknep@zwvTmqnPW6Nxm+c;@qLPcU<+(FI-NTv9u>HKR?+9dZE}W@q5?2M`RQb3)sFsI ztB9;dd5tE-+7JH-q8Q-wyQ>U8jt-^&zQRIo6`gpvjY?>!Cik*r_H%jWx00?&1`x=F zU50s6?~}H-Qs<;>?PHV3BhJI==%0RFZRN67)KvUCl$PEmmHo$vOCX*z(wnomi*7p? zLGG5si)R|D=k@o9>~B;5^r9Z{qh9b|zR|zEl$igIuv}QL{r{GX3K>-pXq#So1-6Z8 zuH>kqo)+oJGZKN7@1H*Dya1BkK=qo030Qrx{9wNkoKd4EduU=3T(A`S94~uFvd{nu z2A9kVO#7>wSI%-;3X5I}zZ5J4@vWDcwh-xWg;(eVU$LYdIfvFJue8sd66+ixM|E?pxe_u066g7=18VI&tB(20%FtRnQ zJT5gW{1;}UVbcRIvB$?BHUaEM!A&SXTn|NS6x?y&SqJ(n-gwdL@SZ?Ht_U*aji)ID z2g3r3BDG)gtntf-?pkw&nm?l=`z8zAN-YSlOXOKt^v6g*`$PMah+bIW5C5w3@;Z_# z7IT>8)z>3rUHGk9CP?)K*_jM`6?1CcD_hG96HZJu#Q5|9utUb-E;!19*ahb3!iA+*Q&C`R-C>ikq2Mr<^_ z((PeLm{#p+{U&=Aj&jGy%r;=7`;U{kGO7eCtT7{8m?`YM_UHFGsNV-JwlL>&ta>!e zBlzZw-P6+X&-$n46{neipZL8LVx=;i$<|Vot=TW;$vtXa5D_?b&)5n1d(Xwjw8Hzn z=_GnI|HYuj8B3m}u*}xWa;@yzBg$39#B+2Ja2|>Kb!IUkv^}AI!3JOJtwS$+^N9#t z?pwH-hlLP8K-dj5D9H4RB4hvl@E4f|cI&C3D)b8mK?1!;e(}+XDT+pMhH*iF!S#)U zmTPRZDRbyX<1laV#qh@Zk`JS5!9QCaE!3oI0X`eZ8V1`2@BxMmvb*FPJS%Vhf1vDr z?hTi&C z6&e^C5zi@V7fSSn2*1ASOg`M-GRrdVAOQz zwyimvR4!XpG!+rBqw&y^gb6pn&&>;Wp%jS%F4M%pC+W$CTrYXY1L}^BKV9Je8xNA3 zmgO)PI{{|ZyQ1_-3>?(;rilIm$d)ox5jc;3X@&np!v7W%|Cn&DD-dqjR`)ptJ3G5` z|5)WJ=({3nY|Nm-K<;EQX_p!-`ISyD?9NTiY+3UP6Oo2Di9XjrAUb|o+15|s&5e!4 z2BQMq(JD)%l8`5)Fha<=G46c;xFT))EvfSLOlF;sy+kwv!Ol)rcW&h~>q0d_gSnV^rmLIVKq>nN4EB6>AaZE2Z;O-d8B3Nsea{sDXHnJ%hVu{YGMZUh?6(a8-UW? z%pcM`?;aD+*ZoiV`Hvg(zZF)~{S1B zJuqfqID?|!C;ag{{o7DH{R{(xz_`wXd!~UiTl1k1Q-|!<9pT%Ypt~H&R@Z@#hpbZc zKaY!832VGce=k*16KnmoAs%xkBYW&^q`i>q?>U&t*$%eMy-2bqq|uC!IeYWq{qb8R!cN8feo9Q&kmc7#|;Jru*E7P;bcWCe-!8ye>6d!c--{H`@}B*ul~MI9 zUx?Bs+jdA?uV~E*`@{HMG&zqR+ui)lAxvI6p7o6T)X8jT((T*&8Dj;$U_pz&ZhyU@ zzjv761pL_j)I0D|Z17xw8r?8M3zJnPl$h9@F-kUDc{h--26O+l@A1XC@lLh0s->ku zr=HsGBV8hlEuHU5$w$Sz*F5Yofg-|6zBWZ|_ItYoWyzw4q>fm*Y&04q zPlSxW;Hks!NUgW~_wCDN<)0YtjP^KPg>&8M75YK=Wq{R(~c0vH?cxe!fxgV>cMJ_7b`~MsR6ift`Zrr|}Nn zIEOJTkOpj#B{;B_cq~% z3im3M`!!0{3)*zevCADNpYAMXfJBEcu7X4_c$aGII+_+EsAbbF6L@AC{!=b|R}1ra z_{wQ}OqEJUzHDrnK)Az+g6mZ<4XVFB{C%XA zD?iRs>Z_x8v>0g!6L&hbRzLNvsHJ>~X+;TTIe9_Hq~o^y7^FO4i+FE|o{e*I0rk)> z-UMZUT=qtUu(+mF^i`xrt}JoG>denenLcvORyG*w^vIegxI~BqmL&x)UnF*ND};T| zzMOVOe-@%t^E~Am6bJ>RXo4^Yf1oJq?5cjE;@ns%@al9$OyK_XJ zF1XwLXlKSqPNV;pqM6!Z`rB_7!cVWAXJGIqPaTKMjr0|;A7Pu_^>zm*;44a>YePqq zZUlaKPn!CX6Q_;Pa6@+W3t+u|%o27yR-t*}0)S&j_qP>$5!8b~NcE`GBiP z8MqFIp})f&IU_Hzu01nFOLt+bnP<4oHOW&0V(Ld}RDsY7Pe8y}RKQs1Js!p|(>KL#<&^*mo$&$@Z`%L>pUgWD#u*`r)%G#IiH zHC1%RN}mV?sxIMJ_{C()y7WN_-rR&~5vSeku1Df7i5~HWq$@B} zS4fqj30DlliSoAp79>o?)q3Yme{TUbHpWGEY>XA4Ch=vw20(uGruMHKH9aCUXF&b4 z?}{SmOZwP5(`OFveUg*QqNsck?O)7>jqs_iqWO*ah=IUnS?y-bUOIBsqsKQ(!#!m6 zxFA%aMY+v%-D3jJHhoxK(_&5-ONm;i4GVJ_AEib&6$xCo8beLy7-Nk|?gdbyRJiAl zy@Pk12b7jWk!u;hiZTY)(u-3nQ9>kDLqVg!-}1G)`T*abWum$G>(+nU2SpewXj~faAH4rzt?Fo=DM^ngASr0Wi#>Q!FKvKCNTZxW zH)d~c%(CiM@NtDk#mAYJWL1~8W!#tA-u<{n?aIeLC=CmmxVRfqMKaZL>_l<$5*a6d zvv=x{Waq?fJD0Vu;EOWgtJ(@;_Fa(f!t|LMxTnq7=6USCmu`vA^*r1Ggt5vZ(Lp3{ z^9bBbl*;dHk^b?+;2Ij)*&MRzr{A!5naKtB_Ii(w`tiUO28LEEU(ji)7h?Yx2EA1K zHz@K2@&AIP_22&qjQ$D15d3v06e>Sot6~z@;Mcnl!9=&|uB51l!C(Rd0~J+NW*aIz z;Ns^}lA}^Mr(igBI^!NtZh8Tv}8_S&EaQlDECwR%a$KDJdzceG5ffC$U(QnkFWUS8JlwVs{dIQoFJu6;9~|SqJ6y%UhK~_j&!x zZNe*S&{dQiq1wZfpe=FkoXl|-Aj^vj2BgHOPKk_7yd4!obvJOGQ8^t_P;O*L<_5cT zKH=5AxiQwzTCY$O!z39vIGvlmetlj1XI;Jn?*<>TIqT`g0=_i|zhLN*uJCJ(fdR1* zX3wysv<^md7tXp&uE7Ki zUVWZJdY&rZ_~>}7+u_GDW(5^C0#$ATQVoCBBB~7uXVco+ifxFT;+f7WiARq!F6M9$ zn+R{Iwu$wUlo+Otwm=OO1n_--?ZM8(24mXy-HA@Mt?^YJ9rBMLv#($CiG^y2&tan~ z`MLmQC2HQ#wUOBoneco*(+^^vf|ogh!^qZF$PIOhmb)eAvfo0f9nFF4{V2w6j>Lwz z+85q_?mKw?JhE=h_ba?w{XsYHv_ed%OJlt3Y|BVTN^S*SW>*jW0*|AXYW^tey)?SxHt34Kv?~b5-p5NSFLI_` zmVpTL{^qv{2({h2<v3UJ2dQQ1CeAzM-sq;0Wwtsz?*M_hbkPK@aDJ&U*!Ro;Y zV7{`no{*#tFfW)pYh`b#DKSTgG0hQ&ZF{Fa&|PIaO&{F?TfotN zZ>UKzakm_0LlypnC}EEGwajK}ZtcQDn+S`#G4Nf@UbJ~Xw^ToM^$f#H!R*wcIe$@T zWcdW<^~v$Tr2KMdKJQ1!ai+Nh5;!++3jMd(X6P*QQi67Qcir58)Lc#e5`l8u)YL3!y&L3O?h{3s zL5!O%J2{YOmD%XFpO=&aoMvc9U|gp@r|HOaKl#?fCvp;^m7a44Y*VZ6^K{Iu3J+Vx zWg-*!>u7P8_R_1xjd{^!*XP^P?BcpgEvX-~WPvkJ%-r^T>f+Z8WIeZx{Kjw*b+<2-R2h*A zY9<$aKr6AckFd=z9OrnV?-y+imJ*ZTtCQDIFTVZlMYfhz7{P6NiLyO}S>4CzDrlV# z;Bb}NgcJ?@0m&I5Z&_jG1JX`ZW$7(LWl`GPyFKr#c8nfES=?kPdC`< zMyW4h!J-AT*uqZnhFc0!Uc5W%V?16l5@9cVMfpIMP<~kOX7P19sW_a7toisAJsW$g z%v<<)gy&FrMykwP5E<7I%aS#;8c8RRGPFLjvyjx*afYFkdnt-G6PS+a5K+Ba*-T5i0^8 zJ_4bN8SkZPxQ!icrx+`3gZ_$(C?sU^C7cU*w{@$-EJ8UlWlc9cR5 z$jB_Y*kZc>+$20;55ic|DQAw<)BP5Ref%TQ9T~8_n7x;$#BYpKl3KXD<3>$3mg{ou z*V2ZIU*2D1&vn76OU;KUY@@JNeB@-=cGlT1SOz<3xpx2I8Q)49d^PCu!C2;*>^)1qMnZ=*9gdtjk$;Vr(pAr-PSvL=NyrZ~az- zmMgdIf$TgFZa$eP1OGQejfjYdi;IhnjxKv89uoa46ov-H|5dj6C#L+bMfSdUd3pJT zrl3(<>5$!ig#&;p-Q@EUaGfVhWHyXUGB7ZZ-*z*>$G!rC!NiS?4FZ9%xM;i0`Zuwj zZ}2N=X=!O_n3-f&_iuXCe-7+_5V8JY5khhjBPS=fHh^q|;;n_I|GP+JsS7D#B@QNAoiDIWPRI%AxE6iWe_l^p3s|8ylOim;Td3 zwEV<&c4isL$X)w-HX@O+snVEp%uul|^uXeDuKt9)Za$-9)txDM9jNzx4AdW|YK2F=bE zU^NfL9G*X0bV)J8n**L`O?DnXBYkRwfjvx{ZBm2^P3||ftc7mBKk&RwPr0jp^_}xo z_Fe14Iop+OMJ5HA;U^Ro!CVoK%YXaC(5XZ=9cz_tc3k{!^q{@}U5s zb%o+`EprQ?EuFlj^Atfb&?#%*{p&+t88Gx~oGLQqBDS`$XYs(+_G@v9Z&ZEywvz#N z<)mwDsh@c|Sb3GB?ML?smwpe)*9MjV{>0pXx(%G4>Uq62&Uh46JiC!Lv!~uuiIrF_zmF*QIt|{aoWiG1vbV!GbCl z3;J#u8En`moSGso?>Thv>WYO?Vm)(8Bk$n1LPSy%^t(Mt)2}7i=b7zE#@!+&@!lTN z?v>@Di>|Ei3%KG{b2)GxYH_*cizzpcXh1pOxq9Yv5k{yd9}?y??a$t0DLQe`&u-kF1Zz5priAf`%LrWHW=ie17QU@P7pDv?tmM_TIIr3k zA0H%|1n8-)REDp*0rQ}9vSJP5Z&)p`K@_dciOW0L=d-qK6?Pbe<8nQ~hi`+_NcI+*!Li^F$3r3CW=na}x7RO6bpf0ixUAbzj=3v? zxQBtYX(RnOII-I=t-DyWspi$O4jkL-UcGN z?+4d4E#PTY*aYVyJu7fPC57_z?=O1d-vEeT+d0L}Ys24xwikR&`jar4h|XGw>C6D1 zNl8kD`LydWX1v3~%_IQX^u*(x`X5h&4$+++qHoJ4$I$LVC;0U7hpD{65`I6>)-PvC z!H_B_>+gnLvhWs@E}5-V`D)vbHC(8b)w7{I*A~tagPc)cU=F1vVlx%}3pNwNLVvnG z`|%~0-WsT6rzn)$iaiGG-mAPEVi!xZY27G1GF~k=FYU2X)Vn2J(iyr|MK(WM)3=RQ zNIdd@!>+mYj7Ztbcbz=|O(`bM-os1MlyAWD6UX=8@<)TDl%;Wl$JIGO5MrmtwxWDL z9_=xwafo%ZMhq(_&IVWH`mwS0tO_KA#`n-+?OM`sZeMMG+*oIo$e+|=Z0U20 zE)8yYSk}0rIN>nK&^~@OpSpn^C>KG!C)S)M_q8U|thDvhDCce(<0GSWvCfrvVSD`& zd&c{I$i)ro$uK-iO5+zNE=I2;b5g9$C&UQabDmBFNfx{#hSH`y`41#V9}2YC4T(eB((lW*;90tAHL^_=KC(VXp+tLO?97I(}=JOQKC!u)$$ zOGk^_QnErfCMvQJQ?<1ZZ?eYzevZr`Hl~?Q2U81BQ;ir}EbDDzv{WSeSv#0qn7hHF>FDMUV zI(uIG5mH5gXHD}%l=^FE{ncB&f11P+=l=Y>U?rpmdUkZH_F$f+ckNcqBxb}WaH?7I zA*?Bvnolo=tsNz@Z8V9@5~09zB@=2pRR=^$fae@rg7D>@>T$y6>sSL-P+KuHGIj0N zSp5Y=PRu6KdNZr!=gnz!uwOZ4+w*Kx*;Dm!kwi0kzW)l0F4NunTcazPH@qq!0D(Y0 zB9YrC$i-_F^cg<%8I%9&K-JUb;lGtKpL_qgFZBB}ek72z>bTcO|S z=H8XjccU$fY8Z)ek>>-la&mGGN1{Sia2QSB)!474XtLR_7Tl@;{iE;B0%@D*54qOlFeF%w+OQh?0UdCI%q}3JMCQ%x4J|6qIK@C@4>TUOs*J zbG5CHhJq46EF%h>WA5XE~pc4PpAa2?XYAI>@_`_MP zpg@NXt8CiRekE63)hI_IXK%b~NOC+Vf!jhubTMlqkiG66H|GNB2mIJMX?0|iAi)1kw)SS3PM zx4KO}4u|?Z{;!W?vf(PT?*Stp&j(emMMpzR8s$pSpBd=56u&cQ$)_A5%^8ZzDy2|N zYNuAmtSZrAMfuhurw+x-duOEqmuUeu>-_R42(aK+qyjSL90XZ32bjEq*09F7t4*e! z%rbO~a?=YFGK4~LBjTrVWz>1&XUUz=Q9hT}Doa)mzW!BUQ_P?b^4M0Q)J(GH(%HE@ ziR=&2_v@~H(^VI4i2=nDbNcX zqM{v{w^~)SwIdP5=&;04Pj%x zc1V#fDASvvi)Sj#?{1Ghfalb)($#zOGe7y(vLhEFrM`@{ak!TA5fo4LBAwl&Q zTR0o&c~>1V?g+HTg#NlKHj^nU7W-;&%&#PtMZJJjN&kFlYIzRj%8_p@>CcoAVC6BxW?> zeF??)0TzbB_ebZ-@;?yss7eCaE-D}dEexdg7i&l4q*e)1D9^kwe+gyfur)+H(TU2Sc6 z^XKB4?nzvx{a5NqT~1e*WN55gcW${;Z1NZA6k)w(?Q2ccf9#5?jR#~b2lAAO6oy@= zhQadhAtd70aj)TaLK%x*Fh0Crw%8l1!G|Kg3 zsrB41W@bE|iGp$s@o#i=tZ25x7|F_qG|Urd;Dbe5NyTCY0uH*3+AF8nFT!o_c${|0 zbj2&$hp7cdJTcQayf?q$A+~KCE^^9Su|VGG!wDc3`s1mt6)VDPP|9I{gh;dZ+GuUe zKvqa(vG;6_s!-no?-$%su~mO@!Sk%w-bWl6Za8ZfcCUy&SH_S*c%xJ=bTfVt3gt%30z6la1}Anr%2!o=f-aoi=Kq-=SQ{WfLVgZ-)v z4Yn{cT3dfH>eC5q;Dyw%@=`c0bOrum<>#46i~{o<{oykUuSYm=Odbx34Wt_>C;MdQ z$q~AMtE^{GhF%bNZPE6nFE@7~*BK|h&SCzjs)>?oJu&&0<77!Ady18xn+7KEU0A@5 zCk57``05r#ySy>dhuW-K9A@TLBwhHzzjABsc#-0fCMlZ~y%CF-`(?L_6BSsE*d%rb z%&8|7r^R*TKUr- zSMctnilt@IZ4>roV9`)H8H+~a6#FX5mPNQ&oH&D9+K!)j6oSA?1NUZF0eI z@mw~WX!m2fEpWvd*j>Ye^fRKP8tS6UB3R$jX)CMURi`!gu6{>y*iz(Jt@2q%8{sq2 zea!_*W$xKVLja?)Hz<49`#W<-ji+NU1p;1TwNs zYZfDh?Bk=^5!f=>>GpCWQNx1Lsa(&~>hDj@JzTh@T_klEg>oj+hzY2n?Ev1{0xxl`rbX-gGchwm)n&{;JkkuoJ zzt+=5SJw=gnT5YV5ydUtkSXNow9&-Ey^(AnH22+Dq^exh6^mu5d{DEYOW%DG8yzos z>BBXj%U{YK?h|bLSJ%vnt+_;Di%VuR`W5TNJ#nw3uY%^?(e6d2w0z1j8Vj;zDL1g7 z16%kJ+N7|>$&Ug8_CHhehCJZ1nQu1n|A5r~2K{=0_<7yi0U%}#A6oS66c`iacY@Ac zX7J_T80f?dk``8cXOtVcJN+!lQecjY^4TloS3&QB8cwtJoRsFki148Llf|2gTn17I zZr~FOQ;UHam{juA^{8k-LSq(UMsfR8RJ}-7b2638 z+Vmqbe`gQUa=xi6X(k0oty*oaWSFiV2!4^{=;@L%R!~UU2*s%Udns z28l4&6|=n3Pl@o7i+mPhjP*_c^d@u^CF z3eL60x4q8fHc&PGWh0D%5ihgFe%#Mfk0O~O0T-=90pxCN_!1} z)HWz6>Z;{&9Pu|a2dr-mop4K!*_b=V>I#wT1~c+K$P}zOzWZ4#cnvZI5Bs$*%bGU? zH^4%9Ql5>pebaSJzZcQa6wpn7Cm4212zRZq+YC zZ&COJigu>mlChjYZF@`S8?(kf+i720-0wF8r?eR0w9A*%R=*~aB&}$W_-`KAD$Zx5 z^yQvl4TkdWoiciKiwxKl#$8vUzr_w1O5=_F>NWGB^Rt)-vtYZar~zIQVjy-+#lYhU z31ma8tK!FCOSI++*E{MJ*&wX){Ucj&amm4?y3DhoKg;U5e?0N7n&*o|lOY(^Z@nF^ zXT+1p+JJNdkn?AKqv;%rEuW6r*Lu)`UG@M3vXxR!X$yi_&KW|(6Kc{P3GceOC{kji zd2c)Jb&OBU6rK^ynh=@J@Ag+j``BD=lZ`cgJQw7+tn54=sv={3bH&?B!goSvP?&XZ ze{^D{0zedHD^lOmCk>IQ(NU32J)LH=BkFsCq9)Ez0$(r`B^cnxV>{Pd8zhA=g3%j$ zOVi#jiWA~D>0mD>JpY#J_pr9nNLoK6?(}yykkw1ZuV@xUlF@BXvW@%uz<7bPUTs8E zcrT&#D!(1LE4sjh>vrGfUkzNy<=-$D+jCb&yn%FnHEH=wX~7U2_Za z`k9#Xtm5?bv+RaqSbpJrvr4@cno`Oe$P-bS4;=xlG9(vC&rsCR11ug+e<&z46u@VX z9#5l^L<%WJq-SJg zq^Db(n}1FiGUl*qiFl-fqAo`M#@N`Hnudnkd|Xscu5?NWE5FZ8_`Kj=IvPB)T?@h{q_P%1Qhq$OXR{P@8t6n<*~{t79xm`{DA?cp z@FmT%wY^ro-m!f+(4(LfMH0S-()-%@%3l!{=*w#*$o?Q)FjJD_J?TBw(?Cf|wy?4$ znfCZN%;pL!IIjF0{mf!WZKn!+ym8(l;)J@nMA_Z4n5&pe^X=tw8~ zES~VO%UO$}x7ltGnsOi~{yFdGrW1Rk%qEO7e^mi5=;s!do4TUpz%BSbkBX7Jxm{by zvL+$ogp%7>etWT}Qd(S0BtzuG{&`{>e!E+|@O1j#^sY#%OenLe#bHVrY6GgGiDY`j zse7!aj%cT`lXP5p`)jMKpN~R)o1C^zj@11*ExRw*LWiob-U)$G)7Uy2(Z{?k@i zm{~7BDW72qp~HaoVg~@uI6xa;L>=Pp=I=drH6!ez*zmBivG0@)&);)$I)9pv!^auj zbO+XwE`IybTHO`{HydjS`YPO~;{(<6&+k}r+ZNXo zJS`V?`pumlooBy8RPx4jbcnC96EKHat394dwO%Wn+-cQeB6t7x9gq8I5;_ zJcLyUX;w#Iv1_34c}jJSsBA%1H?=q}U9lKF%W0Uf;1Dd|}q7o&=}*s6lG z)2($fTT93)8|ZxUA}5&CmfP07sxgxqs94LjHnsQbarRL*RJ#py?*6jG40JdpE7*P{ zUY1aKPSOh9gUp4m;*a#HSPdph$-ab2mQb{tRu@v{en4`)Gi|WWuR7WISYE~W+#;tB ztZ)(a+P3^~qTQaz+Xa*OL1 z+(}oHvC$Mr`Q=NLnz3x!m^rQ6OARxh^M_ z_Jwq&#`|sEHE(Fw*M)vlk65nsGsNmp;9LH}jYUF59-!*LwdGW_ryBZR-tv5SZ2Os> zf_2&093n#dx1A|I(#}f!cAFY7F>;M}Zqx9S2e8rM$$qP(BT8!TXx`ka2|;Yiew6n~ z_8}3xHTOVC(%=3gYPI%KPFh?;p6tUTBT6kgM~Y)!q#q?maVSkHmg1e?`Z`l(3xX^#Y3U&-qzjpIRwNI=aHs^9>xF07GpjQOb z)`y;u)$#o@N*g0r#gb{RwSk$A=HAwp^WA9nZ83QRY|=cXN#6Nd4!FMc$G$*JmBU3I zLxpdw@q@t@Vun~vFH-k(RwOpo)<_xqb4jS=;m#GV&Fi*(@5*DGEC<$+aidMzzhAVF zax9%WDw0gB9@(_pISBz8U%e=NgG&y%HZe!(f27Kb!;fTSz@>jzAgKd+3&W@*bri_ z|Lo5q_Xmaew|~{}{`Ub}2`;3#JU>5QNfQ0JU+MwDBYPKy>?uHoCqy4Un46och|=+76J#yc7G%N$lnlUosWuJl{52j{<}1T*%UQ*FycL9hK3_Sv^#g9#T7WLL zIemCN!DV{yg}-k3+0F-$k!-{JGMWcQGz1wbzrYkmyUOF3w5j)7D*GgN&xV3hlvcbi zbNhW3+B|n?^yeLbMs;ca=xOXKkh>N6;e zN$>!}s56gKkmK%YuCBtU8>)iXjIh15l z2cf9g#nkc}aLV1OW;SMSv-wGzg_7?<2=K&pA*pSHg#}srMP8Pq{uZ|g#qveJ5(uLd)C2W5-Rj~xZQy7@@6A(-`v2M1- zV+-sHi`LNvk5g-@|LbqvqJf19T6bM~3_QJx*>YxF>j6H+7SgZ6G$D7icDV zpzrm^xR_6r5g$@Ktp*iI zM}COAl8gswLMHFV))yLx`#4UGxTm!a&zr`R$F52ws0KO*wJ)KF#%JBcNO$MN;j$kO zYDYKiefWN8)j;5GyG;_Ed{>?wq*&4-;1}*(j4NOyiL=Nj;31fkNkOHt==eJB;nvbM)xe#To&A=;2rFMI+ zaQ#NjwzTddp2rz?%zIK-!=cdZmlF@9j!2ElM`VSNab}|7 z*64V)O@gEkQheJf)%}n6%zpR(|Eaelos9$s$H>U2+i*pHagVgz+G+w(@E(^miU%nmxJ98Hac!>aL zXg2m28s*b?rpL#XS{{w7M0{bfhVr8UW;hUiBvaIy45Ur?hWYw6Lu`IXN#MWE-*le; zcLeZ1TEhSNp#EU@YoD)UYF>n}_C$sJGsx2h?^L3Gn-3b8b26$$KHM%c$lPCRXAh}B zO*sf;lO9i>C`yDBBqFHro3@73;r|%?F^2$P*Q9~Q9`v8F5uG!}c>c7@t~}>Pv;rd# z?y2q9YmL>L|5%yr@v@j}c+I8c=Xl*iRTa}GRi45f!GAdg(N)Z-1=Rl%5dHr^z?V=Z zcx)w^$LA~lGp_tQJnBFY_?B8QW7{nfZc(WTRWD6@UaZI}bag6!F8E}^uyjF7dt_(v z2et5`Qw-2?Kbuh}5Xpo{5;Wf7lXhgbydD0Nw(^NRrP@m@8F&q0rah~lGLajUy+`VQ z(K>lXdaFj{9ao&UKrm{!?-K|xQl>;8Clw((pQR9eW-iWlTd?%#PH zt{{&qe`o{;H9)02uq-9|`xy0o-tLXjQ>+*A;|Q9MM`h~$sXe<}8gduP zHRWhonnE4b2(pZ=ImlXUJs4ODcJEQ^F42uj86pX{Y;i|1d06@cmJQg-OOBt#I0@+@ zlKWT+LyE_{uSH5zyg`EbY4 z;7{S49q6nZ95v5DqV9HjLvKFX7ICVrR?GH)aT`F>n%8FxBwfy$ZL`e%&2TV zK1zL^61h1I%S0?BokwGxw(xw^$#E=?PbMnW`~u(65hQoDGro zyf-}RO^LvSeWP}W%#Hagm?Q$Z_LRiF#p13vB%t6 zn}F|ag3Y1qP++xz;JXns+%S{+%wY;O?JV_Br@OHGec+xDRQWQjrpBS0WuLMk6BODY ztqYRRc&XxmI@nNTSj2YQWnNiZ5@eAgp8MKZ0h0!Kw!6<*SqEN)MNm1~(7%TAvoG9; z4|jt2%RUKcl9RKFOWlmjtqV6Kkf+i08?kZC0q+7yDpn#}x3sIXp0@^Rk%DJ3OaIR2 z7FR&DJKDi-QyLS~*>wbGa&>rKfKdW0ikxB_U53n(I--UXn5+z&H60ShnjF_nt%(Xl z_NPq9YM}S+jdWa>>{;g3^+C>u+txYap^?foV8HvtFM@7fR`8MISW*~v=x6Vrc@>*G zc^>=%P)^(;?mWzl9RT0`j!MIwBI1YKdF#T8=l#eJ+&8CE5YAv7f)@I;Gh_Tw7VgBI$*HNd2P!NSYlS7?Unf-P8!=WPko-a{i%ktiwb$k zQ*w;P+*0-B0z3TRUh9YWa%V2NPb7cl&|>=I`P{YEakN}}Z)Y=)w;Eg7XZ(eJdMcMb z-4ZQ`f5CKJX0Bl^I79f7i&{Q90}R^AoXj9^M8nt!1fBe_tGlye1i@*;x)Dvi2EG6w z{Ew9bqqBgFY9S)xmF|hoJ*?3pvFeLD?e5CPz+vhE$zp82@H}4nyouUapP>pal|W#xHTQooOr<5_#St6vuto1hezG>z`hymOsk zEF3{X6??|@pQ@9NKdbQ6ggHo`FMC-|cp7>#$KGyU{WklAxHCy5N*N}e8jXhGRDTNQ z*kAC$YDtov?zH!pBK6-R4C76HN8}*FL+#IyVzHb%T?aGO0j8`4NNZMxdCzxeU`yKY z*6VSNr_0-T`_|3;yi-_Z1jhtRd>XLp(geqg1f)umMfP)4k{y2x+4%@!zP0dg{qw_B z$$;@>L3iDpNhmthRRp&R#@m3S|3cQQAh)3DJTnh#X;CM4> z*Ud8NyuLs1XBE~{N*OGH2D(J6%2oBJ@C7sOZ25V6*j^*5u+owQ`bYo9 z1;FuKU2Gx`+viHvT`Io8rb@#^9349W+;tR{N2|G+I34v%zQTsRbqXEz7Fxhr)n%6n zI){P`#PX+J7Sj1>p&QSoAs+8c@SkeIIJ3F0ZOi!z=oGrMJ-uxzwOT?aTkvv8Oz-nT zO~3uwL;s$kLS!;`VQWayfdx|WKnw4fE!EuFoXfI!H`*mv4nuuYx9^yqVz4FWUDk@&02r8ehsa$7v`PZ2Px%p{!HYdAh)_9uFKooE3wt-p+t7i zymVHxtbciX2yitsP1|{WVLv(5fr&o#kjGPkQx6muR;OyHT!cc6N7V$qbIAFny*5lO zMcP;JtePy6X}kyI!WQj?JQu@Rt|nZ)Y+stT^3}~6*@FRyTe{-gmxZK3lD$Pmv4=ei z*mpXnP2VVf_>R~u=EvZLU9Z9vw@&m5UDyj|+dQS#O8Le2Ms_(J0H>;Cpe!WNwY}6v z)nz8nx57r#sx99Ci|mFS7EB7P4Y_ekV3R*e4j!K(@S4 zL3-ODu&Z-`SP@Q_pO#UXI?uDum&>XypRPRwgAig_uuuWO?n(xkZ5%xg@d&?DN@-?o zMuq?;Z)G2ynCbe+TXt~92MZaJt2us|*;jtFXSUwVo>$owQY zPV{c#ZBgdCd;Qv&=I;VBo;AWp;&PUDGiE!qB1a-4&KXmZhp>W?V$(94w{5n}Pk53hO;!gVah;qdJs_LeBzCcQ8_Gz<|(Q=(dXVqt;l&necMshMiX|2P(psPFP zvO`83z48=ipne97$cnA)Fq+mnHtkA8TwFCcqu}oz#Bv+A{0yqKL#+0d`%PQx&FosZ zLawblQOAv2=vp%D+yh~jGcHAfC%_G*ZEkM1d_9NP-sfBC2!lEg1{=F7ql|u(yOQHEr{U{DsPnY@+)0{Zv8RX`f)N}kLRlIVVYQNeu;A0SKI7@h<4&WJ`_pG=;_+|QFZ9?EBU zDgQdvpynUWxX8e9hEsa=LWSkYoPBpE6R&>$92)v4r11W|9OwtEZIIK#w5+_>+h-@3 zzir_DwN0k|vhU;&#V?kIsR}P2%L#>Bb)U%L^s;fxG?vDU4(o7sy0zm-^unpc`y=Nx zjJ9PzOVQ*YSxu+ZU}HmDk%sxS+E)E3vbokcQke&=l%PdpgLEFvwE z4IqBj6caMubsW@V&aogWcV|dLQ>IycMH0I@&Im%KCnxmi;-`B|@* zvy;RSFf+Qicd*sj$5bjT<92r$yCvy>&s@tfmN^?%;Wp+swrq321(V8PaMXqrbUM~5 z3Q^p~h;82gR$0OoSIm7$xFirvN6j>ItxD0T^BMvp#$nA8&b38)^X3WN75XYJ{op#} ztza&!BaQC*GNVb?g>A2C+jkI#kJyLVs97<4%s%g{U1+o>I$d?&J%9?%;8$KB?7@w$ zuq5xh71Z~>&$xI1IJo$MBW*oqITPO%RRG-eHx}9ax*qZ=!gsk^$t-=5**C8Gcgo7= z4frW+Kh=yZ->qy3QN$$>x+vA~rdUfIjD%Uis?Rv*Sa4dn4KSMMV><8Sge@Tc2ASXb zzU;irI#@W)8EF(Q=Ti%V)o0C>a*IdHeGp)8?CbqOJJB03>ZN6O_?(DBll%*ZGYoLC zl0I$|3o@F(5*BK4W{IleXN|Ouu;Z=OWDNQ?X51m@%u%=THwI6FQ_#Ut>HH^shI~r% zm>7#>12J1pxlV=J7$cMR<{OWnhr5fdZvoOjv$5wny9TD{vJ{m){c5E~T-erCbd9|` zoP9_t_a{kvC8MNJGg#-nPYC6bb*y9i@V^GWE>B)qqj`l}uBUaeMunZpWy4)##7W`| z5r~7mdO*TB{o?O8jk}0e{e;;v44=yWdds(?D%~DYp&@qFW85ZWzvH4>Xiv+&+J3H1 z3PQv3|B5;=$!ypg$bwB%al1Dh!Nq6!`bB%H(8-u>Z5LGIU}m9sNU&wS?rLPC79X=^ zthzADQvN)wdjY27vrsGl3q9lZ5SBe9vewE|cygA8wp&rXNT*`Jq&-nD37HRkwiSx? zMY1r+Z>cc5pk@{ia&!v~3uZkKi01r@jkHHJzAk2Kw`tT^rXiu!kmA3%pHx0k{*Ljh zH3Dh71EGK}jrlWIaG_`Hk1KiETwWlC3xtU>O~VOV4PC6@R$;(o5i@r$druZ`9pU>S zt~T#sUK@$R=>YxS4oKJcVHEj zsEhKAC=fRU9kiKa`fHb@C~;H9@~nr#G<-NP{v*>2a8nF%qjcJrVbset<}?Z5HHBBfwZI&Qm!^+H4t){#^&lfRF)1Z;;w@w;9zN zL*y%BfK9yp<)fSHCIWPt1J?ZvTWmH+GA-aLtk^6Fw)nJJDv0f$X(p5~%s&GLMZ;d4 z@8+{Ixvh{9OeTzj>El|AyPQ_=B+s(olbNddAjI{I=5>bdkJ3^Cq8+hL_aMYLxn!%ICb3i!`tP9JVZSv#(v&4EqyY8CAZv9@J+_v)XOrm|8HzM=a-<}D>V z2luW?kL;H(bR%+#d*6#RZ`!Mlcw6GDwphF#qi<*ld0Tp~u*26i@QG_R&F9pQwQ+jB zV6De8i$&YPI(S9n21>N}b)(QI~AHyKbWo|7v ziIjlU4RFSOCiNMhc5fT*CjMI9bol%JMDh93mTQG#`%tJZ`%t~G?&8Ss{avGQ#j$ze zDCRbvbIQIsQ}j|)E(tQp@s$jpoOj*X;a+92%fOye$}HZVUe}=K>DZ+%M1iGTAC=_u z&dy9by}0F8qFT)!1=o0ST*n^E8*hCN@})U>-HXsa zv_GozqN<$@t^YA%%7&Af(SCPjC;;spbWq!ZSW`yb)V3B3AFy;d2YZ}EvhbJtcy1!b z?DE0o2MT05mr+`;54x=w#W>f{CnhH|Hm9mvtFN|l@$0&*!mR5bAYi$VPB!P_XCicx z(sAyzk{OAmh@42i9vk1xjj@dL=-YxkoXQOZfW zR~NNQ#@h>wH=vnK98+|O6eu`gBsEHmMu+m+_?c;kUZp5BMzZ!M|FFDs=^GSW@+CE* z(LQ)12nlIIo67YcAyr*Twg$Tw_SLX!#2NvRd*^oGbAGPYgr;GmTBcI~IN?1c41XcO zxI>8GWa}Sfo{2@y^7W=lykUob50rPte)e5?r|s@O*!Z zKh!M2yA3(JbfLguAaH%B9;KBb4_;`PD&%?BZgv{1P;-iLQi}L?$YuW7K;r$T&!*X6 zspBzQ2Kb&*y#GotSnh?wys4wR+K?0HY>SSKxZJ$ncm`_eg zJ{#!6CydjX>!W(tI?dL}HCeImY-vMdZxiRAo!AGA-OneiiWXGgKrBkw9qd5q$Vv0F z3zwFuYh+rhK7NRxu#(PEZuqtDvX_PM7d;~Gl#Abk*M}FE(l*;G>cx>v+`uGf>2cxg zzeOKC7fd`d?`%yD>MBWECTl+d^#5Fc%K}6Qo+HX@&pIuyC<_K&PWV=HQZ|x~kO~%@ zYOX5$6%njq9T+VS=9fG7)Cm+%$f-S;UErG0;dq+#ruu~PIMulH!3>$`>oz%}i*Gq6 zZ*^bErO{P<=2)2Tw17CVCKVgc<$(l%S?_>pbHx@0W>81ad+&Bd+hmp*t?r}0X^n&p zr#n`b*`w4kyg_{*9&mg7!c-9hQ#lUrIHNKPzAAbjNVHyIjM{n_r!Jgtk*<<3yE$&| z0fMkHNldyCs{VhE1F6czzLV3ytB3XDpp-!ZX~n+`tC|o2DccPS%XO-BzXt%VX+sjj ztGd2~4ENg%GnTM9Xk!{?x(T?+VlL$Q;=Nc!`##@SYT*!Y{}7JxIA^%(dyuYi321x^ z1N#eVVNmW8U1I@8$J73|BJ*|xP-atLtsg5nA;&J=lHLK~H2+trMyaX7l-aGI=Np%I zY!VEVX5htr(&@8tq)oHRELYdNURy0(c2S{TCJG|R0!bT*Z&WJ11^y|a@UsGz@2HOCId~7SIay7QWW0!85Pyoe z7BlhIANcya+|$j2wxPCaalr+yFUK&Eb3odZ`*UH#asqq-exUbU5mp5M&0hbtkE@D} z$3Osl49V(!Uoj9_smpol0E4|c_3d)W(iZ}9I@)HPdO-gce%c4_)}pft-f~WqSJE_& zn!JYAR&2DK@BV3R#**>z*j{JM>ljs#hqLZ911j&k|6)PTw&$;4Z-?Jwa^Xd=Rvxl6 zk0J<{tJ&p5lPwB@;Cp?unqKDTR`;8F{O#pMXc)$AVFOb<>{HXZgqg<-2v`vHnoZsU z#;dg6abw>$XSO}lI0bzWCb}Rm{rceMScEB`_JsFuc@K|`l?Ftm&n-llPBHnGheiIh zv=?)`GRNc|N&VMB%6Ar4USA+sv(5(EiM&7@P7uZ53HQyJzkQ-g_ZaYPHsE~fQAhGd z@L<}=<4WrXjkJvD19DWKz2IGQ?@1)eN|y?O*aKdjd6(@A|I#>|8~KgoUg~>@uZ%^o zTYM@ETH(T}mdBi#`c1cK*&BB&c>GUMQ~b|1Co_wB&NK7`xyTn?XQKeGZRYLWHS_j3 z0xi0X>0q#HyCzeG(#X+U`H($2JX9J+fq;D1?>eg)-pE6q`c&9-{QM=gAb%Ry_#|a$ zcO7sG2eR0^0}ybaYmq+;*{^qWTs=(pY18aBluqe#lA0vS)X#fi-4K1bvXc19cu+!@ z3e~L9e6%j8@5_MCvJa2VPhM|b3mNa%Z+f4jwf%LeBeOEVr4Z8}R-{RhDQe8!9hWDNAHGqa+MfyBv`OB)f`nnjJF(TA_a~N0; zo9+dt!rejK!ep1oP`Ga_WT_@5Gm&t`tV77d?aXmu39#_0z&4^!&1fTi{&=Zi#%jiu zH@B0`(Rj2b{nJqA0W_$CTYohp8sMWq>R_%h8+3!vtS;7(2fpSm+L%+Uyz*>!7P%`= zm_kMjkw98WaP%v9E1H-6-B*7d2D!FL(+S+uxc#TpiZrEv!HR!$wY$g9)ebzN{`x(-)O z$IZ)IhVT~dH?48OTiHkIi^h27EaoH><<3i6l!*R0DDh;xsNRe%_og%R!EDweAdmQk z-Jir=vTjMF&4=a2p{m4GxO+eqXPiQCxqCvIR5HnMdC-=S`;-bT(CTPekB<;Hnf9v2 z9b2wD*e;?E7aJ-OcYAqO@7bDVDs_sU_WNKFX6n&bxjxfeW^fgFj%>r$#o0c*#%?%d zYp+!nP%IihM?!xmJ~n#APuqalNSZxmx3v z7O5kH6$ZbR3y!;8p7wl_+mWk3`FrX{a7$z7>75zH3IOwVU%@hed%0BY8J&Rh4m2Q+ z!khDtN|#fypkL1A)m`c-8R@Hj^TJ=h0CUVp8C{CC_Vra@^;miKEZ&zd6 znhE>dv$6#NW07m~ttpu`IM}znmVh@qjwNes)Z26QYUPTgt;I(jd~`ktFA_f7PNUG` zu{`Piah~cWqNr?a%;sEc7!@QzCR2FWyz&LsTiU73q9{6u2Z1*)zD=T&gkLGvL;uQP zkG~Ck+?d8LPgIleT@Q?%lsH%;I#2^fdwhfic^D{wLr!<&i4H_o54^*IUXhU=g;dyf zyMwqDq%1t+>49`XWS;MnDJwz_sE_whQO$VOyNAx0xHBb4WDAjdJwBk|hVgu?+OAYi z?JJr4gLYz9iiD2e@<#1JwLwm{kdZQ0H|G;`wKw(A19eq(chzR9a6HWSuqE%cHBjb7 zQA4_L5zR{P^ZiIGKDG06dW_M7E~$Yfk6UAY>7?)J8e8_yv%0%omgO*Urt?)#H8`(Q zWCAT<*I`L*_i;V?%vV8Tp#6yC&(KK<)kQN0GR4%qL>0Rcye(q1G9E;X6(*5!e>>aS$TA6-pEOP%AwHy- z@dytWGJxIQ+i2Y*?4Nsk?4H#o?{GrEoZN6Lxyx=uoayd~0&A4}ooxA;HQk{k7NOVG z3!knd93Q!^Luniv-8J-5I-eye|Bn3kn9$)dUhFdc_eejkR7XRp*{*Awe%8b|d{@(f zmG=Afw?jc|-ob=-xHE3d>NLMvz0>f^5^vVzOOr0kHYzgYi)v4P(=W%NjX?@%-U=7e zs(M3QSa?vd>aiYg#;$q?s1*@Wa@>jE2`|&T@Aa$;($O@xXp{GdY-8>L;z2Khi+{%w zOS`+@+}KI8OM(}3?%!c-A9__icej|Ns$+t%q!rV85M;5wVI%M(_JKH&Q2*wv<7X-% zw!eJZL7u=Et!tLjnld;AE&)!I4d#J$YY1W|MPxb}y2e$^EZHQ>--O;((xooyA+U;b z?e@nj3nFibDGIZ-uu7k(Y8|lxNHDp%OR5JHk+-K7M{dD9XOitdJ-xjSRm&+9NHAp& zzCV3Uf{7PQVZrBIv2k=UcVpNZ##k_FV6k;b)$-lz_&&R! z|2#R9mg=x}@8F|}^c$?Sf;=fZzpSLBUR5Wx`09NX#+T0r^eEvjS8wY(w--FkUTR+v zzW|^3x+sIuQ7xLEJ_*y#V%ARCsT@=1Pj^1PWQj>gkavl50K&8*$ zP0Y_JOav#ffiUl=X!FDoCRNrZ=5sNlA%4|B8airQEHyCK@{N9LdoXUna)NhX3zhq= z@dlm`?#a?dEu9mw&kjwbonKk2CLJBu68}%&L(XAGB1we$g8$#HkYZ7;yIw~+4$LOz zCV{VVQZMS>jnw6gnwx(5?(PRv7ME>rcu(4BB2c~^y>vG1W~H2>@(`EDsvv$aFG@=u zZc;RAx#Q<{j_gnip%|SqeVfEuv=``bYiVL6WR5s%Z%W z;#3AoPPd3AsTwo;Nd+b=nj;C{u0uLQG1?IBf2M39Wuf?(B`Zta%!SYwp{5*DPU>m| zha-V<_(U#gmb#TSvcp)Nq&;=l75MqE@DK5zb(l>e=P@@!XhW{1o(Kn} z4k#o)v0%^Ptju@V@vV38lJ=G=0C7$6Tk7O*-%DBY0C$b=ke!?peUeayx<5PTrlz*H zBY{Hc`y1+~20C=R%YV5G{i4>5-{#sZR6+aoYdh=lG@z_}V$KgiuqEwfXW=*2H@82n z_o=r!|ENpvEVt&y(NtcnV-%Gqd!zyrx0gri&-_i!zSI&HvH#fa+?iANo>$+U1H~iC zNW~O?Wv8Y4i{~vGZ;?z(RR2kE#`xbu5y1+{9Z59i!<%gJKEjV+6H)j7;6<(;9;ek3 zQ^Zv{B@gocdzzBH$AS9v$x7plk`JF|V3$+kx10Y)s<4av!;`2>e-2jsBmk%^r>%YZ z3|jIY67o^8a|Hu%99VzmdiF>@nptG4PhS87K8UiN&O zhnxq%>F(t8oe79>s_wFifS}TtTKr~gj*ao%ui%VhaObVt``MqrrVEz~FWH49cO7vm z4v(?<9B((9HVammv#^kb1R_nsq2Fp> z;ZH$v+?NFO1;F!LaT7)_(b=naAe%3UW8J-nigp|NysQtIoI?m$eG*BTvSR*vn5&d_ zwV3FGHXLAy6(6LhJ_2gCzqR5PK0MYv^bG>DrV3Ar1$$7^j?;*mt4YE!}JDb-P zt{iQM#e_}`a_TG7&*;^SUaOua*>4?uuwYQl`mGlQqDl)PJeijX{ z$np&3CFm$eMnrCHxvVIu>)gzF&whm7%nqhd#sY99=)8uCh(J*z`~5kFjeQt3KVY_> zmQ+~owqw`=LuXg~dXVUS(UG7jaJ4+HGq&B$81I5Bt0iF^%}7huByVF3BpF zFCRCOEON(K{fTULq`ah9mmKH10KT~V%$9vmH}}y$S?Rf``y}(48Gk9~>aehrqRX0+ zQ|~%Uvab##FOK@nm_;C4xNLw<`Q)X)HcogIc12|>=_K9itm3K{_}8aP3sR#8{N$z` zAyq3YB7v!#bn$>%>$)B#SsxM#MtdjO)LRYSAa)P;JBhTI_-HP2FBII-J)CK0ePk@k zI$&xM+)=z`5GKNv>%59cu6p*{xjD%P2z0`sSu#H`qYb!grh+;WnNK_zwaF2CgBmXn z1R#VCg@sq*?=EKQVXCFS#a-HGrn12VcUXWNU9<9y*>cODD~fDwrCI{!lkkP_k;|gr zMbKy0mGG)h*}jUPy{o6NUwT%g^UaPDha3^P;%j#WapTiPxDP8Ki7`cE22Oy_TC?Ib zY@yb=j{1JMVzXkz6XVk=5QBxZsjj3jOVoqaS8VSFldxu-qkxZv9AMf9KJYwTNfDj? z-ODT#l{$ukrSI_x^ZR%60SD+UwEAVgvw@=*6>Yej=c#V$eq`%=nEzuD;y7!{w=RL`Uetj`g`Z5!_4To(R;k99!h~Cs0vhJJc_?yKwB;ebt zsCvl;Cs2IIpU6EmK}{~O#v=iy-$-TYuVU(a+k=HL97s6_g%+o8kwYkIZ=aaMH z=ZU#!m&NbY%h_a6vJTBo&257DXKA(!GL56w4Fqz2&&wAPHEFMM^y9R1I+On9k|uoq ze};07r2OL-=zl%5=5-;Ecz}h4#h>HVL-Jv#{);X4gDT|byVp0zfBbm<;zb72QjS_2 zLTG2XH<492L9Gy4`bKN|<3%|&*v`=jK$}I{&I(yiRxr6i{)Jcj2MGKNuU3?mwY|Ol zy2;R=wEGPk%y0NRl=U%#xa&Zk7H5`G_}`;*ruw(IWTcRnzQ#lU4~;(> z4O1IVOuTGwW+S0&iMrqtUmCe;eB4b=&C6ZTeMfjbp|EYi#~uc7=eZ3+S{*Txxo8-w zqF^H7;$Q({ZLyP&+#7AD-)?`r<&9AX;>`A6)z&eMzqcUKzNoC>VZKhW7j9L(spVjE z>Kunwl^xB^Hx}hQE=e^~(4^rx&;2MlyxZxMI*+;?M)tdrF12N}9JX^nXNCZ|i;6JW z?ZuS$m$}lokG`m*3@sfs8=M$qYuH{4y);WP$V!1MqIvhS42W02IQ-HUS8d58IN27b z$URNW9`!a^q4W50t}UKxF0w(i-4JxSq1N{G)KlvDdduL-_ZoGFdY3N~Y+oXF#=kr3 zL!x-k-SmnS@;LI?6mQQonBv1$RmH0ejf%s{YlkzMamvi9Tc+w34pu6UvnC7+H7u& zaCQq9c??EkQ>(sg>!>qcx!ZsEX*jh2-Y5JiFH{kRZ?lmb^UN*kW}2+h7_AU7o>uYe>PjMuYHtb z5e`mub}bppjT@_g=8_D$&$|$8?SO!$LvrE=EJaKg?;tJwe9u{By)8|>QusCKrG8s(-P{g%A{wsvKiw|gg_a)?v@`dL|I4<#G#*8?We?$)7~ ze!mUr3@bjb0AUKRIlc}-|1v*I5OwosKUw-6cwNuFcOe1AahiHYpftE*+Z zrZSU_v~1(0pq$HMF|&ApwNQY)hUkN}qbONFG=~ryR`{+oz`kcS?>aVDRbPAGPZga? zdFR)rN1vC)P2bozWX=`23rC-qNCSM(zvFr*C&n*Dn=w(_DaW%Us_ki<*|9tHzLf2#IET zAk>0VeyDqtXcw(2{WRoOoZa+?L{%fjad*ca$16LSr(K^QbDt*qe3w#fj=dO#6Z#q| zS~Ws+7G16BLHpL?mZzMfL@O?L!mf0GP-;4f^8HB*xY8W9KbiC*L7N$DwTQZej;ksp zLQ`uq2IAGUb5dJ!0e*(dv2d@Tjh*_b=fo1P%bGtx5Gm>N*x^-UmQUFG6I)+N6-8Id zpLQp&y_j%b{c1ZwZ;yJc_cWEe$DV(U@wcF`L2dhte`1jlaMIa2dAjO+MvNpDqm#dPMB$rlFs*t&#*5 zRIb_sL|mE>$KTN_YailRbt3~}ZN(3shLlu-h+IKQ@AEsDWX&0<9+xxS3A^RXU~7;w zvdBdi7=yuFnlOgM@0(U>z2WoHo<8!~>}Z+a&35JjF(8&6+qMZBIjgu!bmxA@vMWZe zgwq27&?7w-WrPRzQ+x1WF{C+RkjUObWJsA^ufOy3ukV_17@4}&!Vtn5@*D}mg5ge03jj@tUeg3DGChUgWo&7HsqVYG-dnv#pFHEAZ4l6hWcZk zCxL$<;;rJSgwU^_sE6?0zniRfy>~EuC5f7w{~5EZnwgX2w$y=OlE|LKtmA4#f6}Qt zd2^Qz^g%~O?&bXCGN-A-<~R1WgK@q`aYFFdGFTp?&BJ%=7{%P}4c(>W1DOW1}-w|m0evYmE^38?ean`qP8b3 z!A9eJjx8p9<@qy$0#Tu`8h!&1B7dtY;dMw{jLp`TLqt4(Ub#k#M;*U4t4sct|E#p0 z=f*;ybK$I^=y!*%ETekiqjEMAGs1eft&{m=&mpyeWKs1IWFZ*~X{%`ZWaVg%qU5vQ z%H&v$*;*t)pEpw6-xH!m4`wx;?{2^KygF0tb@(Mi5tTTB>Q|vV+1yp4*czv}bV>XJ zN32_%=a`%c3dn|Io5XVQ;Zf@O4c15gh&5X;T~f!zGL>%Wfp1P zIHZdjBM`En)>dpSkYZUd)wcHMGv32l+dwz>^=7K>S>5$}FAC-1n0b1cmq=XA;be-N6c}qa>UDdRc8W9@%D%MxC`IlQUWAY4y&J z7Lr+H0;PfKgKzcHXNnCJ64%Dmm#c`M89*V8X6^?=X(_#*=FzlNoEp;^YY)&1vHB18 z4-$uH-dptIP#w7SK9ZQA^-=Klez1XPU9y@4qW`h7;RG*-OF``+YR#n<8->zxo%?FC z?$X=3u9kGV9k{WwV08yQl(!nld^(%L^10^FdT})CZrB#g^AQWzT+V_&_qh)8ub1Mr z5oPz?woEujPk`e>K02(uLaiEK?_D6Soi{aEqPueE{80Y+irMm4bzXu%#2WsYk_w_g zVcK5*+$YfHBmWuS!0+~V)-i71QZUsD_&VZ_KEK(xaZzXQ+V>WzLmIRh=kZ_h9xZc& zKR+7yE9rL6>LtRPRxKFJ%)I9Eqw~i$V^j2o27Wr)jTii|Y4ey3Q4&205$JI7W}p>v z{xWxbedqZ$2xE_WiFXPggV>(t8T1%HQEL_qfM=Tafl$*E>>H%_2p{5nN-`5yzMJg^ zPN6>-+Z_QRhdeq7(UQ64q#f5$tU$N!TuFJueK zjksow{khpqfmVG*HCt+c95Xv#V6pg|J*KLCX8soJCJ|zkZ)W2u$`K!cyL{<)PI+M* zx6bYeVb77Mmuzi0hoGK_v^SeKvF*5RsT<1~L};2<%>%4N)l@>%XdRa)vm#O)5F}W} zBmXd)UWqb^@ywRN*z8&$0EB<5mHvzyJ)a2!4L!Y?Zd^W^Tz|rLmDDqsEl&3`6o`Kl z*ZjbL5nJm+@cCmodB^l8(l(wUIZo1X863eNv9Y;n8gYT-hEufjCA?0m0|Ejz?i8>i z+H%DY#!a}nxyjB@7g$h6U478D@l?CRw=yP?5s6>K7YP%lOwG;NC`-!A9SvSVN~-?!ih-&1 zB2mjj3cd@|SLe$=hODP|E~@nb|Jz4V&TY6tJ!FwlW6|LI*2^HcDe&I!&bw1U)J+F_x|LGXUn7;7J$5^x6E!vQQ#(7&w9fA7%;VT2aP zNDu{EkwLB5?hK%#z_u|n6BD`^PoRmn#K7~$lihCZLP!k?mEeg?OZ&CE)a`xLZM4{X zk#VK!hl`0j5cPU`ykFZ*N<>QcfDigonW$lRzas=Hyw%G|Ntf!HK3n0&=QnwaZ8Sn^ zl-UhR=C%SYd=+jx@#HoQx@FKo0j*W2h7_3p; zVXc_KAX~KG8Qg)8g+u81-@qbYsT3Gha9M04bp+-gM)KW}v{ovEX1}!U;~Wj+vkw#a zxL%V;#r>*N+;FJEG-4py>aT6*SP(=YBUQ4lcqI#DM4p}c)ka{( zv>sTA!7gW_BKB6d>yS;3WVZUAq0LyGY3~VrJ217!>I54$>d&ll^w>}jrs}ZWkEHIunZSsiht3P7 zR!23b6brRq~Z%RY)L z`NHStQ86NK?*@iRGtZYgH{ng{)zxmxtDnB!ELF;G{PkFWB8x6X&~B{uO4jeXxWuW>dL<=)wK`#!Rt$!k zZ++$B1E+}`%>JGLO`%NsK-jeLM3?Sq>v3Z>izluv&2K2ou=k_CpAby9 z{7ujCx>1L6xb<1TYPOTmn^tJ?&nZdsliKF#9xerPiR+n^H1ko_*g;iXwb z^mb_Evb{mZ`#f@$Vz>Q5t2_DTfoxevBG!Ga^;eJz%prSZnDModBmQ=$QBd!wC;d7_ z{+l|p&#@V5C(hHuU-mKcu~+f+=VE7vf$uCbv>kW4daDXS)#0?4E{zL7Ckp_;623gY zldN}lzDnQ2`KSY(iY|`#G7c+Y>f^IqTI4BpccTF~pWwT2Rwj|OBlB`rqa+l(i~qQPxrn;-`_h^i6oo%7@_-VFVZHK3o}nTN zH)=6(osG2J8+}s(hEG}pSJ?Z!ceAil+1dqMQl;N*ccW@4Nk_NY>iF2k$!V_*`YO1FE@m{#IbWM17Hg|SJOZ7xn=1}- z{vnqi6?Q!S5K;WDShwN>S|_{seWvhnZ+9ItLirnV2er~g-%9m@ijG&D+9Fy(Y(aL2 zbqpNBR}cFYNxf8Fe9>FbcKw(hq)pw;{`x81W5cTpV(Y#WR#~8*Vqapaxj{&`#Hf~|>u6k1q`|B(n|83B#TMIc7T!2NIdR3VgH zh4JB5S$c0iq*3z0p|Z1N32enFzifEEdDgOuZ-`0FB$)6C6VX$bS*b|nN^Z6V)7O_b z+FUD7t9i{-;l#m5k8W=3jgn`4a8g=_<(c=h6ltjusO_ktbA zx1=>|&+Z&H&TVn84eg zV>@?BbB&b92HsDWbqrwlnop(^X+SE~)e@d34UhCBA8 z0Ig1jcu;Y2rVXU@hP$NF!EcXQj{Hrz|i9YTwbHWq?UR8!{A;^4Ll9Gk8X zPq@-F?4-*Xkd)W^JjKlHi2SnMZh(jaKxb0s6t*fg9>AF82NsJoIL0=6^V`tkp-@PU zXM%i?3H~NuQ=#@dyaK7C)Y*>jwV%gQ-}rfX9k#w<#Cw3{ee-#I2VwizV@c3kN<##t%sWVBhZFm`sr$WlZhP*06~SPjab@Z>T(C)+srnA&fXa5 z+y&YZlK(J!orH${Ua(vk&BWBytc3q|GX$9LRg1_&*>uCAM?j$uu|QhA`tXgflm#4! z{e@MDUrHC~MGv2S%bB_r^#@P629p0LVdH-fZ2qU;(p3lNkE{W?`>e)_;ysaWd&>qW zCwn`)65Ra@hgBEw+V4*>WW)y)NK3lkhQri*5cbz$ zvGk;L&v@;A{h*P1(iQ0GykmU2&f1r9dd1iGio1x^ulzSUYe^OT{;_iIl3$TCBOe1XKYWI{u6^7;8}LQhzuf0-Kl{NPppXog~lr9v>q1#+?w)EU(d=KF`Ppe!}^M$bkhjj${%qS`DdH9<~u7-I=Q;fNTfjZ%7KS6q$TB4kL z8AqN~cSA@mJFdta@7aZbqPj*T)M@oI{3Jkd2rzsH@nb$vPC4{5{oVvUM*flZ`d}st zpCXY~0;LURfr-g*->F3Sq~t+mBIG)9f+DgcTfuHi@+rUylsx`uvuIurs;tnhE^L3` z>4tjR(=lQQcXfLYe$@cMd;JI?$e?J$H5fXeUAC5YhL%I(ZyM!XrRoPf$e&!Xa>IGy ztR3wio)x@y4ZltLq1-mnPZGgNHr(vE2sS;uq=UUm8QQzns4nvSSk#Wy?X`Z?s;f6L zPd8QJf!z;})Zq-&k*Ylg0T$QK{EZ7yQ*rD)UYTz7n@@)`NopQf+zG|sNg`b5Fef^A z>JdIan)IngiY)oN3OU~U>6-~|P|@TQ9sSo$S*mJar{`4uTYr7C)fDG{`c5YC)Pi&b z3aR5Nm1%7*GWsm{c=4V^rm~^q>rA-7kr)M32eGX0{AHPO8Pq%XQs!O5*Z_Y}sf7p) zmi^VXZ);o@3Xb4{hz@FqzB3*zgDpH&$q|@e40y?PW8EYRkG*{9M@HLqD5R(9vLd~d z!RopvtA#_TD3@d=(r^3&^uy0||NpHXPW_$}Fkf5&+mIQea$1wkdghBL)$75(;%JUT4V1ESQ@Q71%k&h5JEey*fZVI-M)pbQJGkgfvz444HA1A zkThO-&{lD7h9{fP-gh9s^?Ekp+nc-Or-o|9l)h^raiv7{&d8NEc)QJdnH~1AJ>!0S zMclx~8Esa#=@y;i-S+krEaUgvF-3~|iK~+*!;SLyRR#@)h^Zsd5hMoLI2-jZq6VTO z7VL#i$y8P?8sPQ{*PVP;p22rKd#daAcnl~lNW1BxtvWmu2rn1=kJu-X88Yz4#*@DN z64{`zFWl-XuV04pTD^G7X1|Me_+0Q6kv?)SN1%wiU;q&D`%N)W6#LFnug#M^c$e6^ z{#pg>+LAmo$<|JA)-xRnl;u15g>+31rfjOKEJW_B6xxoi6WtSrLxo$AHrzDrqx>%0 z$2vATn{J#HZ-+kr;66U>e;lUlbY_=s8&wdOdvuxh%Dz$%@sPQ!Me}~@NRq;hnY1lW zY!^Qttl(TI7@K!QOOIMB3naAO;Fn@&e3=-<%k`7lEj{Ax7F}CD@+UKBGFx_EBPvOm z2H9k-)pj=_W9P~N9z(wsX)5rox}Rg^5P-15tw#$&SJ%c8sLXoY^(eT{d|TlMxM_*< zi0>!JCuih_XDwZqbx#lcoyHamZW=uL#Lk9u(CR!R1N7=&DHG4ZI^27mf~cE$9$OtX zKj4q9cRPnEl{)0CnP?B!C>26cbu?jBI)t}v5xz|s3b^)m9dPx-{q2RX?(Ny&8WXot zb+8VJmDBr-I3dUP=oR*c&fOx^t9C{zvQxbBXGbi*u&MF(3%M8Z5Wu8}$P!x*DJSV5 z4x}Qpu80`)wA1?f`xGX>xV4w6{;GJ$2ulD|^5Fn^Da4+JOm;HaE3);h!v-N3 zLb=UpW(%AcgjE}<2-Yi!h9TO%Ygx*KA~cKMn!nTZ@=mSmO|Y=Kk}vUiF~wx^*Oo`& z7I;<=FmO`Sp4>Vsx|LVm=*0s=gsqs(U%gh&XCUp!&Ahg4-r-4u2}uIB1X&6oIUC>v zNTucee?Y=|&!b(R%U3KPwDBTr?=5Ds^vpc$Ib??%BViDW-U<#^3s)m^0DXarD|fs; zdo#C#!Ruob9^6{TZqHUnDda7ivqWR72#g+2Sn7)X((YgNpje0t!UE{dis}$`E5X)N!0Rwbgl^0n!&iTg;EGp~_Fb~%1z{OoF2=sMW?b`(#CHbFXv8s3}k z&_$ZLoAnKZ4T+LCuDk&u!c=uVoZ@Gn8e^Ktd35~i)70|?ZkZGL14wYvza=xOJ2>^e z*0ZLK1Pi`ODK)MW-si_>Y7O6}*}S$CA}Hs7(O^&X*e&m%6MP+Y=%%Vg124n(?V4xH z>$NF>lRQoGjXL;zx0^@m?9fC}G3Y0Zo}NC{eJz)iUUZl@c#hH9Vs2UDF|VC(g#1#Y zT>g;-1FOm8bQJehK;HL~7dSC5KB1sb{og<&Yz5rR%1e>dLDxg-Y3|Q-|WO5rt zR!GS^znGhz@o>)^$_~RtoM_q>+;W%edNBi9`*HZTKTo?3Z_1GHNTPgUUv=*WO7`DsSSylu8+ao>lLY1;){`hiUHzlBIru9Vh8|@DJ#Nt%%EFcCZ~43UdgBlD#0>V8K|i_BjT5+E)7eG^&pOkUXK|-BC%|`C`>COo4sRFE+zVT>DV zPI}QbPoxlTiGE&1a(r->?Jz+WiPLF6QL$UGyJl=uwWQb`GaZka1L)XC)wAtA(5J+< zwnj10%96%z>*Z#NS(KrLmc99L9X3wVId9t>vSgJUP*ue#d1|7T!213bG93gutpyCc zKGC^&LG+4OQhnjGwxYqrdV_Yn`?R8W2cI=X9X3}{f->d)&R`*>YFvw+4pvet{^NgYxxuF>I{4W?RwRtuO~wac-f~YPg~jzEH9q ziCVvh&QsN14r{c;J()=$HwV7jOT2HJO?=H;S-0^`Pdlaug-6zKg#TPmS8AXVsIpi20h&1bmAGhVZ*%ok7KhweoiZW}J z>eZbun$#$JB_3;5t~{6WF=aprJ~oYDq@Sod^S(&_=o&b@hZg7Fs>f8=dStiXlCE|W zaqQ-i7Ebnxo8NkT;`L#jEPZYHr%9@v?K_@thLX6DnGl2IFerZc2u2Zn%e~5I$O!+Y zey{OtAPwHX>mB!Ihm2fsY%kch25FP7=Uiy;G;962ymSdas!2cJ+Xo0dKg|4U=r=RF zfstV+)E}CU*n*}|v;9(Z7rLdq^l3Y;hH+M*F-Di^w2iWZb(=A*>$|G0GdmkOOy zO(vU~n*JfwC@LXvDHD|SR8@>5GthckihiAI6emjzX`MSGk+{8XX866JO6C5p<54qepKbWE<-lg=tU7#sY}Flm=8=uzm-^}K73i!2sL4ONbTzyBQorI^ccM9zUFAA5`l&tega3 ze}iE&z18o-C;6zI_I6s?5>a#X?)}7rl^mM~p+?+n#?My~yJPTWPt@-==Ew^@?opqh z>T@0*K>?;m*$T|{2MJMSonuFGUhQ4up9E%F4O5D4@7W7B5Q-*sodY{Pi_^{TnxGv7 zhC2VD(yjBF4h{vS3>n`(P)Gizqo%v_v{l*Lb)+_*#)6uILShM*JPlK&x`#{Zn%Sk=A^@B8NGEAppaNr#?>l+)7NzTg3 z9-h3&s*X@|a-B%*zUMgl*-7Vyc@(Q`ev8y??1;=jQg@&`-22=ar7aoBYqLYW{nk{$ z=+v3K5%kV&d!Y~T4f)WG-bddp6qOQVwosm*JGhg-d{jLdvM&PiPU5DM^`|b!jDGSK z7%D7N>t_v{`c-9_f^6`PXeS$=^?+5&YcJw_(-xnT`6V`(nLu)kQ)!@+i&yJz?~boB z957@AS&;I0h)h|*Tp9gyMFJV8(T;fVX`%>bsW~^brFglf9kG$F=*t{}uuD1|QqNqbU@UCay zD9QTJ@Oj+>?`VIHhC>2t3zE>ItUFFnTfF-S8d+?7FEI@JJwvgZ;&nul`b^H@p+sB7 z&zldz-#$RgQnyo3=n3U!>>S^s2w~mNGhF8}Co5jJvgG8Vc1mua|fw0*7*xfY7V^$I=Q$fJRUt zhGu1Z>yX!6KO0}945p>4*M=d204Jyqp)~=DS_Ox*KiU7%y3+%VVpWv$ZhF<3kV8k+>iTGzPQ2pWDcI7pttn|(Ypcu zqiU&Y-$Uo-<}%BNS6nnL)-Pec$_EE9dWjT_k1|02ox zilU)w_N|X)z(6m%@sE_0+7<%))eOE~aQi-?b>QlwMei#fmFnNf-Y%!jYp!5!>$N3GwHe)^V6V;jDqcnX5D*(?#pd)3=-}Yb1_|UF-%TP z%w8uKM>S*;bg$hH8I2w|ZH%jX#pn!TOxd!3d@m)SBT zVb4t9ua}>6NJh!{8aimiiRA3;+FTqe;@|>KM83q}_o1#bLEh>fd zBgf&$wU(^HC=`NBN=pKfk10+v1QCIil=vCZD4Ar}gJ`#4Yn>}w{mB;g&$C!t51Hk_ zv++Xr(LgLTgmA}wRElMK(=m#O1wgVtTDpUw$7oe4K?<~y_kcr5$$D1-27%FIYQPW5 z&o-X9CmfK+gh9m9@Z`lw|GGDJNVA-|1R@F^vr$Kt<|Qy%{!L;E!~A9sBR)5^Ka*Go5T}G~G2+nH8yb$&qDK=r<5{?P z*YLPe?0Yo!5*sCEt1{aUaaK`$j9$;yVZ=%2YWEh zS>Jx96yv|RkmJFt?C_Vu!?*BB5vO{@T8v|1PgbQ2W$`;sek8V944gAMbkaGlgOEvn zlQ^4`E|~Ik5pbgcA&$@FHc~Uh!k}EGn>zM&NVeN5ruY%!nsjm$%2Rg8>l7_imo3i$ zpQP^3<+YlqwWnqaO<6W(LiB>=;7m_kb`S-QmeSMDI6T`A4f_rdWUl~`=MxYMNJoTn zVoy8H5!=!rNRO7s*n--(vV^m0N1-(?-E=Mv`#Fx+Y5i?uswle;hk7v4JWi>499w03 zLtyFYLyS}_RX=SQ^|n`8oqJYBDlzC>v!?5cRxN+Mvn3Lj&XyG?n8p7 z;kTEeSRWrB)VV0|Evcnm%&*P#GtWaijcvLhD}Hb%d(uu_E?$y+R*7dAbh+jm%`h_> zf0%c^H&Ves{UU-bd{}E;*xuT+O~TBH%Ufr*^Sa3^F|OeV$|u$}-<}qB;OIXS?HJf| z4bHx$Zez(v&lAf2#;B9yYOf;RC6fVXYKxz)(Kqb~r#I;ckA`Cbx%Bo9Aogj6KJZeY zn11R0G^d z_BvaVk)z@DMw}nDFx*jm8yax8sq@Aio zUiSRoGe2hNvDtK%2TZ+PBjB-QV`C$u73w)5%yQXoQ|X2%h*d%YesZ`|#zTK`3^WHr-2rMEEDS3j{{T(F3NFE2 zATB#wKw<&u>p=jD0PaHbyTC23tAM$JA>fat<89!dKmT_a5V=)+2KxG*2OGN4ue7wa&9EYW z7WWgtF#yP^*(v}bG|95uyYPZHnjs${^nTz626Lt=8Y8I;bo-Yi;e~wu2q0){0lH`< z79gSHV6$)?2xPLv_yykx2p$fU`f){5Tia!Qw9u?KL4vSRF1V$iA17(|%SR@?1h^{( z2k?;qvt5#Q{>Xa)V29`1_XE{5`4Q0yTDGoTkVwaU0l&urK)8St4hsJ~O@9$^@7A?H zm|X8+dxczv+fEym)%2fDeJS+6NPc+tGtOqTKo_8X0;Ap7*x-WGFS2uTa&mJ^0z6&| zi`=Xgz$SKyxa18ugk=UG*#-z?kOV2hcNZ1i0nG5@x-J)@)(JbmvEg~J5+bjfbaaYn z9~zSmZx6dykMeMG{|-=syLx*oaZW%rYO`FFXhTCofPI??^E~RZzes zCN?$X2+YQFc=;RfI$4cP_exB|U(SN|xLF*V4K@gPJ+0vm+FADE6CCG)qKf{Qs1jwt zWA`s6<865$7WIc;`+<_rK$Z3{2kU!^f3M?LRDC2UF zD_-f<)9pqw>FieU5wVKQSBa<*7-l?hnS-5Az!9Ho{_e~ATnIKuRe@89|ST zu$O({4VPXR%C%*LtypCXd&TpFO{7NxX77dWHQSM-?x1$ zs~5U2YBX~`(qI&ZAGFqiAB=caZnZGd19lL zD1POOwfu#V$m5$)N$--{okhE$1ksx|=U=NxOa^1GCxQIQbmkq}@H7Is6-?nxLV zjuR&k&w3rTP0%dM{n(I$|4Vhu<7Cb&gd>LVJEUev6IEXnv5woM9-1 zQVFF4i%?Om(8|>W(k{oOTzvU!iEU7nZn@bE%DEi)hr6GX4^Xk9*i>U;Vj%8J|ETMN zUk_Zy0&{S1SBQf2tj^ER0|BHO7onw9KfnHw65_-E)|iVR&|TahN$JG3mxHS#{ zkX5mf^MX67Oei~h5+A3i=nCyT*c zoSX_SBvpk%p*9sIWw4gPg>Wsu5Uvb2#Kgo((}Byj7JmIwOFXrry>R1Q%KPK3ycGX$ f`}tpWB%Vo)zxKUrDxOww(Tt+3%F7~|x4!=a!(^_X literal 0 HcmV?d00001 diff --git a/user-manual/import-export/import-xml.rst b/user-manual/import-export/import-xml.rst index 3d4f953b..4c25d296 100644 --- a/user-manual/import-export/import-xml.rst +++ b/user-manual/import-export/import-xml.rst @@ -21,40 +21,164 @@ For authority records, this includes EAC-CPF XML. * :ref:`import-export-skos` * :ref:`csv-import` +XML imports in AtoM are are executed as :term:`jobs ` and performed +asynchronously in the background to avoid timeouts in the browser. Jobs in AtoM +are handled by `Gearman `__, and the status of AtoM jobs +can be seen in the :term:`user interface` via the **Manage > Jobs** page. For +more information, see: :ref:`manage-jobs` and +:ref:`installation-asynchronous-jobs`. + +To import XML files, a user must be logged in as an :term:`administrator`. +For more information on user groups and permissions, see: + +* :ref:`user-roles` +* :ref:`manage-user-accounts` +* :ref:`edit-user-permissions` + +In addition to importing new records, AtoM can also attempt to identify +matches on existing records and delete the matches before importing the new +records as replacements. This functionality is currently only available for +EAD 2002 and EAC-CPF XML imports. It will be described in greater detail +below, along other import options. + +**Jump to:** + +* :ref:`import-description-xml` +* :ref:`import-actor-xml` + .. _import-description-xml: -Import XML file -=============== +Import archival description XML files +===================================== -1. Click on the import menu menu, then click on XML. +AtoM supports the import of EAD 2002, MODS, and simple Dublin Core XML files +for :term:`archival description` data. EAD 2002 XML generally contains an +entire descriptive hierarchy, while MODS and DC XML files are limited to +single descriptions. -.. image:: images/import-menu.* - :align: center - :width: 20% - :alt: The import menu +With all XML imports, it is important to be aware of the available fields in +the AtoM templates, as not all fields supported by the related metadata +standards will necessarily have an equivalent in the current version of the +corresponding AtoM templates. Additionally, because EAD 2002 is a very +flexible metadata standard that offers users many different but valid ways of +representing the same data, not all possible EAD representations will +necessarily import as expected into AtoM. -2. Click on Browse, and navigate to an XML file saved to your computer. Click - Open, then click Import. +For this reason, it is **strongly recommended** that you review the AtoM edit +templates and the :ref:`data entry ` pages in the AtoM +documentation, and that you perform a couple test imports of representative +samples prior to importing descriptive data into your production AtoM +instance. See: -.. TIP:: +* :ref:`archival-descriptions` +* :ref:`ISAD(G) template ` +* :ref:`DACS template ` +* :ref:`RAD template ` +* :ref:`Dublin Core template ` +* :ref:`MODS template ` - If you prefer that AtoM does not index the terms on import, click the tick - box beside "Do not index imported items." +For **EAD 2002 XML** :term:`archival description` imports, AtoM can also +attempt to identify existing top level description records that match the +import record, and then delete them before importing the EAD XML as a new +record. Further details on this can be found in the section below, +:ref:`ead-delete-replace`. On new EAD 2002 imports, AtoM can also search for +matches on the top-level import and skip the import if a match is found - this +can be useful as a sanity check prior to import to ensure you are not +accidentally creating duplicate records. In both cases, skipped records are +reported in the :ref:`Job details ` page of the related import +job (see: :ref:`manage-jobs` for more information). -3. If the file is successfully uploaded, the page will show the elapsed time. - If there are errors in the file, the page will display a message describing - the errors. After a successful import, AtoM will display a link to the - imported description or term. +.. NOTE:: -.. image:: images/import-completed.* - :align: center - :width: 80% - :alt: Screen showing completed import. + This match checking is **only** made against the top-level description in + the EAD file. Because the :term:`user interface` currently only supports 1 + XML import at a time, this effectively means that if a match is found and + the user has enabled the "Skip" option, then the entire import will not + proceed. + +For more information on the matching criteria used for existing archival +descriptions, see :ref:`below `. + +.. IMPORTANT:: + + XML data can contain other related :term:`entities ` - for example, + an EAD 2002 XML :term:`archival description` may contain references to a + :term:`repository`, creator name (which will be managed as an + :term:`authority record` in AtoM), place/subject/genre :term:`access points + `. On import, AtoM will attempt to match these other entities + to existing records (criteria for this will be explained in greater detail + :ref:`below `) and link them. Where it does not + find a match, AtoM will create new related entities. + + This means that your XML description import could end up linking to + existing terms, repositories, and authority records, **or** creating new + access point, repository, and authority record data in addition to the + descriptions. + + Please review the matching criteria :ref:`below ` + closely prior to import, and be sure to review the results of your import + carefully after it is complete. We strongly recommend performing a test + import into a separate test instance of AtoM prior to importing directly + into your production AtoM site. + +**Jump to:** + +* :ref:`xml-description-matching` +* :ref:`xml-description-import-ui` +* :ref:`ead-delete-replace` + +.. _xml-description-matching: + +Matching critera for description XML imports +-------------------------------------------- + +As an archival management system, AtoM's data model has many different entity +types, which can be linked in a number of ways. This supports the reusability +of information - for example, rather than recreating the biographical history +of a creator in every different collection they are responsible for creating, +we can create a single :term:`authority record` to capture this information +and then link it to multiple archival descriptions. You can read more about +entity types in AtoM here: :ref:`entity-types`. + +XML imports can contain data that AtoM treats as a different :term:`entity` - +meaning that on import, AtoM must decide if if should link these elements to +existing entities that seem to match the incoming data, or whether it should +use the available data to create new records. + +With description XML imports, these elements might include: + +* creator information (which AtoM stores as an :term:`authority record`) +* repository information (which AtoM stores as an :term:`archival institution` + record) +* :term:`subject`, :term:`place`, and genre + :term:`access points ` (which AtoM maintains as + :term:`terms ` in a :term:`taxonomy`) +* :term:`name` access points (which AtoM stores as authority records) + +When importing a record, the **authorized form of name** of existing records +of other entity types is typically used as the matching criteria. For example, +if you import a description that includes a :term:`subject` access point for +"automobiles", and the term "automobiles" already exists in AtoM's Subjects +taxonomy, then AtoM will re-use the existing term and link to it instead of +creating a new subject term. Note that any difference - "automobile" vs +"automobiles" (pluralized) will result in a failure to match. When no +exact match is found, AtoM will create a new stub record with the available +data (generally just the authorized form of name), which you can then +supplement later by editing it via the :term:`user interface`. + +Because EAD 2002 files are generally more complex, used more frequently for +XML description imports into AtoM than other description XML types, and +because they also include the "Delete and replace" import option (described +:ref:`below `), they are given special attention in the +following sub-sections: + +* :ref:`ead-actors-import` +* :ref:`ead-description-matching`. .. _ead-actors-import: On Authority records and EAD imports ------------------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ AtoM tries to support the reusability of actor information through the maintenance of :term:`authority records ` that can be linked @@ -107,6 +231,19 @@ the key behaviors are outlined below: a new one, this method was chosen as the least destructive. However, this means that administrative or biographical histories CANNOT be updated via an import. +* When using the "Delete and replace" update method during an EAD import + (described further in the section :ref:`below `), AtoM + will **also** check for an exact match on any existing actor's + biographical/administrative history before linking the incoming + description's creator to an existing authority record. If the incoming + history in the ```` element of the EAD XML import file, as well + as the authorized form of name (captured in the ```` element + of the incoming EAD record) are not exact matches, then AtoM will create a + new authority record instead of linking to the existing one. This is to avoid + accidentally overwriting existing authority record data in the case of an + undesired match. +* This means that the "Delete and replace" update method **cannot** be used to + update existing authority records. * This also means that **users should be careful to double check authority linking behaviors in AtoM following an import**, and manually perform any desired adjustments where needed. @@ -115,4 +252,662 @@ the key behaviors are outlined below: * :ref:`csv-actors-import` +.. _ead-description-matching: + +Skipping records and finding archival description matches +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +With EAD 2002 XML imports, users have a few additional options. For imports of +new records, users can select an option to "Skip matched records". +Additionally, AtoM can attempt to identify top-level matches and then delete +them before importing the new EAD XML as a replacement. For more details, see +below, :ref:`ead-delete-replace`. + +When identifying :term:`archival description` matches among existing records, +AtoM will look for a match on the **title, identifier, and the associated +repository's authorized form of name**. If all of these criteria are not +matched - e.g. if the identifier is different - then the record will not be +considered a match, and depending on other user import settings, the incoming +EAD file will either be skipped, or will be imported as a new record without +deleting the previous record. This conservative approach is to avoid +accidentally deleting near matches in a :term:`multi-repository system`. + +This means that you cannot use the "Delete and replace" method described +:ref:`below ` to update the title, identifier, or related +repository of an :term:`archival unit`. If the update file contains different +information for these fields, then AtoM will fail to identify a match. + + +.. _xml-description-import-ui: + +Import new description XML records +---------------------------------- + +You can import EAD 2002 XML, MODS XML, or DC XML via the :term:`user +interface`. To do so, you must be logged in as an :term:`administrator`. + +**To import description XML records:** + +1. Click on the import menu menu, then click on XML. + +.. image:: images/import-menu.* + :align: center + :width: 20% + :alt: The import menu + +2. AtoM will redirect you to the XML import page: + +.. image:: images/xml-import-page.* + :align: center + :width: 90% + :alt: The XML import page in AtoM + +3. Use the "Type" :term:`drop-down menu` to select the XML type you are + importing. For archival descriptions, available types are EAD 2002, MODS, + and DC. + +4. If you are importing EAD 2002 XML, then AtoM contains some additional + import options, described in steps 5-6 below. If you are importing MODS or + DC XML, you can skip ahead to step 7. + +5. For imports of **new** EAD 2002 XML descriptions, make sure that the + "Update behaviors" :term:`drop-down menu` is set to "Ignore matches and + import as new." + +6. AtoM can check for existing records that seem to match the EAD + 2002 XML top-level description you are about to import, and skip these + record if desired - they will be reported in the + :ref:`Job details ` page of the related import job (see: + :ref:`manage-jobs` for more information). To enable this option and skip + matched records, click the checkbox labelled "Skip matched records." + +7. If you do not want your files indexed during the import, you can click the + checkbox labelled "Do not index imported items." This will prevent the new + records from automatically being added to AtoM's search index. + +.. WARNING:: + + If you do not index your records during import, they will not be + discoverable via search or browse in the user interface! You will need to + know the exact URL to reach them. To make them visible in the interface + again, a system administrator will need to rebuild the search index. See: + :ref:`maintenance-populate-search-index`. + +8. When you have configured your import options, click the "Browse" button to + open a window on your local computer. Select the XML file that you would + like to import. + +.. image:: images/csv-import-browse.* + :align: center + :width: 25% + :alt: Clicking the "Browse" button in the XML import page + +9. When you have selected the file from your device, its name will appear + next to the "Browse" button. Click the "Import" button located in the + :term:`button block` to begin your import. + +.. image:: images/import-button-block.* + :align: center + :width: 80% + :alt: The import button on the XML import page + +.. NOTE:: + + Depending on the size of your XML import, this can take some time to + complete. Be patient! Remember, you can always check on the status of an + import by reviewing the :ref:`Job details ` page of the related + import job - see: :ref:`manage-jobs` for more information. + +10. After your import has begun, AtoM will indicate that the import has been + initiated. A notification at the top of the page will also provide you with + a link to the :ref:`Job details ` page of the related import + job. Alternatively, you can click the "Back" button in the + :term:`button block` at the bottom of the page to return to the XML import + page, or navigate elsewhere in the application. + +.. image:: images/csv-import-completed.* + :align: center + :width: 85% + :alt: When an XML import has been initiated in AtoM + +.. TIP:: + + Want to find your recent imports? You can use the + :ref:`sort button ` located in the top-right hand + side of the archival description browse page to change the results display + to be ordered by "Most recent" if it is not already - that way, the most + recently added or edited descriptions will appear at the top of the + results. If you have come directly here after importing your descriptions, + they should appear at the top of the results. + + .. image:: images/csv-import-browse-page.* + :align: center + :width: 85% + :alt: The browse page following an XML import + + +.. _ead-delete-replace: + +Import EAD XML as a replacement for existing records +---------------------------------------------------- + +AtoM can attempt to identify existing top-level :term:`archival description` +records that match the incoming EAD 2002 XML import, and then delete those +records before proceeding with the import. This can be a useful way to replace +updated records. For more information on the criteria used to identify matches, +see above: :ref:`ead-description-matching`. + +.. NOTE:: + + This method is currently only available for EAD 2002 XML imports. It will + not work with MODS or DC XML imports. + + CSV imports have 2 methods of performing update imports. For more + information, see: + + * :ref:`csv-descriptions-updates` + +Note that related :term:`entities ` such as linked authority records, +terms (such as subject, place, and genre access points), repository records, +physical storage locations, etc. **are not deleted during this process**. The +link between them and the deleted archival description(s) is removed, but the +related entities are left intact. If you want these removed as well, they will +need to be manually deleted via the :term:`user interface`. + +Note as well that the links previously established are also **not guaranteed +to be re-established during the replacement import**. Once the matched +description is deleted, AtoM proceeds with the EAD 2002 XML import as a new +record. This means that it will link to existing entities or create new linked +entities based on the same criteria used for all imports - these are described +above: :ref:`xml-description-matching`. + +.. TIP:: + + When using the "Delete and replace" method, we strongly suggest testing the + results in a clone of your AtoM site prior to performing the replacement + import in a production system. + +**To delete matches and import EAD XML replacement records:** + +1. Click on the import menu menu, then click on XML. + +.. image:: images/import-menu.* + :align: center + :width: 20% + :alt: The import menu + +2. AtoM will redirect you to the XML import page: + +.. image:: images/xml-import-page.* + :align: center + :width: 90% + :alt: The XML import page in AtoM + +3. Use the "Type" :term:`drop-down menu` to select EAD 2002. + +4. Set the "Update behaviors" :term:`drop-down menu` to "Delete matches and + replace with imports." + +5. AtoM's default behavior when it cannot find a match during a "Delete and + replace" import is to import the XML as new records. However, if you are + **only** importing updates and don't want to accidentally create + duplicate new records when no match is found, you can check the "Skip + unmatched records" checkbox. Any unmatched records will not be imported - + instead, skipped records will be reported in the + :ref:`Job details ` page of the related import job (see: + :ref:`manage-jobs` for more information). + +.. image:: images/csv-match-options.* + :align: center + :width: 85% + :alt: The Match options available on the archival description XML import + page when EAD is used and "Delete and replace" is selected + +6. To improve the default matching behavior (described in detail above: + :ref:`ead-description-matching`), you can provide further criteria to help + AtoM find the correct match. You can limit the matches to either the + :term:`holdings` of a specific :term:`repository`, or if you are updating a + single :term:`archival unit`, you can limit matches to a specific top-level + description. To prevent contradictory options, these limiters are mutually + exclusive - you cannot pick a repository AND a top-level description. + + To limit your matches to the holdings of a specifc + :term:`archival institution`, use the :term:`drop-down menu` to select the + name of the related institution + + To limit your matches to a specific top-level description, place your + cursor in the "Top-level description" field and begin to slowly type the + name of the top-level description. This :term:`field` is an autcomplete + menu - as you begin to type, AtoM will display matching records in the + :term:`drop-down menu` that will appear below. When you see the top-level + description you want to use as a match limit, click on it in the drop-down + menu to select it. + +7. If you do not want your files indexed during the import, you can click the + checkbox labelled "Do not index imported items." This will prevent the new + records from automatically being added to AtoM's search index. + +.. WARNING:: + + If you do not index your records during import, they will not be + discoverable via search or browse in the user interface! You will need to + know the exact URL to reach them. To make them visible in the interface + again, a system administrator will need to rebuild the search index. See: + :ref:`maintenance-populate-search-index`. + +8. When you have configured your import options, click the "Browse" button to + open a window on your local computer. Select the XML file that you would + like to import. + +.. image:: images/csv-import-browse.* + :align: center + :width: 25% + :alt: Clicking the "Browse" button in the XML import page + +9. When you have selected the file from your device, its name will appear + next to the "Browse" button. Click the "Import" button located in the + :term:`button block` to begin your import. + +.. image:: images/import-button-block.* + :align: center + :width: 80% + :alt: The import button on the XML import page + +.. NOTE:: + + Depending on the size of your XML import, this can take some time to + complete. Be patient! Remember, you can always check on the status of an + import by reviewing the :ref:`Job details ` page of the related + import job - see: :ref:`manage-jobs` for more information. + +10. After your import has begun, AtoM will indicate that the import has been + initiated. A notification at the top of the page will also provide you with + a link to the :ref:`Job details ` page of the related import + job. Alternatively, you can click the "Back" button in the + :term:`button block` at the bottom of the page to return to the XML import + page, or navigate elsewhere in the application. + +.. image:: images/csv-import-completed.* + :align: center + :width: 85% + :alt: When an XML import has been initiated in AtoM + +.. TIP:: + + Want to find your recent imports? You can use the + :ref:`sort button ` located in the top-right hand + side of the archival description browse page to change the results display + to be ordered by "Most recent" if it is not already - that way, the most + recently added or edited descriptions will appear at the top of the + results. If you have come directly here after importing your descriptions, + they should appear at the top of the results. + + .. image:: images/csv-import-browse-page.* + :align: center + :width: 85% + :alt: The browse page following an XML import + +:ref:`Back to top ` + +.. _import-actor-xml: + +Importing authority record XML files +==================================== + +AtoM supports the import of EAC-CPF XML as a means of creating +:term:`authority record` data. As with most XML standards, EAC-CPF is a +flexible standard with many different but valid implementations possible - not +all of which will be supported by AtoM's import module. For this reason, we +strongly recommend that you review the available :term:`fields ` in the +AtoM authority record edit template, which is based on the International +Council on Archive's ISAAR-CPF standard. See: + +* :ref:`authority-records` +* :ref:`ISAAR-CPF template ` + +AtoM can also attempt to identify existing authority records that match the +import record, and then delete them before importing the EAC-CPF XML as a new +record. Further details on this can be found in the section below, +:ref:`delete-replace-actor-xml`. On new EAC-CPF imports, AtoM can also search +for existing matches and skip the import if a match is found - this +can be useful as a sanity check prior to import to ensure you are not +accidentally creating duplicate records. In both cases, skipped records are +reported in the :ref:`Job details ` page of the related import +job (see: :ref:`manage-jobs` for more information). + +.. IMPORTANT:: + + XML data can contain other related :term:`entities ` - for example, + an EAC-CPF XML :term:`authority record` may contain references to other + related authority records, or linked :term:`archival description` records. + The import might also contain :term:`access point` data such as an Actor + Occupation access point. In most cases, on import AtoM will attempt to + match these other entities to existing records (criteria for this will be + explained in greater detail :ref:`below `) and link + them. Where it does not find a match, AtoM will create new related entities. + + For links to related archival descriptions, AtoM **does not have the + ability to look for existing matches**, and will therefore create new stub + archival description records on import if there is information about + related descriptions in your import EAC-CPF XML. + + This means that your XML description import could end up linking to + existing terms, repositories, and authority records, **and/or** creating + new records for various entity types on import! + + Please review the matching criteria :ref:`below ` + closely prior to import, and be sure to review the results of your import + carefully after it is complete. We strongly recommend performing a test + import into a separate test instance of AtoM prior to importing directly + into your production AtoM site. We also suggest removing any references to + related archival descriptions from the EAC-CPF prior to import. If you want + to import and link authority records and descriptions, import the authority + records first, and then the archival descriptions - you can see the linking + criteria from archival descriptions to authority records in the section on + archival description imports above: :ref:`ead-actors-import`. + +Below you'll find information on the matching criteria for authority record +imports, how to import new authority record data, and how to identify and +delete an existing authority record to replace it with an EAC CPF XML import. + +**Jump to:** + +* :ref:`actor-xml-matching` +* :ref:`import-actor-xml-ui` +* :ref:`delete-replace-actor-xml` + +.. SEEALSO:: + + Authority records can also be imported and updated as CSV data - see: + + * :ref:`csv-import-authority-records` + * :ref:`csv-import-authority-records-gui` + * :ref:`csv-update-actors` + + You can also import EAC-CPF XML data in bulk via the command-line. For more + information, see in the Administrator's manual: + + * :ref:`cli-bulk-import-xml` + + +.. _actor-xml-matching: + +Matching criteria for EAC-CPF XML imports +----------------------------------------- + +AtoM can attempt to identify existing authority records that match the +import record, and then delete them before importing the EAC-CPF XML as a new +record. Further details on using this can be found in the section below, +:ref:`delete-replace-actor-xml`. On new EAC-CPF imports, AtoM can also search +for existing matches and skip the import if a match is found - this +can be useful as a sanity check prior to import to ensure you are not +accidentally creating duplicate records. In both cases, skipped records are +reported in the :ref:`Job details ` page of the related import +job (see: :ref:`manage-jobs` for more information). + +To identify matching authority records, AtoM uses compares the **authorized +form of name** of the existing authority records against the import data. This +means that the "Delete and replace" method will fail to identify a match if +you are attempting to use it to update the authorized form of name of an +authority record. + +You can also add an additional criteria to improve the likelihood of finding +the correct match. If you have linked your :term:`authority record` to a +:term:`repository` as its maintainer, then you can set this as a limiting +option on the match. In this case, AtoM will check for a match on the +authorized form of name of existing authority records, and then will also +check to see if any matches are also linked to the selected repository. For +more information on linking an authority record to an +:term:`archival institution` (a.k.a. a repository), see: + +* :ref:`link-repo-actor` + +If there are other related :term:`entities ` in the incoming EAC-CPF +XML (such as Occupation :term:`access point` terms), then AtoM will look for +existing terms based on the authorized form of name - if none are found, AtoM +will create new records for these related entities. + +.. IMPORTANT:: + + Currently AtoM **does not** check for existing matches on related + :term:`archival descriptions `. If your EAC-CPF XML + includes information on related descriptions, AtoM will end up creating + stub archival description records based on the data in the EAC-CPF record, + even if there is an exact match on title among your existing descriptions! + + We strongly recommend performing a test import into a separate test + instance of AtoM prior to importing directly into your production AtoM + site. We also suggest removing any references to related archival + descriptions from the EAC-CPF prior to import. If you want to import and + link authority records and descriptions, import the authority records + first, and then the archival descriptions - you can see the linking + criteria from archival descriptions to authority records in the section on + archival description imports above: :ref:`ead-actors-import`. + + +.. _import-actor-xml-ui: + +Importing new authority record XML files +---------------------------------------- + +You can import EAC-CPF XML via the :term:`user interface`. To do so, you must +be logged in as an :term:`administrator`. + +**To import authority record XML records:** + +1. Click on the import menu menu, then click on XML. + +.. image:: images/import-menu.* + :align: center + :width: 20% + :alt: The import menu + +2. AtoM will redirect you to the XML import page: + +.. image:: images/xml-import-page.* + :align: center + :width: 90% + :alt: The XML import page in AtoM + +3. Use the "Type" :term:`drop-down menu` to select the XML type you are + importing. For authority records, select "EAC CPF" from the menu. + +4. For imports of **new** EAC-CPF XML data, make sure that the "Update + behaviors" :term:`drop-down menu` is set to "Ignore matches and import as + new." + +5. AtoM can check for existing records that seem to match the EAC-CPF XML + authority record you are about to import, and skip the import if a match is + found - it will be reported in the :ref:`Job details ` page of + the related import job (see: :ref:`manage-jobs` for more information). To + enable this option and skip matched records, click the checkbox labelled + "Skip matched records." + +6. If you do not want your files indexed during the import, you can click the + checkbox labelled "Do not index imported items." This will prevent the new + records from automatically being added to AtoM's search index. + +.. WARNING:: + + If you do not index your records during import, they will not be + discoverable via search or browse in the user interface! You will need to + know the exact URL to reach them. To make them visible in the interface + again, a system administrator will need to rebuild the search index. See: + :ref:`maintenance-populate-search-index`. + +7. When you have configured your import options, click the "Browse" button to + open a window on your local computer. Select the XML file that you would + like to import. + +.. image:: images/csv-import-browse.* + :align: center + :width: 25% + :alt: Clicking the "Browse" button in the XML import page + +9. When you have selected the file from your device, its name will appear + next to the "Browse" button. Click the "Import" button located in the + :term:`button block` to begin your import. + +.. image:: images/import-button-block.* + :align: center + :width: 80% + :alt: The import button on the XML import page + +.. NOTE:: + + Depending on the size of your XML import, this can take some time to + complete. Be patient! Remember, you can always check on the status of an + import by reviewing the :ref:`Job details ` page of the related + import job - see: :ref:`manage-jobs` for more information. + +10. After your import has begun, AtoM will indicate that the import has been + initiated. A notification at the top of the page will also provide you with + a link to the :ref:`Job details ` page of the related import + job. Alternatively, you can click the "Back" button in the + :term:`button block` at the bottom of the page to return to the XML import + page, or navigate elsewhere in the application. + +.. image:: images/csv-import-completed.* + :align: center + :width: 85% + :alt: When an XML import has been initiated in AtoM + +:ref:`Back to top ` + +.. _delete-replace-actor-xml: + +Import EAC-CPF XML as a replacement for an existing authority record +--------------------------------------------------------------------- + +AtoM can attempt to identify existing authority records that match the incoming +EAC-CPF XML import, and then delete the existing matched record before +proceeding with the import. This can be a useful way to replace +updated records. For more information on the criteria used to identify matches, +see above: :ref:`actor-xml-matching`. + +.. NOTE:: + + CSV imports have 2 methods of performing update imports. For more + information, see: + + * :ref:`csv-update-actors` + +Note that related :term:`entities ` such as linked authority records, +terms (such as subject, place, and genre access points), repository records, +or archival descriptions, etc. **are not deleted during this process**. The +link between them and the deleted authority record is removed, but the +related entities are left intact. If you want these removed as well, they will +need to be manually deleted via the :term:`user interface`. + +Note as well that the links previously established are also **not guaranteed +to be re-established during the replacement import**. Once the matched +authority record is deleted, AtoM proceeds with the EAC-CPF XML import as a +new record. This means that it will link to existing entities or create new +linked entities based on the same criteria used for all imports - these are +described above: :ref:`actor-xml-matching`. + +.. TIP:: + + When using the "Delete and replace" method, we strongly suggest testing the + results in a clone of your AtoM site prior to performing the replacement + import in a production system. + +**To delete matches and import EAC-CPF XML replacement records:** + +1. Click on the import menu menu, then click on XML. + +.. image:: images/import-menu.* + :align: center + :width: 20% + :alt: The import menu + +2. AtoM will redirect you to the XML import page: + +.. image:: images/xml-import-page.* + :align: center + :width: 90% + :alt: The XML import page in AtoM + +3. Use the "Type" :term:`drop-down menu` to select the XML type you are + importing. For authority records, select "EAC CPF" from the menu. + +4. Set the "Update behaviors" :term:`drop-down menu` to "Delete matches and + replace with imports." + +5. AtoM's default behavior when it cannot find a match during a "Delete and + replace" import is to import the EAC-CPF XML as a new record. However, if + you are **only** importing updates and don't want to accidentally create a + duplicate new record when no match is found, you can check the "Skip + unmatched records" checkbox. Any unmatched records will not be imported - + instead, skipped records will be reported in the + :ref:`Job details ` page of the related import job (see: + :ref:`manage-jobs` for more information). + +.. image:: images/eac-match-options.* + :align: center + :width: 85% + :alt: The Match options available on the authority record XML import + page when EAC CPF is used and "Delete and replace" is selected + +6. To improve the default matching behavior (described in detail above: + :ref:`actor-xml-matching`), you can provide further criteria to help + AtoM find the correct match. You can limit the authority record matches to + only those which have been linked to a specifc :term:`archival institution` + as the maintainer - records that have no link to a repository, or to a + different :term:`repository`, will be ignored. For more information on + linking an authority record to a repository, see: :ref:`link-repo-actor`. + + To limit your matches to authority records maintained by a specifc + :term:`archival institution`, use the :term:`drop-down menu` to select the + name of the related institution. + +7. If you do not want your files indexed during the import, you can click the + checkbox labelled "Do not index imported items." This will prevent the new + records from automatically being added to AtoM's search index. + +.. WARNING:: + + If you do not index your records during import, they will not be + discoverable via search or browse in the user interface! You will need to + know the exact URL to reach them. To make them visible in the interface + again, a system administrator will need to rebuild the search index. See: + :ref:`maintenance-populate-search-index`. + +8. When you have configured your import options, click the "Browse" button to + open a window on your local computer. Select the XML file that you would + like to import. + +.. image:: images/csv-import-browse.* + :align: center + :width: 25% + :alt: Clicking the "Browse" button in the XML import page + +9. When you have selected the file from your device, its name will appear + next to the "Browse" button. Click the "Import" button located in the + :term:`button block` to begin your import. + +.. image:: images/import-button-block.* + :align: center + :width: 80% + :alt: The import button on the XML import page + +.. NOTE:: + + Depending on the size of your XML import, this can take some time to + complete. Be patient! Remember, you can always check on the status of an + import by reviewing the :ref:`Job details ` page of the related + import job - see: :ref:`manage-jobs` for more information. + +10. After your import has begun, AtoM will indicate that the import has been + initiated. A notification at the top of the page will also provide you with + a link to the :ref:`Job details ` page of the related import + job. Alternatively, you can click the "Back" button in the + :term:`button block` at the bottom of the page to return to the XML import + page, or navigate elsewhere in the application. + +.. image:: images/csv-import-completed.* + :align: center + :width: 85% + :alt: When an XML import has been initiated in AtoM + :ref:`Back to top `