PortalGroup Class

  • PortalGroup
  • class Esri::ArcGISRuntime::PortalGroup

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

    Header: #include <PortalGroup.h>
    Since: Esri::ArcGISRuntime 100.0
    Inherits: Esri::ArcGISRuntime::Object, Esri::ArcGISRuntime::Loadable, and Esri::ArcGISRuntime::JsonSerializable

    Public Functions

    PortalGroup(Esri::ArcGISRuntime::Portal *portal, const QString &groupId, QObject *parent = nullptr)
    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 void cancelLoad() override
    virtual void load() override
    virtual Esri::ArcGISRuntime::Error loadError() const override
    virtual Esri::ArcGISRuntime::LoadStatus loadStatus() const override
    virtual void retryLoad() override
    virtual QString toJson() const override
    virtual QJsonObject unknownJson() const override
    virtual QJsonObject unsupportedJson() const override

    Signals

    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

    [since Esri::ArcGISRuntime 100.13] PortalGroup::PortalGroup(Esri::ArcGISRuntime::Portal *portal, const QString &groupId, QObject *parent = nullptr)

    Constructor that takes a portal, a groupId, and an optional parent.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    [override virtual] PortalGroup::~PortalGroup()

    Destructor.

    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.

    [override virtual, since Esri::ArcGISRuntime 100.13] void PortalGroup::cancelLoad()

    Reimplements: Loadable::cancelLoad().

    See Loadable.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    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.

    [signal, since Esri::ArcGISRuntime 100.1] 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.

    [static, since Esri::ArcGISRuntime 100.1] 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.

    [override virtual, since Esri::ArcGISRuntime 100.13] void PortalGroup::load()

    Reimplements: Loadable::load().

    See Loadable.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    [override virtual, since Esri::ArcGISRuntime 100.13] Esri::ArcGISRuntime::Error PortalGroup::loadError() const

    Reimplements: Loadable::loadError() const.

    See Loadable.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    [override virtual, since Esri::ArcGISRuntime 100.13] Esri::ArcGISRuntime::LoadStatus PortalGroup::loadStatus() const

    Reimplements: Loadable::loadStatus() const.

    See Loadable.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    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.

    [override virtual, since Esri::ArcGISRuntime 100.13] void PortalGroup::retryLoad()

    Reimplements: Loadable::retryLoad().

    See Loadable.

    This function was introduced in Esri::ArcGISRuntime 100.13.

    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.

    Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.