Archival Description Correction
143 views
Skip to first unread message
leonardo...@gmail.com
May 20, 2020, 5:45:43 PM5/20/20
to AtoM Users
Hello,
due to mistake, some files were created and they require name access point. They are 700 files to add. Is there a way to added in mass form? Or can it only be corrected one by one?
Dan Gillean
May 21, 2020, 12:24:09 PM5/21/20
to ICA-AtoM Users
Hi Leonardo,
@accesstomemory
If you just need to add an access point to a number of descriptions, then the CSV import update functionality may work well for this case.
Note that an access point is a different entity - it is not stored in the main database tables used for descriptions (i.e. information_object and information_object_i18n). Consequently, we cannot replace existing access points with new ones, but we can append new access points.
The trickiest part of using the update import functionality right now is getting it to match the right records. It was originally designed to update records in an external system (such as another AtoM instance, like a regional portal site) where original creation was also done via CSV import. However, in practice most people want to use it to "roundtrip" in a single system as a way of making bulk updates.
I have previously explained some of the problems with the current matching criteria here:
The short version is: matching by legacyID and source_name will not work when roundtripping in a single system (because the legacyID you used for import is not what is exported), so you need to rely on the fallback match criteria, which is an exact match on:
- Title
- Repository name
- Identifier
In 2.6, we have introduced a new command-line option for roundtripping, that ignores other criteria and only matches the import CSV's legacyID values against the database's object ID values (which is what populates the legacyID column during an export from AtoM). See:
However, in the meantime, for your case - I think we might be able to get it to work (since you are not making changes to Title, Repository, and Identifier) and we can use the skip option so if a match isn't found, nothing is changed.
Here is a rough outline of the workflow I would recommend trying:
1) First, if this a production site, we always recommend making a backup of your data first, just in case you need to roll back to the previous state.
2) Next, find the records you want to update, and add them to the Clipboard. If they are all part of the same hierarchy, you can just add the top-level record, and then use the "include descendants" option on the clipboard export. See:
3) Now we can open up the CSV, and add the name(s) we want to the nameAccessPoints column in the CSV for the rows you want to update. One important thing - we strongly recommend NOT using Microsoft Excel when editing your CSV files! Microsoft tends to use their own custom character encoding (WinLatin instead of UTF-8) and end-of-line characters (CRLF instead of just LF), and this can cause problems during import, potentially causing strange characters, extra blank descriptions, etc. Instead, we recommend LibreOffice Calc - it is free, open source, and includes an option to configure your CSV setting every time you open a file.
4) Once you have made your changes and saved the CSV, we can attempt to import this as an update. To do so, we will want to use the following import settings:
- Update behaviors: "Update matches in place and ignore blank rows in the CSV"
- Check the "Skip unmatched records" options
5) Run the import!
6) Review the log on the related Job details page, and see if records were matched or skipped. If skipped, then this method may not work - but hopefully this means that nothing was changed, so there are no mistakes to undo. If they found matches, then go and check your records and see if the name access point has been successfully added as expected.
Let us know how it goes!
he / him
On Wed, May 20, 2020 at 5:45 PM <leonardo...@gmail.com> wrote:
Hello,due to mistake, some files were created and they require name access point. They are 700 files to add. Is there a way to added in mass form? Or can it only be corrected one by one?
--
You received this message because you are subscribed to the Google Groups "AtoM Users" group.
To unsubscribe from this group and stop receiving emails from it, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/d7a54e77-6a58-4211-a101-550182559e88%40googlegroups.com.
Leonardo José Giménez Rodriguez
May 22, 2020, 11:47:15 AM5/22/20
to ica-ato...@googlegroups.com
For some reason, I can't add the archival descriptions to a clipboard, I click on it and nothing happens. On the other hand, I have 2.4 Atom's version, I would like to know if this is a significant thing. I'm not available to see the menu option even when I type index.php/user/clipboard
You received this message because you are subscribed to a topic in the Google Groups "AtoM Users" group.
To unsubscribe from this topic, visit https://groups.google.com/d/topic/ica-atom-users/mLG9ry_3yio/unsubscribe.
To unsubscribe from this group and all its topics, send an email to ica-atom-user...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CAC1FhZK6DY25zdkG9GZq4Limejtd0of2LN%2B5MntHOLSX3zk0RQ%40mail.gmail.com.
Dan Gillean
May 22, 2020, 5:20:06 PM5/22/20
to ICA-AtoM Users
Hi Leonardo,
Does your site have a custom theme plugin installed? If yes, does the clipboard work if you change to the base Dominion theme?
Have you tried clearing your browser cache, and/or testing in a new incognito/private browser window?
You could also try clearing the application cache, and restarting PHP-FPM (and memcached if you are using it) to see if that helps. The following commands are typically run from the root AtoM installation directory, which is /usr/share/nginx/atom if you have followed our recommended installation instructions.
Clearing the cache:
- php symfony cc
Restarting PHP-FPM
- Ubuntu 14.04 with PHP 5.x: sudo service php5-fpm restart
- Ubuntu 16.04 with PHP 7.0: sudo systemctl restart php7.0-fpm
Restarting memcached:
- Ubuntu 14.04: sudo service memcached restart
- Ubuntu 16.04: sudo systemctl restart memcached
You can possibly also try recompiling the theme. We use LESS to minimize the size of the CSS files - you may need to install it first. Here are our 16.04 instructions for installing the needed version of LESS, and running the command to recompile the base Dominion theme:
- curl -sL https://deb.nodesource.com/setup_6.x | sudo -E bash -
- sudo apt install nodejs make
- sudo npm install -g "less@<2.0.0"
- sudo make -C /usr/share/nginx/atom/plugins/arDominionPlugin
If you have a custom theme plugin, you can also try the last command, but with the name of your custom theme plugin - for example:
- sudo make -C /usr/share/nginx/atom/plugins/arCustomThemePlugin
If it's still not working:
- Can you give me the full AtoM version number listed in Admin > Settings > Global at the top of the settings page?
- Did you install using our recommended instructions?
- If yes, are you using Ubuntu 14.04 or 16.04 with AtoM 2.4?
- If no, what changes have you made?
- Have you checked the AtoM error logs for any relevant messages? If so, please share the log message with us.
- What happens when you try to manually navigate to /user/clipboard? Do you get a 500 error message? A white screen? Something else?
Cheers,
he / him
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CALLTQm9QGT1FqNF3vzDPoW0DTJdNfTX%3Des9gdtNPbWa30%3DkC_Q%40mail.gmail.com.
Leonardo José Giménez Rodriguez
May 25, 2020, 12:27:30 PM5/25/20
to ica-ato...@googlegroups.com
- Version 2.4.0-156
- Yes, it was installed with the recommended instructions.
- No, we use centOS linux.
- I'm not sure of all the change. I did not participate in most of them. But I attach some images of how the clipboard menu is configured to see if it is correct.
- Clicking on add to clipboard doesn't do any function and it doesn't generate any error.
- Manually in the route user/clipboard it works but the route user/clipboardClear gives me error 500.
Attached images
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CAC1FhZ%2BPEEGZFMDCVZp4pFSsEifFiHkC_-eB3p-g_GMX6K9w7g%40mail.gmail.com.
Dan Gillean
May 26, 2020, 11:54:06 AM5/26/20
to ICA-AtoM Users
Hi Leonardo,
Thank you for the information. If it's a CentOS installation, then there is a limit to the suggestions we can offer, as some of the available packages may be different. However, several community users have shared CentOS installation guides, so you could check your installation against these:
Please note that in general, we do not test these instructions ourselves.
I would also recommend that you review this section of our upgrading docs, to see if there are any fixes you need to make to your custom theme:
I also suggest that you try running the CSS recompile commands I recommended in my last post, against both the Dominion base theme, and your custom theme.
Finally, it's good to see that the clipboard page itself is accessible, but it seems that clicking the paperclip icon to pin a record is not working for you. I suggest checking your webserver error logs to see what the related error message is for the 500 error you saw when trying the clear clipboard option.
Of course, if you are able to upgrade to version 2.5.4, it may help as well - I'm not sure if it will help solve this particular issue, but you will find a number of enhancments, new features, and bug fixes.
Let us know how it goes!
he / him
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/CALLTQm_RwVdv73w%3DpUWg3K3SrGgYfx4WFu8bDg8CZQUG9K9XWQ%40mail.gmail.com.
Cindy
Jul 15, 2022, 3:21:23 PM7/15/22
to AtoM Users
Hi,
We are having similar clipboard issues:
- When click clipboard icon nothing happens.
- Clipboard is not in menu bar.
We have custom theme plugin installed.
- When we changed to the base Dominion theme, clipboard works and displays in the menu
- We tried following steps that Dan recommended, but still not working.
- clear cache
- restart php-fpm and memcached
- recompiled arDominionPlugin and myCustomThemePlugin
We are on:
- Version 2.6.4-184
- Installed with the recommended instructions.
- We are using centOS linux.
- The custom theme was created years ago(2.4 or earlier) nothing has been changed.
- No error in nginx error.log.
- Manually go to index.php/user/clipboard, /clipboardClear and /clipboardSave, no error.
I checked our custom theme code, the Configuration.class.php file is same as:
https://www.accesstomemory.org/en/docs/2.6/admin-manual/customization/theming/#customization-theming
Any help and suggestion would be greatly appreciated.
Thanks,
Dan Gillean
Jul 15, 2022, 4:18:25 PM7/15/22
to ICA-AtoM Users
Hi Cindy,
I think there have been a few changes in AtoM since the 2.4 release that affect this, but hopefully this is an easy fix.
One of our developers suggests checking and making sure that the following line is added to the header template in your custom theme plugin:
You can see an example of this in the ArchivesCanada custom theme - though it's a bit unique since the AC theme has 2 headers (a separate black one for logged in users, that shows on top of the custom themed public one), which is why it appears so much farther down in the code of that example.
You should recompile the theme again after making changes, and you may want to restart services and clear caches / your web browser cache for good measure.
Let us know if that resolves the issue!
he / him
To view this discussion on the web visit https://groups.google.com/d/msgid/ica-atom-users/d45add0c-d871-44b3-bd60-4d7c9435347an%40googlegroups.com.
Cindy
Jul 21, 2022, 3:16:33 PM7/21/22
to AtoM Users
Hi Dan,
Cindy
Adding that line of code has resolved the clipboard issues on our site.
Thank you so much Dan and your developer!
Cindy
Reply all
Reply to author
Forward
0 new messages