The Ellucian Objects
Mapping
Under the object tab, select which field types for Ellucian fields are mapped to Laserfiche fields.
There is a default type selection, however you can always update the type in the connection.
The selected connection will use the following default mappings.
Default mappings follow the format: [Laserfiche Field] -> [Ellucian type title] [(Ellucian type category)]
Note: Each type title and type category correspond to the Description and Translation in the Ellucian Banner front-end. Show me an example.
Note: The titles below can be changed on an Ellucian system. For example, Billing (billing) can be updated to Billing2 (billing)
- Billing Address -> Billing (billing)
- Email/Email Address -> School (school) Email Address
- Home Phone -> Home (home) Address
- Mailing Address -> Mailing (mailing)
- Mobile Phone -> Cell Phone (mobile)
- Name -> Legal Name (legal)
- Section Title -> Short Course Title (In Banner, if user creates a section without giving a title, the short course title will be used as section title. Also, if the section title is exactly the same as the course title, will only be able to get short course title value from ethos.)
- Section Description -> Schedule Description (Derived from short & long description based on their availability)
- Course Title -> Short Course Title (In Banner, there must be a short course title for each course.)
- Instructor Name -> Legal Name (legal)
- Instructor Email -> School (school) Email Address
For each value in the type selection, the "category" is in the parentheses.
Example, "Email/Email Address -> School (school) Email Address", where "(school)" denotes the category.
Note: The type selection drop-down will not include duplicate categories for Name (due to special handling). For example, if the Ellucian system is configured to have two types with the exact the same category for names then both will be hidden in the object tab.
Under the same group, the type will stay consistent. Updates made to the type for any of the fields under the same groupwill be applied to all the fields under the same group. For example, if the mapping of Billing Address/City is changed from Billing (billing) City to Business (business) City, then Billing Address/Address, Billing Address/Country, Billing Address/Postal Code and Billing Address/State will also be updated to the "Business" type.
Duplicate mapping
The type selection drop-down will not be filtered based on previous selection (used options shared between fields are not removed.) If a duplicate type is selected, a warning icon next to each duplicated field will be displayed, and a warning message will be displayed on save.
If the two "Address" fields are configured to have the same mapping, when performing an action, it will follow the following behavior:
- Update: One of the two addresses will arbitrarily be picked.
- Search/Get: Both addresses will share the same values on return.
If the two "Phone" fields are configured to have the same mapping the action will succeed as Ellucian allows a record to have multiple phone numbers with the same type. The effect is that a get/search action will return both the Home Phone and Mobile Phone as the same result, and on update both the Home Phone and Mobile Phone will be added.
Mapping Empty Fields
Fields can be mapped as empty using "--", the empty mapping. For addresses, phones and email, empty mapping will render the fields as unable to perform retrieve or update, and they will be removed from Workflow and Lookup as a field option. In addition, giving the email field an empty mapping will remove the following actions from Workflow and Lookup: Search Students by Email, Search Student by Banner ID and Email and Search Student by Banner Username and Email.
On save, a warning will be displayed if email is mapped empty, alerting that the search actions requiring email will be unavailable.
The empty mapping is a valid option for names on the Ellucian system and will not change the ability to retrieve or update names.
The Object Mapping Interface
The Expand all button will expand all the objects and group mappings, such as Billing/Mailing Address under the Student object. The Collapse all button will collapse all the objects and group mapping fields. Show me an example.
Some Objects have fields that is referencing to another model. Clicking on the model name will take user to that referenced model. Show me an example.
Possible Warning Messages
Field type is not available
- When refreshing the page, the previously mapped field type or default field type does not exist, or its Value was changed in Ellucian.
Field type properties have been changed
- When creating Ellucian connection for the first time, users will see a "Data Has Been Changed" popup with this warning message and are expected to save the changes in order to proceed.
- When refreshing the page, the previously mapped field type's title or category has been changed in Ellucian.