The LUNA Uploader makes importing media items and data into your collections and the IMI a snap.
You can upload content to the IMI or to a specific collection. With the correct settings you'll be able to upload media items and records at the same time and have them automatically linked and ready for display in the LUNA Viewer. This will save you a lot of time when building collections!
Open the Uploader page from the Tools menu. Select the collection you would like to upload records and images for. Create a new batch or use the existing batch. Now click the "Select Files" button to search your computer for the files you want to upload. Select all the records and images you like.
Using the "Settings" menu next to the Tools menu you can decide what field in the records to use to link the images you just uploaded to their respective data records. Most often this is done using the filename of the image. If "Filename" is part of your data schema, the system will automatically select "Filename" in the pull down menu and link the items and records by this field. If you are using a different field, use the "Link records and media items with" pull down menu to tell the system which data field to use.
Next, select one of the 3 choices directly below "Link records and media items":
It's a best practice to upload your data first in your batch then upload the media. This allows the system to attempt linking with an existing record as each media item is processed.
If you've uploaded items and records but forgot to auto link, no problem. Just go back to the settings and select the field and one of the 3 options below the pull down menu, then click "Apply links now". This will then link all the items and records. You can apply these links even after everything has been uploaded.
A best practice when uploading content into LUNA is to always include "Filename" as one of your data fields. This is the easiest way for the system to link the records and items together.
When you upload a .csv file with all your records the only way LUNA can link the images to the records is if one of the fields in the record contains the filename of the image. If you are using schema for a collection that does not have a field that contains the filename, how can you link the images to the records you are uploading? You could do it one at a time in the Library but that may get very tedious, especially if you have hundreds or thousands of records to attach. This is why we have the ability to create and upload a linking file. The only piece of information a media item has to link to is its filename. Your schema may not have a field that contains the filename but it probably has a field that is unique for every record, like an identification number or something similar. We will use that unique field and the filenames of the images to create a link.
To create the linking file you need to choose a field from your schema that is unique (different) for each record. Usually a field like "Identifier" is used. You will create a "Linking File" that is tab separated (instead of comma separated) that will link images to records using the filename of the image and any field you choose from the records (a field that is unique for each record is highly recommended). Create a file that has 2 columns of data. On the left side is the file name of the media you are uploading or have uploaded and on the right side the field in your schema you choose.
- The field you choose as the linking value must be a field in the primary Field Group/Record Type. For example in Dublin Core it would be "Identifier".
Tip: You know your media items are linked to records if you see data displaying next to them when looking at the batch in the Uploader. If you've uploaded records and items and told the system to link them but you don't see any data after the upload is complete, go back to the settings and click on "Apply Links".
If you forgot to make your linking selections before uploading items, you can manage the linking of records and media items after they have all been uploaded. Open the batch that has the .csv file uploaded. Open the "Settings" menu (next to the Tools menu up top). Select the linking field from the pulldown menu under "Link records and media items with". Then select one of the 3 options below and click "Apply links now". This will link all the items and records.
If you do not have a linking field in your data, you will need to use a linking file instead. See the answer above.
There are a few reasons you might see this.
This error happens if something is wrong with the data file you uploaded. A User can click "Download log" for info. Usually one or more fields are missing or out of order in the upload file. It could also be that fields with repeating values are not set up correctly. If one of the fields in the first row of your .csv (the field defining row) is missing, mis-typed, or in the wrong order you will get an error. You can download a blank .csv for the collection you are working on in the lower left of the Uploader page. This blank .csv will only contain the first row with the correct data fields in it. You can use this to verify that your format is correct on the .csv you are trying to upload that is getting errors.
Open the Uploader page from the Tools menu. Select the collection you would like to upload images for. Create a new batch or use the existing batch. Now click the "Select Files" button to search your computer for the files you want to upload. Select all the images you like. When all images have been selected, click "Start Upload".
You can also use Drag and Drop to add your files.
This will upload the images and make them available in the Library for you to work with. If you import a .csv after the image upload you can connect the records. If you want to manually connect the records in the Library you can also do that. You can even manually create the records in the Library.
Once you start the upload you will see all the images upload. It will then take a moment before you start seeing it process all the images one at a time. You can see that all the images have been processed but do not have records yet attached (no data in the columns next to the thumbnails).
When uploading PDF files, LUNA will use the first page of the PDF file as a Custom Thumbnail to represent that item in the LUNA Library and the LUNA Viewer. If a custom thumbnail is not displaying for the PDF file(s) you are uploading, we recommend that you create the PDF as a PDF/A-2b and upload it again.
When you go to the Uploader From the Tools menu you can decide if you want to upload records or media items (or both). If you only want to upload records in a batch you may do that. If you only want to upload media items in a batch you may do that also. You can come back and add images or records at any time to a batch you have created.
The only file types supported for records are: .csv .xml .mrc
Select the file with the records:
After you click upload:
You can see the records uploaded. They are not linked to images as you can see in the first column. When you click upload it will begin to process the records one at a time. You can refresh your browser if you like.
The easiest way to prepare a .csv (comma separated value) file is to download the pre-made one that has ALL the fields setup properly but no records. This file is located in the lower left "Download blank data schema .csv file". You can then begin to fill in the rows with your record information.
The .csv file must match the data schema you selected in the Collection Manager when you first established the collection properties. If you download the blank .csv from the Uploader page it will be the correct schema or the collection selected.
To import repeating fields that are part of a field group or authority via a .csv spreadsheet in the Uploader make sure each repeating field has the # sign and a successive number following it. In the following example, the .csv spreadsheet for import would look like this, where "Nickname", "Creation Year" and "Century" are repeating fields:
To import repeating fields that are not part of a field group or authority via a .csv spreadsheet in the Uploader make sure each repeating field has the $ sign and a successive number following it. In the following example, the .csv spreadsheet for import would look like this, where "Subject" and "Style" are repeating fields:
If you'd like to create an even more hierarchical data structure with Field Groups within Field Groups contact our support team for assistance,firstname.lastname@example.org.
At the top of the screen is a tab for Authorities. You can use that tab to select which Authority you want to upload to, using a .csv file. The easiest way to prepare a .csv (comma separated value) file is to download the pre-made one that has ALL the authority fields setup properly but no authority values. This file is located in the lower left "Download blank authority schema .csv file". You can then begin to fill in the rows with your authority information.
To upload your authority .csv file, select or create a batch then select the file you're going to upload. When you have selected the authority .csv file, click "Start Upload".
On the Uploader page once you have chosen a collection to add your book to you will see a "Books" tab at the top.
Using the Book Upload feature.
Initially in the Settings menu you can choose to have the media items and records you upload be available in the viewer. By default both the media items and records will be checked for display. If you did not choose to have the items viewable when you uploaded them you can always make items viewable/not-viewable using "edit" in the Library.
If you enabled Image Analysis in the Collection Manager, you will see options for Label detection, Text detection and Landmark detection in the Uploader Settings. Check the boxes to make the information detected within images display as custom data fields to be used for search and display in the LUNA Viewer.
All of the batches you have in a collection will be listed on the left side of the window. At the top of that list is the heading "Batches". There is a plus sign right next to "Batches" that you can use to create a new batch. Creating new batches is useful because if you later find you need to remove everything from a specific batch you made it can easily be done be deleting the batch.
Once you have selected a batch you will see the name of the batch appear at the top of the window. If you place your mouse on the name of the batch at the top of the screen you will see a trash can icon and edit icon appear next to the name. You can use the edit icon to change the name of the batch.
Once you have selected a batch you will see the name of the batch appear at the top of the window. If you place your mouse on the name of the batch at the top of the screen you will see a trash can icon and edit icon appear next to the name. You can use the trash can icon to delete the batch.
Note: when deleting batches in Media Items & Books- this will ask if you want to delete records only, media items only or both.
This will delete all the selected contents from the system and is not reversible.
The stats show you what is happening with the processing of the records and media items you have uploaded.
Some spreadsheet programs save CSV files with an invisible BOM (BYTE ORDER MARK) at the beginning of the UTF-8 text file.
Here is a link to: What is a BOM.
Loading a CSV file with a BOM will fail in LUNA's Uploader. You will need to remove the BOM character before loading the CSV file.
Removing a BOM on a Windows machine, you will need a program like Notepad++.
Here is an example in Notepad++
On a Mac you can use Text Wrangler or BBEdit
At the Bottom of the editor you will see the words "with BOM"
To remove it, just choose (UTF-8)