<!-- 
RSS generated by JIRA (1001.0.0-SNAPSHOT#100246-sha1:7a5c50119eb0633d306e14180817ddef5e80c75d) at Thu Feb 08 23:07:49 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary add field=key&field=summary to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>FOLIO Jira</title>
    <link>https://folio-org.atlassian.net</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>1001.0.0-SNAPSHOT</version>
        <build-number>100246</build-number>
        <build-date>07-02-2024</build-date>
    </build-info>

<item>
            <title>[FOLIO-715] User import script update</title>
                <link>https://folio-org.atlassian.net/browse/FOLIO-715</link>
                <project id="10290" key="FOLIO">FOLIO</project>
                    <description>&lt;p&gt;On yesterday&apos;s UM SIG meeting we talked about the bulk user import script.&lt;br/&gt;
Some key points came up :&lt;/p&gt;
&lt;ul&gt;
	&lt;li&gt;The externalSystemId should be used for checking existing users and as match point for updating users&lt;/li&gt;
	&lt;li&gt;Addresses:
	&lt;ul&gt;
		&lt;li&gt;Test what happens with addresses on user update if created an additional address in FOLIO - addresses created within FOLIO shouldn&apos;t be deleted unless something is explicitly sent via the update (a blank value?  delete flag?)&lt;/li&gt;
		&lt;li&gt;Test how an address created in FOLIO can be deleted and document&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;Other fields
	&lt;ul&gt;
		&lt;li&gt;Similar to addresses, it would be nice if data added within FOLIO was ignored/left in tact unless something is explicitly sent to remove/update it.  Please test whether that already works today and document.&lt;/li&gt;
	&lt;/ul&gt;
	&lt;/li&gt;
	&lt;li&gt;There was a misunderstanding about username, maybe we should use userid in the script input and map it to FOLIO&apos;s username field &lt;font color=&quot;red&quot;&gt;CB: Actually, I think the desire was that FOLIOs internal field names match the names specified by the SIG in the &lt;a href=&quot;https://docs.google.com/spreadsheets/d/121RpsJNaewhQEKb7k58eNVIhZ7N9oSWowNRJGYjPJ2M/edit?usp=drive_web&quot; class=&quot;external-link&quot; rel=&quot;nofollow noreferrer&quot;&gt;User Metadata Document&lt;/a&gt;.  Or, if the internal names can&apos;t be made to match, there should be some way to obscure any inconsistencies from those interacting with the system (script developers, people reading error messages).  Let&apos;s get Jakub&apos;s take on this.&lt;/font&gt;&lt;/li&gt;
	&lt;li&gt;The code should be optimized for a large amount of records.&lt;/li&gt;
	&lt;li&gt;An equivalent version could be written in another language, e.g. Python or Perl.  This is not a hard requirement, though, as most institutions are probably going to want to write their own scripts.  The purpose of our writing a script is just as a proof-of-concept and the current script is probably fine for that purpose.&lt;/li&gt;
	&lt;li&gt;The script shouldn&apos;t have to supply a FOLIO ID/system identifier for the user and it seems like it does.  Let&apos;s discuss with Jakub and file a bug, if needed.&lt;/li&gt;
&lt;/ul&gt;
</description>
                <environment></environment>
        <key id="80232">FOLIO-715</key>
            <summary>User import script update</summary>
                <type id="10003" iconUrl="https://folio-org.atlassian.net/rest/api/2/universal_avatar/view/type/issuetype/avatar/10318?size=medium">Task</type>
                                            <priority id="10001" iconUrl="https://dev.folio.org/assets/jira-priority/jira-p2.svg">P2</priority>
                        <status id="6" iconUrl="https://folio-org.atlassian.net/images/icons/statuses/closed.png" description="The issue is considered finished, the resolution is correct. Issues which are closed can be reopened.">Closed</status>
                    <statusCategory id="3" key="done" colorName="green"/>
                                    <resolution id="10003">Done</resolution>
                                                        <assignee accountid="5e1750638dfdd40ec489bf08">Katalin Lovagn&#233; Sz&#369;cs</assignee>
                                                                <reporter accountid="5e1750638dfdd40ec489bf08">Katalin Lovagn&#233; Sz&#369;cs</reporter>
                                    <labels>
                            <label>demo19</label>
                            <label>sprint18</label>
                    </labels>
                <created>Thu, 13 Jul 2017 08:38:20 +0000</created>
                <updated>Mon, 12 Nov 2018 14:23:38 +0000</updated>
                            <resolved>Mon, 24 Jul 2017 12:33:02 +0000</resolved>
                                                                        <due></due>
                            <votes>0</votes>
                                    <watches>2</watches>
                                                                <comments>
                                                            <comment id="188833" author="5af5ed55244bc90a106063c7" created="Thu, 13 Jul 2017 10:59:37 +0000"  >&lt;p&gt;&lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=557058%3Ab8e64633-1f7c-402d-9caf-9959a5ba5d0d&quot; class=&quot;user-hover&quot; rel=&quot;557058:b8e64633-1f7c-402d-9caf-9959a5ba5d0d&quot; data-account-id=&quot;557058:b8e64633-1f7c-402d-9caf-9959a5ba5d0d&quot; accountid=&quot;557058:b8e64633-1f7c-402d-9caf-9959a5ba5d0d&quot; rel=&quot;noreferrer&quot;&gt;Jakub Skoczen&lt;/a&gt;, can you please take a look at this issue and weigh in with your thoughts?&lt;/p&gt;</comment>
                                                            <comment id="188836" author="5e1750638dfdd40ec489bf08" created="Fri, 21 Jul 2017 08:48:58 +0000"  >&lt;p&gt;The script has been updated with the following:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;The externalSystemId is the matching point when creating/updating users.&lt;/li&gt;
	&lt;li&gt;The code is optimized for a larger amount of records (tested with a batch of 1000 records).&lt;/li&gt;
	&lt;li&gt;When creating a new user, a UUID is generated as FOLIO id for that specific user.&lt;/li&gt;
	&lt;li&gt;Error management which handles errors differently according to the error type. E.g. if a user can not be added because a required field is missing, it will be skipped but the import will handle the other users. But if the reason of the failure was that the user is not authenticated properly, there was an internal server error or the system is currently offline then the script will most certainly fail to import more users thus it is exiting in this case.&lt;/li&gt;
&lt;/ul&gt;


&lt;p&gt;The field overwrites has been tested with the following result:&lt;/p&gt;

&lt;ul&gt;
	&lt;li&gt;Addresses coming from the import always overwrite the ones in FOLIO.&lt;/li&gt;
	&lt;li&gt;The same is true for any other field.&lt;/li&gt;
&lt;/ul&gt;
</comment>
                                                            <comment id="188839" author="5af5ed55244bc90a106063c7" created="Fri, 21 Jul 2017 09:40:08 +0000"  >&lt;p&gt;Great work &lt;a href=&quot;https://folio-org.atlassian.net/secure/ViewProfile.jspa?accountId=5e1750638dfdd40ec489bf08&quot; class=&quot;user-hover&quot; rel=&quot;5e1750638dfdd40ec489bf08&quot; data-account-id=&quot;5e1750638dfdd40ec489bf08&quot; accountid=&quot;5e1750638dfdd40ec489bf08&quot; rel=&quot;noreferrer&quot;&gt;Katalin Lovagn&#233; Sz&#369;cs&lt;/a&gt;!  Have you heard from Chris Manly about the user set from Cornell?  It would be great to get testing with a real data set.  &lt;/p&gt;

&lt;blockquote&gt;&lt;p&gt;The field overwrites has been tested with the following result:&lt;br/&gt;
Addresses coming from the import always overwrite the ones in FOLIO.&lt;br/&gt;
The same is true for any other field.&lt;/p&gt;&lt;/blockquote&gt;

&lt;p&gt;Just to confirm, if a home address has been added manually to User A in FOLIO and the import updates User A with only a campus address, the home address is cleared out?  In other words, there is no way for the import to leave FOLIO data in tact upon update.  &lt;/p&gt;

&lt;p&gt;That is what I was expecting based on our last discussion with Jakub, but wanted to double check.  &lt;/p&gt;</comment>
                                                            <comment id="188841" author="5e1750638dfdd40ec489bf08" created="Fri, 21 Jul 2017 13:25:32 +0000"  >&lt;p&gt;No, I have not heard from Chris about the data set yet.&lt;br/&gt;
Yes, currently the import works that way.&lt;/p&gt;</comment>
                    </comments>
                    <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                <customfield id="customfield_10000" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummarycf">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10019" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>0|hzxqyn:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    <customfield id="customfield_10020" key="com.pyxis.greenhopper.jira:gh-sprint">
                        <customfieldname>Sprint</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        <customfield id="customfield_10024" key="com.atlassian.jira.ext.charting:firstresponsedate">
                        <customfieldname>[CHART] Date of First Response</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>Thu, 13 Jul 2017 10:59:37 +0000</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10025" key="com.atlassian.jira.ext.charting:timeinstatus">
                        <customfieldname>[CHART] Time in Status</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                    </customfields>
    </item>
</channel>
</rss>