These methods together form the SOAP interface. They drive the Handle System local resolver database.
pidType : Used as a request and response parameter. It contains pid and resolve attributes.
pid : the persistent identifier, including the naming authority.
Example: 12345/abcdefg
resolveUrl : the resolve URL that directs a web client to a webresource.
locAtt : see locAttType
localIdentifier : a locality or local system identifier.
See GetPidByAttributeRequestType for its usage.
locAttType : a package of one or more resolve urls.
locationType : a resolve Url. Just like the pidType.resolveUrl it points to a web
resource.
However the locationType is activated by extending parameters such as a -view to the handle request.
Example: http://hdl.handle.net/12345/abcdefg?view=master
For more information about the locationType, visit http://www.handle.net/ and read the section on the
10622/loc type.
UpsertPidRequestType (method UpsertPidRequest): inserts a Pid and binds it to the supplied resolve
attributes as defined in the pidType IF it does not exist. If the pid or lid
already persist in the database, the method will update the pid data.
na : the naming authority
CreatePidRequestType (method CreatePidRequest): inserts a Pid and binds it to the supplied resolve
attributes as defined in the pidType.
na : the naming authority
UpdatePidRequestType (method UpdatePidRequest):
re-binds the pidType.pid to the supplied pidType.resolveUrl, pidType.locAtt and pidType.localIdentifier.
If the pidType.resolveUrl or pidType.locAtt are not supplied they will be un-bound\removed from the pid
(if there). A pidType.localIdentifier cannot be removed, only changed or added.
GetPidRequestType (method GetPidRequest):
retrieves all known bound attributes that belong to this pid.
GetPidByAttributeRequestType (method GetPidByAttribute): a reverse lookup of a Pid using a bound
pidType.resolveUrl or pidType.localIdentifier as the attribute value. It is possible there are more than
one pid to include the lookup result.
na : the naming authority
GetQuickPidRequestType ( method: GetQuickPidRequest ): use for creation, binding and
reverse lookup of a Pid. Specifically:
1. Pid creation: when the localIdentifier is not bound to a known pid, the webservice creates a pid and
then binds it to the resolveUrl and localIdentifier.
2. Pid lookup: when the localIdentifier is bound to an existing Pid, the method will echo back all data
bound to the pid.
3. Pid update: when the localIdentifier is bound to an existing Pid and the supplied resolveUrl is
different to the bound resolveUrl, a rebind will be made.
na : the naming authority
DeletePidRequestType (method DeletePidRequest): deletes a Pid.
deleted :true ( gone ) or not so true ( unsuccessfull; or no such pid ).
na : the naming authority used for testing. This method will only accept naming authority
prefixes used for testing. This method will remove all PIDs bound to the NA.
count : the number of PIDs deleted.