Page History

...

Guidelines for the exchange of usage statistics from a repository to a central server using OAI-PMH and OpenURL Context Objects.

The abstract describes what the application profile is about. It should contain a problem definition, the standards described by the application profile and the goal of the application profile.

Wiki Markup

From here, content can be added. Remember to start chapters with <ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="c1c32708-7747-4996-91c4-b7ae48e09951"><ac:parameter ac:name="">Chaptername</ac:parameter></ac:structured-macro>and include \[#Chaptername\] in the Table of contents.
XML may be added between

...

(remove the \ to use tags)

Info
This page is maintained by: KE Usage Statistics Work Group

...

Code Block

	xml
	xml
title	Listing 2
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://schemas.xmlsoap.org/soap/envelope/ [http://schemas.xmlsoap.org/soap/envelope/]">
    <soap:Body>
        <ReportRequest
             xmlns:ctr="http://www.niso.org/schemas/sushi/counter"
            xsi:schemaLocation="http://www.niso.org/schemas/sushi/counter
             [http://www.niso.org/schemas/sushi/counter_sushi3_0.xsd]"
            xmlns="http://www.niso.org/schemas/sushi"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >
            <Requestor>
                XMLSchema-instance" >
<Requestor>
<ID>www.logaggregator.nl</ID>
                <Name>Log Aggregator</Name>
                <Email>logaggregator@surf.nl</Email>
            </Requestor>
            <CustomerReference>
                <ID>www.leiden.edu</ID>
                ID>
<Name>Leiden University</Name>
            </CustomerReference>
            <ReportDefinition Release="urn:robots-v1.xml" Name="Daily Report v1">
                <Filters>
                    <UsageDateRange>
                        <Begin>2009-12-21</Begin>
                        <Begin>2009-12-21</Begin>
<End>2009-12-22</End>
                    </UsageDateRange>
                </Filters>
            </ReportDefinition>
        </ReportRequest>
    </soap:Body>
</soap:Envelope>

Listing 2.
Note that the intent of the SUSHI request above is to see all the usage events that have occurred on 21 December 2009. The SUSHI schema was originally developed for the exhchange of COUNTER-compliant reports. In the documentation of the SUSHI XML schema, it is explained that COUNTER usage is only reported at the month level. In SURE, only daily reports can be provided. Therefore, it will be assumed that the implied time on the date that is mentioned is 0:00. The request in the example that is given thus involves all the usage events that have occurred in between 2009-12-21T00:00:00 and 2002-12-22T00:00:00.
As explained previously, the repository can respond in four different ways. If the parameters of the request are valid, and if the requested report is available, the OpenURL ContextObjects will be sent immediately. The Open URL Context Objects will be wrapped into element <Report>, as can be seen in listing 3.

...

Code Block

	xml
	xml
title	Appendix A
linenumbers	true
collapse	true

<?xml version="1.0" encoding="UTF-8"?>
<context-objects xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:dcterms="http://dublincore.org/documents/2008/01/14/dcmi-terms/"
     xmlns:sv="info:ofi/fmt:xml:xsd:sch_svc"
    xsi:schemaLocation="info:ofi/fmt:xml:xsd:ctx [http://www.openurl.info/registry/docs/info:ofi/fmt:xml:xsd:ctx]"
    xmlns="info:ofi/fmt:xml:xsd:ctx">
    <context-object timestamp="2009-07-29T08:15:46+01:00" identifier="b06c0444f37249a0a8f748d3b823ef2a">

    <referent>
        <identifier>https<referent>
<identifier>[https://openaccess.leidenuniv.nl/bitstream/1887/12100/1/Thesis.pdf<pdf]</identifier>
        <identifier>http<identifier>[http://hdl.handle.net/1887/12100<12100]</identifier>
    </referent>

    <referring-entity>
        <identifier>http<identifier>[http://www.google.nl/search?hl=nl&amp;q=beleidsregels+artikel+4%3A84&amp;meta=]"</identifier>
        <identifier>info:sid/google</identifier>
    </referring-entity>

    <requester>
        <metadata-by-val>
            <format>http<format>[http://dini.de/namespace/oas-requesterinfo</format>
            <metadata>
                requesterinfo]</format>
<metadata>
<requesterinfo xmlns="http://dini.de/namespace/oas\-
                    requesterinfo">
                    <hashed-ip>b505e629c508bdcfbf2a774df596123dd001
                    cee172dae5519660b6014056f53a</hashed-ip>
                    <hashed-c>d001cee172dae5519660b6014056f5346d05
                        e629c508bdcfbf2a774df596123d</hashed-c>
                    <hostname>uni-saarland.de</hostname>
                    <classification>institutional</classification>
                    <hashed-session>660b14056f5346d0</hashed-session>
                    <user-agent>mozilla/5.0 (windows; u; windows nt
                        5.0 (windows; u; windows nt
5.1; de; rv:1.8.1.1) gecko/20061204
                        </user-agent>
                </requesterinfo>
            </metadata>
        </metadata-by-val>
    </requester>

    <service-type>
        <metadata-by-val>
            <format>ihttp://dublincore.org/documents/2008/01/14/dcmi-terms/</format>
            <metadata>
                </format>
<metadata>
<dcterms:format>objectFile</dcterms:format>
            </metadata>
        </metadata-by-val>
    </service-type>

    <resolver>
        <identifier>http<resolver>
<identifier>[http://www.worldcat.org/libraries/53238<53238]</identifier>
    </resolver>

    <referrer>
        <identifier>info:sid/dlib.org:dlib</identifier>
    </referrer>

    </context-object>
</context-objects>

...

<?xml version="1.0" encoding="UTF-8"?>

<exclusions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="robotlist.xsd"
version="1.0"
datestamp="2010-04-10">

<sources>
<source id="l1" name="COUNTER" version="R3" datestamp="2010-04-01">COUNTER list of internet robotos</source>
<source id="l2" name="PLOS">PLOS list of internet robotos</source>
</sources>

<robot-list>
<useragent>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="e39743ddc670e4b8-7be7e8e7-4ee2427a-b7ff830b-8cdadc0e19dc3f755efc07a8"><ac:plain-text-body><![CDATA[<regEx>[^a]fish</regEx>
]]></ac:plain-text-body></ac:structured-macro>
<sourceRef id="l2"/>
</useragent>
<useragent>
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="08eb9abad9d443ea-0675315c-4cad45aa-b7c7bb1e-35ec6a897c1c8768ed6667ed"><ac:plain-text-body><![CDATA[<regEx>[+:,\.\;\/
]]></ac:plain-text-body></ac:structured-macro>
-]bot</regEx>
<sourceRef id="l2"/>
</useragent>
<useragent>
<regEx>acme\.spider</regEx>
<sourceRef id="l2"/>
</useragent>
<useragent>
<regEx>Brutus\/AET</regEx>
<sourceRef id="l1"/>
<sourceRef id="l2"/>
</useragent>
<useragent>
<regEx>Code\sSample\sWeb\sClient</regEx>
<sourceRef id="l1"/>
</useragent>

</robot-list>

</exclusions>

...

Child pages

Versions Compared

Old Version 25

New Version 26

Key