What’s New in Xafari 15.2.9010.523

The XafariValueManager class facilitates interaction with IValueManager by exposing 2 methods to get and set the object of the ValueManager.

public static TService Instance
{
get { return XafariValueManager.GetInstance<TService>("Instance"); }
}
public new static SettingsAccessor Instance
{
set { XafariValueManager.SetInstance("Instance", value); }
}

This method returns the CriteriaOperator instance for the specified IMemberInfo.
It is useful when there is a task to create a filter for data selection according to a specified field value.
The method takes into account the specific structure of the filter for XPWeakReference, XPWeakReferenceStruct, GuidWeakReference.
Sample:

interface Object1
{
string String1 {get;set;}
XPWeakReference Weak {get;set;}
}

var criteria = typeof(Object1).Xafari().TypeInfo().FindMember(“String1”).Xafari().GetCriteriaEqualsTo(“1”); // result – “[String1]=’1′”
var criteria2 = typeof(Object1).Xafari().TypeInfo().FindMember(“String1”).Xafari().GetCriteriaEqualsTo(null); // result – “[String1] is null”

var criteria = typeof(Object1).Xafari().TypeInfo().FindMember(“Weak”).Xafari().GetCriteriaEqualsTo(object1); // result – “[Weak.TargetType] = ? AND [Weak.TargetKey] = ?”
var criteria2 = typeof(Object1).Xafari().TypeInfo().FindMember(“Weak”).Xafari().GetCriteriaEqualsTo(null); // result – “[Weak] is null”

• Xafari.Helpers.IMemberInfoHelper
• Xafari.Helpers.IObjectSpaceHelper
• Xafari.Helpers.ITypeInfoHelper
• Xafari.Helpers.ITypesInfoHelper
• Xafari.Helpers.ObjectHelper
• Xafari.Helpers.SessionHelper
• Xafari.Helpers.TypeHelper
• Xafari.Helpers.ViewControllerHelper
• Xafari.Helpers.XafApplicationHelper
• Xafari.Helpers.XafariHelperBase
• Xafari.Helpers.XPMemberInfoHelper

They are intended to replace the usage of static extensions. To learn more, refer to the Helpers topic.

[AliveType(typeof(Object2))] interface Object1 {}
interface Object2 : Object1 {}

This means that in runtime the Object2 type will be used instead of Object1 type. For instance:

Object creation:
var obj1 = objectSpace.Xafari().CreateObject();
The Object2 object will be created.

Data selection:
objectSpace.Xafari().GetObjects(criteriaForObject2);
The only those Object2 objects will be retrieved which satisfy the criteriaForObject2 restrictions.

Why is it needed

Often, the entity that declared at the design of the core system gradually acquired new fields and features. For example, inheritance hierarchy of classes means the Employee entity, but with a different set of fields. In practice, the development and deployment of enterprise systems the many base entities have been extended by one way or another. This can be done both by using classical inheritance, or by the implementation and registering the Extensions (see Xafari XF). Thus, at the stage of actual use of an entity in the application, it may be that it has a number of additional (purchased) capabilities.
Use AliveType allows utilizing these features when the application operates on the basic entity.

• string UserName { get; set; }. The name of the user who owns the record. If the username is empty, it is considered that the record is shared.
• bool IsShared { get; set; }. Calculated (not persistent) property that indicates whether a record is private or shared. If set this property to true, the UserName field will be cleared (reset). If set this property to false, then the current user will be specified in the UserName field. It is assumed that the system administrator changes the value of this property. By default, the property is not displayed in visual forms. If necessary, you can customize the layout of the admin’s form to add this property.
• bool UserIsOwner { get; }. Calculated (not persistent) property which indicates whether the current user is the owner of the current record.

To select from the database all records owned by the current user, use the criteria available through a static property SharedObjectLogic.AvailableSharedObjectsFilter:
using (var objectSpace = Application.CreateObjectSpace()) {
var availableObjects = objectSpace.GetObjects(SharedObjectLogic.AvailableSharedObjectsFilter);
...
}
SharedObjectViewController automatically adds the specified filter to the criteria list of the CollectionSource. This is done for List Views of all objects that support the ISharedObject interface. To control the filter’s activity, it is possible activate/deactivate the SharedObjectViewController from the custom controller:
protected override void OnActivated()
{
base.OnActivated();
Frame.GetController().Active["Deactivated by Controller1"] = false;
}