
Error When Associating Courses/Users to Hierarchy Nodes
Date Published: Apr 11,2025 Category: Version:Learn_BU Article No.: 000076248
Date Published: Apr 11,2025 Category: Version:Learn_BU Article No.: 000076248
Producto: Learn SaaS
Versión: SaaS
Paquetes de servicio: Blackboard Learn
Descripción: An error message is shown when uploading a feed file twice to a data integration (SIS) This issue is affecting "User/Course Node Association" integrations.
Pasos para repetir:
- Log in to Blackboard Learn as an Administrator
- Go to System Administrator page > Integrations > Data Integration > Data Sources
- Click on Create
- Provide a name for the Data Source and click on Submit
- Navigate back to the Data Integration page, then, select Student Information System Integrations
- Create a Snapshot Flat File integration (You can find more details on how to create a Data Integration Here)
- Go to System Administrator page > Communities > Institutional Hierarchy
- Click on Create Node
- Provide a name for the node, then, click on Submit
- Select the node created in the previous step from the list of nodes available
- Click on Create Node (This step will create a child node)
- Go to System Administrator page > Courses > Courses > Create Course > New (Alternatively, you can use an existing course)
- Go to System Administrator page > Integrations > Data Integration > Student Information System Integrations
- Locate the integration created in step # 6
- Click on the "Chevron" button, then, select Upload feed file
- Upload a feed file (TXT/CSV). The file must contain the following fields:
external_user_key|external_node_key|external_association_key|data_source_key
<user>|<node>|<association>|<data source>
- You can use an existing user account in the external_user_key field, or create a new one; the data_source_key field must contain the Data Source created in step # 3
- You can find more details on the user association integration fields here
- Select User Association from the Data Type drop-down list
- Select Store in the Operation Type field
- Click on Submit
- Repeat steps 14 to 19 using the same data feed file (Same information as in the first upload)
- An error message like the one below will be shown in the integration logs when the file is uploaded a second time:
Jan 19, 2022 02:56:22 AM - User Association [create/update, adis_z_Znode2] Persist Operation Failed for object type blackboard.platform.flatFileUserAssociationSISObjectType. blackboard.platform.dataintegration.operationdefinition.OperationHandlerException: CoursePersistOperation failed. at blackboard.platform.dataintegration.operationdefinition.institutionalhierarchy.UserAssociationPersistOperationHandler.handleOperation(UserAssociationPersistOperationHandler.java:75) at blackboard.platform.dataintegration.operationdefinition.institutionalhierarchy.UserAssociationPersistOperation.execute(UserAssociationPersistOperation.java:69) at blackboard.platform.dataintegration.operationdefinition.BaseOperation.execute(BaseOperation.java:53) at blackboard.platform.dataintegration.operationdefinition.impl.OperationManagerImpl.processOperation(OperationManagerImpl.java:99) at blackboard.platform.dataintegration.operationdefinition.impl.OperationManagerImpl.executeOperation(OperationManagerImpl.java:43) at blackboard.platform.dataintegration.operationdefinition.impl.OperationManagerImpl.executeOperation(OperationManagerImpl.java:34) at blackboard.platform.dataintegration.mapping.impl.DataIntegrationObjectMappingManagerImpl.persistSISObject(DataIntegrationObjectMappingManagerImpl.java:237) [...] Caused by: java.lang.IllegalStateException: The Data Source BatchUid is not set. at blackboard.platform.dataintegration.operationdefinition.institutionalhierarchy.AssociationPersistOperationHandler.setDataSourceId(AssociationPersistOperationHandler.java:25) at blackboard.platform.dataintegration.operationdefinition.institutionalhierarchy.UserAssociationPersistOperationHandler.handleOperation(UserAssociationPersistOperationHandler.java:47) ... 34 more The Data Source BatchUid is not set. adis_z,Znode2,adis_z_Znode2,ZDSK Skipping attribute: replacementDataSourceBatchUid. SKIP_ATTRIBUTE returned from mapping script. Field mapping successful.
Expected Behavior:
No error messages should be shown after uploading the feed file a second time
Observed Behavior:
An error message is shown after uploading the feed file a second time
Síntomas: An error message is shown when uploading a feed file twice to a Course/User Node Association integration.
Versión de destino: Learn 9.1, 3900.62.0 Release
Versión de destino: Learn 9.1, 3900.62.0 Release
SaaS - Fixed (v3900.62.0)