PortalGroup

data class PortalGroup : Loadable, JsonSerializable

Represents a group within a portal.

Collections of fully populated PortalGroup objects can be obtained by calling the Portal.waitFindGroups(PortalQueryParameters), Portal.fetchFeaturedGroupsAsync(), and PortalItem.fetchGroupsAsync() methods, and from the PortalUser.getGroups() property. The load status of such objects is LoadStatus.Loaded.

Alternatively, a PortalGroup object can be constructed using PortalGroup.PortalGroup(Portal, String) if the group ID is known. In this case the load status is initially LoadStatus.NotLoaded and the object needs to be loaded to populate its properties.

The portal group owner is automatically an administrator and is returned in the list of admins. The access property determines the visibility of the group to other users. If the group is private, no one except the administrators and the members of the group can see it. If the group is shared with an organization, then all members of the organization can see the group.

Administrators can invite, add to, and remove members from a group, and also update and delete the group. The administrator for an organization may also reassign the group to another member of the organization. Group members may leave the group. Authenticated users may apply to join a group.

Since

200.0.0

Constructors

Link copied to clipboard
fun PortalGroup(portal: Portal, groupId: String)

Constructs a PortalGroup with the given Portal and group ID.

Types

Link copied to clipboard
object Companion

Functions

Link copied to clipboard
open override fun cancelLoad()

Cancels loading metadata for the Loadable object.

Link copied to clipboard
suspend fun fetchGroupUsers(): Result<PortalGroupUsers>

Fetches users and administrators of this group.

Link copied to clipboard
suspend fun findItems(searchParams: PortalGroupContentSearchParameters): Result<PortalGroupContentSearchResultSet>

Finds portal items that belong to this group and match the given search parameters.

Link copied to clipboard
open suspend override fun load(): Result<Unit>

Loads the metadata for the object.

Link copied to clipboard
open suspend override fun retryLoad(): Result<Unit>

Loads or retries loading metadata for the object.

Link copied to clipboard
open override fun toJson(): String

Convert the PortalGroup to a JSON string.

Properties

Link copied to clipboard
val access: PortalAccess?

The access level of the group's content. Remark: If null, the access is unknown.

Link copied to clipboard
val creationDate: Instant?

The date on which the group was created.

Link copied to clipboard
val description: String

The description of the group.

Link copied to clipboard
val id: String

the ID of the group

Link copied to clipboard
val isInvitationOnly: Boolean

The property indicates whether the group will not accept join requests. If true, only group owners and admins can invite users to the group. Otherwise, this group does not require an invitation to join.

Link copied to clipboard
val isViewOnly: Boolean

The property indicates the group is view only or not. Users cannot share items with view only groups.

Link copied to clipboard
open override val loadStatus: StateFlow<LoadStatus>

The load status.

Link copied to clipboard
val modificationDate: Instant?

The date on which the group was modified.

Link copied to clipboard
val owner: String

The user who created the group.

Link copied to clipboard
val phone: String

The contact information for the group.

Link copied to clipboard
val portal: Portal

the Portal in which this group exists

Link copied to clipboard
val snippet: String

Snippet or summary of the group with a character limit of 250 characters.

Link copied to clipboard
val sortField: PortalGroupSortField?

The sort field for the group's content.

Link copied to clipboard
val sortOrder: PortalQuerySortOrder

The sort order for the group's content.

Link copied to clipboard
val tags: List<String>

A list of words or short phrases that describe the group.

Link copied to clipboard
val thumbnail: LoadableImage?

The thumbnail image of the group. If it is null, there is no group thumbnail. Otherwise, the image needs to be loaded asynchronously by using LoadableImage.load.

Link copied to clipboard
val title: String

The group title.

Link copied to clipboard
open override val unknownJson: Map<String, Any>

Unknown data from the source JSON. Unknown JSON is a dictionary of values that was in the source JSON but was unparsed by this API.

Link copied to clipboard
open override val unsupportedJson: Map<String, Any>

Unsupported data from the source JSON. Unsupported JSON is a dictionary of values that are supported by web maps, but not exposed through this API.