Class: JSS::Group

Inherits:
APIObject show all
Includes:
Creatable, Criteriable, Sitable, Updatable
Defined in:
lib/jss/api_object/group.rb,
lib/jss.rb

Overview

This is the parent class of the smart/static group objects in the JSS namely, ComputerGroup, MobileDeviceGroup, and UserGroup

It provides methods for working with the membership of static groups and, by including Criteriable, the criteria for smart groups.

When changing the criteria of a smart group, use the #criteria attribute, which is a Criteria instance.

Subclasses must define the constant MEMBER_CLASS which indicates Ruby class to which the group members belong (e.g. JSS::MobileDevice)

Direct Known Subclasses

ComputerGroup, MobileDeviceGroup, UserGroup

Constant Summary collapse

GROUP_TYPES =

the types of groups allowed for creation

%i[smart static].freeze
SITE_SUBSET =

Where is the Site data in the API JSON?

:top

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(args = {}) ⇒ Group

When creating a new group in the JSS, you must call .make with a :type key and a value of :smart or :static, as well as a :name and the :id => :new

See Also:


114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
# File 'lib/jss/api_object/group.rb', line 114

def initialize(args = {})
  if args[:id] == :new
    raise JSS::InvalidDataError, 'New group creation must specify a :type of :smart or :static' unless GROUP_TYPES.include? args[:type]
  end

  super args

  @is_smart = @init_data[:is_smart] || (args[:type] == :smart)

  @members =
    if @init_data[self.class::MEMBER_CLASS::RSRC_LIST_KEY]
      @init_data[self.class::MEMBER_CLASS::RSRC_LIST_KEY]
    else
      []
    end

  @site = JSS::APIObject.get_name(@init_data[:site])
end

Instance Attribute Details

#criteriaJSS::Criteriable::Criteria Originally defined in module Criteriable

#is_smartBoolean (readonly) Also known as: smart?


98
99
100
# File 'lib/jss/api_object/group.rb', line 98

def is_smart
  @is_smart
end

#membersArray<Hash>

Each hash contains the identifiers for a member of the group, those being:

  • :id, :name, and possibly :udid, :serial_number, :mac_address, :alt_mac_address, and :wifi_mac_address


95
96
97
# File 'lib/jss/api_object/group.rb', line 95

def members
  @members
end

#need_to_updateBoolean (readonly) Originally defined in module Updatable

#notify_on_changeBoolean (readonly) Also known as: notify_on_change?, notify?


101
102
103
# File 'lib/jss/api_object/group.rb', line 101

def notify_on_change
  @notify_on_change
end

#siteString


104
105
106
# File 'lib/jss/api_object/group.rb', line 104

def site
  @site
end

Class Method Details

.all_smart(refresh = false, api: JSS.api) ⇒ Object

Returns an Array of all the smart groups.


71
72
73
# File 'lib/jss/api_object/group.rb', line 71

def self.all_smart(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |g| g[:is_smart] }
end

.all_static(refresh = false, api: JSS.api) ⇒ Object

Returns an Array of all the static groups.


78
79
80
# File 'lib/jss/api_object/group.rb', line 78

def self.all_static(refresh = false, api: JSS.api)
  all(refresh, api: api).select { |g| (g[:is_smart]) }
end

Instance Method Details

#add_member(mem) ⇒ void

This method returns an undefined value.

Add a member, by name or id

Raises:


226
227
228
229
230
# File 'lib/jss/api_object/group.rb', line 226

def add_member(mem)
  raise UnsupportedError, "Smart group members can't be changed." if @is_smart
  @members << check_member(mem)
  @need_to_update = true
end

#clearvoid

This method returns an undefined value.

Remove all members

Raises:


249
250
251
252
253
254
# File 'lib/jss/api_object/group.rb', line 249

def clear
  raise InvalidDataError, "Smart group members can't be changed." if @is_smart
  return if @members.empty?
  @members.clear
  @need_to_update = true
end

#clone(new_name, api: nil) ⇒ APIObject Originally defined in module Creatable

make a clone of this API object, with a new name. The class must be creatable

#create(calculate_members: true) ⇒ Object

See Also:


138
139
140
141
142
143
144
145
# File 'lib/jss/api_object/group.rb', line 138

def create(calculate_members: true)
  if @is_smart
    raise JSS::MissingDataError, 'No criteria specified for smart group' unless @criteria
  end
  super()
  refresh_members if calculate_members
  @id
end

#criteria=(new_criteria) ⇒ Object

Apply a new set of criteria to a smart group

Raises:


169
170
171
172
# File 'lib/jss/api_object/group.rb', line 169

def criteria=(new_criteria)
  raise InvalidDataError, 'Only smart groups have criteria.' unless @is_smart
  super
end

#deleteObject

See Also:


157
158
159
160
161
162
163
# File 'lib/jss/api_object/group.rb', line 157

def delete
  super
  @is_smart = nil
  @criteria = nil
  @site = nil
  @members = []
end

#member_idsArray<Integer>


190
191
192
# File 'lib/jss/api_object/group.rb', line 190

def member_ids
  @members.map { |m| m[:id] }
end

#member_namesArray<String>


184
185
186
# File 'lib/jss/api_object/group.rb', line 184

def member_names
  @members.map { |m| m[:name] }
end

#name=(newname) ⇒ void Originally defined in module Updatable

This method returns an undefined value.

Change the name of this item Remember to #update to push changes to the server.

#parse_criteriavoid Originally defined in module Criteriable

This method returns an undefined value.

During initialization, convert the @init_data Hash into a JSS::Criteriable::Criteria instance stored in @criteria

Classes mixing in this module must call this in #initialize

#refresh_membersArray<Hash>

Refresh the membership from the API


260
261
262
# File 'lib/jss/api_object/group.rb', line 260

def refresh_members
  @members = @api.get_rsrc(@rest_rsrc)[self.class::RSRC_OBJECT_KEY][self.class::MEMBER_CLASS::RSRC_LIST_KEY]
end

#remove_member(mem) ⇒ void

This method returns an undefined value.

Remove a member by id, or name

Raises:


238
239
240
241
242
243
# File 'lib/jss/api_object/group.rb', line 238

def remove_member(mem)
  raise InvalidDataError, "Smart group members can't be changed." if @is_smart
  raise InvalidDataError, "Can't remove nil" if mem.nil?
  removed = @members.reject! { |mm| [mm[:id], mm[:name], mm[:username]].include? mem }
  @need_to_update = true if removed
end

#should_updatevoid Originally defined in module Criteriable

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

This method returns an undefined value.

Allow our Criteria to tell us when there's been a change that needs to be updated.

#site_assigned?Boolean Originally defined in module Sitable

Does this object have a site assigned?

#site_idInteger Originally defined in module Sitable

The id of the site for this object.

#site_nameString Also known as: site Originally defined in module Sitable

The name of the site for this object. For backward compatibility, this is aliased to just 'site'

#site_objectJSS::Site Originally defined in module Sitable

The JSS::Site instance for this object's site

#sizeInteger Also known as: count

How many members of the group?


178
179
180
# File 'lib/jss/api_object/group.rb', line 178

def size
  @members.count
end

#unset_sitevoid Originally defined in module Sitable

This method returns an undefined value.

Set the site to nothing

#updateObject

See Also:


149
150
151
152
153
# File 'lib/jss/api_object/group.rb', line 149

def update
  super
  refresh_members
  true
end