Class

OpportunityCollection

api/opportunity.OpportunityCollection()

Represents an Opportunity, such as "LiveWire Internship". To represent an Opportunity taken by a specific student in a specific academicTerm, use OpportunityInstance.

Constructor

# new OpportunityCollection()

Creates the Opportunity collection.

View Source api/opportunity/OpportunityCollection.ts, line 24

Extends

Methods

# assertAllDefined(names)

Verifies that the list of passed instances are all members of this collection.

Parameters:
Name Type Description
names

Should be a list of docs and/or docIDs.

Overrides:

View Source api/base/BaseCollection.ts, line 248

If instances is not an array, or if any instance is not in this collection.

Meteor.Error

# assertDefined(name)

Verifies that the passed object is one of this collection's instances.

Parameters:
Name Type Description
name String | List

Should be a defined ID or doc in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 238

If not defined.

Meteor.Error

# assertValidRoleForMethod(userId)

Asserts that userId is logged in as an Admin, Faculty, or Advisor. This is used in the define, update, and removeIt Meteor methods associated with each class.

Parameters:
Name Type Description
userId

The userId of the logged in user. Can be null or undefined

Overrides:

View Source api/opportunity/OpportunityCollection.ts, line 219

If there is no logged in user, or the user is not in the allowed roles.

Meteor.Error

# checkIntegrity() → {Array}

Returns an array of strings, each one representing an integrity problem with this collection. Returns an empty array if no problems were found. Checks slugID, opportunityTypeID, sponsorID, interestIDs, termIDs

Overrides:

View Source api/opportunity/OpportunityCollection.ts, line 239

A (possibly empty) array of strings indicating integrity issues.

Array

# count() → {Number}

Returns the number of documents in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 41

The number of elements in this collection.

Number

# countNonRetired() → {Number}

Returns the number of non-retired documents in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 48

The number of non-retired elements in this collection.

Number

# define(description, name, slug, description, opportunityType, interests, academicTerms, sponsor, ice, eventDate, timestamp, picture, retired)

Defines a new Opportunity.

Parameters:
Name Type Description
description Object

Object with keys name, slug, description, opportunityType, sponsor, interests,

name

the name of the opportunity.

slug

must not be previously defined.

description

the description of the opportunity. Can be markdown.

opportunityType

must be defined slug.

interests

must be a (possibly empty) array of interest slugs or IDs.

academicTerms

must be a (possibly empty) array of academicTerm slugs or IDs.

sponsor

must be a User with role 'FACULTY', 'ADVISOR', or 'ADMIN'.

ice

must be a valid ICE object.

eventDate

optional date.

timestamp

the Date timestamp that this Opportunity document was created at.

picture

The URL to the opportunity picture. (optional, defaults to a default picture.)

retired

optional, true if the opportunity is retired.

Overrides:

View Source api/opportunity/OpportunityCollection.ts, line 101

If the definition includes a defined slug or undefined interest, sponsor, opportunityType, or startActive or endActive are not valid.

Meteor.Error

The newly created docID.

Example
Opportunities.define({ name: 'ATT Hackathon',
                       slug: 'att-hackathon',
                       description: 'Programming challenge at Sacred Hearts Academy, $10,000 prize',
                       opportunityType: 'event',
                       sponsor: 'philipjohnson',
                       ice: { i: 10, c: 0, e: 10},
                       interests: ['software-engineering'],
                       academicTerms: ['Fall-2016', 'Spring-2016', 'Summer-2106'],
                     });

# dumpAll() → {Object}

Returns an object with two fields: name and contents. Name is the name of this collection. Contents is an array of objects suitable for passing to the restore() method.

Overrides:

View Source api/base/BaseCollection.ts, line 277

An object representing the contents of this collection.

Object

# dumpOne(docID) → {Object}

Returns an object representing the Opportunity docID in a format acceptable to define().

Parameters:
Name Type Description
docID

The docID of an Opportunity.

Overrides:

View Source api/opportunity/OpportunityCollection.ts, line 281

An object representing the definition of docID.

Object

