Oracle Beehive
  Oracle® Beehive RESTful Web Services API Reference
  Release 2 (2.0.1.7)
  E16658-04

Contents

Overview

This type represents a group contact.

Members

Name Type Required Description

addresses

entityAddress[]

Addresses of the AddressesBookElement.

agents

agent[]

Members of this GroupContact. These members are present in the directory only. The members are of type Agent.

alias

string

Alias of the element. Note that this is distinct from the name or nickname of the element.

attachedMarkers

marker[]

Set of marker elements associated with the entity.

attachedReminders

reminder[]

List of reminders attached to the entity

attachedSubscriptions

subscription[]

List of subscriptions attached to the entity

attachments

anyType[]

Attachments to the AddressBookElement.

autoCreated

boolean

Checks if this element has been created automatically. When a user/group/resource is added to a team workspace, a bookmarked contact is automatically created in the default team workspace address book. The type of contact created depends on the entity added to the workspace i.e. PersonContact for OrganizationUser, GroupContact for Group, ResourceContact for Resource. The automatically created contacts are read-only.

bonds

bond[]

List of artifact bonds

bookmark

group

Bookmark to the group entry in the directory.

buddyListEntry

boolean

Checks if this element is also included in the owner's buddy list.

changeStatus

changeStatus

The change status of the artifact

collabId

beeId

CollabId of the snapshot

createdOn

dateTime

Entity's creation date

creator

actor

The actor that created this entity

deleted

boolean

Deletion flag. If this property is set to true the entity is deleted.

elements

addressBookElement[]

Members of this GroupContact. These members are present in the address book. The members are of type AddressBookElement.

externalMembers

externalContact[]

Members of this GroupContact. These are members which are not present in the directory or the AddressBook. The members are of type ExternalContact.

favorite

anyType

(constrained to Favorite)

BuddyList if the contact is marked as BuddyList entry or PeopleList if the contact is marked as PeopleList entry

groupContacts

groupContact[]

GroupContacts to which the AddressBookElement directly belongs.

groupName

string

Group name of this GroupContact The group name is distinct from the name as in entity which is used as the display name.

memberDisplayedInPeopleList

boolean

Checks if the members of the GroupContact should be displayed in PeopleList when the GroupContact is a PeopleList. While adding a GroupContact to the PeopleList, the user may choose to see the members of the GroupContact in the PeopleList. This flag is used for this purpose. Note that the service does not mark the elements of the GroupContact as PeoplList entries. If the flag is set to true, the onus is on the CSI caller to display the members of the GroupContact in the PeopleList.

members

accessor[]

Members of this GroupContact. These members are present in the directory only. The members are of type OrganizationUser, Group, Dynamic Group.

modifiedBy

actor

The actor that last modified the entity

modifiedOn

dateTime

The date when entity was last modified

name

string

Name of the entity.

parent

entity

The parent for this entity.

peopleListEntry

boolean

Checks if this element is also included in the owner's people list.

primaryAddress

entityAddress

Primary Address of the AddressBookElement.

priority

priority

Priority of the element for the current user.

properties

collabProperties

The properties of the artifact that are shared among all the actors

sensitivity

sensitivity

Sensitivity assigned to the element

size

long

Size of the AddressBookElement.

snapshotId

string

Contains the snapshot identifier for this snapshot. Snapshot identifiers are used to implement optimistic locking on the server.

speedDial

int

Speed dial number of the element for the current user. The speed dial may be set to null.

userCreatedOn

dateTime

The user creation date (if created offline)

userModifiedOn

dateTime

The user last modified date (if modified offline)

viewer

actor

The actor for which this artifact snapshot was loaded. All the artifact viewer properties in this snapshot are loaded for this actor.

viewerProperties

collabProperties

The viewer properties of the artifact that are private to loading actor

Hierarchy

Inherits From

Applied Markers

Examples

Below are examples in JSON and XML formats. All examples are shown with all inherited members. Quoting when required is part of the examples, but you must obviously populate with your own data.

