The world’s libraries. Connected.

WorldCat Metadata API Workshop*

28 August 2013

Shelley Hostetler, Community Manager WorldShare Platform

John Chapman, Product Manager WorldShare Metadata

Steve Meyer, Technical Platform Product Manager

The world’s libraries. Connected.

The world’s libraries. Connected.

*ceci n’est pas une webinar

The world’s libraries. Connected.

•  Explain how the WorldCat Metadata API can add value to

your library

•  Demonstrate what you need to know to get started

implementing an application

Workshop Goals

The world’s libraries. Connected.

Agenda

• WorldCat Metadata API overview • Use Cases • Technical implementation details • Q & A • Resources

The world’s libraries. Connected.

Write access to WorldCat.

The world’s libraries. Connected.

Data entities and actions

WorldCat Holdings

Set Delete

Master Bib Records

Create Read Update

Local Bib Data

Records

Create Read Update Delete

The world’s libraries. Connected.

Same pipelines that we use.

The world’s libraries. Connected.

Built for “online.”

The world’s libraries. Connected.

1. Holdings setting/deletion

2. Adding new bib records

3. Replacing bib records

4. Local bib data actions

Use cases

The world’s libraries. Connected.

1. “Are our holdings

up-to-date?”

The world’s libraries. Connected.

2. “We have lots of unique material.”

or…

The world’s libraries. Connected.

“We have non-expert users.”

The world’s libraries. Connected.

3. “Those records

were added years ago.”

The world’s libraries. Connected.

4. “WorldCat is our discovery layer.”

The world’s libraries. Connected.

1.  Go to oclc.org/developer/news

2.  Pick “Services” facet under “Categories”

3.  Read the two most recent postings…

Consistent design

The world’s libraries. Connected.

Getting started

The world’s libraries. Connected.

DEMO

Housekeeping: configuration

OCLC is providing this code for demonstration purposes and on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using the code and assume any associated risks.

The world’s libraries. Connected.

http://www.worldcat.org/wskey/v2/hmac/v1

clientId="dz4ES5H4qHHOs713zqL4AnmqFukywjcpTNv3Eeh5T7CeKebc4a5vEGR

d3IR3Ou4BKx6bZ6B0f82vty9J", timestamp="1377607207",

nonce="907471678391287835943536888104",

signature="fX3Fg60WoPgQHzt7pUEg2ou2XFtW0cG364RxZegzuvo=",

principalID="201571dd-b197-42e1-bd36-9fea403a864d",

principalIDNS="urn:oclc:wms:da"

Housekeeping: AuthNZ

Housekeeping: API Key

Housekeeping: Request Signing

http://oclc.org/developer/platform/authentication/hmac-signature

HTML Rendering display a single record

Load Dependencies

Models & Helpers

Web Form for New Record

Create New Record from User Supplied Data

Read an Existing WorldCat Record for Editing

Update Existing WorldCat Record with User Input

Closer Look @ Reads & Updates

Model: Bib

Model: Bib#read

Model: Bib#parse_marc

Model: Bib#update

Helpers: Marshalling MARC

Helpers: Marshalling MARC

OCLC is providing this code for demonstration purposes and on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using the code and assume any associated risks.

The world’s libraries. Connected.

• Sign up for a WorldCat.org account

• Request a WSKey in OCLC’s

Service Configuration

https://worldcat.org/config

How can you write real (better) code?

The world’s libraries. Connected.

• Principal ID and Principal ID

Namespace (IDNS)

• Provisioning your institution in IDM

• ceci n’est pas une sandbox http://oclc.org/developer/documentation/worldcat-metadata-api/worldcat-metadata-api-sandbox-testing

Caveats

The world’s libraries. Connected.

•  About the WorldCat Metadata API

•  http://www.oclc.org/en-US/worldshare-metadata/worldcat-apis.html

•  http://www.youtube.com/watch?v=GipHY_ZgAKU&feature=youtu.be

•  Web service documentation

•  http://oclc.org/developer/services/worldcat-metadata-api

•  Assistance

•  DeveloperNetwork@oclc.org

Resources

The world’s libraries. Connected.

Join the OCLC Developer Network and listserv

•  www.oclc.org/developer/register

•  http://oc.lc/subscribewc-devnet-l

Get inspired and keep learning

•  www.oclc.org/developer/contribute

Join the community

The world’s libraries. Connected.

This Workshop Brought to You By

http://www.oclc.org/developer