Campuses and Buildings can be created and updated using CSV Imports.
The fields requested for the update are identical to those requested for create, with the exception of needing the Campus or Building ID for making updates.
Generating a Campus or Building Export should provide all the data you need for an Update-action import.
You cannot delete campuses or buildings via Delete-action import. Deleting campuses or buildings also deletes the associated rooms and would, therefore, negate any capture schedules configured for those rooms.
IMPORTED FILES MUST HAVE ALL FIELDS/COLUMNS REQUESTED: If the Update-import example contains a field, that field MUST be included in the final import, even if you are not making changes to the values for that field. As cited below, if a value is blank for an optional field, the value is removed for that item. Similarly, if the FIELD itself is missing from the import file for an optional field, that value will be removed from ALL of the items in the update file. If the field is required, it must both exist in the import file and must have a value in it.
Removing or Appending Field Values on update
Since you can copy existing values from an export into an update-action import file, we expect that if you wish to retain the existing values, those will be resident in the import. This means that for updates:
- To REMOVE the value(s) for a field where the value is optional, remove the existing value and leave the field blank.
- If the value is required and the field is blank, the row will be rejected.
- If the value is optional and the field is blank, the value will be removed from the object's properties.
- If the value is optional and the field is missing (the column is not resident) from the import, that value will be removed from ALL of the items in the update.
- To REPLACE the value for a field, remove the existing value and replace it with the new/updated value.
- To APPEND the values in a field where multiple values are allowed, retain the existing values but add the new values into the field (separating with a semi-colon.
Create Campus
Download a sample CSV file and enter the necessary data into the fields (columns) provided. Then import your new file.
Field Name | Description | Example |
---|---|---|
Name (required) | The name of the campus. Must be unique to the institution | Brooklyn Institute of Art |
Time Zone (optional) | The time zone in which the campus resides. If not included, applies the time zone for the institution. | US/East |
External Id (optional) | External system identifier of the campus | Determined by the external system |
Update Campus
Generate a Campus Export, then select and update the necessary organizational information. Then import your new file.
IMPORTED FILES MUST HAVE ALL FIELDS/COLUMNS REQUESTED: If the Update-import example contains a field, that field MUST be included in the final import, even if you are not making changes to the values for that field. As cited above, if a value is blank for an optional field, the value is removed for that item. Similarly, if the FIELD itself is missing from the import file for an optional field, that value will be removed from ALL of the items in the update file. If the field is required, it must both exist in the import file and must have a value in it.
Field Name | Description | Example |
---|---|---|
Id (required) | System identifier (UUID) of the campus being updated | 69324a-315-4de-8dg-g75d42 |
Name (required) | The name of the campus. | Brooklyn Institute of Art |
Time Zone (optional) | The time zone in which the campus resides. | US/East |
External Id (optional) | External system identifier of the campus | Determined by the external system |
Create Building
Download a sample CSV file and enter the values for your new department into the fields provided. Then import your new file.
You must use the Campus ID to identify the Campus to which the new Building(s) belong. To use the system ID, perform a Campus Export to get that information first and copy it to your create-action file.
Field Name | Description | Example |
---|---|---|
Campus Id (required) | System ID of the campus to which the building belongs. | 69324a-315-4de-8dg-g75d42 |
Name (required) | The name of the building. Must be unique within the campus. | Wyeth Hall |
External Id (optional) | External system identifier of the building. | Determined by the external system |
Update Building
Generate a Building Export, then select and update the necessary information for the import file. Then import your new file.
IMPORTED FILES MUST HAVE ALL FIELDS/COLUMNS REQUESTED: If the Update-import example contains a field, that field MUST be included in the final import, even if you are not making changes to the values for that field. As cited above, if a value is blank for an optional field, the value is removed for that item. Similarly, if the FIELD itself is missing from the import file for an optional field, that value will be removed from ALL of the items in the update file. If the field is required, it must both exist in the import file and must have a value in it.
Field Name | Description | Example |
---|---|---|
Id (required) | System ID of the building being updated | 38151b-015-4de-8cc-f98d91 |
Campus Id (required) | System ID of the campus to which the building belongs. | 69324a-315-4de-8dg-g75d42 |
Name (required) | The name of the building. Must be unique within the campus. | Wyeth Hall |
External Id (optional) | External system identifier of the building. | Determined by the external system |