ࡱ > B D
! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A C D E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~ R o o t E n t r y F s!< @ W o r k b o o k $* S u m m a r y I n f o r m a t i o n ( D o c u m e n t S u m m a r y I n f o r m a t i o n 8 g \ p
Dave Vieglais B a = = X@$J8 @ " 1 V e r d a n a 1 A r i a l 1 A r i a l 1 A r i a l 1 & C o u r i e r N e w 1 & C o u r i e r N e w 1 C a l i b r i 1 & C o u r i e r N e w 1 V e r d a n a 1 V e r d a n a 1 V e r d a n a 1 V e r d a n a 1 C a l i b r i 1 C a l i b r i 1 C a l i b r i 1 4 C a l i b r i 1 C a l i b r i 1 C a l i b r i 1 C a l i b r i 1 , > C a l i b r i 1 > C a l i b r i 1 > C a l i b r i 1 > C a l i b r i 1 4 C a l i b r i 1 < C a l i b r i 1 ? C a l i b r i 1 h > C a m b r i a 1 C a l i b r i 1
C a l i b r i "$"#,##0_);\("$"#,##0\) ! "$"#,##0_);[Red]\("$"#,##0\) " "$"#,##0.00_);\("$"#,##0.00\) ' " "$"#,##0.00_);[Red]\("$"#,##0.00\) 7 * 2 _("$"* #,##0_);_("$"* \(#,##0\);_("$"* "-"_);_(@_) . ) ) _(* #,##0_);_(* \(#,##0\);_(* "-"_);_(@_) ? , : _("$"* #,##0.00_);_("$"* \(#,##0.00\);_("$"* "-"??_);_(@_) 6 + 1 _(* #,##0.00_);_(* \(#,##0.00\);_(* "-"??_);_(@_) "$"#,##0;\-"$"#,##0 "$"#,##0;[Red]\-"$"#,##0 "$"#,##0.00;\-"$"#,##0.00 # "$"#,##0.00;[Red]\-"$"#,##0.00 5 0 _-"$"* #,##0_-;\-"$"* #,##0_-;_-"$"* "-"_-;_-@_- , ' _-* #,##0_-;\-* #,##0_-;_-* "-"_-;_-@_- = 8 _-"$"* #,##0.00_-;\-"$"* #,##0.00_-;_-"$"* "-"??_-;_-@_- 4 / _-* #,##0.00_-;\-* #,##0.00_-;_-* "-"??_-;_-@_- 0.0
ff + ) , *
P P ` a ( ) ( ) ( ( ( 8 ) 8
(
)
( ? ( 8 ? ( X H ) X h ( ( ( ? ) 8 ? ( 8 ) 8 h ? ( ( ( 8 ( ( ( 8 ) 8 1 1 , 1 1
1 1 , 1 , 8 | | m i}A }
_-;_-* " ef -@_-_) }A }
_-;_-* " ef -@_-_) }A }
_-;_-* " ef -@_-_) }A }
_-;_-* " ef -@_-_) }A }
_-;_-* " ef -@_-_) }A }
_-;_-* " ef -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " L -@_-_) }A }
_-;_-* " 23 -@_-_) }A }
_-;_-* " 23 -@_-_) }A }
_-;_-* " 23 -@_-_) }A }
_-;_-* " 23 -@_-_) }A }
_-;_-* " 23 -@_-_) }A } !
_-;_-* " 23 -@_-_) }A } "
_-;_-* " -@_-_) }A } #
_-;_-* " -@_-_) }A } $
_-;_-* " -@_-_) }A } %
_-;_-* " -@_-_) }A } &
_-;_-* " -@_-_) }A } '
_-;_-* " -@_-_) }A } (
_-;_-* " -@_-_) } } )
} _-;_-* " -@_-_)
} } *
_-;_-* " -@_-_) ??? ??? ???
??? }- } 0
_-;_-* " }A } 1
a _-;_-* " -@_-_) }A } 2
_-;_-* " -@_-_) }A } 3
_-;_-* " ? -@_-_) }A } 4
_-;_-* " 23 -@_-_) }- } 5
_-;_-* " } } 6
??v_-;_-* " ̙-@_-_)
}A } 7
} _-;_-* " -@_-_) }A } 8
e _-;_-* " -@_-_) }x } 9 _-;_-* " -@_
} } :
???_-;_-* " -@_ ??? ???
???
??? }- } <
_-;_-* " }U } =
_-;_-* " -@_ }- } >
_-;_-* "
20% - Accent1M
2 0 % - A c c e n t 1 ef %
20% - Accent2M "
2 0 % - A c c e n t 2 ef %
20% - Accent3M &
2 0 % - A c c e n t 3 ef %
20% - Accent4M *
2 0 % - A c c e n t 4 ef %
20% - Accent5M .
2 0 % - A c c e n t 5 ef %
20% - Accent6M 2
2 0 % - A c c e n t 6 ef %
40% - Accent1M
4 0 % - A c c e n t 1 L %
40% - Accent2M #
4 0 % - A c c e n t 2 L渷 %
40% - Accent3M '
4 0 % - A c c e n t 3 L %
40% - Accent4M +
4 0 % - A c c e n t 4 L %
40% - Accent5M /
4 0 % - A c c e n t 5 L %
40% - Accent6M 3
4 0 % - A c c e n t 6 Lմ %
60% - Accent1M
6 0 % - A c c e n t 1 23 %
60% - Accent2M $
6 0 % - A c c e n t 2 23ږ %
60% - Accent3M (
6 0 % - A c c e n t 3 23כ %
60% - Accent4M ,
6 0 % - A c c e n t 4 23 %
60% - Accent5M 0
6 0 % - A c c e n t 5 23 % !
60% - Accent6M 4
6 0 % - A c c e n t 6 23 % " Accent1A A c c e n t 1 O % # Accent2A ! A c c e n t 2 PM % $ Accent3A % A c c e n t 3 Y % % Accent4A ) A c c e n t 4 d % & Accent5A - A c c e n t 5 K % ' Accent6A 1 A c c e n t 6 F % ( Bad9 B a d % ) Calculation C a l c u l a t i o n } % *
Check Cell
C h e c k C e l l % ??? ??? ??? ??? + C o m m a ,( C o m m a [ 0 ] -& C u r r e n c y .. C u r r e n c y [ 0 ] " / Excel_BuiltIn_20% - Accent1 1 0 Explanatory TextG 5 E x p l a n a t o r y T e x t % 1 Good; G o o d a % 2 Heading 1G H e a d i n g 1 I}% O 3 Heading 2G H e a d i n g 2 I}% ? 4 Heading 3G H e a d i n g 3 I}% 23 5 Heading 49 H e a d i n g 4 I}%
6 Inputu I n p u t ̙ ??v% 7 Linked CellK L i n k e d C e l l } % 8 NeutralA N e u t r a l e % " N o r m a l 9 Noteb
N o t e : Outputw O u t p u t ???% ??? ??? ??? ??? ;$ P e r c e n t
< Title1 T i t l e I}%
= TotalM T o t a l % O O > Warning Text? W a r n i n g T e x t % X T a b l e S t y l e M e d i u m 9 P i v o t S t y l e M e d i u m 4 8 3f f f f ̙ ̙ 3f 3 f ff 3f 3f 3 33 3 3f 33 \ ` V Functions
Exceptions !
; B 9 Excel_BuiltIn__FilterDatabase_1; B ; ! Excel_BuiltIn__FilterDatabase_1_1= x x T fN f 8 @ b Z 3 @ @
> Control Module Function Version Tier
ImplStatus UseCases REST Description RESTDescr Params ParamType Xmit
ParamDescr Return ReturnDescr
Exceptions
detailCode ExceptDescr TODOI Instructions for filling out this sheet are available in source/about.txt START MNCore ping 1.0 Tier 1 UC10 GET /monitor/ping Low level "are you alive" operation. A valid ping response is indicated by a HTTP status of 200. A timestmap indicating the current system time (UTC) on the node MUST be returned in the HTTP Date header. examples/ping.txt null Null body or Exception. The body of the message may be ignored by the caller. The HTTP header *Date* MUST be set in the response. NotImplemented{ Ping is a required operation and so an operational member node should never return this exception unless under development. The Member Node should perform some minimal internal functionality testing before answering. However, ping checks will be frequent (every few minutes) so the internal functionality test should not be high impact. ServiceFailuree A ServiceFailure exception indicates that the node is not currently operational as a member node. A coordinating node or monitoring service may use this as an indication that the member node should be taken out of the pool of active nodes, though ping should be called on a regular basis to determine when the node might b ready to resume normal operations.] Any status response other than 200 indicates that the node is offline for DataONE operations. InsufficientResources A ping response may return InsufficientResources if for example the system is in a state where normal DataONE operations may be impeded by an unusually high load on the node. Note that the timestamp returned in the Date header should follow the semantics as described in the HTTP specifications, http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.18 The response body will be ignored by the caller except in the case of an error, in which case the response body should contain the appropriate DataONE exception.
getLogRecords examples/getLogRecords.txt session Session SSL Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. The subject of the session defaults to the :term:`public user` if the certificate was not provided with the request. Log
NotAuthorized Raised if the user making the request is not authorized to access the log records. This is determined by the policy of the Member Node. This method is used primarily by the log aggregator to generate aggregate statistics for nodes, objects, and the methods of access.
[fromDate] DateTime QueryR Records with time stamp greater than or equal to (>=) this value will be returned. InvalidRequestM The request parameters were malformed or an invalid date range was specified.V The response MUST contain only records for which the requestor has permission to read. [toDate]n Records with a time stamp less than (<) this value will be returned. If not specified, then defaults to *now*.x Note that date time precision is limited to one millisecond. If no timezone information is provided UTC will be assumed. [event]K Return only log records for the specified type of event. Default is *all*. InvalidToken Access control for this method MUST be configured to allow calling by Coordinating Nodes and MAY be configured to allow more general access. string [start=0] integer} Optional zero based offset from the first record in the set of matching log records. Used to assist with paging the response. [count=1000] The maximum number of log records that should be returned in the response. The Member Node may return fewer and the caller should check the *total* in the response to determine if further pages may be retrieved. getCapabilities GET / and GET /nodeB Returns a document describing the capabilities of the Member Node. examples/mn_getCapabilities.txt Node- The technical capabilities of the Member Node The response at the Member Node base URL is for convenience only. Clients of Member Nodes SHOULD use the /node URL to retrieve the node capabilities document. MNRead get UC01, UC06, UC16 examples/get.txt OctetStream Bytes of the specified object. B The provided identity does not have READ permission on the object. pid
Identifier Path NotFound If the object does not exist on the node servicing the request, then :exc:`Exceptions.NotFound` must be raised even if the object exists on another node in the DataONE system.< Also implmented by Coordinating Nodes as :func:`CNRead.get`.~ The node is unable to service the request due to insufficient resources such as CPU, memory, or bandwidth being over utilized. getSystemMetadata UC06, UC37, UC16 examples/getSystemMetadata.txt SystemMetadata- System metadata object describing the object. If the object does not exist on the node servicing the request, then :exc:`Exceptions.NotFound` MUST be raised even if the object exists on another node in the DataONE system. describe UC16d This method provides a lighter weight mechanism than :func:`MNRead.getSystemMetadata` for a client to determine basic properties of the referenced object. The response should indicate properties that are typically returned in a HTTP HEAD request: the date late modified, the size of the object, the type of the object (the :attr:`SystemMetadata.formatId`). examples/describe.txt DescribeResponse< A set of values providing a basic description of the object. The principal indicated by *token* must have read privileges on the object, otherwise :exc:`Exceptions.NotAuthorized` is raised. Note that this method is likely to be called frequently and so efficiency should be taken into consideration during implementation. getChecksum; GET /checksum/{pid}[?checksumAlgorithm={checksumAlgorithm}]w Returns a :class:`Types.Checksum` for the specified object using an accepted hashing algorithm. The result is used to determine if two instances referenced by a PID are identical, hence it is necessary that MNs can ensure that the returned checksum is valid for the referenced object either by computing it on the fly or by using a cached value that is certain to be correct. Checksum@ The checksum value originally computed for the specified object.A The identifier of the object the operation is being performed on. [checksumAlgorithm] The name of an algorithm that will be used to compute a checksum of the bytes of the object. This value is drawn from a DataONE controlled list of values as indicted in the :class:`Types.SystemMetadata`. If not specified, then the system wide default checksum algorithm should be used. A supplied parameter was invalid, most likely an unsupported checksum algorithm was specified, in which case the error message should include an enumeration of supported checksum algorithms. listObjects
UC06, UC16 Retrieve the list of objects present on the MN that match the calling parameters. This method is required to support the process of :term:`Member Node synchronization`. At a minimum, this method MUST be able to return a list of objects that match:: examples/listObjects.txt
ObjectListY The list of PIDs that match the query criteria. If none match, an empty list is returned.3 fromDate < SystemMetadata.dateSysMetadataModifiedw Entries with :attr:`SystemMetadata.dateSysMetadataModified` greater than or equal to (>=) *fromDate* must be returned. but is expected to also support date range (by also specifying *toDate*), and should also support slicing of the matching set of records by indicating the starting *index* of the response (where 0 is the index of the first item) and the *count* of elements to be returned.d Entries with :attr:`SystemMetadata.dateSysMetadataModified` less than (<) *toDate* must be returned. Raised if some functionality requested is not implemented. In the case of an optional request parameter not being supported, the errorCode should be 400. If the requested format (through HTTP Accept headers) is not s< upported, then the standard HTTP 406 error code should be returned.} Note that date time precision is limited to one millisecond. If no timezone information is provided, the UTC will be assumed.
[formatId] ObjectFormatIdentifier; Restrict results to the specified object format identifier. booleans The zero-based index of the first value, relative to the first record of the resultset that matches the parameters. The maximum number of entries that should be returned in the response. The Member Node may return fewer and the caller should check the *total* in the response to determine if further pages may be retrieved. synchronizationFailed UC06 POST /error This is a callback method used by a CN to indicate to a MN that it cannot complete synchronization of the science metadata identified by *pid*. When called, the MN should take steps to record the problem description and notify an administrator or the data owner of the issue. Boolean A successful response is indicated by a HTTP 200 status. An unsuccessful call is indicated by returing the appropriate exception. A successful response is indicated by a HTTP status of 200. An unsuccessful call is indicated by a returned exception and associated HTTP status code. message Exception Filee An instance of the :exc:`Exceptions.SynchronizationFailed` exception with body appropriately filled. C Optionally raised by the receiving MN, depending on implementation. MNAuthorization isAuthorized Tier 2
UC01, UC37l Test if the user identified by the provided session has authorization for operation on the specified object. True if the operation is allowedC A successful operation is indicated by a return HTTP status of 200.Q Failure is indicated by an exception such as :exc:`NotAuthorized` being returned. action
PermissionA The type of operation which is being requested for the given pid.J The body of the response is arbitrary and SHOULD be ignored by the caller. This error is raised if the request comes from a black listed source (e.g. a temporary block may be imposed on a source that calls this method too many times within some time interval)V If the action is not authorized, then a :exc:`NotAuthorized` exception MUST be raised. .. Note:: Should perhaps add convenience methods for "canRead()" and "canWrite()" to verify that a user is able to read / write an object. MNStorage create Tier 3 UC04, UC09, UC16 POST /object; Called by a client to adds a new object to the Member Node. examples/create.txtE The identifier that was used to insert the document into the system. K The provided identity does not have permission to WRITE to the Member Node. ParamX The identifier that should be used in DataONE to identify and access the object. This is an Unicode string that follows the constraints on identifiers described in :doc:`/design/PIDs`. If the identifier is already in use, :exc:`Exceptions.IdentifierNotUnique` will be raised and the client SHOULD try again with a different, unique identifier. IdentifierNotUnique The requested identifier is already used by another object and therefore can not be used for this object. Clients should choose a new identifier that is unique and retry the operation or use :func:`CNCore.reserveIdentifier` to reserve one.Q The caller MUST have authorization to write or create content on the Member Node. object bytes8 The data bytes that are to be added to the Member Node. UnsupportedTypeC The MN can not deal with the content specified in the data package. sysmeta The system metadata document that provides basic information about the object, including a reference to its identifier, access control information, etc. Attributes of the sysmeta that are the responsibility of the client MUST be set. Note that the obsoletes and obsoletedBy elements MUST not be set. It is the role of the update() method to ensure these are properly updated to ensure object lineage is as expected.g The MN is unable to execute the transfer because it does not have sufficient storage space for example. InvalidSystemMetadata The supplied system metadata is invalid. This could be because some required field is not set, the metadata document is malformed, or the value of some field is not valid. update PUT /object/{pid}C This method is called by clients to update objects on Member Nodes.d The identifier of the document that is replacing the original, which should be the same as *newPid*. Updates an existing object by creating a new object identified by *newPid* on the Member Node which explicitly obsoletes the object identified by *pid* through appropriate changes to the SystemMetadata of *pid* and *newPid*. The identifier of the object that is being updated. If this identifier does not exist in the system, an error is raised and the operation does not cause any changes to the objects or their metadata. The requested identifier is already used by another object and therefore can not be used for this object. Clients should choose a new identifier that is unique and retry the operation.^ The bytes of the data or science metadata object that will be deprecating the exsting object. - The MN can not deal with the object provided. newPid The identifier that will become the replacement identifier for the existing object after the update. This identifier must have been previously reserved. A System Metadata document describing the new object. The :attr:`SystemMetadata.obsoletes` field must contain the identifier of the object being obsoleted. Other required client provided fields as described for :class:`Types.SystemMetadata` must be filled. The update operation failed because the object which was supposed to be updated in the system (indicated via the *obsoletedPid* parameter) is not present in the DataONE system, so update is an illegal operation. One or more required fields are not set, the metadata document is malformed or the value of some field is not valid. :attr:`SystemMetadata.obsoletes` is set by the client and does not match the *pid* of the object being obsoleted. :attr:`SystemMetadata.obsoletedBy` is set on the SystemMetadata of the new object provided by the client (a new object cannot be created in an obsoleted state). :attr:`SystemMetadata.obsoletedBy` is already set on the object being obsoleted (no branching is allowed in the obsolescence chain). generateIdentifier POST /generate! The identifier that was generatedw The supplied authentication token is not a proper certificate, or missing required fields, or otherwise proves invalid.9 Need to provide a list of recommended identifier schemes.8 The message body is encoded as MIME Multipart/form-data scheme/ The name of the identifier scheme to be used, drawn from a DataONE-specific vocabulary of identifier scheme names, including several common syntaxes such as DOI, ARK, LSID, UUID, and LSRN, among others. The first version of this method only supports the UUID scheme, and ignores the fragment parameter.
[fragment] The optional fragment to include in the generated Identifier. This parameter is optional and may not be present in the message body.3 Supplied credentials does not have WRITE permissionC The scheme requested is not a valid scheme accepted by this service delete Deletes an object managed by DataONE from the Member Node. Member Nodes MUST check that the caller (typically a Coordinating Node) is authorized to perform this function.. The identifier of the object that was deleted. The delete operation will be used primarily by Coordinating Nodes to help manage the number of replicas of an object that are present in the entire system.` The delete operation failed because the object is not present on the node servicing the request.E The operation removes the object from further interaction with DataONE services. The implementation may delete the object bytes, and in general should do so since a delete operation may be in response to a problem with the object (e.g. it contains malicious content, is innappropriate, or is the subject of a legal request). If the object does not exist on the node servicing the request, then an :exc:`Excep< tions.NotFound` exception is raised. The message body of the exception SHOULD contain a hint as to the location of the :func:`CNRead.resolve` method. archivez Hides an object managed by DataONE from search operations, effectively preventing its discovery during normal operations. / The identifier of the object that was archived. The operation does not delete the object bytes, but instead sets the :attr:`Types.SystemMetadata.archived` flag to True. This ensures that the object can still be resolved (and hence remain valid for existing citations and cross references), though will not appear in searches.a The archive operation failed because the object is not present on the node servicing the request.O Member Nodes MUST check that the caller is authorized to perform this function. systemMetadataChanged POST /dirtySystemMetadatan Notifies the Member Node that the authoritative copy of system metadata on the Coordinating Nodes has changed.E True if notification was received OK, otherwise an error is returned. The Member Node SHOULD schedule an update to its information about the affected object by retrieving an authoritative copy from a Coordinating Node.= Note that date time precision is limited to one millisecond.
serialVersion
unsigned long) The serialVersion of the system metadata.Z Access control for this method MUST be configured to allow calling by Coordinating Nodes. dateSysMetaLastModified8 The time stamp for when the system metadata was changed.
MNReplication replicate Tier 4 UC09 POST /replicate Called by a Coordinating Node to request that the Member Node create a copy of the specified object by retrieving it from another Member Nodeode and storing it locally so that it can be made accessible to the DataONE system. examples/replicate.txt< True if everything works OK, otherwise an error is returned.M A successful operation is indicated by a HTTP status of 200 on the response. 3 Copy of the CN held system metadata for the object.Q Failure of the operation MUST be indicated by returning an appropriate exception.
sourceNode
NodeReference A reference to node from which the content should be retrieved. The reference should be resolved by checking the CN node registry.
getReplica GET /replica/{pid}H Called by a target Member Node to fullfill the replication request originated by a Coordinating Node calling :func:`MNReplication.replicate`. This is a request to make a replica copy of the object, and differs from a call to GET /object in that it should be logged as a replication event rather than a read event on that object. Bytes of the specified object. If the object being retrieved is restricted access, then a Tier 2 or higher Member Node MUST make a call to :func:`CNReplication.isNodeAuthorized` to verify that the Subject of the caller is authorized to retrieve the content.0 The identifier of the object to get as a replicaL A successful operation is indicated by a HTTP status of 200 on the response. MNQuery query
UC02, UC16 GET /query/{queryEngine}/{query}k Submit a query against the specified *queryEngine* and return the response as formatted by the queryEngine.f The structure of the response is deter mined by the chosen search engine and parameters provided to it. The *query()* operation may be implemented by more than one type of search engine and the *queryEngine* parameter indicates which search engine is targeted. The value and form of *query* is determined by the specific query engine. queryEngine Indicates which search engine will be used to handle the query. Supported search engines can be determined through the MNQuery.listQueryEngines API call. For example, the SOLR search engine will accept many of the standard parameters of SOLR, including field restrictions and faceting.b The remainder of the URL is passed verbatim to the respective search engine implementation. Hence it may contain additional path elements and query elements as determined by the functionality of the search engine. The caller is reponsible for providing a '?' to indicate the start of the query string portion of the URL, as well as proper URL escaping. This method is optional for Member Nodes, but if implemented, both getQueryEngineDescription and listQueryEngines must also be implemented.( The specified queryEngine does not exist getQueryEngineDescription GET /query/{queryType} Provides metadata about the query service of the specified *queryEngine*. The metadata provides a brief description of the query engine, its version, its schema version, and an optional list of fields supported by the query engine. Session information that contains the identity of the calling user as retrieved from the X.509 certificate provided with the request. The certificate must be traceable to an authority recognized by DataONE, currently CILogon. QueryEngineDescriptionP A list of fields that are supported by the search index and additional metadata. Indicates which query engine for which to provide descriptive metadata. Currently supported search engines can be determined through MNQuery.listQueryEngines. listQueryEngines
GET /query Returns a list of query engines, i.e. supported values for the *queryEngine* parameter of the *getQueryEngineDescription* and *query* operations. QueryEngineListO A list of names of queryEngines available to the user identified by *session*. c The list of search engines available may be influenced by the authentication status of the request. CNCore} Null body or Exception. The body of the message is ignored by the caller. The HTTP header *Date* MUST be set in the response. The response body will be ignored by the caller expect in the case of an error, in which case the response body should contain the appropriate DataONE exception.S Used internally within a Coordinating Node to add a new object to the object store. The identifier that was used to insert the document into the system. This should be the same as the identifier provided as the *pid* parameter.; This method is not publicly exposed by a Coordinating Node. The identifier that should be used in DataONE to identify and access the object. This is an Unicode string that follows the constraints on identifiers described in :doc:`/design/PIDs`.9 The object store is unable to store the provided content.< The complete system metadata document describing the object.V The CN object store is unable to execute the transfer because of resource limitations. listFormats GET /formatsX Returns a list of all object formats registered in the DataONE Object Format Vocabulary.! examples/cn_listObjectFormats.txt ObjectFormatListM The list of object formats registered in the DataONE Object Format Vocabulary The service is not implemented.9 An error occurred when attempting to service the request. getFormat GET /formats/{formatId}m Returns the object format registered in the DataONE Object Format Vocabulary for the given format identifier. examples/cn_getFormat.txt formatId3 Unique ObjectFormatIdentifier for the object format ObjectFormatE The object format registered in the DataONE Object Format Vocablulary& Unexpected exception from the service.? The format specified by *formatId* does not exist at this node. Retrieves consolidated log information for the specified date range (fromDate < timestamp <= toDate) for the entire DataONE infrastructure Starting time for records in response, entries with timestamp greater than or equal to (>=) this value will be returned. Defaults to include all records. Note that full access to log records requires access through a priviledged account. A public user may be presented with an empty response. End time for records in response, entries with timestamp less than (<) this value will be returned. If not specified, then defaults to now.I Return only log records for the specified type of event. Default is all. [start]E The zero based index of the first log record to return. Default is 0. The request could not be serviced due to a limitation of resources - too many requests, internal service timeout, or another similar failure. [count]< reserveIdentifier
POST /reserve Reserves the identifier that is unique and can not be used by any other sessions. Future calls to :func:`MNStorage.create` and :func:`MNStorage.update` that reference this ID must be made by the same :term:`principal` making the reservation, otherwise an error is raised on those methods. The identifier that was reservedG The identifier requested is not a valid format accepted by this servicez The requested identifier can not be reserved because it already exists in the DataONE system or has already been reserved.A The schme requested is not a valid schme accepted by this service listChecksumAlgorithms
GET /checksumD Returns a list of checksum algorithms that are supported by DataONE. ChecksumAlgorithmList) A list of supported checksum algorithms. [ A problem occurred with the service that prevented it from returning the expected response. setObsoletedBy PUT /obsoletedBy/{pid} Updates the :attr:`Types.SystemMetadata.obsoletedBy` property for an object, indicating that the object specified by *pid* has been obsoleted by the identifier in *obsoletedByPid*. Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. The :term:`Subject` of the session MUST have *write* permission on the object.0 True if the operation succeeds, otherwise false.7 The service endpoint has not yet been fully implemented7 Identifier of the object system metadata being updated. obsoletedByPidH Identifier of the object that obsoletes the object identified by *pid*. 5 The request was malformed and could not be processed. The serial version of the system metadata being updated. If the specified *serialVersion* does not match the current version at the Coordinating Nodes, then a :exc:`Exceptions.VersionMismatch` error is raised and no changes are made.R The supplied session information could not be verified as a valid DataONE session.# The specified *pid* does not exist.c The credentials provided with the request in the *session* do not have *write* privileges on *pid*. VersionMismatch The provided *serialVersion* does not match the latest version that is held by the CN. The client should refresh it's copy, verify that the update is still necessary, and resubmit the request with the updated information. The delete operation is used only by administrators in response to a request to remove an object from DataONE, perhaps because of legal requirements or the object has been identified as containing malicious content.> The delete operation failed because the object does not exist.? The archive operation failed because the object does not exist. The CN should ensure that all MNs holding a copy of the object are informed of the change so that they may update their information about the object. CNRead UC01, UC16, UC09 examples/cn_get.txt For science metadata objects, this will be the exact byte stream of the science metadata object as it was original ingested. Note that additional object types may in the future be returned by the get method. The object specified by the identifier is not present on this (or any) CN. The response body should contain a reference to :func:`CNRead.resolve`. UC36, UC37, UC16! examples/cn_getSystemMetadata.txt1 A system metadata document describing the object.N The principal identified by token does not have READ permission on the object.Q There is no object identified by *pid* and so no system metadata can be returned.d This method provides a lighter weight mechanism than :func:`CNRead.getSystemMetadata` for a client to determine basic properties of the referenced object. The response should indicate properties that are typically returned in a HTTP HEAD request: the date late modified, the size of the object, the type of the object (the :attr:`SystemMetadata.formatId`). resolve
UC36, UC16 examples/resolve.txt ObjectLocationListu A list of nodes known to contain copies of the target object, plus the URLs known to resolve to the node get methods.< Note also that the same functionality as *resolve()* can be implemented by retrieving a copy of the system metadata for the object and utilizing the node registry to discover the base URL from which the client can construct the *get()* URL. Resolve is provided for efficiency since the response size is much smaller. Resolve will return a HTTP status of 303 (see other) on success. The HTTP header "Location" MUST be set, and it's value SHOULD be the full get() URL for retrieving the object from the first location in the resolve response.5 There is no object identified by the given identifier GET /checksum/{pid}Q Returns the checksum for the specified object as reported in the system metadata.$ The checksum of the specified object Note that the signature of this method differs from :func:`MNRead.getChecksum` as that method takes an optional algorithm parameter.> Identifier of the object for which checksum is being requested Retrieve the list of objects present on the CN that match the calling parameters. At a minimum, this method should be able to return a list of objects that match::0 Restrict results to the specified object format. search GET /search/{queryType}/{query}_ Search the metadata catalog and return identifiers of metadata records that match the criteria.: A list of objects that match the specified search criteria Search may be implemented by more than one type of search engine. The queryType parameter indicates which search engine should be targeted. The value and form of *query* is determined by the search engine. queryTypes Indicates which search engine will be used to handle the query. Currently supported search engines include: "SOLR".2 Currently supported search engines include: "solr" Indicates which search engine will be used to handle the query. Supported search engines can be determined through the CNRead.listQueryEngines API call. Indicates which query engine for which to provide descriptive metadata. Currently supported search engines can be determined through CNRead.listQueryEngines. CNAuthorization setRightsHoldere Changes ownership (RightsHolder) of the specified object to the :term:`subject` specified by `userId`* Identifier of the object that was modified userId SubjectC The subject that will be taking ownership of the specified object. O The supplied subject does not have permission to change ownership of the objectT The serialVersion of the system metadata that is the intended target for the change.9 The specified object does not exist in the DataONE systemZ The serialVersion supplied with the request does not match the serialVersion of the target
CNIdentity registerAccount POST /accounts4 Create a new :term:`subject` in the DataONE system. H The new subject in the DataONE system. This may be a simple identifier. Note that there should probably be a lot more metadata captured about the new user, and there should be a mechanism for specifying the default access control rules for the new account. person PersonF Information about the Person to be registered with the account, including the real name and email address for the individual. The Subject with the Person must match the subject of the X.509 certificate associated with the authenticated SSL session via client-side authentication, and must not have been registered previously.0 The chosen identity already exists in the system InvalidCredentialsU Raised if the supplied credentials are invalid, such as an invalid X.509 certificate.D The subject of the session does not match the subject of the person.
updateAccount PUT /accounts/{subject}} Update an existing :term:`subject` in the DataONE system. The target subject is determined from subject provided in the URL. 3 The Subject in the DataONE system that was updated.J The use calling this method must have write access to the account details. subject( The subject of the person being updated.Y Note that there should be a policy for verifying the details that change via this method. New information about the Person. The subject of the Pe< rson cannot be updated with this method and must match the subject of the X.509 certificate associated with the authenticated SSL session via client-side authentication.G Raised if the subject of the session does not match that of the person.% Raised if the account does not exist.
verifyAccount$ PUT /accounts/verification/{subject}k Verify that the Person data associated with this Subject is a true representation of the real world person.; True if the account verification succeeds, otherwise false.m This service can only be called by users who have an administrative role for the domain of users in question. The Subject identifier of the Person to be verified. After this service is called for a subject by an authorized user, the account is marked as verified by this user.k This error is raised if the person attempting to validate the account is not authorized to verify accounts.Y A successful completion of this operation is indicated by returning a HTTP status of 200.K An exeption MUST be returned if the account verification is not successful. getSubjectInfo UC12 GET /accounts/{subject} Get the information about a Person (their equivalent identities, and the Groups to which they belong) or the Group (including members). SubjectInfo[ The Person or Group details are contained in the returned SubjectList for the given SubjectF The Subject identifier of the Person or Group details to be returned. I Raised if the requested subject is not registered with the DataONE system listSubjectsI GET /accounts?query={query}[&status={status}&start={start}&count={count}]T List the subjects, including users, groups, and systems, that match search criteria.3 The list of people and groups that match the query. The list can be restricted to subjects whose identifier matches certain substrings, and the size of the resultset can be paged through. A query string criteria to be matched using a case-insensitive substring match against the identifier for the principal, the givenName or familyName of users, and the groupName of groups. The function returns the union of all successful matches against these fields. status When provided, the status field can limit the returned list of Subjects to only those with the given status. Currently the 'verified' status is supported. startH The starting record number for the records to be returned (default = 0). count The maximum number of entries that should be returned in the response. The Member Node may return fewer and the caller should check the *total* in the response to determine if further pages may be retrieved (default = 100). mapIdentity POST /accounts/map` Create a new mapping between the two identities, asserting that they represent the same subject. Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. @ True if the mapping was successfully initiated, false otherwise. Mapping identities with this method requires explicit authorization for the user given in the Session object. The caller must have made sure that the primary and secondary identities represent one and the same individual. primarySubjectT The Subject identifier that will have a mapped identity to the other given subject. T Successful completion of the request is indicated by returning a HTTP status of 200. secondarySubjectK The supplied principal does not have permission to map these two identitiesz A failed request MUST be indicated by returning an appropriate exception and setting the response HTTP status accordingly.< The specified principal does not exist in the DataONE system@ The subject of the session and the provided subject are the same removeMapIdentity DELETE /accounts/map/{subject} Removes a previously asserted identity mapping from the Subject in the Session to the Subject given by the parameter. The reciprocol mapping entry is also removed.: True if the map was successfully created, false otherwise.D A successful request is indicated by returning a HTTP status of 200.{ The Subject identifier to be used for equivalentIdentity. This Subject will not match the Subject named in the certificate.| The specified principal does not exist in the DataONE system, or the mapping between the subjects has no yet been initiated. requestMapIdentity POST /accounts/pendingmap Request a new mapping between the authenticated identity in the session and the given identity, asserting that they represent the same subject. Mapping identities is a two-step process wherein a map request is made by a primary Subject and a subsequent (confirmation) map request is made by the secondary Subject. This ensures that mappings are performed only by those that have authority to do so. confirmMapIdentity" PUT /accounts/pendingmap/{subject} Confirms a previously initiated identity mapping. If subject A asserts that B is the same identity through :func:`CNIdentity.requestMapIdentity`, then this method is called by B to confirm that assertion. getPendingMapIdentity" GET /accounts/pendingmap/{subject}@ Gets the SubjectInfo of a previously initiated identity mapping. The SubjectInfoF The supplied principal does not have permission to get the SubjectInfo denyMapIdentity% DELETE /accounts/pendingmap/{subject} Denies a previously initiated identity mapping. If subject A asserts that B is the same identity through :func:`CNIdentity.requestMapIdentity`, then this method is called by B to deny that assertion. createGroup POST /groups# Create a group with the given name.* The Subject of the group that was created. Groups are lists of subjects that allow all members of the group to be referenced by listing solely the subject name of the group. Group names must be unique within the DataONE system. Groups can only be modified by Subjects listed as rightsHolders. group Group The Group to be created.A The supplied principal does not have permission to create a group# A group by this name already exists updateGroup PUT /groups Add members to the named group. Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. The subject of the session is used to determine if the request is being made by the creator of the group.A True if the group that was modified successfully, false otherwise Group members can be modified only by the original creator of the group, otherwise a NotAuthorized exception is thrown. Group members are provided as a list of subjects that replace the group membership. The new Group object that will replace the old Group. The Group.Subject must match the groupName and an update cannot modify this value.[ Successful completion of this operation is indicated by a HTTP response status code of 200.A The supplied principal does not have permission to add to a groupb Unsuccessful completion of this operation MUST be indicated by returning an appropriate exception.8 The specified group does not exist in the DataONE system UC01, UC02, UC36, UC37j Test if the user identified by the provided token has authorization for operation on the specified object. A successful response is indicated by a response HTTP status of 200. The body of the response is arbitrary and SHOULD be ignored by the caller. setAccessPolicy The supplied token is invalid= Triggers a change to the system metadata modified time stamp. accessPolicy AccessPolicy4 The desired privileges to be assigned to the object. Unsuccessful completion of this operation MUST be indicated by returning an appropriate exception such as :exc:`NotAuthorized`.Z The :term:`Subject` does not have permission to alter access control rules for the object.
CNReplication setReplicationStatus PUT /replicaNotifications/{pid}b Update the replication status of the system metadata, ensuring that the change is appropriate for the given state of system metadata. For example, a MN can not change the status to *COMPLETED* unless the CN previously requested replication of the object and the replications status of the object (as in< dicated in the system metadata) is set to *QUEUED*. Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. The subject of the session defaults to the public user if the certificate was not provided with the request.W True if the operation is allowed and expected, otherwise an exception should be raised.? Identifier of the object to be replicated between Member Nodes. nodeRef Reference to the Node which made the setReplicationStatus call. If this is a Member Node, the checksum must be compared with that of the authoritative Member Node. If not, this step can be ignored as the call is not signifying a replication is complete. The nodeRef, status, and failure parameters are transmitted as part of the HTTP request body encoded as a MIME Multipart/form-data encoded payload. ReplicationStatusD Replication status. See system metadata schema for possible values. failure
BaseException A BaseException object or one of it's subclasses, or null. If the status is set to 'failed', this exception object can provide more detail. Appropriate sub-classes include InsufficientResource, NotAuthorized, ServiceFailure, etc. listNodes UC39 GET /nodeR Returns a list of nodes that have been registered with the DataONE infrastructure. NodeList List of nodes from the registry
CNRegister updateNodeCapabilities PUT /node/{nodeid}W For updating the capabilities of the specified node. Most information is replaced by information in the new node, however, the node identifier, nodeType, ping, syncrhonization.lastHarvested, and synchronization.lastCompleteHarvest are preserved from the existing entry. Services in the old record not included in the new Node will be removed. True if operation is successful nodeid8 The identifier of the existing node entry being updated.X The :term:`Subject` does not have authority to modify the node registration information. nodeI An instance of :class`Types.Node` that contains the updated information. The request was malformed.6 The requested nodeid is not available in the registry. register
POST /node| Register a new node in the system. If the node already exists, then a :exc:`IdentifierNotUnique` exception MUST be returned.Q The identifier of the new node entry if successful, otherwise an error is raised. An instance of :class:`Types.Node` that fully describes the node being registered. Note that some attributes will be set by the Coordinating Node. updateReplicationMetadata PUT /replicaMetadata/{pid} Replaces the replica with matching nodeRef in the system metadata of the specified object. Adds a new replica if the nodeRef of passed in Replica is not already present. Changes the date sys meta modified. True on successV Successful completion of the operation is indicated by returning a HTTP status of 200. replicaMetadata ReplicaU The serialVersion of the system metadata that is the intended target for the change. The specified pid does not exist registerSystemMetadata
POST /meta Provides a mechanism for adding system metadata independently of its associated object, such as when adding system metadata for data objects. The pid that was updated.5 This method is used internally by Coordinating Nodes. setReplicationPolicyS Updates the replication policy entry for an object by updating the system metadata. policy ReplicationPolicy isNodeAuthorizedF GET /replicaAuthorizations/{pid}?targetNodeSubject={targetNodeSubject} Verifies that a replication event was initiated by a CN by comparing the target node's identifiying subject with a known list of scheduled replication tasks., The method functionality is not implemented. targetNodeSubject The subject that identifies the target node, with a value extracted from the X.509 certificate passed in during the call to MNReplication.replicate().< Replication of PID is not authorized for the subject listed.. The identifier of the object to be replicated." An internal server error occurred.# The replication request is invalid.- The PID does not exist as an existing object.# The session information is invalid. hasReservation Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to an authority trusted by the DataONE Coordinating Nodes. True - subject has the reservation on the PID; False - the PID does not exist; False - the PID is already in use; False - the PID is reserved by somone else.y A positive response (that the *pid* is reserved and owned by *subject*) is indicated by a return of a HTTP status of 200.G The subject of the :term:`principal` (user) that made the reservation. U A negative response is indicated by an exception and the associated HTTP status code.a The PID does not exist as a reservation or an existing object and is not in use as an identifier. The PID is reserved but the owner is not the :term:`principal` identified by the *subjectInfo* OR the provide *session* does not have authority to access this service. deleteReplicationMetadata PUT /removeReplicaMetadata/{pid}o Removes the replication information for the specified node from the object system metadata identified by *pid*. Session information that contains the identity of the calling user as retrieved from the X.509 certificate which must be traceable to the CILogon service. The subject of the session MUST be a Coordinating Node.: True if the replication metadata was successfully deleted.1 The method functionality if not fully implemented Removal of replication metadata is necessary if the Member Node goes offline permanently or for an extended period, or when it is deeemed prudent to migrate an object from one node to another to address resource management issues.K The identifier of the object whose replication metadata is being modified. O An internal server error occurred that prevented the operation from completing. nodeIdi The identifier of the node replication information that is being removed from the system metadata record.$ The request parameters are malformed The :attr:`Types.SystemMetadata.serialVersion` of the system metadata being updated. This MUST match the latest version of system metadata available for the object on the Coordinating Node. The supplied session is invalid The object identified by *pid* or the node reference specified by *nodeId* could not be located in the system metadata for the object. The subject identified by the *session* information does not have appropriate priviledges for modifiying the content or accessing the service.~ The *serialVersion* does not match the current :attr:`Types.SystemMetadata.serialVersion` value of the object system metadata. END Name Code AuthenticationTimeout% The authentication request timed out.( Set by the method raising the exception. descriptionD Human readable description that can assist the caller in determining traceInformation
dictionary Optional set of key-value pairs that can include the name of the method that raised the error plus other details such as parameters used in the call that can be helpful for debugging. Sensitive information such as passwords must **never** be logged or recorded in error messages. The provided identifier conflicts with an existing identifier in the DataONE system. When serializing, the identifier in conflict should be rendered in traceInformation as the value of an identifier key. ^ Human readable description that can assist the caller in determining how to avoid the problem.( The identifier value that is in conflict [traceInformation]9 Optional additional information to assist with debugging.P There are insufficient resources at the node to support the requested operation. Optional set of key-value pairs that can include the name of the method that raised the error plus other details such as parameters used in the call that can be helpful for debugging. k Indicates that the credentials supplied (to :func:`CN_crud.login` for example) are invalid for some reason. Can include the name of the method t< hat raised the error and perhaps the username. Obviously, the supplied password or other sensitive information should not be included.y The parameters provided in the call were invalid. The names and values of parameters should included in traceInformation.T The supplied system metadata is invalid. This could be because some required field is not set, the metadata document is malformed, or the value of some field is not valid. The content of traceInformation should contain additional information about the error encountered (e.g. name of the field with bad value, if the document is malformed). Key-value pairs that should include additional information about the error that was encountered while processing the SystemMetadata document.Q The supplied authentication token (Session) could not be verified as being valid.P The supplied identity information is not authorized for the requested operation. Used to indicate that an object is not present on the node where the exception was raised. The error message should include a reference to the :func:`CN_crud.resolve` method URL for the object.5 The identifier of the object that can not be located.c A method is not implemented, or alternatively, features of a particular method are not implemented. Some sort of system failure occurred that is preventing the requested operation from completing successfully. This error can be raised by any method in the DataONE API. UnsupportedMetadataTypeb The science metadata document submitted is not of a type that is recognized by the DataONE system. The information presented appears to be unsupported. This error might be encountered when attempting to register unrecognized science metadata for example. SynchronizationFailed` Sent to a Member Node from a Coordinating Node when an attempt to synchronize some object fails.h Human readable description of the problem which can be forwarded to an administrator for further action.8 Identifier of the object that could not be synchronized.w The serialVersion of the system metadata being updated differs from the serialVersion supplied with the change request.? Identifier of the system metadata for the object being updated. Raised when the request parameters are incorrect or the operation is not applicable to the current state of the object (e.g. an archived object can not be updated)] Objects that are archived can not be updated through the :func:`MNStorage.update` operation. h Archived objects can not be un-archived. This behavior may change in future versions of the DataONE API. The update operation MUST fail with :exc:`Exceptions.InvalidRequest` on objects that have the :attr:`Types.SystemMetadata.archived` property set to true. The Member Node sets :attr:`Types.SystemMetadata.obsoletedBy` on the object being obsoleted to the *pid* of the new object. It then updates :attr:`Types.SystemMetadata.dateSysMetadataModified` on both the new and old objects. The modified system metadata entries then become available in :func:`MNRead.listObjects`. This ensures that a Coordinating Node will pick up the changes when filtering on :attr:`Types.SystemMetadata.dateSysMetadataModified`. The :func:`MNQuery.query` operation may be implemented by more than one type of search engine and the *queryEngine* parameter indicates which search engine is targeted. The value and form of *query* is determined by the specific query engine. MNView view GET /views/{theme}/{pid}p Provides a formatted view of an object (science metadata, data, resource, or other) using the given named theme. If this service is implemented, the :func:`MNView.view` operation must implement at least one {theme} named 'default' to provide a standard (possibly minimalistic) view of the content in HTML format. theme Indicates which themed view will be used to handle the query. All implementations must support a 'default' HTML theme, but are free to implement additional themes that return both HTML and non-HTML responses.! The specified pid does not exist. Any return type is allowed, including application/octet-stream, but the format of the response should be specialized by the requested theme. listViewsJ Provides a list of usable themes for rendering content in a view, including a required 'default' theme. The list of themes is provided as an OptionList, where the option key should be used as the theme name in calls to MNView.view, and the description provides a human readable description of what will be returned fo rthat theme.h If the {theme} parameter is not recognized, the service must render the object using the default theme rather than throwing an error. Note that the return type of Types.OctetStream requires that the consuming client has a priori knowledge of the theme being returned (like HTML). Response headers must include the correct mime-type of the view being returned.d This method is optional for Member Nodes, but if implemented, MNView.view must also be implemented.i This method is optional for Member Nodes, but if implemented, MNView.listViews must also be implemented.
GET /views
OptionListI A list of available themes that can be used with the MNView.view service. CNViewv The service :func:`CNView.view` operation will implement at least one {theme} named 'default' to provide a standard (possibly minimalistic) view of the content in HTML format. In addition, a CN may redirect a client to the view service of the authoritative Member Node for a PID if that node has implemented the :func:`MNView.view` service and implements a compatible theme. MNPackage
getPackage! GET /packages/{packageType}/{pid}) This method is optional for Member Nodes. packageType\ The identifier of the package or object in a package to be returned as a serialized package. Provides all of the content of a DataONE data package as defined by an OAI-ORE document in DataONE, in one of several possible package serialization formats. The serialized package will contain all of the data described in the ORE aggregation. The default implementation will include packages in the BagIt format. The packageType formats must be specified using the associated ObjectFormat formatId for that package serialization format. Indicates which package format will be used to serialize the package. All implementations must support a default BagIt package serialization, but are free to implement additional package serialization formats. Any return type is allowed, including application/octet-stream, but the format of the response should be specialized by the requested packageType.v GET /log?[fromDate={fromDate}][&toDate={toDate}][&event={event}][&idFilter={idFilter}][&start={start}][&count={count}]
[idFilter] Return only log records for identifiers that start with the supplied identifier string. Support for this parameter is optional and MAY be ignored by the Member Node implementation with no warning. Accepts PIDs and SIDst Retrieve log information from the Member Node for the specified slice parameters. Log entries will only return PIDs. GET /object/{id}k Retrieve an object identified by *id* from the node. Supports both PIDs and SIDs. SID will return HEAD PID. The response MUST contain the bytes of the indicated object, and the checksum of the bytes retrieved SHOULD match the :attr:`SystemMetadata.checksum` recorded in the :class:`Types.SystemMetadata` when calling with PID. idE The identifier for the object to be retrieved. May be a PID or a SID.{ The object specified by *id* does not exist at this node. The description should include a reference to the resolve method. GET /meta/{id}[ Describes the object identified by *id* by returning the associated system metadata object. There is no data or science metadata identified by the given *id* on the node where the request was serviced. The error message should provide a hint to use the :func:`CNRead.resolve` mechanism.e Identifier for the science data or science metedata object of interest. May be either a PID or a SID. HEAD /object/{id}E Identifier for the object in question. May be either a PID or a SID. GET /object[?fromDate={fromDate}&toDate={toDate}&identifier={identifier}&formatId={< formatId}&replicaStatus={replicaStatus} &start={start}&count={count}] [identifier] Restrict results to the specified identifier. May be a PID or a SID. In the case of the latter, returns a listing of all PIDs that share the given SID.& GET /isAuthorized/{id}?action={action} The identifer of the resource for which access is being checked. May be either a PID or a SID. Will use the HEAD PID when given a SID value. The *pid* must not exist in the DataONE system or should have been previously reserved using :func:`CNCore.reserveIdentifier`. A new, unique :attr:`Types.SystemMetadata.seriesId` may be included. A new, unique :attr:`Types.SystemMetadata.seriesId` may be included when beginning a series, or a series may be extended if the newPid obsoletes the existing pid. Given a scheme and optional fragment, generates an identifier with that scheme and fragment that is unique. Maybe be used for generating either PIDs or SIDs. DELETE /object/{id}z The identifier of the object to be deleted. May be either a PID or a SID. Will delete the HEAD PID when called with a SID. PUT /archive/{id}| The identifier of the object to be archived. May be either a PID or a SID. Will archive the HEAD PID when called with a SID. Identifier of the object for which system metadata was changed. May be either a PID or a SID. Calling with SID is equivalent to calling with HEAD PID.O The identifier of the object to render in a view. May be either a PID or a SID.! Return only log records for identifiers that start with the supplied identifier string. Support for this parameter is optional and MAY be ignored by the Coordinating Node implementation with no warning. Supports PID and SID values. Only PID values will be included in the returned entries. The requested identifier is transmitted in a MIME Multipart/form-data body with *id* as key, and the identifier string as value.C The identifier that is to be reserved. May be a PID or a SID value. Given a scheme and optional fragment, generates an identifier with that scheme and fragment that is unique. Returned identifier may be used as either a PID or a SID. Deletes an object from the entire DataONE system, including all nodes known to hold a copy of the object. The PID and/or SID of the object will continue to be shown as in use (preventing its reuse for other objects), however the object should not be resolvable (NotFound) or retrievable.p The identifier of the object to be deleted. May be either a PID or SID, the latter will operate on the HEAD PID.o The identifier of the object to be archived. May be either a PID or a SID, the latter will act on the HEAD PID. Retrieves the object identified by *id* from the node. If the object is not present on the node, then an :exc:`Exceptions.NotFound` error is raised, regardless of whether the object exists on another node in the DataONE system.z Identifier of the object to be retrieved. May be either a PID or a SID, the latter acting as if called using the HEAD PID. Returns the :term:`system metadata` that contains DataONE specific information about the object identified by *id*. Authoritative copies of system metadata are only available from the Coordinating Nodes.t Identifier for the object of interest. May be either a PID or a SID, the latter acts as if called with the HEAD PID.v Identifier for the object in question. May be either a PID or a SID, the latter acting as if called with the HEAD PID. GET /resolve/{id} Returns a list of nodes (MNs or CNs) known to hold copies of the object identified by *id*. The object resolution process is intended to provide a simple mechanism for a client to discover from which node(s) a particular object may be retrieved. Details about method interfaces (i.e. REST URLs) exposed by a particular node can be determined by examining the response from the *node* collection. For convenience, the :func:`MNRead.get` URL is included in the response as is the base URL of the node REST services.j Identifier being resolved. May be either a PID or a SID, the latter acting as if called with the HEAD PID. Restrict results to the specified identifier. May be either a PID or a SID. If the latter, will return results for each PID in the series. PUT /owner/{id}i Identifier of the object to be modified. May be either a PID or a SID, the latter acting on the HEAD PID. The identifer of the resource for which access is being checked. May be either a PID or a SID, the latter returning results as if called with the HEAD PID.H The type of operation which is being requested for the given identifier. PUT /accessRules/{id}= Sets the access permissions for an object identified by *id*.{ The object for which access control is being updated. May be either a PID or a SID, the latter acting on the HEAD PID only. PUT /replicaPolicies/{id}q The identifier of the policy being updated. May be either a PID or a SID, the latter acting only on the HEAD PID.# GET /reserve/{id}?subject={subject}V Checks to determine if the supplied *subject* is the owner of the reservation of *id*. The identifier that is being checked for existing as a reserved identifier or is in use as an identifier for an existing object. May be either a PID or a SID. GET /views/{theme}/{id}z The identifier of the object to render in a view. May be a PID or a SID, the latter acting as if called with the HEAD PID. PUT /meta updateSystemMetadataY Provides a mechanism for updating system metadata for any objects held in the federation." True if the update was successful.q This method is typically used by Authoritative Member Node or rights holder[s] to ensure system metadata quality. getNodeCapabilities GET /H Returns a document describing the capabilities of the Coordinating Node.3 The technical capabilities of the Coordinating Node GET /node/{nodeid}p For retrieving the capabilities of the specified node if it is registered on the Coordinating Node being called.: The identifier of the existing node entry being looked up.F An instance of :class`Types.Node` that contains the Node information. synchronize POST /synchronizeL True if the synchronization request was successfully queued, otherwise False Indicates to the CN that a new or existing object identified by PID requires synchronization. Note that this operation is asynchronous, a successful return indicates that the synchronization task was successfully queued. 2.0~ This method may be called by any Member Node for new content or the authoritative Member Node for updates to existing content. The CN will schedule the synchronization task which will then be processed in the same way as content changes identified through the listObjects polling mechanism. 1.0, 2.0 For example, the solr search engine will accept many of the standard parameters of solr, including field restrictions and faceting.3 v2.0: This method was added to the Version 2.0 API.9 v2.0: The identifier may be a :term:`PID` or :term:`SID`.F v2.0: The structure of :class:`v2_0.Types.SystemMetadata` has changed.< v2.0: The structure of :class:`v2_0.Types.Node` has changed.D v2.0: The supplied identifier may be a :term:`PID` or a :term:`SID`. v1.1: This method was added. v2.0: The supplied identifier may be a :term:`PID` or a :term:`SID`. If the identifier is a SID, then resolution is for the latest version of an object (i.e. the head of the obsolescence chain). v2.0: The supplied identifier may be a :term:`PID` or a :term:`SID` and the returned :class:`v2_0.Types.SystemMetadata` structure has changed. v2.0: Method implementation has changed to ensure that the obsolescence chain is consistent with use of any SID assigned to the object.P v2.0: The identifier being reserved may be used as a :term:`PID` or :term:`SID`.; v2.0: The structure of :class:`v2_0.Types.Log` has changed.D v2.0: The structure of :class:`v2_0.Types.ObjectFormat` has changed.U v2.0: The structure of :class:`v2_0.Types.SystemMetadata` has changed from Version 1. echoCredentials Echo the credentials used to make the call. This method can be used to verify the client certificate is valid and contains the expected information.k Session information that < contains the identity of the calling user as retrieved from the X.509 certificate. CNDiagnostic GET /diag/subject echoSystemMetadata+ Parse and echo the provided system metadataE The subjects and groups parsed from the supplied session information.4 An internal failure prevented a successful response.5 The supplied session information could not be parsed. POST /diag/sysmeta Session information that contains the identity of the calling user as retrieved from the x.509 certificate. The service MAY choose to limit access to only authorized users. A SystemMetadata object to be examined. The object is parsed and error conditions reported by an exception response. On successful parsing, the SystemMetadata object is echoed back with a HTTP 200 status.' A copy of the supplied System Metadata.F A SystemMetadata object that passes the echoSystemMetadata diagnostic. echoIndexedObject{ Since DataONE supports multiple types of query engine, the query engine to be used for parsing is specified in the request.A A valid query engine name as reported by :func:`listQueryEngines`? The supplied credentials are not authorized for this operation.( The structure of the request is invalid.0 The supplied object was not of a supported type.( The system metadata could not be parsed.B The provided metadata format is not supported by the query engine.r Insufficient resources could be allocated to support the request. The provided object may be too large to process.b The servce may terminate the POST operation if the size of the object is beyond a reasonable size.+ v2.0: This operation is new to version 2.0. On successful parsing, a copy of the system metadata is returned, otherwise an exception is returned indicating an error condition. POST /diag/object Parse and echo the provided science metadata or resource map document. The response is governed by the type of object provided in the request, and on success is one or more documents that are the result of parsing for indexing.Y A document (e.g. science metadata or resource map) that is to be evalauted for indexing. A document representing the parsed object as it would be prior to being added to a search index. For the solr query engine for example, this would be the equivalent of a * .. .. * structure with possibly multiple documents.
1.0, (2.0)
1.1, (2.0)
Event, stringX v2.0: The event parameter has changed from :class:`v1_0.Types.Event` to a plain *string*z Usage of this method SHOULD be restricted to CNs for updating the system metadata in the underlying CN storage sub-system. [nodeId]G Restrict results to those with authoritativeMemberNode equal to nodeId.4 V2.0: Added filter on authoritativeMemberNode value. GET /object[?fromDate={fromDate}&toDate={toDate}&identifier={identifier}&formatId={formatId}&nodeId={nodeId}&start={start}&count={count}] [replicaStatus]l Indicates if replicated objects should be returned in the list (i.e. any entries present in the :attr:`SystemMetadata.replica`, objects that have been replicated to this node). If ``false``, then no objects that have been replicated should be returned. If ``true``, then any objects can be returned, regardless of replication status. The default value is ``true``.5 This method can be only called by Coordinating Nodes.N This method can be only called by Coordinating Nodes and trusted Member Nodes.Z Note: the serial version and the replica list in the new system metadata will be ignored. Provides a mechanism for updating system metadata for any objects held on the Member Node where that Member Node is the authoritative Member Node. Coordinating Node can call this method on the non-authoritative Member Node. However, this is not a normal operation and is for the special case - the authoritative Member Node doesn't exist any more. Coordinating Node calling the method on the non-authoriative Memember Node in the normal operation can cause an unexpected consequence. The {id} parameter must be the identifier of an ORE package object. If it is the identifier of one of the science metadata documents or data files contained within the package, the Member Node should throw an InvalidRequest exception. Identifiers may be either PIDss or SIDs.4 The request was malformed and could not be processed) The object (e.g. Science Metadata) bytes. B 3 j3 Z 3 W4 G 5 9 < I> 9 R@ B
uB e C D gF W H ZL J O S U 9X Y | \ &] ` P
Mc .g al - n q yv ! ]x gy { E ~ )
T ; _ ڎ . y l $
7 * } q K ? { t
U
@ O
q L ` &
G
r o L ; Z ;
9 X ^ Y O J b ] !
& ( N* I + . 1 4 W 5 8 ; = 9A
c c PK ! pO [Content_Types].xmlj0Eжr(] yl#!MB ;.n̨̽\ A1&ҫ
QWKvUbOX#&1`RT9<l#$>r `С-;c=1g, Q,%iaiS쑚0 $e[X,Pd
譇m]פݢ }IΌ֨Vvn ×| $u "$kkx>h
ӽiO[*& A?As-{P0xM
>3-8= 68oj\1rN
> ?y'yCp~`Ѣ 9mK&n2'R`M\2^sTȬqhƜѨb}lo{nw6xud
mxM7ڡi.= k5
.=DS-) 4aESV QŜW| $hW9(F\O! ӭ~N9SZ5|H 11,0uBGیoh{ "V<6w2=%K C1?ryyMҺ wH#O%,@u?$F,Qg2 "M $!U,MO d.:(VCn!9$V'<-\l7J1fV]k BA2XSOjњfjJ; L^5APC~3h[ n1^f\kmq@5wEmճ1n,Fy&,ώF. gKRt9|
vd4kA"8.Q{c.$]kܯ& ^lI'3!1z$;N[(PC&͢Ճfv]KJ}͙/8D g6TIhk˭9Tϴ ζc8gK}:Sd>)`*jn{wUtߖ*0?SE/p
|8Lz\ e1} -pB pl
rڜ2LZFP
ˉ!@K&n̗ +LDU+3; l99C1a zy-"]Tar9.\l2Rj )zMb*?vC}) WZX tɁ75Ʋ `gB/s~܊ATiViPFLZ5m^h-gem;ck۶)
Ma11]ջ(x>S%S27٩@K!P$+Cte(n aW
"Z/. _ ؍ œ"C<ˬ`x3^ t VpYu{%X/=1 ʨZ?%qrxB2
@ .
@ 6
@ ?
? @ ~
?
F
? *
@ A
?
? B
? 6
@
? ~
?
F
? *
@ /
? C
? D
@ 6
@ E
F
? * h K
@
K
? F
? D
@ 6
@ G K
L K F F
@ @ @ h K K K K K K K
K
L K h K K K K K K K
K
L K
F
? H
f
G
@ I
@ J
@ K
? L
@ M
? ~
? !
F
? H
@ N
? # ~
? ! F F O E E i E E E E E E
C C
D C
? O
B P
f
B ~
B
@ Q
?
P
P R
M ,
M -
M .
N /
P S
@ T
Q 1 ~
Q
R U
? O
? P
P P
@
P W
P X
P
Q Y ~
Q
R
? O
? P
P Z P
Q # ~
Q R
? O
? P
@ [
Q @ ~
Q R
? O
? P
Q ~
Q R
? O
? P
Q & ~
Q
R \ B XL ^ d ( ( B ~ ~ ~ b
B B F
@ Z P B ! x F " ` # ` $ % ( F ) H * ` + H , / F 0 1 x 2 3 4 5 7 x F 8 0 9 : H ; H < = 0 > ` ? Q Q R
! ? O
! G ]
! f
! G ! G
! H ^
! F
! H
! H _
!
M ,
! M -
! M .
!
N /
! F `
! H a
! F 1 ~
! F B
! I H
" ? O
" ? ]
" @ b
"
@
" P W
" P X
"
P
" S ~
" S F
# ? O
# ? ] #
@ @ @
# ? Y ~
# ?
# A
$ ? O
$ ? ] $
@ @ @
$ ? # ~
$ ?
% ? O
% ? ] %
@ @ @
% ? @ ~
% ? j
( ? O
( G c
( f
( G ( G
( H d
( F
( H e
( H f
(
M ,
( M -
( M .
(
N /
( F g
( H h
( F 1 ~
( F B
( I H
) ? O
) ? c
) @ i
)
@
) P W
) P X
)
P
) ? Y ~
) ?
* ? O
* ? c
* @ Z *
@ @ @
* ? # ~
* ?
+ ? O
+ ? c
+ @ j +
@ @ @
+ ? @ ~
+ ? j
, ? O
, ? c
, ? ~
, ? F
/ ? O
/ G k
/ f
/ G
/ G H
/ F l
/ H m / H
/
M ,
/ M -
/ M .
/
N /
/ F n
/ H o
/ F 1 ~
/ F
/ I H
0 ? O
0 ? k
0
@ V
0 P W
0 P X
0
P p
0 ? Y ~
0 ? 2
1 ? O
1 ? k
1
@ q
1 @ B
1 @ 6
1
@ r
1 ? 8 ~
1 ?
1 A s
2 ? O
2 ? k 2
@ @ @
2 ? # ~
2 ?
3 ? O
3 ? k 3
@ @ @
3 ? @ ~
3 ? Z
4 ? O
4 ? k
4 ? ~
4 ?
5 ? O
5 ? k
7 ? O
7 T t
7 f
7 G 7 G
7 H u
7 F
7 H v
7 H w
7
M ,
7 M -
7 M .
7
N /
7 F x
7 H y
7 F 1 ~
7 F
7 I H
8 ? O
8 ? t
8 @ z
8
@ 4
8 @ 5
8 @ 6
8
@ {
8 ? 8 ~
8 ?
9 ? O
9 ? t
9 @ |
9
@ ;
9 @ 5
9 @ 6
9
@ }
9 ? ~
9 ? b
9 A ~
: ? O
: ? t
: @
:
@
: @
: @ 6
:
@
: ? # ~
: ?
; ? O
; ? t
; @
;
@
; @ W
; @ 6
;
@
; ? @ ~
; ?
< F O
< ? t < ?
<
@ 5
< @
< @ 6
<
@ 6
= ? O
= ? t
=
@ C
= @ D
= @ 6
=
@
> ? O
> ? t
>
@ F
> @ D
> @ 6
>
@ ?
@ @ @ :
~ V H H ~ V V 8 p ~ H H 8 ~ ~ ~ ^ T T @ A H B H C 0 D E F x F G H H 0 I ` J 0 K H L N x F O P 0 Q R ` S T U V X x F Y x Z 8 [ ` \ x ]
^ _
@ ? O
@ ?
@ ?
@ @
@ ?
@ @
@
M ,
@ M -
@ M .
@
N /
@ ?
@ @
@ F ~
@ ? !
A ? O
A ?
A @
A
@
A @
A @
A
@
A ? # ~
A ? !
B ? O
B ?
B @ A B
@ @ @
B ? 1 ~
B ? !
C ? O
C ? C
@ @ @
C ? @ ~
C ? !
C A D
@ @ @ E
@ @ @
F F
F G
F f
F G F G
F H
F F
F H F H
F
M ,
F M -
F M .
F
N /
F F
F H
F F # ~
F F
F I H
G F
G ?
G @
G
@
G ? W
G ? X
G
@
G ? ~
G ?
H F
H ?
H @
H
?
H ?
H ? 6
H
@
H ? Y ~
H ? "
I F
I ?
I @
I ? 1 ~
I ? r
I A
J F
J ?
J @
J ? @ ~
J ?
K F
K ?
K @
K ? 8 ~
K ? L @
N F
N G
N f
N G N G
N H
N F
N H
N H
N
M ,
N M -
N M .
N
N /
N F W
N H
N F 1 ~
N F 2
N I N H
O F
O ?
O @
O
@ V
O P W
O P
O
P
O ? ~
O ?
O A
P F
P ?
P @
P
@
P @
P @
P
@
P ? ~
P ?
P A
Q F
Q ?
Q
@
Q @ `
! " # $ % & ' ( ) * + , - . / 0 1 2 3 4 5 6 7 8 9 : ; < = > ? @ A B C E F G H I J K L M N O P Q R S T U V W X Y Z [ \ ] ^ _ ` a b c d e f g h i j k l m n o p q r s t u v w x y z { | } ~
Q @
Q
@
Q ? & ~
Q ? "
Q A
R F
R ? R
@ @ @
R ? ~
R ? r
R A
S F
S ? S
@ @ @
S ? # ~
S ?
T F
T ? T
@ @ @
T ? @ ~
T ? Z
U F
U ?
U ? ~
U ? 6
V F
V ?
V ? 8 ~
V ? :
X F
X G
X f
X G X G
X H d
X F
X @ X H
X
M ,
X M -
X M .
X
N /
X F W
X H
X F 1 ~
X F
X I H
Y F
Y ?
Y H
Y
@ V
Y P W
Y P X
Y
P
Y ? ~
Y ?
Y A
Z F
Z ?
Z `
Z
@
Z @
Z @
Z
@
Z ? ~
Z ? b
Z A
[ F
[ ?
[ @
[
@
[ @ W
[ @
[
@
[ ? & ~
[ ?
[ A
\ F
\ ?
\ `
\
@
\ @ `
\ @
\
@
\ ? Y ~
\ ?
\ A
] F
] ? ] ]
@ @ @
] ? ~
] ? R
] A
^ F
^ ? ^
@ @ @
^ ? # ~
^ ? z
_ F
_ ? _
@ @ @
_ ? @ ~
_ ? @ B D ~ V V ~ ~ T F F
~ V H H 8 8 ` H ` a H b c x d x e H f 0 g h i k x F l ` m n x o p q x r s 0 t H u 0 v x w x x y H z 0 { 0 | ~
H
` F
` ?
` ? ~
` ?
a F
a ?
a ? 8 ~
a ?
a @ b U
c U
c ?
c f
c ?
c F
c H c H
c
M ,
c M -
c M .
c
N /
c F W
c H
c F @ ~
c F :"
c I
c H
d U
d ?
d H d H
d
?
d ? B
d ?
d
@
d F H
d ? # ~
d ? >"
e U
e ?
e
?
e ? B
e ?
e
@
e ? 1 ~
e ? B"
e A
f U
f ?
f ? 8 ~
f ? F"
f A
g U
g ?
g ? ~
g ? J" h U i U
k F
k G
k f
k G k G
k H d
k F
k H k H
k
M ,
k M -
k M .
k
N /
k F W
k H
k F 1 ~
k F R-
k I H
l F
l ?
l @
l
@
l P W
l P X
l
P
l ? Y ~
l ? V-
l A
m F
m ?
m @ m
@ @ @
m ? # ~
m ? Z-
n F
n ?
n @ n
@ @ @
n ? @ ~
n ? ^-
o F
o ?
o ? ~
o ? b- p F
q F
q B
q f
q ?
q ?
q H
q
M ,
q M -
q M .
q
N /
q F W
q H
q F 1 ~
q F z-
q I H
r F
r ?
r @
r
@
r P W
r P X
r
P
r ? Y ~
r ? ~-
r A
s F
s ?
s @ s
@ @ @
s ? # ~
s ? -
t F
t ?
t @ t
@ @ @
t ? @ ~
t ? -
u F
u ?
u @
u ? ~
u ? - v U
v @ w
x U O
x ?
x f
x ?
x ?
x @
x
? ,
x ? -
x ? .
x
N /
x ?
x @
x ? ~
x ?
y U O
y ?
y @
y
?
y ? W
y ?
y
@
y ? 1 ~
y ?
z U O
z ?
z @
z
?
z ?
z ?
z
@
z ? @ ~
z ?
{ U O
{ ?
{ @
{
?
{ ? 5
{ ?
{
@
{ ? # ~
{ ?
| U O
| ?
| ? 8 ~
| ?
~ ?
~ ?
~ f
~ ?
~ ?
~ @ :
~
? ,
~ ? -
~ ? .
~
N /
~ ?
~ @
~ ? ~
~ ? @
?
?
@
? V
? W
?
? 1 ~
? @ @
D8 F
~ F 8
V V 8
V V F
~ ~ ~ 8 x F 0 H 0 x 0 0 H x x H x H
?
?
?
? `
?
? # ~
? @
?
?
? 8 ~
? @
?
?
? ~
? \@
?
?
? @ ~
? ]@
F
G
f
F
H
F
H
H
M ,
M -
M .
N /
F
H
F ~
F !
I H
F
?
@
@
@ `
@
@
? # ~
? !
F
?
@
@
@
@
@
? 1 ~
? !
F
?
@
@ @ @
? 8 ~
? !
F
?
@ @ @
? & ~
? !
F
?
@ @ @
? ~
? !
F
?
@ @ @
? @ ~
? ! U
@ @ @
? O
B
f
?
@
?
@
M ,
M -
M .
N /
P S
@
F ~
F "
? O
?
@
@ V
@ W
@ X
@
? # ~
? "
? O
?
@
@ @ @
? 1 ~
? "
? O
?
@
@ @ @
? @ ~
? "
? O
?
@ @ @
? & ~
? ""
R \
? O
?
@ @ @
? Y ~
? &"
@ @ @
?
? g ?
?
@
?
@
? ,
M -
M .
N /
? S
@
F @ ~
F ,
?
?
@
?
? B
? X
@
? # ~
? ,
?
?
@
?
? B
? X
@
? 1 ~
? ,
?
?
@
? 8 ~
? ,
?
?
? ~
? ",
?
?
? Y ~
? &,
A
?
? g ?
?
?
@
? ,
? -
? .
@
?
@
? ~
? +
?
?
?
? B
? X
@
? # ~
? +
?
?
? @ ~
? +
?
?
? 1 ~
? +
?
?
? Y ~
? +
A
@ Db 8 8 8 ~ ~ V H H H `888* ~ ~ F 8 F p 8 8 ` H a x H a 0 a 0 a x F x ` x `
?
? g ?
?
?
@
? ,
? -
? .
@
?
@
? ~
? +
?
?
@
? # ~
? +
?
?
? @ ~
? +
?
?
? 1 ~
? + j b b b b b b b
b c b d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d
?
? ~
g ^@
?
?
@
? ,
U -
U .
X /
? S
@
U @ ~
U @
?
?
@
?
? B
? X
@
? # ~
? @
?
?
@
@
@ W
@ X
@
? 1 ~
? @
?
?
@
? 8 ~
? "@
?
?
? ~
? $@
?
?
? Y ~
? &@
A j b b b b b b b
b
c b
?
? ~
g ^@
?
?
@
? ,
U -
U .
X /
?
@
U @ ~
U 0@
?
?
@
? # ~
U 2@
?
?
? 1 ~
U 4@
?
?
? 8 ~
U 6@
?
?
? ~
U 8@ j b b b b b b b
b
c b
?
? ~
g ^@
?
?
@
? ,
U -
U .
X /
? S
@
U @ ~
U l@
?
?
@ ;
?
N
? X
@
? # ~
U n@
?
?
@
@
@ W
@ X
@
? 1 ~
U p@
?
?
? 8 ~
U r@
?
?
? ~
U t@
?
?
? Y ~
U v@
A j b b b b b b b
b
c b
F
G
f ,
G G
H
F
H
H
H H H H
F
H
F ~
F
I H
F
?
@ "
?
? # ~
?
F
?
@ %
@ @ @
? & ~
?
A ' F
@ (
@ @ @ F
@
@ @ @ F
@ @ @ B X F 8 8 ~ ~ F 8 F B X J 8 8 B ~ ~ 8 8 F B P d ( ( F x H 0 ` H M @ @ D @ D @ @ p M U U @ x F H H 0 x H ` F H F 0
M
G
f
G G
H
F
H H
M ,
M -
M .
N /
F W
H
F 1 ~
F 2
I H
M
?
@
@ V
P W
P
P !
? ~
?
A
M
?
@
@
@
@
@ =
? ~
? ~L
A "
M
?
@
@ `
@
@ #
? & ~
? L
A $
M
?
@ @ @
? ~
? L
A
M
?
@ @ @
? # ~
? vL
M
?
@ @ @
? @ ~
? zL
M
?
? ~
? jL
M
?
? 8 ~
? nL F
M
V %
f
V N
M &
N '
N (
N N N N
M )
N *
M ~
M K
W + N
M
U %
@
@ @ @
? # ~
? K
W ,
M
U %
@ @ @
M
U %
@ @ @
M
U %
@ @ @
@ @ @
M
V -
f
V N
M .
N /
N 0
N 1
N
N X
N 2
M 3
N 4
M ~
M K
W + N
M
U - k X
X X X X X X
X
U # ~
U K
A 5 X
M
U - k X X X X X X X
X
U Y ~
U K
Y 6 X
M
G *
f
G G
H d
F
H 7 H
M ,
M -
M .
N /
F 0 H
F @ ~
F
I H
M
? *
@
? 4
? 5
? 6
@ 8
S # ~
S J
M
? *
@ 9
@ ;
@ 5
? 6
@ :
S 1 ~
S
M
? *
@
@ >
@ .
? 6
@ ;
S ~
S
M
? *
@ /
?
? B
? 6
@
? 8 ~
S "
M
? *
? <
? D
? 6
@ =
? & ~
S &
A >
M
? *
? ?
? D
? 6
@ G S
F
G @
f
G G
H d
F A
H B H
M ,
M -
M .
N /
F W
H C
F @ ~
F zA
I H
F
G @ f G G H
H H
F
F W
F
H H
I H
F
? @
@
? # ~
? A @ D ~ V H H 8 8
d , 6 , ~ ~ ~ ~ ~ ^ 0 H x F x F H 0 0 0 ` H 0 ` 0 ` F x x 0
F
? @
? 1 ~
? RA
A
F
? @
? 8 ~
? A
A D
F
? @
? ~
? A
A E
F
? @
? ~
? ~A F
F
G
f ,
G G
H d
F
H H
M ,
M -
M .
N /
F W
H
F @ ~
F zA
I
H
F
G f G G H
H H
?
? B
?
@ H
I H
F
?
?
? B
?
@
? # ~
? A
F
?
? 1 ~
? RA
A
F
?
? 8 ~
? A
A F
F
?
? ~
? ~A
?
? G
g ,
?
? H
@ I
? J
@ K
? ~
? BL
A +
?
? G
? # ~
? FL
A L
?
? M
g
? N
@ O
? ,
? -
? .
N P
F
H Q
? ~
? 2M
A R
?
? M
@
? V
? W
? X
@ S
? # ~
? 6M
A L
?
? M
? T
? W
?
@ U
? 8 ~
? :M
A V
?
? M
?
?
?
@ W
? @ ~
? >M
A X
?
? M
? Y ~
? BM
A Y
?
? M
? 1 ~
? FM
A Z
?
? M
? [ ~
? JM
A \
F
G
g ,
G G
H d
F
H H
M ,
M -
M .
N /
F W
H
F 1 ~
F M
I H
F
?
@ ]
@
P W
P X
P
? Y ~
? M
A ^
F
?
@ @ @
? # ~
? M
F
?
@ @ @
? @ ~
? M
F
?
? ~
? M F
F
B
g
?
?
H
M ,
M -
M .
N /
F W
H
F 1 ~
F M
I H
F
?
@
@
P W
P X
P
? Y ~
? M
A _
F
?
@
@ @ @
? # ~
? M > ( 0F F F 8
p F F 8 F ~ ~ F F F H H 8
H H 0 F 0
H x F ` 0 0 F H ` H 0
F
?
@
@ @ @
? @ ~
? M
F
?
@ `
? ~
? M
@
F a
G P
f
G G
H b
F
H
H c
M ,
M -
M .
N /
F S
H d
F 1 ~
F
I H
F a
? P
@
@
@ W
@ X
@
? ~
?
F a
? P
@ @ @
? Y ~
?
A e
F a
? P
@ @ @
? # ~
?
F a
? P
? @ ~
? F
F a
G ]
f
G G
H f
F
H
H g
M ,
M -
M .
N /
F `
H h
F @ ~
F j
I H
F a
? ]
@
@
? W
? X
@
? ~
? F
F a
? ]
? # ~
?
F a
? ]
? 1 ~
? B
A i
F a
? ]
? Y ~
?
A j F
? a
G c
f
G G
H d
F
H k
H f
M ,
M -
M .
N /
F g
H h
? ~
?
M
I H
? a
? c
@ i
@
P W
P X
P
? # ~
? M
? a
? c
@ Z
@ @ @
? @ ~
? M
? a
? c
@ j
@ @ @
? Y ~
? M
? a
? c
@
F 1 ~
F M , < |V F ~ V H 8
~ 8 F F
~ V V F ! " x # ` $ % ' x F ( H ) * + , - . x F / 0 0 1 H 2 H 3 0 4 ` 5 0 6 7 x F 8 ` 9 : ; < = x > x ?
F a
G l
f
G G
H m
F
H
H n
M ,
M -
M .
N /
F o
H p
F @ ~
F @
I H
! F a
! ? l
! @ q
!
@
! ? W
! ? X
!
@
! S # ~
! S @
" F a
" ? l
" @ r
" S 1 ~
" S b@
# F a
# ? l
# @
# S Y ~
# S @
# A s
$ F a
$ ? l
$ S ~
$ S @ % F % S
' F a
' G k
' g ,
' F
' H
' F t
' H u ' H
'
M ,
' M -
' M .
'
N /
' F n
' H v
' F ~
' F
' I H
( F a
( ? k
( @ w
(
@ V
( @ W
( @ X
(
@ x
( ? # ~
( ?
) F a
) ? k )
@ @ @
) ? Y ~
) ? 2
* F a
* ? k *
@ @ @
* ? 1 ~
* ?
+ F a
+ ? k +
@ @ @
+ ? @ ~
+ ? Z , F ,
@ @ @ - F -
@ @ @
. F a
. T t
. g ,
. G . G
. H u
. F 4
. H y . H
.
M ,
. M -
. M .
.
N /
. F x
. H y
. F 1 ~
. F
. I H
/ F a
/ ? t
/ @ z
/
@ 4
/ @ 5
/ @ 6
/
@ {
/ ? 8 ~
/ ?
0 F a
0 ? t
0 @ |
0
@ ;
0 @ 5
0 @ 6
0
@ }
0 ? ~
0 ? b
0 A ~
1 F a
1 ? t
1 @
1
@
1 @
1 @ 6
1
@ z
1 ? # ~
1 ?
2 F a
2 ? t
2 @
2
@
2 @ W
2 @ 6
2
@
2 ? @ ~
2 ?
3 F a
3 ? t
3 @ 3
3
@ C
3 @ D
3 @ 6
3
@
4 F a
4 ? t
4
@ F
4 @ D
4 @ 6
4
@
5 F a
5 ? t
5
@ 1
5 ?
5 @ 6
5
@ 2 6 F 6
@ @ @
7 F a
7 G {
7 g ,
7 G 7 G
7 H
7 F |
7 H } 7 H
7
M ,
7 M -
7 M .
7
N /
7 F x
7 H ~
7 F @ ~
7 F
C
7 I H
8 F a
8 ? {
8 @
8
?
8 ? B
8 ? X
8
@
8 S # ~
8 S ZC
9 F a
9 ? {
9 @
9
?
9 ? B
9 ? X
9
@
9 S 1 ~
9 S B
: F a
: ? {
: S 8 ~
: S 2C
; F a
; ? {
; S ~
; S B < U
< S S
= U a
= ?
= g -
= ?
= @
= ?
= @
=
? ,
= M -
= M .
=
N /
= ? S
= @
= F @ ~
= F C
> U a
> ?
> @
>
?
> ? B
> ? X
>
@
> S # ~
> S C
? U a
? ?
? @
?
?
? ? B
? ? X
?
@
? S 1 ~
? S C B X ~ F T 8 ~ H H H ~ ~ ~ b T T ~ ~ 8 8 ~ @ A B C D x E H F G H I J ` K H L M N O x F P 0 Q 0 R 0 S T U 0 W x M X Y 0 Z [ \ 0 ] _ x M
@ U a
@ ?
@ @
@ S 8 ~
@ S C
A U a
A ?
A S ~
A S C
B U a
B ?
B S Y ~
B S C
B A
C U
C S S
D U a
D ?
D g -
D ?
D ?
D @
D
? ,
D ? -
D ? .
D
@
D ?
D @
D S ~
D S D
E U a
E ?
E @
E
?
E ? B
E ? X
E
@
E S # ~
E S D
F U a
F ?
F ? @ ~
F S D
G U a
G ?
G S 1 ~
G S D
H U a
H ?
H S Y ~
H S D
H A
I U
I S S
J U a
J ?
J g -
J ?
J ?
J @
J
? ,
J ? -
J ? .
J
@
J ?
J @
J S ~
J S E
K U a
K ?
K @
K S # ~
K S E
L U a
L ?
L @
L ? @ ~
L S E
M U a
M ?
M S 1 ~
M S E N
@ @ @
O F
O G
O f
O G O G
O H d
O F
O H O H
O
M ,
O M -
O M .
O
N /
O F W
O H
O F # ~
O F *F
O I H
P F
P ?
P @
P
@
P ? W
P ? X
P
@
P ? @ ~
P ? F
Q F
Q ?
Q
?
Q ?
Q ?
Q
@
Q ? 1 ~
Q ? bE
Q A
R F
R ?
R
?
R ?
R ?
R
@
R ? Y ~
R ? E
R A
S F
S ?
S ? ~
S ? fE
T F
T ?
T ? 8 ~
T ? jE
U F
U ?
U ? [ ~
U ? nE
U A
W F
W V
W g ,
W G W V
W N d
W M
W N W N
W
M ,
W M -
W M .
W
N /
W M
W N
W M # ~
W M F
W W N
X F
X ?
X @
X
?
X ?
X ?
X
N
X ? ~
X ? F
X A
Y F
Y ?
Y ? ~
Y ? F
Y A
Z F
Z ?
Z ? ~
Z ? F
[ F
[ ?
[ ? 8 ~
[ ? F
\ F
\ ?
\ ? 1 ~
\ ? F
\ A
] F
] ?
] ? @ ~
] ? F
_ F
_ V
_ g ,
_ G _ V
_ N d
_ M
_ N _ N
_
M ,
_ M -
_ M .
_
N /
_ M
_ N
_ M # ~
_ M F
_ W N @
DF 8 F ~ 8 8 F F F 8 ~ ~ ~ 8 8 F F 8 8 F 8 ` 0 a ` b c 0 d e g x M h H i 0 j 0 k m x F n 0 o 0 p q r s x F t x u H v 0 w ` x y z { H F | x } 0 ~ H
` F
` ?
` @
`
?
` ?
` ? X
`
@
` ? ~
` ? F
` A
a F
a ?
a @
a
?
a ?
a ?
a
N
a ? ~
a ? F
b F
b ?
b ? 8 ~
b ? F
c F
c ?
c ? 1 ~
c ? F
c A
d F
d ?
d ? Y ~
d ? F
d A
e F
e ?
e ? @ ~
e ? F
g F
g V
g g ,
g G
g V N
g M
g N g N
g
M ,
g M -
g M .
g
N /
g M
g N
g M # ~
g M F
g W N
h F
h ?
h @
h
?
h ?
h ? X
h
@
h ? 1 ~
h ? F
h A
i F
i ?
i @
i ? ~
i ? F
j F
j ?
j @
j ? @ ~
j ? F
k F
k ?
k ? 8 ~
k ? G
m F
m G
m g ,
m G m G
m H
m F
m H m X
m
M ,
m M -
m M .
m
N /
m F
m H
m ? ~
m ? BG
m I H
n F
n ?
n
U
n U
n U X
n
@
n M # ~
n M FG
o F
o ?
o ? Y ~
o ? RG
o A
p F
p ?
p S 1 ~
p S NG
q F
q ?
q ? @ ~
q ? RG r F
s F
s G
s g ,
s G
s G H
s F
s H s X
s
M ,
s M -
s M .
s
N /
s F
s H
s Z # ~
s Z #
s I H
t F
t ?
t @
t
U
t U B
t U 6
t
X
t U @ ~
t U z#
u F
u ?
u
?
u ? B
u U 6
u
@
u S 1 ~
u S R#
v F
v ?
v
?
v ? D
v U 6
v
@
v S ~
v S V#
w F
w ?
w
?
w ? D
w U 6
w
@
w ? 8 ~
w ? Z# x F y F z F
{ F
{ G
{ g ,
{ G
{ G H
{ F
{ H { X
{
M ,
{ M -
{ M .
{
N
{ F
{ H
{ F # ~
{ Z Z%
{ I H
| F
| ?
| @
|
U
| U
| U
|
@
| ? @ ~
| U
%
} F
} ?
} @
}
U
} U
} U
}
@
} ? 1 ~
} S $
} A
~ F
~ ?
~ @
~ ? Y ~
~ ? $
~ A
F
?
? ~
S $ @ D ~ 8 F F 8 F F 8 p F 8 8
~ p p p
~ T 0 ` F 0 H H H F x 0 H 0 ` F 0 H H H F 0 H ` F
F
?
? 8 ~
? $
F
?
? ~
? $
A
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z Z%
I H
F
?
@
U
U
U X
@
? @ ~
U
%
F
?
@
? 1 ~
S $
A
F
?
? Y ~
? $
A
F
?
? ~
S $
F
?
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z Z%
I H
F
?
@
U
U
U
@
? @ ~
U
%
F
?
@
? 1 ~
S $
A
F
?
@
? Y ~
? $
A
F
?
? ~
S $
F
?
? 8 ~
? $
F
?
? ~
? $
A
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z Z%
I H
F
?
@
U
U
U X
@
? @ ~
U
%
F
?
@
? 1 ~
S $
A
F
?
? Y ~
? $
A
F
?
? ~
S $
F
?
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z Z%
I H
F
?
@
U
U
U X
@
? 1 ~
S $
A
F
?
@
? Y ~
? $
A
F
?
? ~
S $
F
?
? @ ~
S M
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z Z%
I H : 0
8 F ~ T F 8 ~ T T 8 8 F ~ T F 8 T 8 8 0 H H x F x 0 x F ` 0 0 x F H 0 ` 0 0 x F 0 0 H
F
?
@
U
U
U X
@
? @ ~
U
%
F
?
@
? 1 ~
S $
A
F
?
? Y ~
? $
A
F
?
? ~
S $ F
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N /
F
H
F # ~
Z &
I H
F
?
@
U
U
U
X
? @ ~
U &
F
?
? 1 ~
S r&
A
F
?
? ~
S v&
F
?
? ~
? %
A F F
F
G
g ,
G
G H
F
H X
M ,
M -
M .
N
F
H
F # ~
Z z(
I H
F
?
@
?
?
?
@
? @ ~
U *(
F
?
@
? 1 ~
S (
A
F
?
@
? Y ~
? '
A
F
?
? ~
S (
F
?
? 8 ~
? '
F
G
f
G G
H
F
H H
M ,
M -
M .
N /
F
H
F # ~
F
I H
F
?
@
@
? W
? X
@
? @ ~
?
F
?
@
?
?
? 6
@
? Y ~
? "
F
?
@
? 1 ~
? r
A
F
?
@
? ~
?
F
?
@
? 8 ~
?
F
G
f
G G
H d
F
H H
M ,
M -
M .
N /
F
H Q
F @ ~
F D
I H
F
?
@
@
? W
? X
@
? # ~
? :E
F
?
@
?
?
?
@
? Y ~
? D
A
F
?
@
?
?
?
@
? 1 ~
? E
A <
~ T F 8
~ F 8 F
~ T T 8 8 ~ ~ T F F ~ 0 0 0 ` H ` 0 0 0 0 0 0 0 ` 0
F
?
@
? ~
? D
F
?
? 8 ~
? D
F
?
? [ ~
? D
A ?
?
?
B
g ,
?
@
?
@
M ,
M -
M .
N
?
@
? # ~
? rI
?
?
@
@ V
? W
? X
@
? ~
? vI
?
?
@
?
?
?
@
? @ ~
? I
?
?
@
?
?
?
@
? 1 ~
? I
?
?
@ 8
?
?
?
@
? 8 ~
? I
?
?
? Y ~
? J
?
?
f
?
@
?
@
?
@
? ~
? K
?
?
@
? # ~
? K
?
?
F
? H
f
G
@
@
? L
@
? ~
? ²@
F
? H
@
? # ~
? ò@ F
?
?
f
?
?
@ !
M ,
M -
M .
N /
?
@ "
? ~
? RK
A +
?
?
@
@ #
?
? X
@ $
? 1 ~
? VK
A %
?
?
@
? &
? L
?
@ '
? # ~
? ZK
?
?
@
? 8 ~
? ^K
A (
?
?
? Y ~
? bK
A )
?
?
? @ ~
? fK
?
?
f
?
?
@
@ #
?
? X
@
? L
@
? ~
? ڲ@
A +
?
?
@
@
? # ~
? ۲@
?
?
? 8 ~
? ܲ@
A ( 6 F 8 F ~ ~ ~ ~ 8 F F
~ T F 8 T x H ` 0 0 0 0 x 0 x H 0 0
?
?
? Y ~
? ݲ@
A )
?
?
?
?
?
? *
f
?
? +
@ ,
M ,
M -
M .
N /
?
@ -
? ~
? K
?
? *
@
? &
? L
?
@ .
? 1 ~
? K
?
? *
? # ~
? K
?
? *
? 8 ~
? K
?
? *
? ~
? K
?
? *
? @ ~
? K
?
? /
g ,
?
? 0
@ 1
? ,
? -
? .
N
?
@ 2
? ~
? K
?
? /
@ 3
? V
? W
? X
? 1 ~
? K
?
? /
@
? 4
? 5
?
? # ~
? K
?
? /
@ 7
?
?
?
@ 6
? 8 ~
? K
?
? /
? Y ~
? K
A 7
?
? /
? [ ~
? K
A
?
? /
? @ ~
? K
?
? 8
f
?
? 9
@ :
? ,
? -
? .
N /
? W
@ ;
? ~
? K
?
? 8
@ <
? V
? W
?
? 1 ~
? K
?
? 8
@
?
? `
?
? # ~
? K
?
? 8
? 8 ~
? K
?
? 8
? ~
? L
?
? 8
? @ ~
? L
?
?
f
?
?
@
? ,
? -
? .
N /
?
@
? ~
? @
?
?
@ 0
? V
? W
?
? 1 ~
? @
?
?
@
?
? `
?
? # ~
? @
?
?
@ 9
? 8 ~
? @
?
?
? ~
? \@
?
?
? @ ~
? ]@ < \ F ~ 8 8 8 8 p p ~ F F 8 p p 8 8 8 p p F 8 x 0 0 0 0 x
H 0
H H 0 ` ` x 0 ` H H H a
?
? =
f
?
?
@ >
? ,
? -
? .
N /
?
@ 2
? ~
? BL
?
? =
@ 3
?
? W
? X
@
? 1 ~
? FL
?
? =
@
? ?
? @
?
? # ~
? JL
?
? =
@
?
?
?
@
? 8 ~
? NL
?
? =
? Y ~
? RL
?
? =
? @ ~
? VL
?
? =
? [ ~
? ZL
A
?
? A
g ,
?
? B
@ C
? ,
? -
? .
X /
?
@ 2
? ~
? L
A D
?
? A
@ 3
? E
?
? 6
X F
? 1 ~
? L
A G
?
? A
@
? V
? W
? X
X H
? # ~
? "L
A I
?
? A
X
? 8 ~
? &L
A J
?
? A
X
? Y ~
? *L
A K
?
? A
X
? @ ~
? .L
A L
X
?
? M
f
?
@
? ,
? -
? .
X N
?
@ O
? ~
? L
A D
?
? M
@ P
?
?
? 6
@ Q
? # ~
? L
A I
?
? M
@ R
?
? W
? X
@
? @ ~
? L
A L
?
? M
@
? Y ~
? L
A S
?
? M
? 1 ~
? L
A T
?
? M
? 8 ~
? =@
A <
?
? U
g ,
? V
@ W
? ,
? -
? .
X X
?
@ Y
? ~
? ZM
A Z
?
? U
@ [
? V
? W
? X
@ \
? # ~
? ^M
A ]
?
? U
@ 7
? ^
?
?
@ _
? 8 ~
? bM
A `
?
? U
?
?
?
@ a
? @ ~
? fM
A b
?
? U
? Y ~
? rM
A c
?
? U
? 1 ~
? jM
A d
?
? U
? [ ~
? nM
A e j b
b b
b b
c b
?
?
g
?
?
@
? ,
U -
U .
X /
? S
@
U @ ~
U D@ > 0 ~ p ~ 8 8 F P P P
T F F ~ F F F D ! " # $ % a & ' ( ) * + a - x . H / ` 0 2 H 3 4 6 H 7 ` 8 9 : ; < > ? H
?
?
@
?
? B
? X
@
? # ~
? F@
! ?
! ?
! @
!
@
! @ W
! @ X
!
@
! ? 1 ~
! ? H@
" ?
" ?
" @
" ? 8 ~
" ? J@
# ?
# ?
# ? ~
# ? L@
$ ?
$ ?
$ ? Y ~
$ ? N@
$ A % j % b % b b b b b b
% b
% c b
& ?
& ?
& g
& ?
& ?
& @
&
? ,
& U -
& U .
&
X /
& ?
& @
& U @ ~
& U X@
' ?
' ?
' @ '
' ? # ~
' U Z@
( ?
( ? (
( ? 1 ~
( U \@
) ?
) ?
) ? 8 ~
) U ^@
* ?
* ?
* ? ~
* U `@ + j + b + b b b b b b
+ b
+ c b
- ? a
- ?
- g
- ?
- ?
- @
-
? ,
- ? -
- ? .
-
X /
- ?
- @
- ? ~
- ? `@
. ? a
. ?
. @
.
? V
. ? W
. ?
. ? # ~
. ? a@
/ ? a
/ ?
/ @
/ ? 1 ~
/ ? b@
0 ? a
0 ?
0 @
0 ? @ ~
0 ? c@
2 ?
2 ?
2 g
2 ?
2 ?
2 @
2
? ,
2 ? -
2 ? .
2
X
2 ?
2 @
2 ? ~
2 ? e@
2 A +
3 ?
3 ?
3 @
3 ? # ~
3 ? f@
3 A
4 ?
4 ?
4 ? @ ~
4 ? g@
4 A
6 ?
6 ?
6 g
6 ?
6 ?
6 @
6
? ,
6 ? -
6 ? .
6
@
6 ? `
6 @
6 ? ~
6 ? j@
7 ?
7 ?
7 @ '
7
?
7 ? `
7 ?
7
@
7 ? # ~
7 ? k@
8 ?
8 ?
8 @ &
8 ? 1 ~
8 ? l@
9 ?
9 ?
9 ? @ ~
9 ? m@
: ?
: ?
: ? 8 ~
: ? n@
; ?
; ?
; ? ~
; ? o@
< ?
< ?
< ? ~
< ? p@
> ?
> ?
> g
> ?
> ? (
> @ )
>
? ,
> ? -
> ? .
>
@
> ? S
> @ +
> ? ~
> ? t@
> A +
? ?
? ?
? @
?
?
? ? B
? ?
?
@
? ? # ~
? ? u@
? A < <
~ ~ F 8 F B X J 8 8 B p F F T F ~ F 8 8 8 8 @ 0 A 0 B C D E 0 F 0 Y
@ ?
@ ?
@ @ %
@
?
@ ? `
@ ?
@
@
@ ? 1 ~
@ ? v@
@ A
A ?
A ?
A @ &
A
?
A ?
A ?
A
@ *
A ? @ ~
A ? w@
A A
B ?
B ?
B ? 8 ~
B ? x@
B A
C ?
C ?
C ? ~
C ? y@
C A "
D ?
D ?
D ? ~
D ? z@
D A !
E ?
E ?
E ? ~
E ? {@
E A #
F ?
F ?
F ? & ~
F ? |@
F A $
Y ? f $ F F F F F ` ` (
# l B X ^ $ ?
" %
] 4
< Dave Vieglais:
Indicates how the parmeter is transmitted in the REST call
SSL = part of HTTPS handshake process
Query = URL query parameter
Path = URL path element
Parameter = Parameter part of MIME multipart/mixed message body
File = File part of MIME multipart/mixed message body<
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F
! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F
! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
S
] F ! d
` X
!
S
] F ! ! d
` X
"
S
! ] F " ! d
` X
#
S
! " ] F # ! d
` X
$
S
" # ] F $ ! d
` X
%
S
# $ ] F % ! d
` X
&
S
$ % ] F & ! d
` X
'
S
% & ] F ' ! d
` X
(
S
& ' ] F ( ! d
` X
)
S
' ( ] F ) ! d
` X
*
S
( ) ] F * ! d
` X
+
S
) * ] F + ! d
` X
,
S
* + ] F , ! d
` X
-
S
+ , ] F - ! d
` X
.
S
, - ] F . ! d
` X
/
S
- . ] F / ! d
` X
0
S
. / ] F 0 ! d
` X
1
S
/ 0 ] F 1 ! d
` X
2
S
0 1 ] F 2 ! d
` X
3
S
1 2 ] F 3 ! d
` X
4
S
2 3 ] F 4 ! d
` X
5
S
3 4 ] F 5 ! d
` X
6
S
4 5 ] F 6 ! d
` X
7
S
5 6 ] F 7 ! d
` X
8
S
6 7 ] F 8 ! d
` X
9
S
7 8 ] F 9 ! d
` X
:
S
8 9 ] F : ! d
` X
;
S
9 : ] F ; ! d
` X
<
S
: ; ] F < ! d
` X
=
S
; < ] F = ! d
` X
>
S
< = ] F > ! d
` X
?
S
= > ] F ? ! d
` X
@
S
> ? ] F @ ! d
` X
A
S
? @ ] F A ! d
` X
B
S
@ A ] F B ! d
` X
C
S
A B ] F C ! d
` X
D
S
B C ] F D ! d
` X
E
S
C D ] F E ! d
` X
F
S
D E ] F F ! d
` X
G
S
E F ] F G ! d
` X
H
S
F G ] F H ! d
` X
I
S
G H ] F I ! d
` X
J
S
H I ] F J ! d
` X
K
S
I J ] F K ! d
` X
L
S
J K ] F L ! d
` X
M
S
K L ] F M ! d
` X
N
S
L M ] F N ! d
` X
O
S
M N ] F O ! d
` X
P
S
N O ] F P ! d
` X
Q
S
O P ] F Q ! d
` X
R
S
P Q ] F R ! d
` X
S
S
Q R ] F S ! d
< ` X
T
S
R S ] F T ! d
< ` X
U
S
S T ] F U ! d
< ` X
V
S
T U ] F V ! d
< ` X
W
S
U V ] F W ! d
< ` X
X
S
V W ] F X ! d
< ` X
Y
S
W X ] F Y ! d
< ` X
Z
S
X Y ] F Z ! d
< ` X
[
S
Y Z ] F [ ! d
< ` X
\
S
Z [ ] F \ ! d
< ` X
]
S
[ \ ] F ] ! d
< ` X
^
S
\ ] ] F ^ ! d
< ` X
_
S
] ^ ] F _ ! d
< ` X
`
S
^ _ ] F ` ! d
< ` X
a
S
_ ` ] F a ! d
< ` X
b
S
` a ] F b ! d
< ` X
c
S
a b ] F c ! d
< ` X
d
S
b c ] F d ! d
< ` X
e
S
c d ] F e ! d
< ` X
f
S
d e ] F f ! d
< ` X
g
S
e f ] F g ! d
< ` X
h
S
f g ] F h ! d
< ` X
i
S
g h ] F i ! d
< ` X
j
S
h i ] F j ! d
< ` X
k
S
i j ] F k ! d
< ` X
l
S
j k ] F l ! d
< ` X
m
S
k l ] F m ! d
< ` X
n
S
l m ] F n ! d
< ` X
o
S
m n ] F o ! d
< ` X
p
S
n o ] F p ! d
< ` X
q
S
o p ] F q ! d
< ` X
r
S
p q ] F r ! d
< ` X
s
S
q r ] F s ! d
< ` X
t
S
r s ] F t ! d
< ` X
u
S
s t ] F u ! d
< ` X
v
S
t u ] F v ! d
< ` X
w
S
u v ] F w ! d
< ` X
x
S
v w ] F x ! d
< ` X
y
S
w x ] F y ! d
< ` X
z
S
x y ] F z ! d
< ` X
{
S
y z ] F { ! d
< ` X
|
S
z { ] F | ! d
< ` X
}
S
{ | ] F } ! d
< ` X
~
S
| } ] F ~ ! d
< ` X
S
} ~ ] F ! d
< ` X
S
~ ] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
< ` X
S
] F ! d
> @ } } z A
V V V
g g
g W ! ) j)
d MbP?_ * + % & ?' ?( '}'}?) '}'}?M d , , " d ,, ` `? ` `? U
} } @[ } } B[ W \ ^
^ ^ ^ ^ ^ ^
\
\ g
]
\ h
\
\
]
\
i
[ j ~
b
B
[ k
l
B
[ m
n
o
[ p
^
^ q ~
^ f
^
^ B
_ k
l
B
[ r
V
W
s
t
o
[ u
^ &
_ v ~
^ v
^
^ B
_ k
l
B
[ r
t
o
[ w
^
_ x ~
^ F
^
^ B
_ k
l
B
[ r
t
o
[ y
^ 8
_ z ~
^ B
^
^ B
_ k
l
B
[ r
t
o
[ y
^
_ { ~
^ B
^
^ B
_ k
l
B
[ r
t
o
[ |
^ @
_ } ~
^ F
^
^ B
_ k
l
B
[ r
t
o
[ w
^ 1
_ ~ ~
^ F
^
^ B
_ k
l
B
[ r 6 p b * * T * * * T * * T * * T * * T * * T * * T " ^ # $ % ' ^ ( ) + ^ , - / ^ 0 1 3 ^ 4 5 7 8 9 : < = > ?
t
o
[ w
" ^ Y
" _ ~
" ^ R
" ^
" ^ B
" _ k
# l
# B
# [ r
$ V
$ W
$ [
% t
% o
% [ w
' ^
' _ ~
' ^
' ^
' ^ B
' _ k
( l
( B
( [ r
) t
) o
) [ w
+ ^ #
+ _ ~
+ ^
+ ^
+ ^ B
+ _ k
, l
, B
, [ r
- t
- o
- [ w
/ ^
/ _ ~
/ ^ B
/ ^
/ ^ B
/ _ k
0 l
0 B
0 [ r
1 t
1 o
1 [ w
3 ^
3 _ ~
3 ^ B
3 ^
3 ^ B
3 _ k
4 l
4 B
4 [ r
5 t
5 o
5 [ w
7
7 [ ~
7
7
7 B
7 _ k
8 l
8 B
8 [
9 V
9 W
9 [
: t
: o
: [ w
< [
< [ ~
< f
<
< B
< _ k
= l
= B
= [
> V
> W
> [
? t
? o
? [ w 6 4 * T * * * T * * T * * T * * T * * T * * * T * * V
V f " P H 0 (
> 6 @ < < < g g
Oh +'0 0 8 P
t ' Dave Vieglais Microsoft Macintosh Excel @ vs!<
՜. +,0 H P X ` h p
x '
Functions Exceptions Worksheets
F$ Microsoft Excel 97 - 2004 Worksh C o m p O b j p eet Biff8 Excel.Sheet.8 9q