Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

You may also create Dublin Core metadata (or any other XML-based metadata) in an external XML editor and using the Import... button to replace the Datastream with this data. When you press Save Changes..., Fedora will check that the Datastream is well-formed XML.

You will notice that there are optional fields on the Datastreams pane for Format URI (to refine the media type meaning with a URI that more precisely identifies the media type) and Alternate Ids to capture any other existing identifiers you would like to associate with a Datastream. We will not be using these in this tutorial.

It is now time to add the ePrints document formats as new Datastreams. You can find content for creating the Datastreams for this example in:

  • FEDORA_HOME/userdocs/tutorials/2/example1/artex.html
  • FEDORA_HOME/userdocs/tutorials/2/example1/artex.pdf
  • FEDORA_HOME/userdocs/tutorials/2/example1/artex.tex

To do this, select the New... tab on the left side of the Datastreams window. We'll start with the text/html format. To insert data into the Datastream, you use the Import... button. This presents a dialog that will allow you to import from your local file system or from a URL.

Your completed HTML Datastream should look like the dialog as shown in Figure 6 (after you have imported the content).

...

A few notes on the contents of this dialog:

  1. The ID of the Datastream should be a single token. By convention, it describes the purpose of the Datastream.
  2. The Label can be a longer, more descriptive string.
  3. Note that the Control Group is Managed Content. As shown in the descriptive text this Datastream type is appropriate for any type of data (MIME type), in contrast to Internal XML Metadata. Once you select this radio button, you can select from the variety of MIME Types of the managed content – in this case text/html.

You can now select the Save Datastream button and repeat the same process to add the PDF and TeX Datastreams. For the PDF, you can select MIME Type: application/pdf and import the file ex1.pdf. For TeX, you can select MIME Type: text/plain and import the file ex1.tex. In each case you should enter appropriate IDs and Labels.

You're done! Your Datastreams window should now look something like that shown in Figure 7, showing all the Datastreams you have entered in the left-side tabs in the window.

...

You will notice as you click through each Datastream that there is a Fedora URL, giving the unique URL to access each Datastream from the Fedora repository. Try going to a browser and entering one of these URLs – the browser will download the Datastream and display it. These URLs can be used by web applications and REST-based web services that access Datastreams from Fedora Digital Objects. Note that if you are building SOAP-based web services, there are also SOAP methods (getDataStream and getDatastreamDissemination) that provide Datastream access. You can also try entering the root URL for the entire FDO, which is simply the common prefix of all the Datastream URLs – e.g., http://localhost:8080/fedora/get/demo:100. This accesses the header page for the FDO, which allows you to access its Datastreams (available through the item index hyperlink) and disseminations (available through the dissemination index hyperlink).

...