XML Example

(show inherited members)

<obh:groupContact xsi:type="obh:groupContact" xmlns:obh="http://www.oracle.com/beehive" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <obh:addresses>your_entityAddress_0</obh:addresses>
        <obh:addresses>your_entityAddress_1</obh:addresses>
        <obh:addresses>your_entityAddress_2</obh:addresses>
        <obh:agents>your_agent_0</obh:agents>
        <obh:agents>your_agent_1</obh:agents>
        <obh:agents>your_agent_2</obh:agents>
        <obh:alias>your_string_0</obh:alias>
        <obh:attachedMarkers>your_marker_0</obh:attachedMarkers>
        <obh:attachedMarkers>your_marker_1</obh:attachedMarkers>
        <obh:attachedMarkers>your_marker_2</obh:attachedMarkers>
        <obh:attachedReminders>your_reminder_0</obh:attachedReminders>
        <obh:attachedReminders>your_reminder_1</obh:attachedReminders>
        <obh:attachedReminders>your_reminder_2</obh:attachedReminders>
        <obh:attachedSubscriptions>your_subscription_0</obh:attachedSubscriptions>
        <obh:attachedSubscriptions>your_subscription_1</obh:attachedSubscriptions>
        <obh:attachedSubscriptions>your_subscription_2</obh:attachedSubscriptions>
        <obh:attachments>your_anyType_0</obh:attachments>
        <obh:attachments>your_anyType_1</obh:attachments>
        <obh:attachments>your_anyType_2</obh:attachments>
        <obh:autoCreated>your_boolean_0</obh:autoCreated>
        <obh:bonds>your_bond_0</obh:bonds>
        <obh:bonds>your_bond_1</obh:bonds>
        <obh:bonds>your_bond_2</obh:bonds>
        <obh:bookmark>your_group_0</obh:bookmark>
        <obh:buddyListEntry>your_boolean_0</obh:buddyListEntry>
        <obh:changeStatus>your_changeStatus_0</obh:changeStatus>
        <obh:collabId>your_beeId_0</obh:collabId>
        <obh:createdOn>your_dateTime_0</obh:createdOn>
        <obh:creator>your_actor_0</obh:creator>
        <obh:deleted>your_boolean_0</obh:deleted>
        <obh:elements>your_addressBookElement_0</obh:elements>
        <obh:elements>your_addressBookElement_1</obh:elements>
        <obh:elements>your_addressBookElement_2</obh:elements>
        <obh:externalMembers>your_externalContact_0</obh:externalMembers>
        <obh:externalMembers>your_externalContact_1</obh:externalMembers>
        <obh:externalMembers>your_externalContact_2</obh:externalMembers>
        <obh:favorite>your_anyType_0</obh:favorite>
        <obh:groupContacts>your_groupContact_0</obh:groupContacts>
        <obh:groupContacts>your_groupContact_1</obh:groupContacts>
        <obh:groupContacts>your_groupContact_2</obh:groupContacts>
        <obh:groupName>your_string_0</obh:groupName>
        <obh:memberDisplayedInPeopleList>your_boolean_0</obh:memberDisplayedInPeopleList>
        <obh:members>your_accessor_0</obh:members>
        <obh:members>your_accessor_1</obh:members>
        <obh:members>your_accessor_2</obh:members>
        <obh:modifiedBy>your_actor_0</obh:modifiedBy>
        <obh:modifiedOn>your_dateTime_0</obh:modifiedOn>
        <obh:name>your_string_0</obh:name>
        <obh:parent>your_entity_0</obh:parent>
        <obh:peopleListEntry>your_boolean_0</obh:peopleListEntry>
        <obh:primaryAddress>your_entityAddress_0</obh:primaryAddress>
        <obh:priority>your_priority_0</obh:priority>
        <obh:properties>your_collabProperties_0</obh:properties>
        <obh:sensitivity>your_sensitivity_0</obh:sensitivity>
        <obh:size>your_long_0</obh:size>
        <obh:snapshotId>your_string_0</obh:snapshotId>
        <obh:speedDial>your_int_0</obh:speedDial>
        <obh:userCreatedOn>your_dateTime_0</obh:userCreatedOn>
        <obh:userModifiedOn>your_dateTime_0</obh:userModifiedOn>
        <obh:viewer>your_actor_0</obh:viewer>
        <obh:viewerProperties>your_collabProperties_0</obh:viewerProperties>
