4.0 Customizing the Driver

This section provides guidelines for customizing your driver to your specific busines rules.

The Subscriber channel issues Blackboard API calls to process XDS commands received for objects and attributes represented in the Blackboard schema. It is up to the policy writer to ensure all required attributes are sent for Blackboard object creation. The sample policies can be configured on driver import or through global configuration values to ensure all required attributes are set on creation. The Blackboard API places restrictions on attribute values. It is up to the policy writer to ensure attributes mapped to Blackboard attributes contain values that conform to Blackboard attribute restrictions. The following tables list attributes required for Person, Course, Enrollment, and Organization creation in Blackboard. For information about restrictions on values for these attributes consult Blackboard documentation.

Table 4-1 Person Attributes Required For Creation

Blackboard Schema

Blackboard Attribute

Dir-XML-BB-p-ext-key

EXTERNAL_PERSON_KEY

Dir-XML-BB-p-id

USER_ID

Dir-XML-BB-p-sys-role

SYSTEM_ROLE

Dir-XML-BB-p-firstname

FIRSTNAME

Dir-XML-BB-p-lastname

LASTNAME

Dir-XML-BB-p-email

EMAIL

Table 4-2 Course Attributes Required For Creation

Blackboard Schema

Blackboard Attribute

Dir-XML-BB-c-id

COURSE_ID

Dir-XML-BB-c-ext-key

EXTERNAL_COURSE_KEY

Dir-XML-BB-c-course-title

COURSE_NAME

Table 4-3 Organization Attributes Required For Creation

Blackboard Schema

Blackboard Attribute

Dir-XML-BB-o-id

ORGANIZATION_ID

Dir-XML-BB-o-ext-key

EXTERNAL_ORGANIZATION_KEY

Dir-XML-BB-o-title

ORGANIZATION_NAME

Table 4-4 Course Enrollment Attributes Required For Creation

Blackboard Schema

Blackboard Attribute

Dir-XML-BB-enr-c-ext-key

EXTERNAL_COURSE_KEY

Dir-XML-BB-enr-p-ext-key

EXTERNAL_PERSON_KEY

Table 4-5 Organization Enrollment Attributes Required For Creation

Blackboard Schema

Blackboard Attribute

Dir-XML-BB-enr-o-ext-key

EXTERNAL_ORGANIZATION_ID

Dir-XML-BB-enr-p-ext-key

EXTERNAL_PERSON_KEY