This commit is contained in:
2020-03-12 18:37:31 +00:00
parent 73662fab87
commit 2ac227875f
5 changed files with 215 additions and 175 deletions

View File

@@ -40,10 +40,6 @@ namespace AyaNova.Api.Controllers
serverState = apiServerState; serverState = apiServerState;
} }
TODO: need a db schema table and objects to hold the picklist templates
//while they may have an ID to make them easier to work with, they are fetched and stored by the object type only (which is a type of id and unique so maybe it's still id
//but not an autonumber type id, have to check into that)
/// <summary> /// <summary>
@@ -70,7 +66,9 @@ TODO: need a db schema table and objects to hold the picklist templates
if (!ModelState.IsValid) if (!ModelState.IsValid)
return BadRequest(new ApiErrorResponse(ModelState)); return BadRequest(new ApiErrorResponse(ModelState));
var o = await biz.GetPickListAsync(ayaType, query); var UserRoles = UserRolesFromContext.Roles(HttpContext.Items);
var o = await biz.GetPickListAsync(ayaType, query, UserRoles);
if (o == null) if (o == null)
return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND)); return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND));
@@ -84,14 +82,25 @@ TODO: need a db schema table and objects to hold the picklist templates
/// </summary> /// </summary>
/// <returns>List of strings</returns> /// <returns>List of strings</returns>
[HttpGet("TemplateList")] [HttpGet("TemplateList")]
public ActionResult GetTemplateList() public async Task<IActionResult> GetTemplateList()
{ {
if (!serverState.IsOpen) if (!serverState.IsOpen)
{ {
return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason));
} }
return Ok(ApiOkResponse.Response(PickListFactory.GetListOfAllPickListKeyNames(), true)); //Instantiate the business object handler
PickListBiz biz = PickListBiz.GetBiz(ct, HttpContext);
var o = await biz.GetListOfAllPickListKeyNames();
if (o == null)
return NotFound(new ApiErrorResponse(ApiErrorCode.NOT_FOUND));
return Ok(ApiOkResponse.Response(o, true));
} }
@@ -100,7 +109,7 @@ TODO: need a db schema table and objects to hold the picklist templates
/// <summary> /// <summary>
/// POST (replace) Pick List template /// POST (replace) Pick List template
/// </summary> /// </summary>
/// <param name="aytype"></param> /// <param name="ayaType"></param>
/// <param name="template"></param> /// <param name="template"></param>
/// <returns></returns> /// <returns></returns>
[HttpPost("Template/{ayatype}")] [HttpPost("Template/{ayatype}")]
@@ -132,7 +141,7 @@ TODO: need a db schema table and objects to hold the picklist templates
return StatusCode(409, new ApiErrorResponse(ApiErrorCode.CONCURRENCY_CONFLICT)); return StatusCode(409, new ApiErrorResponse(ApiErrorCode.CONCURRENCY_CONFLICT));
} }
return Ok(ApiOkResponse.Response(new { ConcurrencyToken = o.ConcurrencyToken }, true)); return NoContent();
} }
@@ -140,10 +149,10 @@ TODO: need a db schema table and objects to hold the picklist templates
/// Delete customized template /// Delete customized template
/// (revert to default) /// (revert to default)
/// </summary> /// </summary>
/// <param name="ayatype"></param> /// <param name="ayaType"></param>
/// <returns>Ok</returns> /// <returns>Ok</returns>
[HttpDelete("Template/{ayatype}")] [HttpDelete("Template/{ayatype}")]
public async Task<IActionResult> DeletePickListTemplate([FromRoute] AyaType ayatype) public async Task<IActionResult> DeletePickListTemplate([FromRoute] AyaType ayaType)
{ {
if (!serverState.IsOpen) if (!serverState.IsOpen)
return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason)); return StatusCode(503, new ApiErrorResponse(ApiErrorCode.API_CLOSED, null, serverState.Reason));
@@ -158,7 +167,7 @@ TODO: need a db schema table and objects to hold the picklist templates
if (!Authorized.HasDeleteRole(HttpContext.Items, biz.BizType)) if (!Authorized.HasDeleteRole(HttpContext.Items, biz.BizType))
return StatusCode(403, new ApiNotAuthorizedResponse()); return StatusCode(403, new ApiNotAuthorizedResponse());
if (!await biz.DeleteAsync(o)) if (!await biz.DeleteAsync(ayaType))
return BadRequest(new ApiErrorResponse(biz.Errors)); return BadRequest(new ApiErrorResponse(biz.Errors));
return NoContent(); return NoContent();

