Skip to content

Webform Find and Replace

Webform Find and Replace enables you to search against values found within defined Webform elements to apply metadata replacements with targeted care. Below are a guide and some examples of use cases for this Action.

Step 1: Select the ADOs to be Modified

Depending on your specific use case, you can utilize the Fulltext search, Facets, or a combination of both to aid in the identification and selection of the ADOs you wish to perform the Webform Find and Replace action on.

To use the Fulltext search, type any defining descriptive metadata values (i.e. Title, Date) directly in the search box and click 'Search'. To narrow down potentially lengthy results, you can utilize the facets by selecting a value beneath an appropriate descriptive metadata source.

Search and Faceting

To generate the results (ADOs) of a specific AMI set, you can select the set under the facet 'Ingest Method Service URL'

Faceting via AMI set

Step 2: Digital Object/Collection and Webform Find and Replace Action Selection

To Select the appropriate ADO(s) to undergo the Webform Find and Replace operation, click the toggle next to the individual ADO Title. If you wish to select all of your search results, click the toggle next to 'select/deselect all results'. Once selected, the toggle next to the ADO(s) will be highlighted.

To see a full list of selected ADO(s) use the dropdown menu labled 'Selected'. It is also recommended that you utilize the 'Raw metadata (JSON)' dropdown to check that that the search and replace values for your selected ADO(s) is accurate.

ADO Selection

Next, select 'Webform find-and-replace Metadata for Archipelago Digital Objects content item' from the Action dropdown menu and click 'apply to selected items'.

Selection and Action

Step 3: Webform Find and Replace Action Configuration

Here you will need to select the configurations to be applied to your chosen ADOs.

From the dropdown:

  • 1.) Select which Webform you want to use
  • 2.) Select which Form element you want to use
  • 3.) Select which value to search for in the [chosen form element] JSON key
  • 4.) Select which value to replace with in the [chosen form element] JSON key

The screenshot below shows an example configuration for the type JSON key (media type) where the type value Visual Artwork will be searched for and replaced with type value Photograph

Action Configuration

Simulation Option

Before selecting 'Apply', there is an option to run a Simulation on your chosen configurations. By selecting this option, you will be able to carry out a simulated patch and preview action results. To run a simulation, tick the box next to 'only simulate and debug affected JSON' and select 'Apply'.

On the next screen, you will see a list of your selected items with an option to 'execute action' or 'cancel'. Select, 'execute action'.

Once executed, you will receive a notification displaying the results of your simulated processing and whether or not the patch rendered a match for modification.

Example of Match Simulation Processing

Example of No Match Simulation No Match

Step 4: Execute Webform Find and Replace (Non-simulation)

To execute the Webform Find and Replace you will need to follow steps 2 and 3 once more except this time you will leave the simulate option unticked at the end of step 3. Now select, 'Apply'.

On the next screen, select 'execute action'.

Once the action is finished processing you will receive a notification displaying that your ADO revision persisted to the Filesystem and was successfully patched.

ADO Patch Notification

Step 5: Revisions

How to check your changes:

Navigate to the ADO you just performed the Webform Find and Replace on and select the 'Revisions' tab.

Revision Navigation

Language from form itself:

Revisions allow you to track differences between multiple versions of your content, and revert to older versions.

The current revision will always be at the top of the list.

Revision Report

Thank you for reading! Please contact us on our Archipelago Commons Google Group with any questions or feedback.

Return to the main Find and Replace documentation page or the Archipelago Documentation main page.

Last update: December 13, 2022
Created: December 12, 2022