Module: Code42::API::User

Included in:
Client
Defined in:
lib/code42/api/user.rb

Instance Method Summary collapse

Instance Method Details

#block_user(id) ⇒ Object

Block a user from logging in

Returns:

  • true if blocked



60
61
62
 
# File 'lib/code42/api/user.rb', line 60

def block_user(id)
  put("UserBlock/#{id}")
end

#create_user(attrs = {}) ⇒ Code42::User

Creates a user

Examples:

client.create_user(:username => 'testuser', password: 'letmein', email: '[email protected]', org_id: 3)

Parameters:

  • attrs (Hash) (defaults to: {}) —

    A hash of attributes to assign to created user

Returns:



11
12
13
 
# File 'lib/code42/api/user.rb', line 11

def create_user(attrs = {})
  object_from_response(Code42::User, :post, "user", attrs)
end

#find_user_by_channel_id(channel_id = 1) ⇒ Code42::User

Returns a user for a given channel id

Parameters:

  • channel_id (String, Integer) (defaults to: 1) —

    A code42 User

Returns:



40
41
42
 
# File 'lib/code42/api/user.rb', line 40

def find_user_by_channel_id(channel_id = 1)
  object_from_response(Code42::User, :get, "userChannel?channelCustomerId=#{channel_id}")
end

#find_user_by_id(id = 'my', params = {}) ⇒ Object

Returns a user for a given id



27
28
29
 
# File 'lib/code42/api/user.rb', line 27

def find_user_by_id(id = 'my', params = {})
  object_from_response(Code42::User, :get, "user/#{id}", params)
end

#find_user_by_username(username, params = {}) ⇒ Object

Returns a user for a given username



32
33
34
35
 
# File 'lib/code42/api/user.rb', line 32

def find_user_by_username(username, params = {})
  params.merge!(username: username)
  users(params).first
end

#unblock_user(id) ⇒ Object

Unblock a previously blocked user

Returns:

  • true if unblocked



67
68
69
 
# File 'lib/code42/api/user.rb', line 67

def unblock_user(id)
  delete("UserBlock/#{id}")
end

#user(id_or_username = "my", params = {}) ⇒ Code42::User

Returns information for a given user

Parameters:

  • id_or_username (String, Integer) (defaults to: "my") —

    A code42 user ID or username

Returns:



18
19
20
21
22
23
24
 
# File 'lib/code42/api/user.rb', line 18

def user(id_or_username = "my", params = {})
  if id_or_username.is_a?(Fixnum) || id_or_username == 'my'
    find_user_by_id id_or_username, params
  else
    find_user_by_username id_or_username, params
  end
end

#user_exists?(username) ⇒ Boolean

Check if user exists with given username.

Returns:

  • (Boolean) 


53
54
55
 
# File 'lib/code42/api/user.rb', line 53

def user_exists?(username)
  users(username: username).present?
end

#users(params = {}) ⇒ Array

Returns a list of up to 100 users

Parameters:

  • params (Hash) (defaults to: {}) —

    A hash of parameters to match results against

Returns:

  • (Array) —

    An array of matching users



47
48
49
50
 
# File 'lib/code42/api/user.rb', line 47

def users(params = {})
  params.merge!(key: 'users')
  objects_from_response(Code42::User, :get, 'user', params)
end