# find(selector, options) → {Mongo.Cursor}

Runs find on this collection.

Parameters:
Name Type Description
selector Object

A MongoDB selector.

options Object

MongoDB options.

Overrides:
See:

View Source api/base/BaseCollection.ts, line 101

Mongo.Cursor

# findDoc(name) → {Object}

A stricter form of findOne, in that it throws an exception if the entity isn't found in the collection.

Parameters:
Name Type Description
name String | Object

Either the docID, or an object selector, or the 'name' field value.

Overrides:

View Source api/base/BaseCollection.ts, line 76

If the document cannot be found.

Meteor.Error

The document associated with name.

Object

# findDocBySlug(slug) → {Object}

Returns the instance associated with the passed slug.

Parameters:
Name Type Description
slug String

The slug (string or docID).

Overrides:

View Source api/base/BaseSlugCollection.ts, line 128

If the slug cannot be found, or is not associated with an instance in this collection.

Meteor.Error

The document representing the instance.

Object

# findIdBySlug(slug) → {String}

Return the docID of the instance associated with this slug.

Parameters:
Name Type Description
slug String

The slug (string or docID).

Overrides:

View Source api/base/BaseSlugCollection.ts, line 109

If the slug cannot be found, or is not associated with an instance in this collection.

Meteor.Error

The docID.

String

# findIdsBySlugs(slugs) → {Array}

Returns a list of docIDs associated with the instances associated with the list of slugs.

Parameters:
Name Type Description
slugs Array

A list or collection of slugs.

Overrides:

View Source api/base/BaseSlugCollection.ts, line 119

If the slug cannot be found, or is not associated with an instance in this collection.

Meteor.Error

A list of docIDs.

Array

# findNonRetired(selector, options) → {Array}

Runs find on this collection and returns the non-retired documents.

Parameters:
Name Type Description
selector Object

A MongoDB selector.

options Object

MongoDB options.

Overrides:
See:

View Source api/base/BaseCollection.ts, line 112

non-retired documents.

Array

# findOne(selector, options) → {Mongo.Cursor}

Runs findOne on this collection.

Parameters:
Name Type Description
selector Object

A MongoDB selector.

options Object

MongoDB options.

Overrides:
See:

View Source api/base/BaseCollection.ts, line 123

Mongo.Cursor

# findSlugByID(docID) → {String}

Returns the slug name associated with this docID.

Parameters:
Name Type Description
docID

The docID

Overrides:

View Source api/base/BaseSlugCollection.ts, line 137

If docID is not associated with this entity.

Meteor.Error

The slug name

String

# getCollection() → {Mongo.Collection}

Returns the Mongo collection.

Overrides:

View Source api/base/BaseCollection.ts, line 223

The collection.

Mongo.Collection

# getCollectionName() → {string}

Returns the collection name.

Overrides:

View Source api/base/BaseCollection.ts, line 216

The collection name as a string.

string

# getCollectionSchema() → {SimpleSchema}

Returns the schema applied to the collection.

Overrides:

View Source api/base/BaseCollection.ts, line 188

.

SimpleSchema

# getDefineSchema() → {SimpleSchema}

Returns a schema for the define method's parameter.

Overrides:

View Source api/base/BaseCollection.ts, line 195

the define method's parameter.

SimpleSchema

# getID(instance) → {String}

Returns the docID associated with instance, or throws an error if it cannot be found. If instance is an object with an _id field, then that value is checked to see if it's in the collection. If instance is the value for the username field in this collection, then return that document's ID. If instance is a docID, then it is returned unchanged. If instance is a slug, its corresponding docID is returned.

Parameters:
Name Type Description
instance String

Either a valid docID or a valid slug string.

Overrides:

View Source api/base/BaseSlugCollection.ts, line 25

If instance is not a docID or a slug.

Meteor.Error

The docID associated with instance.

String

# getIDs(instances) → {Array.<String>}

Returns the docIDs associated with instances, or throws an error if any cannot be found. If an instance is a docID, then it is returned unchanged. If a slug, its corresponding docID is returned. If nothing is passed, then an empty array is returned.