View File

@@ -6,7 +6,7 @@ using Newtonsoft.Json.Linq;
using AyaNova.Util; using AyaNova.Util;
using AyaNova.Api.ControllerHelpers; using AyaNova.Api.ControllerHelpers;
using AyaNova.Models; using AyaNova.Models;
using AyaNova.DataList; //using AyaNova.PickList;
namespace AyaNova.Biz namespace AyaNova.Biz
@@ -56,24 +56,20 @@ namespace AyaNova.Biz
//get picklist //get picklist
internal async Task<List<NameIdItem>> GetPickListAsync(AyaType ayaType, string query) internal async Task<List<NameIdItem>> GetPickListAsync(AyaType ayaType, string query, AuthorizationRoles userRoles)
{ {
//TODO: Use picklist objects to formulate and query and return results throw new System.NotImplementedException();
List<NameIdItem> items = new List<NameIdItem>(); // List<NameIdItem> items = await PickListFetcher.GetResponseAsync(ayaType, query, ct, UserId, userRoles);
// if (!string.IsNullOrWhiteSpace(listKey)) // return items;
// { }
// items = await ct.DataListView
// .AsNoTracking()
// .Where(m => m.ListKey == listKey && (m.Public == true || m.UserId == UserId))
// .OrderBy(m => m.Name)
// .Select(m => new NameIdItem()
// {
// Id = m.Id,
// Name = m.Name
// }).ToListAsync();
// }
return items; //get picklist templates, basically all the object types that support picklists
internal async Task<List<NameIdItem>> GetListOfAllPickListKeyNames()
{
throw new System.NotImplementedException();
// List<NameIdItem> items = await PickListFetcher.GetResponseAsync(ayaType, query, ct, UserId, userRoles);
// return items;
} }
@@ -84,59 +80,64 @@ namespace AyaNova.Biz
// //
//put //put
internal async Task<bool> PutAsync(DataListView dbObj, DataListView inObj) internal async Task<bool> ReplaceAsync(AyaType ayaType, string template)
{ {
//preserve the owner ID if none was specified throw new System.NotImplementedException();
if (inObj.UserId == 0) // //preserve the owner ID if none was specified
inObj.UserId = dbObj.UserId; // if (inObj.UserId == 0)
// inObj.UserId = dbObj.UserId;
//Replace the db object with the PUT object // //Replace the db object with the PUT object
CopyObject.Copy(inObj, dbObj, "Id"); // CopyObject.Copy(inObj, dbObj, "Id");
//Set "original" value of concurrency token to input token // //Set "original" value of concurrency token to input token
//this will allow EF to check it out // //this will allow EF to check it out
ct.Entry(dbObj).OriginalValues["ConcurrencyToken"] = inObj.ConcurrencyToken; // ct.Entry(dbObj).OriginalValues["ConcurrencyToken"] = inObj.ConcurrencyToken;
await ValidateAsync(dbObj, false); // await ValidateAsync(dbObj, false);
if (HasErrors) // if (HasErrors)
return false; // return false;
await ct.SaveChangesAsync(); // await ct.SaveChangesAsync();
//Log modification and save context // //Log modification and save context
await EventLogProcessor.LogEventToDatabaseAsync(new Event(UserId, dbObj.Id, BizType, AyaEvent.Modified), ct); // await EventLogProcessor.LogEventToDatabaseAsync(new Event(UserId, dbObj.Id, BizType, AyaEvent.Modified), ct);
return true; //return true;
} }
//////////////////////////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////////////////////////////////////
//DELETE //DELETE
// //
internal async Task<bool> DeleteAsync(DataListView dbObj) internal async Task<bool> DeleteAsync(AyaType ayaType)
{ {
//REMOVE ANY RECORD WITH SAME AYATYPE ID
throw new System.NotImplementedException();
//Determine if the object can be deleted, do the deletion tentatively //Determine if the object can be deleted, do the deletion tentatively
//Probably also in here deal with tags and associated search text etc //Probably also in here deal with tags and associated search text etc
//FUTURE POSSIBLE NEED //FUTURE POSSIBLE NEED
//ValidateCanDelete(dbObj); //ValidateCanDelete(dbObj);
if (HasErrors) // if (HasErrors)
return false; // return false;
ct.DataListView.Remove(dbObj); // ct.DataListView.Remove(dbObj);
await ct.SaveChangesAsync(); // await ct.SaveChangesAsync();
//Delete sibling objects // //Delete sibling objects
//Event log process delete // //Event log process delete
await EventLogProcessor.DeleteObjectLogAsync(UserId, BizType, dbObj.Id, dbObj.Name, ct); // await EventLogProcessor.DeleteObjectLogAsync(UserId, BizType, dbObj.Id, dbObj.Name, ct);
//Delete search index // //Delete search index
//Search.ProcessDeletedObjectKeywords(dbObj.Id, BizType); // //Search.ProcessDeletedObjectKeywords(dbObj.Id, BizType);
return true; // return true;
} }
//////////////////////////////////////////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////////////////////////////////////////
@@ -147,164 +148,164 @@ namespace AyaNova.Biz
private async Task ValidateAsync(DataListView inObj, bool isNew) private async Task ValidateAsync(DataListView inObj, bool isNew)
{ {
//UserId required // //UserId required
if (!isNew) // if (!isNew)
{ // {
if (inObj.UserId == 0) // if (inObj.UserId == 0)
AddError(ApiErrorCode.VALIDATION_REQUIRED, "UserId"); // AddError(ApiErrorCode.VALIDATION_REQUIRED, "UserId");
} // }
//Name required // //Name required
if (string.IsNullOrWhiteSpace(inObj.Name)) // if (string.IsNullOrWhiteSpace(inObj.Name))
AddError(ApiErrorCode.VALIDATION_REQUIRED, "Name"); // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Name");
//Name must be less than 255 characters // //Name must be less than 255 characters
if (inObj.Name.Length > 255) // if (inObj.Name.Length > 255)
AddError(ApiErrorCode.VALIDATION_LENGTH_EXCEEDED, "Name", "255 max"); // AddError(ApiErrorCode.VALIDATION_LENGTH_EXCEEDED, "Name", "255 max");
//If name is otherwise OK, check that name is unique // //If name is otherwise OK, check that name is unique
if (!PropertyHasErrors("Name")) // if (!PropertyHasErrors("Name"))
{ // {
//Use Any command is efficient way to check existance, it doesn't return the record, just a true or false // //Use Any command is efficient way to check existance, it doesn't return the record, just a true or false
if (await ct.DataListView.AnyAsync(m => m.Name == inObj.Name && m.Id != inObj.Id)) // if (await ct.DataListView.AnyAsync(m => m.Name == inObj.Name && m.Id != inObj.Id))
{ // {
AddError(ApiErrorCode.VALIDATION_NOT_UNIQUE, "Name"); // AddError(ApiErrorCode.VALIDATION_NOT_UNIQUE, "Name");
} // }
} // }
if (string.IsNullOrWhiteSpace(inObj.ListKey)) // if (string.IsNullOrWhiteSpace(inObj.ListKey))
AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListKey"); // AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListKey");
var DataList = DataListFactory.GetAyaDataList(inObj.ListKey); // var DataList = DataListFactory.GetAyaDataList(inObj.ListKey);
if (DataList == null) // if (DataList == null)
{ // {
AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListKey", $"ListKey \"{inObj.ListKey}\" DataListKey is not valid"); // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListKey", $"ListKey \"{inObj.ListKey}\" DataListKey is not valid");
} // }
if (inObj.ListKey.Length > 255) // if (inObj.ListKey.Length > 255)
AddError(ApiErrorCode.VALIDATION_LENGTH_EXCEEDED, "ListKey", "255 max"); // AddError(ApiErrorCode.VALIDATION_LENGTH_EXCEEDED, "ListKey", "255 max");
//Filter json must parse
//this is all automated normally so not going to do too much parsing here
//just ensure it's basically there
if (!string.IsNullOrWhiteSpace(inObj.ListView))
{
try
{
var v = JArray.Parse(inObj.ListView);
for (int i = 0; i < v.Count; i++)
{
var filterItem = v[i];
if (filterItem["fld"] == null)
AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListView", $"ListView array item {i}, object is missing required \"fld\" property ");
else
{
var fld = filterItem["fld"].Value<string>();
if (string.IsNullOrWhiteSpace(fld))
AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListView", $"ListView array item {i}, \"fld\" property is empty and required");
//validate the field name if we can
if (DataList != null)
{
var TheField = DataList.FieldDefinitions.SingleOrDefault(x => x.FieldKey.ToLowerInvariant() == fld);
if (TheField == null)
{
AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListView", $"ListView array item {i}, fld property value \"{fld}\" is not a valid value for ListKey specified");
}
}
}
//This is the old filter validation code but at this point only going to validate that the fields are present and valid as the bare minimum
// if (filterItem["op"] == null)
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing required \"op\" property ");
// else
// {
// var opType = filterItem["op"].Value<string>();
// if (!DataListFilterComparisonOperator.Operators.Contains(opType))
// AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Filter", $"Filter array item {i}, \"op\" property value of \"{opType}\" is not a valid FilterComparisonOperator type");
// }
// if (filterItem["value"] == null)
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ");
// else
// {
// //check if the value is present, not what it is exactly, just that it's present
// //value also could contain relative date tokens, not that it checks them anyway but just noting it here
// if (filterItem["value"].Type == JTokenType.String && string.IsNullOrWhiteSpace(filterItem["value"].Value<string>()))
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ");
// if (filterItem["value"].Type == JTokenType.Array && filterItem["value"].Count() == 0)
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ARRAY ");
// }
//NOTE: value of nothing, null or empty is a valid value so no checking for it here
}
}
catch (Newtonsoft.Json.JsonReaderException ex)
{
AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListView", "ListView is not valid JSON string: " + ex.Message);
}
}
// //VALIDATE SORT
// //Filter json must parse // //Filter json must parse
// if (!string.IsNullOrWhiteSpace(inObj.Sort)) // //this is all automated normally so not going to do too much parsing here
// //just ensure it's basically there
// if (!string.IsNullOrWhiteSpace(inObj.ListView))
// { // {
// try // try
// { // {
// var v = JArray.Parse(inObj.Sort); // var v = JArray.Parse(inObj.ListView);
// for (int i = 0; i < v.Count; i++) // for (int i = 0; i < v.Count; i++)
// { // {
// var sortItem = v[i]; // var filterItem = v[i];
// if (sortItem["fld"] == null) // if (filterItem["fld"] == null)
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, object is missing required \"fld\" property "); // AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListView", $"ListView array item {i}, object is missing required \"fld\" property ");
// else // else
// { // {
// var fld = sortItem["fld"].Value<string>(); // var fld = filterItem["fld"].Value<string>();
// if (string.IsNullOrWhiteSpace(fld)) // if (string.IsNullOrWhiteSpace(fld))
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, \"fld\" property is empty and required"); // AddError(ApiErrorCode.VALIDATION_REQUIRED, "ListView", $"ListView array item {i}, \"fld\" property is empty and required");
// //validate the field name if we can // //validate the field name if we can
// if (DataList != null) // if (DataList != null)
// { // {
// if (!DataList.FieldDefinitions.Exists(x => x.FieldKey.ToLowerInvariant() == fld && x.IsFilterable)) // var TheField = DataList.FieldDefinitions.SingleOrDefault(x => x.FieldKey.ToLowerInvariant() == fld);
// if (TheField == null)
// { // {
// AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", $"Sort array item {i}, fld property value \"{fld}\" is not a valid value for ListKey specified"); // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListView", $"ListView array item {i}, fld property value \"{fld}\" is not a valid value for ListKey specified");
// } // }
// } // }
// } // }
// if (sortItem["dir"] == null) // //This is the old filter validation code but at this point only going to validate that the fields are present and valid as the bare minimum
// AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, object is missing required \"dir\" sort direction property "); // // if (filterItem["op"] == null)
// else // // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing required \"op\" property ");
// { // // else
// var sortDir = sortItem["dir"].Value<string>(); // // {
// if (sortDir != "+" && sortDir != "-") // // var opType = filterItem["op"].Value<string>();
// AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", $"Sort array item {i}, \"dir\" property value of \"{sortDir}\" is not a valid sort direction value, must be \"+\" or \"-\" only"); // // if (!DataListFilterComparisonOperator.Operators.Contains(opType))
// } // // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Filter", $"Filter array item {i}, \"op\" property value of \"{opType}\" is not a valid FilterComparisonOperator type");
// // }
// // if (filterItem["value"] == null)
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ");
// // else
// // {
// // //check if the value is present, not what it is exactly, just that it's present
// // //value also could contain relative date tokens, not that it checks them anyway but just noting it here
// // if (filterItem["value"].Type == JTokenType.String && string.IsNullOrWhiteSpace(filterItem["value"].Value<string>()))
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ");
// // if (filterItem["value"].Type == JTokenType.Array && filterItem["value"].Count() == 0)
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Filter", $"Filter array item {i}, object is missing or is empty the required \"value\" property ARRAY ");
// // }
// //NOTE: value of nothing, null or empty is a valid value so no checking for it here // //NOTE: value of nothing, null or empty is a valid value so no checking for it here
// } // }
// } // }
// catch (Newtonsoft.Json.JsonReaderException ex) // catch (Newtonsoft.Json.JsonReaderException ex)
// { // {
// AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", "Sort is not valid JSON string: " + ex.Message); // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "ListView", "ListView is not valid JSON string: " + ex.Message);
// } // }
// } // }
// // //VALIDATE SORT
// // //Filter json must parse
// // if (!string.IsNullOrWhiteSpace(inObj.Sort))
// // {
// // try
// // {
// // var v = JArray.Parse(inObj.Sort);
// // for (int i = 0; i < v.Count; i++)
// // {
// // var sortItem = v[i];
// // if (sortItem["fld"] == null)
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, object is missing required \"fld\" property ");
// // else
// // {
// // var fld = sortItem["fld"].Value<string>();
// // if (string.IsNullOrWhiteSpace(fld))
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, \"fld\" property is empty and required");
// // //validate the field name if we can
// // if (DataList != null)
// // {
// // if (!DataList.FieldDefinitions.Exists(x => x.FieldKey.ToLowerInvariant() == fld && x.IsFilterable))
// // {
// // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", $"Sort array item {i}, fld property value \"{fld}\" is not a valid value for ListKey specified");
// // }
// // }
// // }
// // if (sortItem["dir"] == null)
// // AddError(ApiErrorCode.VALIDATION_REQUIRED, "Sort", $"Sort array item {i}, object is missing required \"dir\" sort direction property ");
// // else
// // {
// // var sortDir = sortItem["dir"].Value<string>();
// // if (sortDir != "+" && sortDir != "-")
// // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", $"Sort array item {i}, \"dir\" property value of \"{sortDir}\" is not a valid sort direction value, must be \"+\" or \"-\" only");
// // }
// // //NOTE: value of nothing, null or empty is a valid value so no checking for it here
// // }
// // }
// // catch (Newtonsoft.Json.JsonReaderException ex)
// // {
// // AddError(ApiErrorCode.VALIDATION_INVALID_VALUE, "Sort", "Sort is not valid JSON string: " + ex.Message);
// // }
// // }
return; return;
} }

