fix(ErrorMessages): Improve error message when attempting to set rela…

…tionships on unloaded entities

models/BaseEntity.cfc

@@ -2680,6 +2680,16 @@ component accessors="true" {
 			return invoke( this, relationshipName );
 		} );
 
+		if (
+			relationship.relationshipClass != "BelongsTo" &&
+			relationship.relationshipClass != "PolymorphicBelongsTo"
+		) {
+			guardAgainstNotLoaded(
+				"This instance is not loaded so it cannot set the [#relationshipName#] relationship.  " &
+				"Save the new entity first before trying to save related entities."
+			);
+		}
+
 		return relationship.applySetter( argumentCollection = arguments.missingMethodArguments );
 	}
 

tests/specs/integration/BaseEntity/SubqueriesSpec.cfc

@@ -100,9 +100,7 @@ component extends="tests.resources.ModuleIntegrationSpec" appMapping="/app" {
 			} );
 
 			it( "can add a subselect using a belongsTo relationship with multiple foreign keys", function() {
-				var game = getInstance( "Game" )
-					.addSubselect( "fieldName", "field.fieldName" )
-					.findOrFail( 1 );
+				var game = getInstance( "Game" ).addSubselect( "fieldName", "field.fieldName" ).findOrFail( 1 );
 				expect( game.getFieldName() ).notToBeNull();
 				expect( game.getFieldName() ).toBe( "Second Field" );
 				expect( variables.queries ).toHaveLength(

tests/specs/integration/GoodErrorMessagesSpec.cfc

@@ -59,6 +59,20 @@ component extends="tests.resources.ModuleIntegrationSpec" appMapping="/app" {
 					regex = 'This instance is missing \`accessors\=\"true\"\` in the component metadata\.  This is required for Quick to work properly\.  Please add it to your component metadata and reinit your application\.'
 				);
 			} );
+
+			it( "throws a helpful error message when trying to set a belongsToMany relationship when the relationship is not loaded", function() {
+				expect( function() {
+					getInstance( "Post" ).create( {
+						"user_id"       : 1,
+						"body"          : "A new post body",
+						"publishedDate" : now(),
+						"tags"          : [ 1, 2 ]
+					} );
+				} ).toThrow(
+					type  = "QuickEntityNotLoaded",
+					regex = "This instance is not loaded so it cannot set the \[tags\] relationship\.  Save the new entity first before trying to save related entities\."
+				);
+			} );
 		} );
 	}