Module control.cust.assessment_table

Expand source code 
from flask import flash

from config import Names as N
from control.utils import pick as G
from control.table import Table
from control.typ.related import castObjectId


class AssessmentT(Table):
    """Logic for the assessment table.

    Inserting an assessment means also to insert the right
    set of criteriaEntry records and prefill some of their fields.
    """

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

    def insert(self, force=False, masterTable=None, masterId=None):
        mayInsert = force or self.mayInsert
        if not mayInsert:
            return None

        if not masterTable or not masterId:
            return None

        context = self.context
        db = context.db
        uid = self.uid
        eppn = self.eppn
        table = self.table
        typeCriteria = db.typeCriteria

        masterOid = castObjectId(masterId)

        wfitem = context.getWorkflowItem(masterOid)

        if not wfitem.permission(N.startAssessment):
            return None

        (contribType, contribTitle) = wfitem.info(N.contrib, N.type, N.title)
        if not contribType:
            flash("You cannot assess a contribution without a type", "error")
            return None
        isActual = G(G(db.typeContribution, contribType), N.actual)
        if not isActual:
            flash("You cannot assess a contribution with a legacy type", "error")
            return None

        fields = {
            masterTable: masterOid,
            N.assessmentType: contribType,
            N.title: f"assessment of {contribTitle}",
        }
        criteria = G(typeCriteria, contribType, default=[])
        if not criteria:
            flash("This contribution type has no criteria", "error")
            return None

        assessmentId = db.insertItem(table, uid, eppn, False, **fields)

        records = [
            {N.seq: seq, N.criteria: crit, N.assessment: assessmentId}
            for (seq, crit) in enumerate(criteria)
        ]
        db.insertMany(N.criteriaEntry, uid, eppn, records)
        self.adjustWorkflow(masterOid, new=False)

        return assessmentId

Classes

class AssessmentT (*args, **kwargs)

Logic for the assessment table.

Inserting an assessment means also to insert the right set of criteriaEntry records and prefill some of their fields.

Initialization

Store the incoming information.

Set the RecordClass to a suitable derived class of Record, otherwise to the base class Record itself.

Parameters

context : object
See below.
table : string
See below.
Expand source code 
class AssessmentT(Table):
    """Logic for the assessment table.

    Inserting an assessment means also to insert the right
    set of criteriaEntry records and prefill some of their fields.
    """

    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)

    def insert(self, force=False, masterTable=None, masterId=None):
        mayInsert = force or self.mayInsert
        if not mayInsert:
            return None

        if not masterTable or not masterId:
            return None

        context = self.context
        db = context.db
        uid = self.uid
        eppn = self.eppn
        table = self.table
        typeCriteria = db.typeCriteria

        masterOid = castObjectId(masterId)

        wfitem = context.getWorkflowItem(masterOid)

        if not wfitem.permission(N.startAssessment):
            return None

        (contribType, contribTitle) = wfitem.info(N.contrib, N.type, N.title)
        if not contribType:
            flash("You cannot assess a contribution without a type", "error")
            return None
        isActual = G(G(db.typeContribution, contribType), N.actual)
        if not isActual:
            flash("You cannot assess a contribution with a legacy type", "error")
            return None

        fields = {
            masterTable: masterOid,
            N.assessmentType: contribType,
            N.title: f"assessment of {contribTitle}",
        }
        criteria = G(typeCriteria, contribType, default=[])
        if not criteria:
            flash("This contribution type has no criteria", "error")
            return None

        assessmentId = db.insertItem(table, uid, eppn, False, **fields)

        records = [
            {N.seq: seq, N.criteria: crit, N.assessment: assessmentId}
            for (seq, crit) in enumerate(criteria)
        ]
        db.insertMany(N.criteriaEntry, uid, eppn, records)
        self.adjustWorkflow(masterOid, new=False)

        return assessmentId

Ancestors

Inherited members