ArcGIS Developers

PortalGroup Class

class Esri::ArcGISRuntime::PortalGroup

Represents a group within a Portal or Organization. More...

Header: #include <PortalGroup>
Since: Esri::ArcGISRuntime 100.0
Inherits: Esri::ArcGISRuntime::Object and Esri::ArcGISRuntime::JsonSerializable

This class was introduced in Esri::ArcGISRuntime 100.0.

Public Functions

virtual ~PortalGroup() override
Esri::ArcGISRuntime::PortalAccess access() const
QStringList admins() const
QDateTime created() const
void fetchGroupUsers()
QString groupDescription() const
QString groupId() const
bool isInvitationOnly() const
bool isViewOnly() const
QDateTime modified() const
QString owner() const
QString phone() const
Esri::ArcGISRuntime::Portal *portal() const
QString snippet() const
Esri::ArcGISRuntime::PortalGroupSortField sortField() const
Esri::ArcGISRuntime::PortalQuerySortOrder sortOrder() const
QStringList tags() const
QUrl thumbnailUrl() const
QString title() const
QStringList users() const

Reimplemented Public Functions

virtual QString toJson() const override
virtual QJsonObject unknownJson() const override
virtual QJsonObject unsupportedJson() const override


void fetchGroupUsersCompleted(bool success)

Static Public Members

Esri::ArcGISRuntime::PortalGroup *fromJson(const QString &json, Esri::ArcGISRuntime::Portal *portal = nullptr, QObject *parent = nullptr)

Detailed Description

Collections of fully populated PortalGroup objects can be obtained by calling Portal::findGroups, Portal::fetchFeaturedGroups, and PortalItem::fetchGroups, and from the PortalUser::groups property. The load status of such objects is LoadStatus::Loaded.

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.

See also PortalUser, PortalItem, and Portal Group (ArcGIS REST API).

Member Function Documentation

[signal] void PortalGroup::fetchGroupUsersCompleted(bool success)

Signal emitted when the fetchGroupUsers operation is complete.

  • success - Whether fetching group users completed successfully.

This function was introduced in Esri::ArcGISRuntime 100.1.

[override virtual] PortalGroup::~PortalGroup()


Esri::ArcGISRuntime::PortalAccess PortalGroup::access() const

Returns the access level for the group.

QStringList PortalGroup::admins() const

Returns a list of users that are administrators of this group.

QDateTime PortalGroup::created() const

Returns the date the group was created.

Always a Gregorian calendar using UTC time zone and English locale.

void PortalGroup::fetchGroupUsers()

Starts an operation to fetch users and administrators of the group.

The fetchGroupUsersCompleted indicates when the operation is complete and errorOccurred will be emitted if there was a problem.

See also Error.

[static] Esri::ArcGISRuntime::PortalGroup *PortalGroup::fromJson(const QString &json, Esri::ArcGISRuntime::Portal *portal = nullptr, QObject *parent = nullptr)

Creates a new PortalGroup from json with an optional portal and parent.

The PortalGroup will be created using the following arguments:

  • json. The JSON representation of the portal user.
  • portal (optional). A Portal object for use by the PortalUser.
  • parent (optional). A QObject object used as parent.

To fetch data from an online portal, the JSON must contains the "id" parameter, and portal must be valid.

const QString json = QStringLiteral(" { \"id\": \"12345678901234567890123456789012\" }");
PortalGroup* portalGroup = PortalGroup::fromJson(json, portal, parent);

This function was introduced in Esri::ArcGISRuntime 100.1.

See also JsonSerializable.

QString PortalGroup::groupDescription() const

Returns the group's description.

QString PortalGroup::groupId() const

Returns the group's ID.

bool PortalGroup::isInvitationOnly() const

Returns whether the group membership is invitation-only.

bool PortalGroup::isViewOnly() const

Returns whether the group membership is view-only.

QDateTime PortalGroup::modified() const

Returns the date the group was last modified.

Always a Gregorian calendar using UTC time zone and English locale.

QString PortalGroup::owner() const

Returns the username of the owner of the group.

QString PortalGroup::phone() const

Returns the telephone number of the group.

Esri::ArcGISRuntime::Portal *PortalGroup::portal() const

Returns the portal this group belongs to.

QString PortalGroup::snippet() const

Returns the summary description snippet for this group.

Esri::ArcGISRuntime::PortalGroupSortField PortalGroup::sortField() const

Returns the field that items in this group are sorted by.

Esri::ArcGISRuntime::PortalQuerySortOrder PortalGroup::sortOrder() const

Returns the sort order for items in this group.

QStringList PortalGroup::tags() const

Returns the user-defined tags that describe the group.

Queries can use the tags field to find groups with particular tags.

See also PortalQueryParametersForGroups.

QUrl PortalGroup::thumbnailUrl() const

Returns the URL of the thumbnail used for the group.

All group thumbnails are relative to the URL: http://<community-url>/groups/<groupId>/info.

QString PortalGroup::title() const

Returns the title of the group.

[override virtual] QString PortalGroup::toJson() const

Reimplements: JsonSerializable::toJson() const.

Returns the PortalGroup as a JSON string representation.

See also JsonSerializable.

[override virtual] QJsonObject PortalGroup::unknownJson() const

Reimplements: JsonSerializable::unknownJson() const.

Returns the unknown JSON of this object.

See also JsonSerializable.

[override virtual] QJsonObject PortalGroup::unsupportedJson() const

Reimplements: JsonSerializable::unsupportedJson() const.

Returns the unsupported JSON of this object.

See also JsonSerializable.

QStringList PortalGroup::users() const

Returns a list of strings representing users of the group.

Feedback on this topic?