</obh:groupContact>

JSON Example

(show inherited members)

{
    "beeType":"groupContact",
        "addresses":[
            { your_{http://www.oracle.com/beehive}addresses_as_entityAddress0 },
            { your_{http://www.oracle.com/beehive}addresses_as_entityAddress1 },
            { your_{http://www.oracle.com/beehive}addresses_as_entityAddress2 }
        ],
        "agents":[
            { your_{http://www.oracle.com/beehive}agents_as_agent0 },
            { your_{http://www.oracle.com/beehive}agents_as_agent1 },
            { your_{http://www.oracle.com/beehive}agents_as_agent2 }
        ],
        "alias":"your_{http://www.oracle.com/beehive}alias_as_string0",
        "attachedMarkers":[
            { your_{http://www.oracle.com/beehive}attachedMarkers_as_marker0 },
            { your_{http://www.oracle.com/beehive}attachedMarkers_as_marker1 },
            { your_{http://www.oracle.com/beehive}attachedMarkers_as_marker2 }
        ],
        "attachedReminders":[
            { your_{http://www.oracle.com/beehive}attachedReminders_as_reminder0 },
            { your_{http://www.oracle.com/beehive}attachedReminders_as_reminder1 },
            { your_{http://www.oracle.com/beehive}attachedReminders_as_reminder2 }
        ],
        "attachedSubscriptions":[
            { your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription0 },
            { your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription1 },
            { your_{http://www.oracle.com/beehive}attachedSubscriptions_as_subscription2 }
        ],
        "attachments":[
            "your_{http://www.oracle.com/beehive}attachments_as_anyType0",
            "your_{http://www.oracle.com/beehive}attachments_as_anyType1",
            "your_{http://www.oracle.com/beehive}attachments_as_anyType2"
        ],
        "autoCreated":your_{http://www.oracle.com/beehive}autoCreated_as_boolean0,
        "bonds":[
            { your_{http://www.oracle.com/beehive}bonds_as_bond0 },
            { your_{http://www.oracle.com/beehive}bonds_as_bond1 },
            { your_{http://www.oracle.com/beehive}bonds_as_bond2 }
        ],
        "bookmark":{ your_{http://www.oracle.com/beehive}bookmark_as_group0 },
        "buddyListEntry":your_{http://www.oracle.com/beehive}buddyListEntry_as_boolean0,
        "changeStatus":{ your_{http://www.oracle.com/beehive}changeStatus_as_changeStatus0 },
        "collabId":{ your_{http://www.oracle.com/beehive}collabId_as_beeId0 },
        "createdOn":"your_{http://www.oracle.com/beehive}createdOn_as_dateTime0",
        "creator":{ your_{http://www.oracle.com/beehive}creator_as_actor0 },
        "deleted":your_{http://www.oracle.com/beehive}deleted_as_boolean0,
        "elements":[
            { your_{http://www.oracle.com/beehive}elements_as_addressBookElement0 },
            { your_{http://www.oracle.com/beehive}elements_as_addressBookElement1 },
            { your_{http://www.oracle.com/beehive}elements_as_addressBookElement2 }
        ],
        "externalMembers":[
            { your_{http://www.oracle.com/beehive}externalMembers_as_externalContact0 },
            { your_{http://www.oracle.com/beehive}externalMembers_as_externalContact1 },
            { your_{http://www.oracle.com/beehive}externalMembers_as_externalContact2 }
        ],
        "favorite":"your_{http://www.oracle.com/beehive}favorite_as_anyType0",
        "groupContacts":[
            { your_{http://www.oracle.com/beehive}groupContacts_as_groupContact0 },
            { your_{http://www.oracle.com/beehive}groupContacts_as_groupContact1 },
            { your_{http://www.oracle.com/beehive}groupContacts_as_groupContact2 }
        ],
        "groupName":"your_{http://www.oracle.com/beehive}groupName_as_string0",
        "memberDisplayedInPeopleList":your_{http://www.oracle.com/beehive}memberDisplayedInPeopleList_as_boolean0,
        "members":[
            { your_{http://www.oracle.com/beehive}members_as_accessor0 },
            { your_{http://www.oracle.com/beehive}members_as_accessor1 },
            { your_{http://www.oracle.com/beehive}members_as_accessor2 }
        ],
        "modifiedBy":{ your_{http://www.oracle.com/beehive}modifiedBy_as_actor0 },
        "modifiedOn":"your_{http://www.oracle.com/beehive}modifiedOn_as_dateTime0",
        "name":"your_{http://www.oracle.com/beehive}name_as_string0",
        "parent":{ your_{http://www.oracle.com/beehive}parent_as_entity0 },
        "peopleListEntry":your_{http://www.oracle.com/beehive}peopleListEntry_as_boolean0,
        "primaryAddress":{ your_{http://www.oracle.com/beehive}primaryAddress_as_entityAddress0 },
        "priority":{ your_{http://www.oracle.com/beehive}priority_as_priority0 },
        "properties":{ your_{http://www.oracle.com/beehive}properties_as_collabProperties0 },
        "sensitivity":{ your_{http://www.oracle.com/beehive}sensitivity_as_sensitivity0 },
        "size":your_{http://www.oracle.com/beehive}size_as_long0,
        "snapshotId":"your_{http://www.oracle.com/beehive}snapshotId_as_string0",
        "speedDial":your_{http://www.oracle.com/beehive}speedDial_as_int0,
        "userCreatedOn":"your_{http://www.oracle.com/beehive}userCreatedOn_as_dateTime0",
        "userModifiedOn":"your_{http://www.oracle.com/beehive}userModifiedOn_as_dateTime0",
        "viewer":{ your_{http://www.oracle.com/beehive}viewer_as_actor0 },
        "viewerProperties":{ your_{http://www.oracle.com/beehive}viewerProperties_as_collabProperties0 }
}

XML Schema


<xs:complexType name="groupContact">
    <xs:complexContent>
        <xs:extension base="tns:addressBookElement">
            <xs:sequence>
                <xs:element maxOccurs="unbounded" minOccurs="0"
                    name="agents" nillable="true" type="tns:agent"/>
                <xs:element minOccurs="0" name="bookmark" type="tns:group"/>
                <xs:element maxOccurs="unbounded" minOccurs="0"
                    name="elements" nillable="true" type="tns:addressBookElement"/>
                <xs:element maxOccurs="unbounded" minOccurs="0"
                    name="externalMembers" nillable="true" type="tns:externalContact"/>
                <xs:element minOccurs="0" name="groupName" type="xs:string"/>
                <xs:element name="memberDisplayedInPeopleList" type="xs:boolean"/>
                <xs:element maxOccurs="unbounded" minOccurs="0"
                    name="members" nillable="true" type="tns:accessor"/>
            </xs:sequence>
        </xs:extension>
    </xs:complexContent>
</xs:complexType>

        

References

The following data represents the references to groupContact

Referenced By Resources

Usage Resource Method
Response GroupContact Copy
Response GroupContact Copy Batch
Request GroupContact Copy Batch
Response GroupContact Create
Request GroupContact Delete Batch
Response GroupContact List
Request GroupContact Move Batch
Request GroupContact Move Batch to Trash
Response GroupContact Read
Response GroupContact Read Batch
Request GroupContact Read Batch
Request GroupContact Undelete Batch
Response GroupContact Update

Referenced By Representaions