Class: Jamf::Printer

Inherits:
APIObject show all
Includes:
Categorizable, Creatable, Updatable
Defined in:
lib/jamf/api/classic/api_objects/printer.rb

Overview

Printer object inside JSS

See Also:

Constant Summary collapse

RSRC_BASE =

The base for REST resources of this class

'printers'.freeze
RSRC_LIST_KEY =

the hash key used for the JSON list output of all objects in the JSS

:printers
RSRC_OBJECT_KEY =

The hash key used for the JSON object output It’s also used in various error messages

:printer
CATEGORY_SUBSET =

Where is the Category in the API JSON?

:top
CATEGORY_DATA_TYPE =

How is the category stored in the API data?

String

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(**args) ⇒ Printer

Returns a new instance of Printer.



91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 91

def initialize(**args)
  super

  if in_jss?

    @uri = @init_data[:uri]
    @CUPS_name = @init_data[:CUPS_name]
    @location = @init_data[:location]
    @model = @init_data[:model]
    @shared = @init_data[:shared]
    @info = @init_data[:info]
    @notes = @init_data[:notes]
    @make_default = @init_data[:make_default]
    @use_generic = @init_data[:use_generic]
    @ppd = @init_data[:ppd]
    @ppd_contents = @init_data[:ppd_contents]
    @ppd_path = @init_data[:ppd_path]
    @os_requirements = @init_data[:os_requirements]
  else

    raise Jamf::MissingDataError, 'CUPS_name must be provided.' if @init_data[:CUPS_name].nil?
    raise Jamf::MissingDataError, 'uri must be provided.' if @init_data[:uri].nil?

    raise Jamf::InvalidDataError, 'uri must be a String.' unless @init_data[:uri].is_a?(String) || @init_data[:uri].nil?
    raise Jamf::InvalidDataError, 'CUPS_name must be a String.' unless @init_data[:CUPS_name].is_a?(String)
    raise Jamf::InvalidDataError, 'location must be a String.' unless @init_data[:location].is_a?(String) || @init_data[:location].nil?
    raise Jamf::InvalidDataError, 'model must be a String.' unless @init_data[:model].is_a?(String) || @init_data[:model].nil?
    raise Jamf::InvalidDataError, 'info must be a String.' unless @init_data[:info].is_a?(String) || @init_data[:info].nil?
    raise Jamf::InvalidDataError, 'notes must be a String.' unless @init_data[:notes].is_a?(String) || @init_data[:notes].nil?
    raise Jamf::InvalidDataError, 'ppd must be a String.' unless @init_data[:ppd].is_a?(String) || @init_data[:ppd].nil?
    raise Jamf::InvalidDataError, 'ppd_contents must be a String.' unless @init_data[:ppd_contents].is_a?(String) || @init_data[:ppd_contents].nil?
    raise Jamf::InvalidDataError, 'ppd_path must be a String.' unless @init_data[:ppd_path].is_a?(String) || @init_data[:ppd_path].nil?

    unless @init_data[:os_requirements].is_a?(String) || @init_data[:os_requirements].nil?
      raise Jamf::InvalidDataError,
            'os_requirements must be a String.'
    end
    unless (@init_data[:shared].is_a?(TrueClass) || @init_data[:shared].is_a?(FalseClass)) || @init_data[:shared].nil?
      raise Jamf::InvalidDataError,
            'shared must be a String.'
    end
    unless (@init_data[:make_default].is_a?(TrueClass) || @init_data[:make_default].is_a?(FalseClass)) || @init_data[:make_default].nil?
      raise Jamf::InvalidDataError,
            'make_default must be a String.'
    end
    unless (@init_data[:use_generic].is_a?(TrueClass) || @init_data[:use_generic].is_a?(FalseClass)) || @init_data[:use_generic].nil?
      raise Jamf::InvalidDataError,
            'use_generic must be a String.'
    end

    @uri = @init_data[:uri]
    @CUPS_name = @init_data[:CUPS_name]
    @location = @init_data[:location]
    @model = @init_data[:model]
    @shared = @init_data[:shared]
    @info = @init_data[:info]
    @notes = @init_data[:notes]
    @make_default = @init_data[:make_default]
    @use_generic = @init_data[:use_generic]
    @ppd = @init_data[:ppd]
    @ppd_contents = @init_data[:ppd_contents]
    @ppd_path = @init_data[:ppd_path]
    @os_requirements = @init_data[:os_requirements]
  end
end

Instance Attribute Details

#CUPS_name ⇒ String

Returns The CUPs name to be used.

Returns:

  • (String) —

    The CUPs name to be used



52
53
54
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 52

def CUPS_name
  @CUPS_name
end

