8 Oracle Beehive RESTful Web Services Notes

This module contains the following type of information on Oracle Beehive RESTful Web Services:

• Known Issues with Oracle Beehive RESTful Web Services

Known Issues with Oracle Beehive RESTful Web Services

This section contains information on known issues with Oracle Beehive Web Services, and includes the following topics:

• Resources Missing List URIs

• Other Application Development Bugs

Resources Missing List URIs

Bug 9171052. The following resources do not have /list methods. To obtain a list of these resources, first retrieve the object (the parent resource) that contains the type of resource you want to obtain. The parent resource contains a member of type listResult that contains the list of resources you want to obtain.

For example, to obtain a list of Topics, retrieve the Forums from which you want to retrieve Topics. The Forum object contains a member named topics that contains a list of Topics contained within the Forum (excluding Announcements; to retrieve both Topics and Announcements, use the member announcementsAndTopics).

In the following list, each resource is preceded by its corresponding parent resources.

Table 8-1 Resources and Their Parent Resources

Resource	Parent Resource
Forum (afrf)	PersonalWorkspace (wspr), TeamWorkspace (ttws)
Topic (afrt)	DiscussThisForum (afrd), Forum (afrf)
DiscussionsMessage (amdm)	Announcement (annc), Topic (afrt)
Announcement (annc)	DiscussThisForum (afrd), Forum (afrf)
Bond (bond)	If an object is bondable, for example, Document, it will contain a bond member that contains a list of objects to which the object is bonded.
PersonContact (cont)	AddressBook (adbk)
ExternalArtifact (exaf)	HeterogeneousFolder (afrh)
RemoteDoc (rdoc)	HeterogeneousFolder (afrh)
RemoteFolder (rfld)	HeterogeneousFolder (afrh)
RemoteShare (rshr)	HeterogeneousFolder (afrh)
Link (link)	HeterogeneousFolder (afrh)
ResourceContact (rcon)	AddressBook (adbk)
TaskList (tskl)	PersonalWorkspace (wspr)
Task (asgn)	TaskList (tskl)
Principal (pcpl)	OrganizationUser (user)
AddressBook (adbk)	PersonalWorkspace (wspr), TeamWorkspace (ttws)
DiscussionsDraft (ddft)	Forum (afrf)
GroupContact (gcon)	AddressBook (adbk)
SubscriptionList (subl)	Folder A subscription list is a container of subscription artifacts. Every user has a SubscriptionList and the user's Subscriptions are stored in the user's SubscriptionList folder.
ReminderList (reml)	PersonalWorkspace (wspr)
Subscription (subs)	SubscriptionList (subl)
Reminder (remd)	ReminderList (reml)
LabelBundle (lbdl)	Use the object's labels member, which contains a set of Labels in the object's label bundle.

The following resources do not have a /list nor does a parent resource exist for these resources:

• BookableResource (bkrs)

• Category (catg)

• DynamicGroup (dgrp)

• CategoryTemplate (ctth)

Other Application Development Bugs

This section contains the list of and descriptions for other bugs related to application development.

Table 8-2 Other Application Development Bugs

Bug Number	Description
8933814	Creating a Bond between the current logged in user and a Forum returns an Access Denied error.
9002876	Creators and updators have set methods with boolean parameters, which default to the value false if not explicitly set.
9050053	A Web service method does not exist to set VersionControlConfiguration for a containers like folders and workspaces.
9122292	Unable to read entity access control fields (with the Read Access Control method) of Labels.
9131230	Unable to create a Bond between more than two entities.
9131518	No valid response is returned when a workspace member tries to add a document to a locked folder.
9142850	No LabelApplication API exists that determines which user has applied a particular shared tag to an entity.
9148600	No Web service method exists that enables the current active principal to join a conference.
9224372	Creating a Preference Set returns an illegal argument error.
9233756	No Web service method exists to set notification delivery channels in meetingSubscription and taskSubscription.
9259058	Unable to add attendees with the Conference update method.
9278189	No Web service method exists to upload or download contact picture.
9297653	No boolean member exists for Conference to indicate whether the conference is public or now, which is used to create public conferences.
9301188	When Oracle Beehive RESTful Web Services raises a fault, it does not translate the action and effect strings to the user's preferred locale.