Welcome to the EntitySpaces 1.5.0 Beta
EntitySpaces Goes Hierarchical ....

The beta is actually pretty solid. However, it is versioned 1.4.3 and available to customers only until the official 1.5.0 is released.

These are our recommendations. Be sure to close MyGeneration and any of your Visual Studio solutions before installing.

• We recommend you install right over the top of your current 1.4.2 release. You can always reinstall the 1.4.2 release if you need to.
• Regenerate your Generated Templates using the "Generated Classes Master" template.
• Next run the "EntitySpaces - Hierarchical" template, this will be located in the EntitySpaces->C#/VB->Generated namespace in the MyGeneration Template Browser. Select all of the tables in your database and generate.  This will create a new file called "EmployeeHierarchical.cs" or "EmployeeHierarchical.vb" for a table named Employee. Include these files in your solution, they should be generated into your generated folder with the rest of your classes.
• Recompile and run ...

There is a new template you can experiment with in the EntitySpaces->esPlugIn namespace named EntitySpaces - Set esPlugin Settings.  You can use this template to override the default setting for EntitySpaces. You will find this very useful to experiment with the naming conventions for the Hierarchical objects, see what you can come up with. Be sure to post any very good settings, we might adopt them as our shipping defaults.

The Basic Tab

The Hierarchical Tab

You can change these settings and regenerate classes and see the effect, just hit OK to save your changes.

In the next BETA release you will not have to run the EntitySpaces - Hierarchical template separately, it will be included in the master and there will be a checkbox to indicate whether or not you want to generated hierarchical code or not.

Release Notes

• Hierarchical support (C# and VB)
• Both VB.NET and C# now support the new LINQ query syntax
• Added CommandTimeout to the EntitySpaces config settings

  <add name="SQLDynamicTest" 
    providerMetadataKey="esDefault" 
    sqlAccessType="DynamicSQL" 
    provider="EntitySpaces.SqlClientProvider" 
    providerClass="DataProvider" 
    connectionString="Password=yadda" 
    commandTimeout="90" 
    databaseVersion="2005" />

• Implemented dOOdads QuerySource trick 

  // Read from a view, save to the core table
  EmployeeCollection empColl = new EmployeeCollection();
  empColl.Query.es.QuerySource = "vEmployee";  // This is a view
  empColl.Query.Load();
  
  Employee emp = empColl[0] as Employee;
  emp.LastName = "ViewsRock";
  empColl.Save();

• New template for esPlugin settings including hierarchical settings (shown earlier)
• Added DetatchEntity/AttachEntity to esEntityCollection
• Add MarkAllColumnsAsDirty to help move records from one database to another
• Fixed template bug that generated an invalid comment when it contained a double-quote (")
• The esEntity.Collection property is now public
• Increased the performance of our Save() logic
• esEntityCollection.IsDirty was incorrectly reporting true after Save, fixed
• Added public class to each provider to fix Visual Studio designer bug

Not in this BETA Version

• Caching
• AddNew fix, esEntityCollection.AddNew should call esEntity.AddNew
• Many other enhancements will make it in before the final release.

We need your input and mileage on this. Normally, our internal testing which is pretty extensive is enough for us to cut a new build, however, this is a major set of new functionality.

- The EntitySpaces Team