View File

@@ -20,6 +20,7 @@ namespace AyaNova.Models
public virtual DbSet<DataListView> DataListView { get; set; } public virtual DbSet<DataListView> DataListView { get; set; }
public virtual DbSet<Tag> Tag { get; set; } public virtual DbSet<Tag> Tag { get; set; }
public virtual DbSet<FormCustom> FormCustom { get; set; } public virtual DbSet<FormCustom> FormCustom { get; set; }
public virtual DbSet<PickListTemplate> PickListTemplate { get; set; }
//Note: had to add this constructor to work with the code in startup.cs that gets the connection string from the appsettings.json file //Note: had to add this constructor to work with the code in startup.cs that gets the connection string from the appsettings.json file

View File

@@ -0,0 +1,15 @@
using System.ComponentModel.DataAnnotations;
namespace AyaNova.Models
{
//See core-picklist-autocomplete-template-system.txt for details
public partial class PickListTemplate
{
public long Id { get; set; }
public uint ConcurrencyToken { get; set; }
public string Template { get; set; }//JSON fragment of picklist template
}
}

View File

@@ -296,6 +296,20 @@ namespace AyaNova.Util
} }
//////////////////////////////////////////////////
//PICKLISTTEMPLATE table
if (currentSchema < 10)
{
LogUpdateMessage(log);
await ExecQueryAsync("CREATE TABLE apicklisttemplate (id integer NOT NULL PRIMARY KEY, " +
"template text)");
await SetSchemaLevelAsync(++currentSchema);
}
//MAKE SURE THE DESIRED SCHEMA WAS SET PROPERLY //MAKE SURE THE DESIRED SCHEMA WAS SET PROPERLY
if (currentSchema > DESIRED_SCHEMA_LEVEL) if (currentSchema > DESIRED_SCHEMA_LEVEL)
throw new ArgumentOutOfRangeException("AySchema::DesiredSchemaLevel WASN'T SET PROPERLY"); throw new ArgumentOutOfRangeException("AySchema::DesiredSchemaLevel WASN'T SET PROPERLY");