QA Testing

Be sure to use the table of contents shown here to help navigate the instructions

_images/QA_table_of_contents.png

Click here to go to the testing site.

Demo Videos

Resources

We use the term resources for all content such as files, folders, projects, repos, items, etc. It’s a catch all term since different websites name their content differently.

BagIt Tool

BagIt is a hierarchical filesystem format for storing and transferring digital content. PresQT expects all files Uploaded to be zipped files in BagIt format. All downloads from PresQT come in BagIt format as well. PresQT has a tool that will take a zipped file and return it to you in BagIt format.

_images/bagit_1.png

Getting Authorization Tokens From Partner Sites

An Authorization Token is a unique identifier for a user requesting access to a service.

You can click here for instructions on how to get authorization tokens for each target.

Test Files

Here are some pre-made ZIP files that are in BagIt format that can be downloaded for use with PresQT.

presqt_Images.zip

presqt_MediaFiles.zip

presqt_TextFiles.zip

presqt_MixedFileTypes.zip

Known Bugs And Issues

  • None as of this writing

Testing Instructions

Login To Targets From PresQT Demo UI

  1. Click on any Target icon under ‘Available Connections’ to pop open a login window.

_images/login_step_1.png

  1. Copy your Authorization Token for the target and press Connect

_images/login_step_2.png

  1. Resources associated with this token will appear on the left side.

  2. You can log out of the target and use a different token by pressing the button next to the resources header.

_images/login_step_3.png

5. To log into a different target simply repeat the process with a different target icon. Once logged in you can switch between targets without having to provide your key.

Resource Details And Actions

1. Once you click on a resource you will get its details and buttons for each action available for this resource. If the button is disabled then that action isn’t available for that resource.

_images/resource_detail_step_1.png

Resource Download

Click here to go to the testing site.

Demo Videos

1. To download a resource, first select the resource in the resource collection and then click the Download action button in the details section.

_images/download_step_1.png

2. A modal will pop open providing you with transaction details. Click on the Download button to start the download.

_images/download_step_2.png

3. Once the download is complete, the modal will provide you with details about how the download process went.

_images/download_step_3.png

4. All downloads come in BagIt format. After the download is complete, unzip the file, and you will see BagIt specification files. The data you requested to download will reside in the data folder.

_images/download_step_4.png

Resource Upload

Click here to go to the testing site.

Demo Videos

Upload As A New Project

1. To upload to the target as a new project click the Create New Project button above the resource collection.

_images/upload_new_step_1.png

2. A modal will pop open with an upload stepper. First select the file you’d like to upload. The file must be a zip file who’s contents are in valid BagIt format.

_images/upload_new_step_2.png

  1. Next, the modal will display transaction details. Click Upload File to begin the upload process.

_images/upload_new_step_3.png

4. Once the upload is completed, the modal will provide you with details about how the upload process went.

_images/upload_new_step_4.png

  1. You should also see the new uploaded resources appear in the resource collection.

Upload To An Existing Resource

1. To upload a resource, first select the resource in the resource collection and then click the Upload action button in the details section.

_images/upload_existing_step_1.png

2. A modal will pop open with an upload stepper. First select the file you’d like to upload. The file must be a zip file who’s contents are in valid BagIt format.

_images/upload_existing_step_2.png

3. Select how you want PresQT to handle any duplicate files it finds existing in the resource already. Ignore will simply ignore the duplicate. Update will update the existing file with the new uploaded file’s contents if they differ.

_images/upload_existing_step_3.png

  1. Next, the modal will display transaction details. Click Upload File to begin the upload process.

_images/upload_existing_step_4.png

5. Once the upload is completed, the modal will provide you with details about how the upload process went.

_images/upload_existing_step_5.png

  1. You should also see the new uploaded resources appear in the resource collection.

Resource Transfer

Click here to go to the testing site.

Demo Videos

1. To transfer a resource to another target, first select the resource in the resource collection and then click the Transfer button in the details section.

_images/transfer_step_1.png

  1. A modal will pop open with a transfer stepper. First, select the target you want to transfer to and press the Next button.

