Entity fields not saving when using 'business logic' method.

Thanks. The documentation makes it seem straightforward but I've had to abandon the entity business rules approach until I get more information. I've moved my latest project from 3 to 4 with very few problems until encountering the entity class. Still not sure if moving was the right decision.