Repository Operations
This section contains a list of basic operations that are available for items in the Repository.
Context Menu
Most operations can be performed via a context menu. This menu is accessed by right-clicking on an item in the Folder Listing (or one of the currently selected items when using Multi-Select). The same menu can be accessed by clicking the button next to the item's name in the right-hand panel. You may need to click on the
button if the panel is collapsed.
Move
Move opens the Move Item dialog, allowing you to move the item (or items) to any accessible folder.
Bring up the context menu for the item (or items)
Click Move
In the popup dialog, select the destination folder from the available list
Click on the Move to Folder button
Copy
Copy opens the Copy Item dialog, allowing you to make a copy of the item (or items) in another folder.
Bring up the context menu for the item (or items)
Click Copy
In the popup dialog, select the destination folder from the available list
Click on the Copy to Folder button
Copy URL (single item only)
Copy URL copies the URL of the item to the clipboard.
Open Folder (folders only)
Open Folder navigates into the selected folder.
View Image(s) (images only)
View Images opens the selected item (or items) in the Viewer.
Properties
Properties displays the Properties Dialog for the selected item (or items).
Retry Type Detection (attachments only)
Retry Type Detection attempts to force the system to detect this attachment as an image again. This can be useful if an image uploaded completely, but for whatever reason is not being recognized by PathcoreScholar as an image. If this still does not work you may need to contact Pathcore Support.
Rename (single item only)
Rename allows you to change the name of the item. While all entries in the Repository have names, names do not have to be unique because each entry has a unique ID, see Names and IDs.
Bring up the context menu for the item
Click Rename
In the popup dialog, type a new name for the item
Click on the Rename button or press the Enter key to save. To discard your changes, click on the Cancel button or press the Escape key
Share (single item only)
Share opens the Share Links dialog, which allows you to add and manage share links for the item.
See Managing Share Links for more details.
Bring up the context menu for the item
Click Share
The popup dialog allows you to add and manage share links
Mark as Read / Mark as Unread
An item can be marked as "read" (name in plain text) or "unread" (name in bold) depending on whether or not you have previously viewed it.
See Read Status for more details.
Bring up the context menu for the item (or items)
Click Mark as Read to enable the read status, or
Click Mark as Unread to clear the read status
Favorite / Unfavorite
Favorite tags the item (or items) as Starred. Items tagged this way are quickly and easily accessible from the Starred Items List. Unfavorite removes this tag.
See Favorite Status for more details.
Bring up the context menu for the item (or items)
Click Favorite to add the Starred tag, or
Click Unfavorite to remove the tag
Download
Download opens the Download dialog, allowing you to save items and metadata locally.
See Downloading for more details.
Bring up the context menu for the item (or items)
Click Download
In the popup dialog, select what you would like to download (files and/or metadata)
Click on the Download button
Delete
Delete allows you to remove the item and all of its contents (in the case of a folder) from the Repository.
Bring up the context menu for the item (or items)
Click Delete
Click on the Yes button to confirm if you are sure you wish to remove the item. To cancel the delete action, click on the Cancel button or press the Escape key
Deleting Images Linked Into a Class
Attempting to delete an image from the Repository that is referenced in a class will fail with an informative message about the cause. If multiple items are selected and deleted, only the images that are unused in any classes will be removed; a warning message will be displayed should any of the items be images that are referenced in a class. This helps prevent Administrators and Educators from accidentally removing resources that are currently being used in training materials.
This applies only to the following images:
- Images used in Image Viewer blocks
- Featured images on Multiple Choice questions
- Images used for Pin-Drop questions
- Pop-Up button images
- Hidden Data button images
Multi-Select
One or more files can be selected from the folder listing page in order to perform bulk operations such as download, copy or move.
To select more than one file
Navigate to any folder in the Repository (click on the
Repository button from the Navigation Menu then navigate to a folder)
Click on an item from the file listing
While holding the Ctrl key (on Windows) or ⌘ / Command key (on macOS) select another file
Repeat step 3 as necessary
To select more than one file in a continuous range
Navigate to any folder in the Repository (click on the
Repository button from the Navigation Menu then navigate to a folder)
Click on the first item in the range from the file listing
While holding the Shift key, select the last file in the range
Read Status
The names of items (files and folders) in the Repository are in bold to indicate an item is “unread”. Once an item has been “read”, plain text font is used for the name of the item. New items are always unread and are automatically marked as read once they have been opened, viewed or downloaded by a user. The following actions will cause the status of an item to be marked as “read”:
- Clicking on an image file causing the Viewer to launch
- Clicking on any other item causing it open in the browser or be downloaded
The read status is unique for each user and can be toggled at any time, making it useful for tracking items that require further attention.
Favorite Status
Each Repository item has a favorite status, which can be toggled by clicking on the button adjacent to the item’s name. A solid star indicates an item has been marked as a favorite while a hollow star (default) status indicates the item is not a favorite.
The favorite status is unique for each user and can be toggled at any time, making it useful for tracking items that require further attention.
To view a list of all favorited items
- Click on the
Starred button in the TAGS section of the Navigation Menu
To toggle favorite status
Navigate to any folder in the Repository (click on the
Repository button from the Navigation Menu then navigate to a folder)
Toggle the
button next to the item to indicate the status
Properties Dialog
The Properties dialog shows details about one or more Repository items.
The following details are displayed:
- The name of a single item, or the total number of items
- A
icon is displayed to the right of this field if at least one item has a share link. Hovering over the icon shows how many share links are associated with the item(s)
- A
- Size: the total estimated size to download the selected items and their children (e.g., image overlays, or folder contents)
- Hovering over the
icon shows additional details such as how much of your Repository storage these items are using, or how much space can be recovered by deleting them
- Hovering over the
- Location: The path in the Repository to the item (or items, if they are all in the same location)
- Contents: The number and types of the items
- Created: The creation date and time of an item (or items, if they are all within the same minute)
- Modified: The last modified date and time of an item (or items, if they are all within the same minute)
Why are there three different sizes?
In some cases, the Properties dialog will show differing values for the total size, the size on disk, and the amount that would be recovered by deleting the selected item(s). This is because when entries in the Repository are copied, the underlying files are not duplicated (i.e., copies are linked to the same underlying file) and thus do not consume additional storage.
The size listed in the dialog represents the total size of the items (e.g., how much storage you would need on your local computer to download these items)
The space consumed on disk takes into account any copies (i.e., it only counts duplicates once)
The storage space recovered by deleting the selection also takes into account other copies of the items elsewhere in the Repository (e.g., deleting one copy of an item which still exists in another folder does not delete the underlying file)
A user uploads an image of size 100 MiB to the Repository. They then make two copies of the image. The user selects two of these images and opens the Properties dialog.
The Size reported will be 200 MiB. Hovering over the information icon shows a tooltip containing "This selection consumes 100 MiB on disk. Deleting it would recover 0 B once the trash can is cleared."
200 MiB - the sum of the image files' sizes
100 MiB - because the two items are copies, there is only one underlying file
0 B - because there is still an active copy of the image in the Repository, deleting these items does not recover any storage space
Downloading
In general, one or more files or folders can be downloaded from the Repository. Depending on the type and number of items downloaded, or the options selected in the download dialog, an archive file may need to be generated before the download can begin. The following will cause this to occur:
- Selecting multiple items, or a folder of items, for download
- Including metadata options in the download dialog
- Downloading a multi-file image format, such as MRXS
When this is the case, the download dialog will include a dropdown menu to select an archive file format.
Certain item types cannot be combined into a single download. For example, a Figure cannot be downloaded with any other item (including another Figure) because it has a unique export workflow.
Download dialog options
The following options are available when downloading:
Files: Toggle to include the selected files and folders
Metadata: Toggle to include metadata about the selected files and folders. You can further customize the additional metadata to include:
- Annotations: Toggle to include your private annotations as well as shared annotations by others
- Snapshot Coordinates: Toggle to include snapshot coordinates and properties
- Fields: Toggle to include system metadata fields
- Tags: Toggle to include tags you have assigned to the items
- Overlays: Toggle to include overlay images added to images in the selected items
Download as JSON / Download as CSV: choose the file format of the selected metadata. These options can only be selected if metadata is included in the download
.tar: This dropdown menu lets you select the archive format when more than one item and/or metadata are included
The .tar.gz and .zip archive formats are not available by default in this release. If you require these formats, you may need to contact Pathcore Support..tar archives are natively supported by Microsoft Windows 11, macOS, and all major Linux distributions. For users running Windows 10 or prior, we recommend a third-party archive manager such as [7-Zip](https://www.7-zip.org/).
When the selection contains a single item, such as an image file, attachment, or report, the file itself will be downloaded. In other cases, such as for a single saved Figure item, the download will trigger an export and preview window. When there are multiple items or a folder selected, a downloadable archive will be generated in the chosen format with the option to include metadata.