applicants.interfaces - Applicants Related Interfaces

Interfaces of the university application package.

class waeup.kofa.applicants.interfaces.AppCatCertificateSource[source]

Bases: waeup.kofa.university.vocabularies.CertificateSource

An application certificate source delivers all certificates which belong to a certain application_category.

This source is meant to be used with Applicants.

The application category must match the application category of the context parent, normally an applicants container.

__doc__ = 'An application certificate source delivers all certificates\n which belong to a certain application_category.\n\n This source is meant to be used with Applicants.\n\n The application category must match the application category of\n the context parent, normally an applicants container.\n '
__module__ = 'waeup.kofa.applicants.interfaces'
contains(context, value)[source]
getTitle(context, value)[source]
getValues(context)[source]
class waeup.kofa.applicants.interfaces.ApplicantRegNumberSource(context)[source]

Bases: waeup.kofa.students.vocabularies.RegNumberSource

A source that accepts any reg number if not used already by a different applicant.

__doc__ = 'A source that accepts any reg number if not used already by a\n different applicant.\n '
__module__ = 'waeup.kofa.applicants.interfaces'
cat_name = 'applicants_catalog'
comp_field = 'applicant_id'
field_name = 'reg_number'
validation_error

alias of RegNumInSource

class waeup.kofa.applicants.interfaces.ApplicationTypeSource[source]

Bases: zc.sourcefactory.contextual.BasicContextualSourceFactory

An application type source delivers screening types defined in the portal.

__doc__ = 'An application type source delivers screening types defined in the\n portal.\n '
__module__ = 'waeup.kofa.applicants.interfaces'
getTitle(context, value)[source]
getToken(context, value)[source]
getValues(context)[source]
interface waeup.kofa.applicants.interfaces.IApplicant[source]

Extends: waeup.kofa.applicants.interfaces.IApplicantBaseData, waeup.kofa.applicants.interfaces.IApplicantTestData

This is basically the applicant base data. Here we repeat the fields from base data if we have to set the required attribute to True (which is the default).

createStudent()

Create a student object from applicant data and copy passport image and application slip.

writeLogMessage(view, comment)

Add an INFO message to applicants.log.

interface waeup.kofa.applicants.interfaces.IApplicantBaseData[source]

Extends: waeup.kofa.interfaces.IKofaObject

This is a base interface of an applicant with no field required. For use with processors, forms, etc., please use one of the derived interfaces below, which set more fields to required state, depending on use-case.

application_number

The key under which the record is stored

course_admitted

Admitted Course of Study

sex

Sex

course1

1st Choice Course of Study

suspended

Account suspended

special

True if special application

reg_number

Registration Number

container_code

Code of the parent container plus additional information if record is used or not

student_id

Student Id

applicant_id

Applicant Id

course2

2nd Choice Course of Study

state

Application state of an applicant

date_of_birth

Date of Birth

email

Email Address

display_fullname

The fullname of an applicant

notice

Notice

translated_state

Real name of the application state

special_application

Special Application

firstname

First Name

middlename

Middle Name

lastname

Last Name (Surname)

phone

Phone

password

Encrypted password of an applicant

application_date

UTC datetime of submission, used for export only

locked

Form locked

payments

List of payment objects stored in the applicant container

history

Object history, a list of messages

interface waeup.kofa.applicants.interfaces.IApplicantEdit[source]

Extends: waeup.kofa.applicants.interfaces.IApplicant

This is an applicant interface for editing.

Here we can repeat the fields from base data and set the required and readonly attributes to True to further restrict the data access. Or we can allow only certain certificates to be selected by choosing the appropriate source.

We cannot omit fields here. This has to be done in the respective form page.

course_admitted

Admitted Course of Study

notice

Notice

email

Email Address

course2

2nd Choice Course of Study

course1

1st Choice Course of Study

interface waeup.kofa.applicants.interfaces.IApplicantOnlinePayment[source]

Extends: waeup.kofa.payments.interfaces.IOnlinePayment

An applicant payment via payment gateways.

doAfterApplicantPayment()

Process applicant after payment was made.

approveApplicantPayment()

Approve payment and process applicant.

doAfterApplicantPaymentApproval()

Process applicant after payment was approved.

interface waeup.kofa.applicants.interfaces.IApplicantRefereeReport[source]

Extends: waeup.kofa.interfaces.IKofaObject

