Page History
...
Several actors and workflows were developed to test Fedora's REST API from within Kepler. In particular, they test the basic functionality of the JyFedoREST and FCRepoKepler packages. The source for the actors and workflows in this project are attached to this page and can be downloaded from https://fedora-commons.svn.sourceforge.net/svnroot/fedora-commons/incubator/kepler/trunk/jython/workflows/fcrepo.
Kepler Workflows
REST API Test1
A simple workflow to retrieve an XML string from a Fedora Repository containing the 'Smiley' demo data set.
...
Screenshot :
...
...
Source file :
...
REST API Test2
A simple workflow to retrieve an image from a Fedora Repository containing the 'Smiley' demo data set.
...
Screenshot :
...
...
Source file :
...
REST API Test3
A workflow to retrieve a list of all objects in a Fedora Repository.
...
Screenshots :
...
...
Source file :
...
REST API Test4
A variation of REST-API-Test4.xml to be customized to retrieve a datastream dissemination from a local repository.
...
Screenshots :
...
...
Source file :
...
REST API Test5
A workflow that uses the fcrepo.http.restapi client code to retrieve a datastream dissemenation.
This is a four step workflow:
- Display a form dialog for entering parameters to be used to retrieve a datastream dissemination.
- Use fcrepo.http.restapi to get a datastream dissemnination.
- Serialize the dissemination into a displayable format.
- Display results.
...
Screenshots :
...
...
Source file :
...
| Anchor | ||||
|---|---|---|---|---|
|
A workflow that uses the fcrepo.http.restapi client code to create a new object with a single datastream.
This is a three step workflow:
- Display a form dialog for entering parameters that can be used to create a new object with a single datastream.
- Use fcrepo.http.restapi to create the new object. Display results.
- Use fcrepo.http.restapi to add a datastream. Display results.
...
Screenshots :
...
...
Source file :
...
Update Datastream
A workflow that uses the fcrepo.http.restapi client code to update a workflow in an existing object.
...
Screenshots :
...
...
Source file :
...
Kepler Actors
The PythonActor was used extensively in this project. It is based on the Jython interpreter which provides standard Python functionality within a Java application. Because Jython is implemented in Java, it also provides access to any Java class or class library available to the JVM. In this way, it provides a rapid prototyping tool that supports coding in both Java and Python.
...
Required Packages :
- JyFedoREST
...
Source file :
...
Input port:
- injestingest_info : ObjectToken containing a Jython dictionary containing data from a form usbmitted via "FCRepo Datastream Dialog". Alternately, any Jython dictionary with the following keys:
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier for object to be queried.
- dsid = identifier of datastream to be queried.
- dsLabel = label for datastream to be created.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
- controlGroup = datastream control group, optional, defaults to 'M'.
- dsState = datastream state, optional, defaults to 'A'.
- versionable = whether datastream is versionable, optional, defaults to True.
- formatURI = URI of datastream format description, optional, no default.
- checksumType = datastream checksum type, optional, no default.
- altIDs = list of alternate IDs for datastream, optional, no default.
...
This actor displays a SWING dialog that allows the user to enter parameters required to connect to a Fedora Repository and access a particular datastream.
...
Screenshot :
...
Required Packages :
- FCRepoKepler - Uses SimpleHTMLFormDialog to display and manage the form.
...
Source file :
...
FCRepoDatastreamDialogActor.py
...
The "FCRepo Datastream Dialog" PythonActor is used in the following workflows:
- REST API Test5
FCRepo Datastream Update Dialog Actor
This actor displays a SWING dialog that allows the user to enter parameters required to connect to a Fedora Repository and update a particular datastream.
...
Screenshot :
...
Required Packages :
- FCRepoKepler - Uses SimpleHTMLFormDialog to display and manage the form.
...
Source file :
...
DatastreamUpdateDialogActor.py
...
Input port :
...
- None
...
Output port:
...
- out : ObjectToken containing a Jython dictionary with name/value pairs for all input fields in the form. This object contains the following keys:
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier for object to be updated.
- dsid = identifier of datastream to be updated.
- dsLabel = label for datastream to be updated.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
The "FCRepo Update Datastream Dialog" PythonActor is used in the following workflows:
- Update Datastream
FCRepo Dialog Actor
This actor displays a SWING dialog that allows the user to enter parameters required to connect to a Fedora Repository.
...
Screenshot :
...
...
Required Packages :
...
- FCRepoKepler - Uses SimpleHTMLFormDialog to display and manage the form.
...
Source file :
...
Input ports :
- None
...
Output port :
...
- out : ObjectToken containing a Jython dictionary with name/value pairs for all input fields in the form. This object contains the following keys:
- passalong = name of button pressed.
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
...
This actor connects to a Fedora Respoitory and retrieves a datastream dissemination.
...
Required Packages :
...
- JyFedoREST
...
Source file :
...
...
Input port:
...
- dialog_info : ObjectToken containing a Jython dictionary containing data from a form usbmitted via "FCRepo Datastream Dialog". Alternately, any Jython dictionary with the following keys:
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier for object to be queried.
- dsid = identifier of datastream to be queried.
...
Output port:
...
- out : ObjectToken containing a Jython object with the data returned by the request for a dissemination.
...
This actor establishes a connection to a Fedora Repository and sends a request using the Fedora REST API.
...
Required Packages :
...
- JyFedoREST
...
Source file :
...
Input ports :
...
This actor displays a SWING dialog that allows the user to enter parameters required to connect to a Fedora Repository and create a new object with a single datastream.
...
Screenshot :
...
...
Required Packages :
...
- FCRepoKepler - Uses SimpleHTMLFormDialog to display and manage the form.
...
Source file :
...
Input ports :
- None
...
Output port :
...
- out : ObjectToken containing a Jython dictionary with name/value pairs for all input fields in the form. This object contains the following keys:
- passalong = name of button pressed.
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier of object to create.
- objLabel = label for object to create.
- dsid = identifier of datastream to be queriedcreated.
- dsLabel = label for datastream to be created.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
...
This actor connects to a Fedora Respoitory and creates a new object.
...
Required Packages :
...
- JyFedoREST
...
Source file :
...
...
Input port:
...
- injest_info : ObjectToken containing a Jython dictionary containing data from a form usbmitted via "FCRepo Ingest Dialog". Alternately, any Jython dictionary with the following keys:
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier for object to be queried.
- objLabel = label for object to be created.
- dsid = identifier of datastream to be queried.
- dsLabel = label for datastream to be created.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
...
- result : StringToken containing results of the request to add a dissemination.
- datastream : ObjectToken containing a Jython dictionary with name/value pairs from input form. This object contains the following keys:
- passalong = name of button pressed.
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier of object to create.
- dsid = identifier of datastream to be queried.
- dsLabel = label for datastream to be created.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
The "FCRepo Add Datastream Object Create" PythonActor is used in the following workflows:
- Ingest With Datastream
FCRepo Update Datastream Actor
This actor connects to a Fedora Respoitory and updates a datastream in an existing object.
...
Required Packages :
...
- JyFedoREST
...
Source file :
...
...
Input port:
...
- fcrepo_info : ObjectToken containing a Jython dictionary containing data from a form submitted via "FCRepo Datastream Dialog". Alternately, a Jython dictionary with the following keys:
- fcrepoURL = base URL of the Fedora Repository.
- username = name of a Fedora Repository user.
- password = password corresponding to the username.
- pid = identifier for object to be queried.
- dsid = identifier of datastream to be queried.
- dsLabel = label for datastream to be created.
- dsLocation = URL of file containing datastream content.
- mimeType = mime type of datastream content.
- controlGroup = datastream control group, optional, defaults to 'M'.
- dsState = datastream state, optional, defaults to 'A'.
- versionable = whether datastream is versionable, optional, defaults to True.
- formatURI = URI of datastream format description, optional, no default.
- checksumType = datastream checksum type, optional, no default.
- altIDs = list of alternate IDs for datastream, optional, no default.
...
Other inputs :
...
The "Datastream Update" script also needs to get name of the action to be performed. This can be done in one of two ways:
A string parameter on the PythonActor named 'action'.
OR
A port on the PythonActor named 'action' containing a StringToken.
...
Output port:
...
- result : StringToken containing results of the request to update a datastream.
The "FCRepo Update Datastream " PythonActor is used in the following workflows:
- Update Datastream
Format Serializer Actor
This actor is a helper that determines the type of object returned by a GET request and reformats the output so that other Kepler actors can handle it.
...
Source file :
...
...
Input port:
...
- in : ObjectToken containing the results of the method executed by a "FCRepo REST GET" actor.
...
- REST API Test1
- REST API Test2
- REST API Test3
- REST API Test4
- REST API Test5
Kepler Workflows
REST API Test1
A simple workflow to retrieve an XML string from a Fedora Repository containing the 'Smiley' demo data set.
...
Screenshot :
...
...
Source file :
...
REST API Test2
A simple workflow to retrieve an image from a Fedora Repository containing the 'Smiley' demo data set.
...
Screenshot :
...
...
Source file :
...
REST API Test3
A workflow to retrieve a list of all objects in a Fedora Repository.
...
Screenshot :
...
...
Source file :
...
REST API Test4
A variation of REST-API-Test4.xml to be customized to retrieve a datastream dissemination from a local repository.
...
Screenshot :
...
...
Source file :
...
REST API Test5
A workflow that uses the fcrepo.http.restapi client code to retrieve a datastream dissemenation.
This is a four step workflow:
- Display a form dialog for entering parameters to be used to retrieve a datastream dissemination. Uses SimpleHTMLDialog
from fcrepo.kepler to display and manage the form. - Use fcrepo.http.restapi to get a datastream dissemnination.
- Serialize the dissemination into a displayable format.
- Display results.
...
Screenshot :
...
...
Source file :
...
...
A workflow that uses the fcrepo.http.restapi client code to create a new object with a single datastream.
This is a three step workflow:
- Display a form dialog for entering parameters that can be used to create a new object with a single datastream. Uses SimpleHTMLDialog from fcrepo.kepler to display and manage the form.
- Use fcrepo.http.restapi to create the new object. Display results.
- Use fcrepo.http.restapi to add a datastream. Display results.
...
Workflow Screenshot :
...
...
Ingest Dialog Screenshot :
...
...
Source file :
...
...
Overview
Content Tools