One of the many great benefits of Resource-Oriented Architecture is that resource representations are versioned. When contract-breaking changes are made to a RESTful Web service a new version is created and full support for the previous version continues … for a long time. Thus, client applications are free to adopt new versions at their convenience. As even newer versions are created, over time the costs and risks associated with maintaining multiple versions increase. Eventually, older versions are ‘deprecated’ (i.e. there’s plan for retiring the code and its communicated to clients). And finally, the day comes when a deprecated version is ‘obsoleted.’ At that point all attempts to access that version will fail. Client applications will break unless they’ve changed to use a newer version.
About 8 months ago (i.e. “a long time”) the plan for retiring SWS v4 was communicated to client application owners (with apologies to users of the Public API: we don’t know who you are!). The day has come: SWS v4 will soon be history!
End of day on Wednesday, January 28th, SWS v4 resources will officially be retired … unless of course there’s a last minute stay of execution (unlikely).
The good news is that most client applications have already made the switch. Fantastic!
The bad news is that a few have not. If you read this and you’re in the still-using-v4 boat, please holler at firstname.lastname@example.org asap!
Goodbye, SWS v4, it’s been nice knowing you.
We released a new build of SWS last week which adds a new resource, Section Status by Course. You can now get Add Code Requirements, Space Available, Section Status (open/closed), and more for all of the sections in a given course.
All sections in a given course:
This resource requires a separate authorization from the Office of the Registrar. Write to sws-support to request access.
Last week’s deployment also included enhancements to the Degree Audit resources and numerous bug fixes. See Production Release Log for more details.
Updated today, blogging today!
We released an update to Student Web Service this morning. It fixes several bugs and adds attributes to the Section resource, including Final Exam information, Section Start and End dates, Institute Name, and Student Credit Hours.
An update to the SWS web service was released on September 10th, 2012. New v5 resources have been added to allow MyPlan and other clients to request degree audits on behalf of students. It includes updates to the section resource to now display the new fields ‘institute name’ and ‘joint sections’. Course search was modified to have an option to exclude courses that have no sections offered. The ‘search with no quarter’ option in section search was updated so that it can now filter based on the delete flag field in order to show active, withdrawn or suspended sections. Numerous other bug fixes have also been incorporated into this release.
More information is available on the SWS client wiki.
An enhancement to HRP WS has been released in production this morning. Appointee search can now be narrowed down by employee type (ie. faculty) to get the specific employee type in the payload. Refer to client wiki for more detail.
The product of a joint project between UWIT and OPB, this new REST Space Web Service provides near real-time, authoritative data about University facilities and rooms. The data are currently sourced from the Space Inventory Management System (SIMS) and the standard UW Business Web Service formats are available (XML, JSON, XHTML).
Please see the online documentation for information about the API, support policy, and how to get access.
Think about the mashable possibilities with facility center point, room capacity, room square feet, and more!
Way back in early April we released an update to the Financial Web Service and I volunteered to blog about it. Several reminders later, head hanging in shame, I’m finally getting it done….
We made some exciting additions to the web service. There are new resources for Biennium and Biennium Search. You can search for bienniums (that’s correct, btw, I looked it up, so there) or call biennium/current, biennium/next, or biennium/previous to get the current, next, or previous biennium.
There are new resources for the Account based information in FIN:
- Fund Search
- General Ledger Account
- General Ledger Account Search
- Revenue Search
- Expenditure Search
- Account Search (which returns links to Fund, General Ledger Account, Revenue, and Expenditure resources)
The new resources are all available in xml, json, or xhtml.
We also did a few bug fixes and some more of the enhancements that you requested. For instance, we increased the maximum size of a search result set from 200 to 500.
Since the changes were all additions rather than modifications of existing elements, we kept the major version at v1.
Next time I pledge to blog sooner!
You can now be authorized to use your UW NetID and password to login to UW Business Web Services that have enabled this feature. So far, the only service to offer this feature is the Student Web Service (also requires Entrust Token for two-factor security), but it can be enabled for the other services such as PWS, FWS, or HRP if there is interest. This Web Login support will be enabled for the forthcoming SpaceWS service.
Web Login support is particularly helpful for developers who want to browse the service without an X509 certificate installed in their browser. X509 certificates are still required for programmatic access
A new SWS release last month has added an additional search capability to the Section and a couple of new attributes to the Term and Section resources. Section search now supports requests without the quarter parameter and returns a list of all the sections that a course has been offered. TimeSchedulePublished and TimeScheduleLinkAbbreviation have been addeded to the Term and Section resources respectively. More information is available on the SWS client wiki.