Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Add instructions for "Self XSL Transform" on a template association.

...

At the top of the screen, you can see that a list of all existing form associations are listed.

Content Model:

Under "Content Model" begin typing the PID of the content model you wish to associate a form with, and the name will auto-complete:

Metadata Datastream ID:

Under “Metadata Datastream ID” put in the DSID of the Datastream where your content model stores its rich metadata (not the DC Datastream). You must use the existing DSID prescribed in your content model (e.g., MODS, MARCXML, etc.), or this metadata will not appear in your collection objects. If you do not know what the correct DSID is for rich metadata in your content model, please review the documentation for the relevant content model. When

Title Field:

After you have entered the DSID for the Datastream, click "selectDo not set the label" in the “Title Field.”

When you do this, you will notice that there is a change in the “Title Field” drop-down menu. Islandora populates this drop-down field with the elements in your form, so that you can choose which element will serve as the source for the object’s label. Most of the time, you will likely want the object's label to come from the “Title” element. For something like a Newspaper Issue, you might want the title of the issue to come from the "date" element instead.  This label can be manually edited after ingest if ever necessary.

...

The next three options require a little bit more explanation: 

XSL Transform:

The "XSL Transform" file you choose is used by lslandora to crosswalk the schema of your rich metadata XML to Islandora’s default DC stream. In this case, where you are cloning a form, you will want to select the default xsl for your content model. This information is provided in the Solution Pack section of your document. (For more information about Islandora’s use of .xslts, please review the “Islandora and Metadata” section of the guide. XSLT are called from a folder within islandora_content_model_forms (in the XML Forms modules).

Self XSL Transform:

This is a transformation that runs on the XML you've entered in your form and cleans it before you save the form.  You can use this to remove empty fields or enforce validation of a local profile.

Upload Template Document:

The “Template Document” is a feature that allows you to submit a form with fields already completed. Usually, this will be a form that you have created by hand in an XML editor. It is not obligatory. 

Saving the new form assocation:

Click “Add Association.” Now, whenever you create an object in a collection that is associated with the content model you have used here, you will see your new form as an option to select in the drop down menu.

...