module GoodData::Mixin::MdObjectIndexer

Constants

MD_OBJ_CTG

Public Instance Methods

[](id, options = { :client => GoodData.connection, :project => GoodData.project }) click to toggle source

Returns either list of objects or a specific object. This method is reimplemented in subclasses to leverage specific implementation for specific type of objects. Options is used in subclasses specifically to provide shorthand for getting a full objects after getting a list of hashes from query resource. @param [Object] id id can be either a number a String (as a URI). Subclasses should also be abel to deal with getting the instance of MdObject already and a :all symbol @param [Hash] options the options hash @option options [Boolean] :full if passed true the subclass can decide to pull in full objects. This is desirable from the usability POV but unfortunately has negative impact on performance so it is not the default. @return [MdObject] if id is a String or number single object is returned @return [Array] if :all was provided as an id, list of objects should be returned. Note that this is implemented only in the subclasses. MdObject does not support this since API has no means to return list of all types of objects.

# File lib/gooddata/mixins/md_object_indexer.rb, line 28
def [](id, options = { :client => GoodData.connection, :project => GoodData.project })
  client, project = GoodData.get_client_and_project(options)

  fail "You have to provide an \"id\" to be searched for." unless id
  fail(NoProjectError, 'Connect to a project before searching for an object') unless project
  return all(options) if id == :all
  return id if id.is_a?(MdObject)
  uri = if id.is_a?(Integer) || id =~ /^\d+$/
          "#{project.md[MD_OBJ_CTG]}/#{id}"
        elsif id !~ %r{/}
          identifier_to_uri options, id
        elsif id =~ %r{^/}
          id
        else
          fail 'Unexpected object id format: expected numeric ID, identifier with no slashes or an URI starting with a slash'
        end
  # new(GoodData.get uri) unless uri.nil?
  if uri # rubocop:disable Style/GuardClause
    raw = client.get(uri)
    md_class = self
    case raw.keys.first
    when 'attribute'
      md_class = GoodData::Attribute
    when 'metric'
      md_class = GoodData::Metric
    when 'projectDashboard'
      md_class = GoodData::Dashboard
    when 'report'
      md_class = GoodData::Report
    when 'attributeDisplayForm'
      md_class = GoodData::Label
    when 'reportDefinition'
      md_class = GoodData::ReportDefinition
    when 'dataSet'
      md_class = GoodData::Dataset
    else
      md_class = self
    end

    client.create(md_class, raw, client: client, project: project)
  end
end
Also aliased as: get_by_id
get_by_id(id, options = { :client => GoodData.connection, :project => GoodData.project })
Alias for: []