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
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