Populate an entity with a structure of name-value pairs. Make sure the names of the properties match the keys in the structure.
Returns
This function returns the populated object
Arguments
INFO With composeRelationships=true, you can populate one-to-many, many-to-one, many-to-many, and one-to-one relationships from property values in the memento. For 'many-to-one' and 'one-to-one' relationships, the value of the property in the memento should be a single value of the primary key of the target entity to be loaded. For 'one-to-many' and 'many-to-many' relationships, the value of the property in the memento should a comma-delimited list or array of the primary keys of the target entities to be loaded.
Examples
var user =ormService.populate( ormService.new("User"), data );// populate with includes onlyvar user =ormService.populate( ormService.new("User"), data,"fname,lname,email" );//populate with excludesvar user =ormService.populate(target=ormService.new("User"),memento=data,exclude="id,setup,total" );// populate with null values when value is empty stringvar user =ormService.populate(target=ormService.new("User"),memento=data,nullEmptyInclude="lastName,dateOfBirth" );// populate many-to-one relationshipvar data = { firstName ="Luis", role =1// "role" is the name of the many-to-one relational property, and one is the key value};var user =ormService.populate( target=ormService.new("User"), memento=data, composeRelationships=true );// the role relationship will be composed, and the value will be set to the appropriate instance of the Role model// populate one-to-many relationshipvar data = { firstName ="Luis", favColors = "1,2,3" ( or [1,2,3] ) // favColors is the name of the one-to-many relational property, and 1, 2 and 3 are key values of favColor models
};var user =ormService.populate( target=ormService.new("User"), memento=data, composeRelationships=true );// the favColors property will be set to an array of favColor entities// only compose some relationshipsvar data = { firstName ="Luis", role =1, favColors = [ 1,3,19 ]};var user = ormService.populate( target=ormService.new("User"), memento=data, composeRelationships=true, exclude="favColors" );
// in this example, "role" will be composed, but "favColors" will be excluded