Parameters:
Name Type Description
instances Array.<String>

An array of valid docIDs, slugs, or a combination.

Overrides:

View Source api/base/BaseSlugCollection.ts, line 55

If any instance is not a docID or a slug.

Meteor.Error

The docIDs associated with instances.

Array.<String>

# getOpportunityTypeDoc(instanceID) → {Object}

Returns the OpportunityType associated with the Opportunity with the given instanceID.

Parameters:
Name Type Description
instanceID

The id of the Opportunity.

View Source api/opportunity/OpportunityCollection.ts, line 228

If instanceID is not a valid ID.

Meteor.Error

The associated Opportunity.

Object

# getPublicationName() → {String}

Return the publication name.

Overrides:

View Source api/base/BaseCollection.ts, line 209

The publication name, as a string.

String

# getType() → {String}

Return the type of this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 181

The type, as a string.

String

# getUpdateSchema() → {SimpleSchema}

Returns a schema for the update method's second parameter.

Overrides:

View Source api/base/BaseCollection.ts, line 202

.

SimpleSchema

# hasInterest(opportunity, interest) → {boolean}

Returns true if Opportunity has the specified interest.

Parameters:
Name Type Description
opportunity

The opportunity(docID or slug)

interest

The Interest (docID or slug).

View Source api/opportunity/OpportunityCollection.ts, line 271

If opportunity is not a opportunity or interest is not a Interest.

Meteor.Error

True if the opportunity has the associated Interest.

boolean

# hasSlug(slug) → {boolean}

Returns true if the passed slug is associated with an entity of this type.

Parameters:
Name Type Description
slug String

Either the name of a slug or a slugID.

Overrides:

View Source api/base/BaseSlugCollection.ts, line 100

True if the slug is in this collection.

boolean

# isDefined(instance) → {boolean}

Return true if instance is a docID or a slug for this entity.

Parameters:
Name Type Description
instance String

A docID or a slug.

Overrides:

View Source api/base/BaseSlugCollection.ts, line 91

True if instance is a docID or slug for this entity.

boolean

# publish()

Default publication method for entities. It publishes the entire collection.

Overrides:

View Source api/base/BaseCollection.ts, line 55

# removeAll()

Removes all elements of this collection. This is implemented by mapping through all elements because mini-mongo does not implement the remove operation. So this approach can be used on both client and server side. removeAll should only used for testing purposes, so it doesn't need to be efficient.

Overrides:

View Source api/base/BaseCollection.ts, line 170

true

# removeIt(instance)

Remove the Course.

Parameters:
Name Type Description
instance

The docID or slug of the entity to be removed.

Overrides:

View Source api/opportunity/OpportunityCollection.ts, line 193

If docID is not a Course, or if this course has any associated course instances.

Meteor.Error

# restoreAll(dumpObjects)

Defines all the entities in the passed array of objects.

Parameters:
Name Type Description
dumpObjects

The array of objects representing the definition of a document in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 315

# restoreOne(dumpObject) → {String}

Defines the entity represented by dumpObject. Defaults to calling the define() method if it exists.

Parameters:
Name Type Description
dumpObject

An object representing one document in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 305

The docID of the newly created document.

String

# subscribe()

Default subscription method for entities. It subscribes to the entire collection.

Overrides:

View Source api/base/BaseCollection.ts, line 64

# toString() → {String}

Returns a string representing all of the documents in this collection.

Overrides:

View Source api/base/BaseCollection.ts, line 230

String

# update(instance, name, description, opportunityType, sponsor, interests, academicTerms, eventDate, ice, retired, picture)

Update an Opportunity.

Parameters:
Name Type Description
instance

The docID or slug associated with this opportunity.

name

optional.

description

optional.

opportunityType

docID or slug (optional.)

sponsor

user in role admin, advisor, or faculty. optional.

interests

optional.

academicTerms

optional

eventDate

a Date. (optional)

ice

An ICE object (optional).

retired

boolean (optional).

picture

View Source api/opportunity/OpportunityCollection.ts, line 147