_images/transfer_step_2.png

  1. Input your token for the target you selected and press the Next button.

_images/transfer_step_3.png

4. Select the resource you want to transfer to. Don’t select any resource if you want to create a new project. Press Next once you have made your selection.

_images/transfer_step_4.png

5. Select how you want PresQT to handle any duplicate files it finds existing in the resource already. Ignore will simply ignore the duplicate. Update will update the existing file with the new transferred file’s contents if they differ. Press the Next button once you’ve made your selection. If you are making a new project then just press Next.

_images/transfer_step_5.png

  1. Next, the modal will display transaction details. Click Transfer File to begin the transfer process.

_images/transfer_step_6.png

7. Once the transfer is completed, the modal will provide you with details about how the transfer process went.

_images/transfer_step_7.png

  1. You should also see the new transferred resources appear in the modal’s resource collection on the right.

Verifying Fixity

Fixity means the assurance that a digital file has remained unchanged. We determine file fixity at every step along PresQT actions. More details about how PresQT handles fixity can be found Here.

Download

All downloads come with a file with detailed fixity information named fixity_info.json. This file has an entry for every file involved in the download including each file’s checksum hash at the Source Target and the hash calculated on the PresQT servers before sent to the browser for download. To verify fixity remains, the user must calculate the files’ hashes on their local machine and compare it to the hashes provided.

_images/fixity_1.png

Upload

Fixity during upload can be determined by inspecting the PRESQT_FTS_METADATA.json file included with every upload. The attribute failedFixityInfo in this file will contain the details if the file being uploaded has failed fixity.

_images/fixity_2.png

Transfer

Fixity during Transfer can be determined the same as Upload by inspecting the PRESQT_FTS_METADATA.json file in the destination target.

Verifying Keyword Enhancement

See Here for Keyword Enhancement details.

Keyword Enhancement As A Service

Keyword Enhancement as a service will write a new entry to the PRESQT_FTS_METADATA.json file in the target. The action entry for keyword enhancement will say exactly which keywords were added during this enhancement.

_images/kw_1.png

Keyword Enhancement During Transfer

Keyword Enhancement during a transfer will work similarly to Keyword Enhancement As A Service. The difference is, for the destination target, the details of keyword enhancement will be located in the transfer action entry instead of there being a new action entry for keyword enhancement.

Services

Click here to go to the testing site.

Demo Videos

Send a Proposal to EaaSI

1. To send a resource to EaaSI, first select the resource in the resource collection and then click the Services action button in the details section. A drop down menu will appear from where you can select EaaSI.

_images/eaasi1.png

2. A modal will pop open with an EaaSI stepper. First read the proposal and ensure the information is correct. Once you have verified that this is what you’d like to do, press the Send button.

_images/eaasi2.png

3. A spinner will keep you informed of where in the process the request is, whether that be on the PresQT server or on EaaSI’s.

_images/eaasi3.png

4. Once the upload is completed, the modal will provide you with details about how the process went. There will also be a link for you to download the EaaSI created image.

_images/eaasi4.png

5. You can now open the image and run it however you please. Note: At this point in time, EaaSI’s server is only returning cd-rom images for us during testing. The environments will be changed to accurately take into account the files contained within the project as development continues.

_images/eaasi5.png

FAIRshare Evaluator Service

1. To initiate a FAIRshare evaluation, first select the resource in the resource collection and then click the Services action button in the details section. A drop down menu will appear from where you can select FAIRshare.

_images/fairshare1.png

2. A modal will pop open with a FAIRshare Evaluator Service stepper. First read the information and ensure the information is correct. Once you have verified that this is what you’d like to do, select the tests you would like to run.

_images/fairshare2.png

3. Once you have selected the tests you’d like to run, you can choose to opt in for email notifications. When you are ready to run the tests, press the Evaluate button.

_images/fairshare3.png

  1. A spinner will let you know that FAIRshare is processing the request. This may take awhile.

_images/fairshare4.png

  1. Once the process is complete, the results will be displayed in a drop down format to be reviewed.

_images/fairshare5.png