#info ⇒ String

Returns Information for this specific printer.

Returns:

  • (String) —

    Information for this specific printer.



64
65
66
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 64

def info
  @info
end

#location ⇒ String

Returns The physical location of the printer.

Returns:

  • (String) —

    The physical location of the printer.



55
56
57
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 55

def location
  @location
end

#make_default ⇒ Boolean

Returns Make this printer as the default printer upon installation.

Returns:

  • (Boolean) —

    Make this printer as the default printer upon installation.



70
71
72
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 70

def make_default
  @make_default
end

#model ⇒ String

Returns The specific model of printer.

Returns:

  • (String) —

    The specific model of printer.



58
59
60
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 58

def model
  @model
end

#need_to_update ⇒ Boolean (readonly) Originally defined in module Updatable

Returns do we have unsaved changes?.

Returns:

  • (Boolean) —

    do we have unsaved changes?

#notes ⇒ String

Returns Notes for this specific printer.

Returns:

  • (String) —

    Notes for this specific printer.



67
68
69
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 67

def notes
  @notes
end

#os_requirements ⇒ String

Returns The OS version requirements seperated by commas.

Returns:

  • (String) —

    The OS version requirements seperated by commas



85
86
87
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 85

def os_requirements
  @os_requirements
end

#ppd ⇒ String

Returns The PPD file name.

Returns:

  • (String) —

    The PPD file name.



76
77
78
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 76

def ppd
  @ppd
end

#ppd_contents ⇒ String

Returns The contents of the PPD file.

Returns:

  • (String) —

    The contents of the PPD file.



79
80
81
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 79

def ppd_contents
  @ppd_contents
end

#ppd_path ⇒ String

Returns The path the PPD file will be installed.

Returns:

  • (String) —

    The path the PPD file will be installed.



82
83
84
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 82

def ppd_path
  @ppd_path
end

#shared ⇒ Boolean

Returns Is this printer to be shared?.

Returns:

  • (Boolean) —

    Is this printer to be shared?



61
62
63
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 61

def shared
  @shared
end

#uri ⇒ String

Returns The URI path for the specific printer.

Returns:

  • (String) —

    The URI path for the specific printer.



49
50
51
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 49

def uri
  @uri
end

#use_generic ⇒ Boolean

Returns Use a generic PPD.

Returns:

  • (Boolean) —

    Use a generic PPD.



73
74
75
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 73

def use_generic
  @use_generic
end

Instance Method Details

#category=(new_cat) ⇒ void Originally defined in module Categorizable

This method returns an undefined value.

Change the category of this object. Any of the NON_CATEGORIES values will unset the category

Parameters:

  • new_cat (Integer, String) —

    The new category

Raises:

#category_assigned? ⇒ Boolean Also known as: categorized? Originally defined in module Categorizable

Does this object have a category assigned?

Returns:

  • (Boolean) —

    Does this object have a category assigned?

#category_id ⇒ Integer Originally defined in module Categorizable

The id of the category for this object.

Returns:

  • (Integer) —

    The id of the category for this object.

#category_name ⇒ String Also known as: category Originally defined in module Categorizable

The name of the category for this object. For backward compatibility, this is aliased to just ‘category’

Returns:

  • (String) —

    The name of the category for this object.

#category_object ⇒ Jamf::Category Originally defined in module Categorizable

The Jamf::Category instance for this object’s category

Returns:

  • (Jamf::Category) —

    The Jamf::Category instance for this object’s category

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

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

Parameters:

  • name (String) —

    the name for the new object

  • cnx (Jamf::Connection) (defaults to: nil) —

    the API in which to create the object Defaults to the API used to instantiate this object

Returns:

  • (APIObject) —

    An unsaved clone of this APIObject with the given name

Raises:

#evaluate_new_category(new_cat) ⇒ Array<String, Integer> Originally defined in module Categorizable

Given a category name or id, return the name and id TODO: use APIObject.exist? and/or APIObject.valid_id

Parameters:

  • new_cat (String, Integer) —

    The name or id of a possible category

Returns:

  • (Array<String, Integer>) —

    The matching name and id, which may be nil.

#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.

Parameters:

  • newname (String) —

    the new name

Raises:

#pretty_print_instance_variables ⇒ Array

Remove the various large data from the instance_variables used to create pretty-print (pp) output.

Returns:

  • (Array) —

    the desired instance_variables



403
404
405
406
407
 
# File 'lib/jamf/api/classic/api_objects/printer.rb', line 403

def pretty_print_instance_variables
  vars = super
  vars.delete :@ppd_contents
  vars
end

#unset_category ⇒ void Originally defined in module Categorizable

This method returns an undefined value.

Set the category to nothing