A referee report.

name

Name

phone

Phone

r_id

Report identifier

report

Report

creation_date

Ticket Creation Date

email

Email Address

interface waeup.kofa.applicants.interfaces.IApplicantRegisterUpdate[source]

Extends: waeup.kofa.applicants.interfaces.IApplicant

This is a representation of an applicant for first-time registration. This interface is used when applicants use the registration page to update their records.

reg_number

Registration Number

lastname

Last Name (Surname)

email

Email Address

interface waeup.kofa.applicants.interfaces.IApplicantTestData[source]

Extends: waeup.kofa.interfaces.IKofaObject

This interface is for demonstration and testing only. It can be omitted in customized versions of Kofa.

school_grades

School Grades

referees

Referees

interface waeup.kofa.applicants.interfaces.IApplicantUpdateByRegNo[source]

Extends: waeup.kofa.applicants.interfaces.IApplicant

Skip regular reg_number validation if reg_number is used for finding the applicant object.

reg_number

Registration Number

interface waeup.kofa.applicants.interfaces.IApplicantsContainer[source]

Extends: waeup.kofa.interfaces.IKofaObject

An applicants container contains applicants.

code

Code

application_fee

Application Fee

application_category

Category for the grouping of certificates

traverse(name)

Deliver appropriate containers.

prefix

Application Target

year

Year of Entrance

addApplicant(applicant)

Add an applicant.

description

Human readable description in HTML format

startdate

Application Start Date

Example: 2011-12-01 18:30:00+01:00

statistics

Applicant counts

description_dict

Language translation dictionary with values in HTML format

title

Title

hidden

Hide container

local_roles

List of local role names

application_slip_notice

Human readable notice on application slip in HTML format

strict_deadline

Forbid additions after deadline (enddate)

expired

True if application has started but not ended

writeLogMessage(view, comment)

Add an INFO message to applicants.log.

enddate

Application Closing Date

Example: 2011-12-31 23:59:59+01:00

mode

Application Mode

interface waeup.kofa.applicants.interfaces.IApplicantsContainerAdd[source]

Extends: waeup.kofa.applicants.interfaces.IApplicantsContainer

An applicants container contains university applicants.

prefix

Application Target

year

Year of Entrance

interface waeup.kofa.applicants.interfaces.IApplicantsRoot[source]

Extends: waeup.kofa.interfaces.IKofaObject, grokcore.content.interfaces.IContainer

A container for applicants containers.

logger_filename

Name of the logger file

description_dict

Language translation dictionary with values in HTML format

logger_name

Name of the logger

local_roles

List of local role names

description

Human readable description in HTML format

interface waeup.kofa.applicants.interfaces.IApplicantsUtils[source]

A collection of methods which are subject to customization.

APP_TYPES_DICT

dict of application types

setPaymentDetails(container, payment)

Set the payment data of an applicant.

getApplicantsStatistics(container)

Count applicants in containers.

getCertTitle(context, value)

Compose the titles in AppCatCertificateSource.

filterCertificates(context, resultset)

Filter and sort certificates for AppCatCertificateSource.

interface waeup.kofa.applicants.interfaces.ISpecialApplicant[source]

Extends: waeup.kofa.interfaces.IKofaObject

This reduced interface is for former students or students who are not users of the portal but have to pay supplementary fees. This interface is used in browser components only. Thus we can’t add fields here to the regular IApplicant interface here. We can only ‘customize’ fields.

reg_number

Identification Number

Enter either registration or matriculation number.

locked

Form locked

special_application

Special Application

firstname

First Name

middlename

Middle Name

lastname

Last Name (Surname)

applicant_id

Applicant Id

email

Email Address

phone

Phone

date_of_birth

Date of Birth

suspended

Account suspended

waeup.kofa.applicants.interfaces.MAX_UPLOAD_SIZE = 51200

Maximum upload size for applicant passport photographs (in bytes)

exception waeup.kofa.applicants.interfaces.RegNumInSource[source]

Bases: zope.schema._bootstrapinterfaces.ValidationError

Registration number exists already

__doc__ = 'Registration number exists already\n '
__module__ = 'waeup.kofa.applicants.interfaces'
waeup.kofa.applicants.interfaces.contextual_reg_num_source(context)[source]
waeup.kofa.applicants.interfaces.year_range()[source]