ASN Resolver Web Service Documentation

Summary of available requests

See the Service Explorer


ServiceInfo

Summary and usage

The ServiceInfo requests is used to retrieve general information about this Web service including name, description, the URL used to access the service (base URL), service version and an administrator e-mail.

Sample request

The following request displays information about this Web service:

http://uc.dls.ucar.edu/asn/service.do?verb=ServiceInfo

Arguments

None

Example

Request

Display information about the Web service

http://www.dlese.org/dds/services/ddsws1-1?verb=ServiceInfo

Response

<?xml version="1.0" encoding="UTF-8" ?> 
<DDSWebService>
  <ServiceInfo>
    <serviceName>
      Digital Library for Earth System Education (DLESE) 
      discovery Web service
    </serviceName>
    <baseURL>http://www.dlese.org/dds/services/ddsws1-1</baseURL>
    <serviceVersion>1.1</serviceVersion>
    <adminEmail>support@dlese.org</adminEmail>
    <compression>gzip</compression>
    <description> ... description here ... </description>
  </ServiceInfo>
</DDSWebService>

Errors and exceptions

None

GetStandard

Summary and usage

The GetStandards request is used to retrieve information about a particular standard, including the Standard Document, the standard's ancestors and the standard's children.

Sample request

The following request displays information about the ASN Standard "S100C78F"

http://uc.dls.ucar.edu/asn/service.do?verb=GetStandard&id=S100C78F

Arguments

Example

Request

Display information about the Web service

http://uc.dls.ucar.edu/asn/service.do?verb=GetStandard&id=S100C78F

Response

<?xml version="1.0" encoding="UTF-8" ?>
<ASNWebService>
  <GetStandard>
    <resultInfo>
    </resultInfo> 
    <result>
      <StandardDocument>
        <Identifier>http://asn.jesandco.org/resources/D1000152</Identifier>
        <Jurisdiction>AAAS</Jurisdiction>
        <Subject>Science</Subject>
        <Title>Benchmarks for Science Literacy</Title>
        <Description>Benchmarks for Science Literacy</Description>
        <FileCreated>2011-03-07</FileCreated>
        <Created>1993</Created>
        <ExportVersion>3.1.0</ExportVersion>
      </StandardDocument>
      <Standard>
        <Identifier>http://asn.jesandco.org/resources/S100C78F</Identifier>
        <StartGradeLevel>0</StartGradeLevel>
        <EndGradeLevel>12</EndGradeLevel>
        <StatementNotation></StatementNotation>
        <Text>B. Scientific Inquiry</Text>
        <Parent>
          <Standard>
            <Identifier>http://asn.jesandco.org/resources/S101EC0F</Identifier>
            <StartGradeLevel>0</StartGradeLevel>
            <EndGradeLevel>12</EndGradeLevel>
            <StatementNotation></StatementNotation>
            <Text>1. THE NATURE OF SCIENCE</Text>
            <Parent>
              <Standard>
                <Identifier>http://asn.jesandco.org/resources/D1000152</Identifier>
                <StartGradeLevel>0</StartGradeLevel>
                <EndGradeLevel>12</EndGradeLevel>
                <StatementNotation></StatementNotation>
                <Text>Benchmarks for Science Literacy</Text>
                <Parent/>
              </Standard>
            </Parent>
          </Standard>
        </Parent>
        <Children>
          <Child>http://asn.jesandco.org/resources/S101D6C8</Child>
          <Child>http://asn.jesandco.org/resources/S1015686</Child>
          <Child>http://asn.jesandco.org/resources/S10071BC</Child>
          <Child>http://asn.jesandco.org/resources/S100F4B8</Child>
        </Children>
      </Standard>
    </result>
  </GetStandard>
</ASNWebService>

Errors and exceptions

If the provided id argument does not resolve to an ASN Standard

<?xml version="1.0" encoding="UTF-8" ?>
<ASNWebService>
  <error>No standard found for asnId: http://asn.jesandco.org/resources/S100C78Fa</error>
</ASNWebService>

ListStandards

Summary and usage

The ListStandards request is used to retrieve information about a list of ASN standards, and provides the same information as the GetStandard request, only for each id in a list of ids.

Sample request

The following request displays information about the ASN Standards "S100C78F" and "S104B58A"

http://uc.dls.ucar.edu/asn/service.do?verb=ListStandards&id=S100C78F&id=S104B58A

Arguments

Example

Request

Display information about ASN Standards S100C78F and S104B58A

http://uc.dls.ucar.edu/asn/service.do?verb=ListStandards&id=S100C78F&id=S104B58A

Response

<?xml version="1.0" encoding="UTF-8" ?>
<ASNWebService>
  <ListStandards>
    <resultInfo></resultInfo>
    <results>
      <result>
        <StandardDocument>
          <Identifier>http://asn.jesandco.org/resources/D1000152</Identifier>
          <Jurisdiction>AAAS</Jurisdiction>
          <Subject>Science</Subject>
          <Title>Benchmarks for Science Literacy</Title>
          ...
        </StandardDocument>
        <Standard>
          <Identifier>http://asn.jesandco.org/resources/S100C78F</Identifier>
          <StartGradeLevel>0</StartGradeLevel>
          <EndGradeLevel>12</EndGradeLevel>
          <StatementNotation/>
          <Text>B. Scientific Inquiry</Text>
          <Parent>
            ...
          </Parent>
          <Children>
            <Child>http://asn.jesandco.org/resources/S101D6C8</Child>
            <Child>http://asn.jesandco.org/resources/S1015686</Child>
            ...
          </Children>
        </Standard>
      </result>
      <result>
        <StandardDocument>
          <Identifier>http://asn.jesandco.org/resources/D1000306</Identifier>
          <Jurisdiction>AZ</Jurisdiction>
          <Subject>The Arts</Subject>
          <Title>Arizona Music Standards</Title>
          ...
        </StandardDocument>
        <Standard>
          <Identifier>http://asn.jesandco.org/resources/S104B58A</Identifier>
          <StartGradeLevel>6</StartGradeLevel>
          <EndGradeLevel>12</EndGradeLevel>
          <StatementNotation/>
          <Text>Performing Ensembles: Band</Text>
          <Parent>
            ...
          </Parent>
          <Children>
            <Child>http://asn.jesandco.org/resources/S104B58C</Child>
          </Children>
        </Standard>
      </result>
    </results>
  </ListStandards>
</ASNWebService>

Errors and exceptions

If a provided id argument does not resolve to an ASN Standard, a warning element is inserted in the resultInfo element. Ids that DO resolve to an ASN Standard are shown in the response. In the response below, an ASN standard was NOT found for "http://asn.jesandco.org/resources/S100C78FXX", but an ASN standard WAS found for "http://asn.jesandco.org/resources/S104B58A".

<?xml version="1.0" encoding="UTF-8" ?>
<ASNWebService>
  <ListStandards>
    <resultInfo>
      <warnings>
        <warning>Standard not found for http://asn.jesandco.org/resources/S100C78FXX</warning>
      </warnings>
    </resultInfo>
    <results>
      <result>
        <StandardDocument>
          <Identifier>http://asn.jesandco.org/resources/D1000306</Identifier>
          <Jurisdiction>AZ</Jurisdiction>
					...
        </StandardDocument>
        <Standard>
          <Identifier>http://asn.jesandco.org/resources/S104B58A</Identifier>
          <StartGradeLevel>6</StartGradeLevel>
          ...
        </Standard>
      </result>
    </results>
  </ListStandards>
</ASNWebService>