general.js

(function (global) {
"use strict";
//**********************************************************************
// 
// Date: 26-10-2021
// Version: 1.0
// Author: M.Faase
// Description: registers a temporary namespace handler on the current library
//
//**********************************************************************
function registerNamespace(namespace) {
var variable = global,
parts = namespace.split('.');
parts.forEach(function (part) {
if (typeof variable[part] === 'undefined') {
variable[part] = {};
}
variable = variable[part];
});
return variable;
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: sets a function to be called when the OnChange event occurs
//
//**********************************************************************
function addOnChange(formContext, fieldName, functionName) {
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(functionName);
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: retrieves the value of a field
//
//**********************************************************************
function getValue(formContext, fieldName) {
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
return attribute.getValue();
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: retrieves the GUID related to value of the lookup
//
//**********************************************************************
function getLookupValue(formContext, fieldName) {
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
var attrValue = attribute.getValue();
if (attrValue !== null && attrValue.length > 0 && attrValue[0] !== null)
return attrValue[0].id;
else
return null;
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: sets a value to the lookup
//
//**********************************************************************
function setLookupValue(formContext, fieldName, id, name, entityType) {
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
var lookupVal = new Array();
lookupVal[0] = new Object();
lookupVal[0].id = id;
lookupVal[0].name = name;
lookupVal[0].entityType = entityType;
//Set value to the lookup
attribute.setValue(lookupVal);
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: sets a value to uppercase
//
//**********************************************************************
function addOnChangeUpperCase(executionContext, fieldName, uniqueId)
{
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(function(executionContext) {upperCase(formContext, fieldName, uniqueId)});
}
function upperCase(formContext, fieldName, uniqueId)
{
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
var sValue = attribute.getValue();
sValue = sValue.toUpperCase();
//Set value to the lookup
attribute.setValue(sValue);
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: capitalize the first char, rest lower case
//
//**********************************************************************
function addOnChangeCapitalize(executionContext, fieldName, uniqueId)
{
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(function(executionContext) {capitalize(formContext, fieldName, uniqueId)});
}
function capitalize(formContext, fieldName, uniqueId)
{
try
{
var sValue = formContext.getAttribute(fieldName).getValue();
//Empty?
if (sValue === null)
return;
var sFormatField = sValue.charAt(0).toUpperCase() + sValue.slice(1).toLowerCase();
formContext.getAttribute(fieldName).setValue(sFormatField);
}
catch(e)
{
//Display errormessage
formContext.ui.setFormNotification(e.message, "ERROR", uniqueId);
}
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: capitalize the first char, rest no change
//
//**********************************************************************
function addOnChangeCapitalizeFirst(executionContext, fieldName, uniqueId)
{
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(function(executionContext) {capitalizeFirst(formContext, fieldName, uniqueId)});
}
function capitalizeFirst(formContext, fieldName, uniqueId)
{
try
{
var sValue = formContext.getAttribute(fieldName).getValue();
//Empty?
if (sValue === null)
return;
var sFormatField = sValue.charAt(0).toUpperCase() + sValue.slice(1);
formContext.getAttribute(fieldName).setValue(sFormatField);
}
catch(e)
{
//Display errormessage
formContext.ui.setFormNotification(e.message, "ERROR", uniqueId);
}
}
//**********************************************************************
//
// Date: 22-12-2020
// Version: 1.0
// Author: HSO
// Description: capitalize the first char of each word, rest no change
//
//**********************************************************************
function addOnChangeCapitalizeAll(executionContext, fieldName, uniqueId)
{
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(function(executionContext) {capitalizeAll(formContext, fieldName, " ", uniqueId)});
}
function capitalizeAll(formContext, fieldName, SeperateChar, uniqueId)
{
try
{
var sValue = formContext.getAttribute(fieldName).getValue();
//Empty?
if (sValue === null)
return;
var sArr = sValue.split(SeperateChar);
var aWords = [];
for(var i = 0 ; i < sArr.length ; i++ )
{
var sFirstLetter = sArr[i].charAt(0).toUpperCase();
var sRestOfWord = sArr[i].slice(1);
aWords[i] = sFirstLetter + sRestOfWord;
}
formContext.getAttribute(fieldName).setValue(aWords.join(SeperateChar));
}
catch(e)
{
//Display errormessage
formContext.ui.setFormNotification(e.message, "ERROR", uniqueId);
}
}
//**********************************************************************
//
// Date: 26-10-2021
// Version: 1.0
// Author: M.Faase
// Description: validate and format the PhoneNumber
//
//**********************************************************************
function addOnChangeValidatedPhoneNumber(executionContext, fieldName, countryField, uniqueId) {
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var phoneAttribute = formContext.getAttribute(fieldName);
var countryAttribute = formContext.getAttribute(countryField);
//Attribute bound to the control?
if ((phoneAttribute === null) || (countryAttribute === null))
return null;
//Sets a function to be called
phoneAttribute.addOnChange(function(executionContext) {validatedPhoneNumber(formContext, fieldName, countryField, uniqueId)});
countryAttribute.addOnChange(function(executionContext) {validatedPhoneNumber(formContext, fieldName, countryField, uniqueId)});
}
function validatedPhoneNumber(formContext, fieldName, countryField, uniqueId)
{debugger;
try
{
//Retrieve PhoneNumber
var phoneNumber = getValue(formContext, fieldName);
//Retrieve country
var countryId = getLookupValue(formContext, countryField);
//Remove message
formContext.getControl(fieldName).clearNotification(uniqueId);
formContext.ui.clearFormNotification(uniqueId);
//Construct request
var req = {};
req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"PhoneNumber": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"CountryCode": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Format": {
"typeName": "Edm.Int32",
"structuralProperty": 1
}
},
operationType: 0,
operationName: "hso_GeneralCheckPhoneNumber"
};
};
//PhoneNumber and Country filled in?
if ((phoneNumber !== null) && (countryId !== null))
{
Xrm.WebApi.retrieveRecord("dys_country", countryId, "?$select=cnxt_isocode2").then(
function success(detail) {
req.PhoneNumber = phoneNumber;
req.Format = 0;
//ISO-code filled in?
if (detail.cnxt_isocode2 !== null)
{
req.CountryCode = detail.cnxt_isocode2;
}
else
{
req.CountryCode = "NL";
}
Xrm.WebApi.online.execute(req).then(
function (data) {
if(data.ok){
data.json().then(function(response){
if (response.ScenarioCode === "CPN001")
{
formContext.getAttribute(fieldName).setValue(response.FormattedPhoneNumber);
}
else
{
formContext.getControl(fieldName).setNotification(response.Message, uniqueId);
formContext.getAttribute(fieldName).setValue("");
}
})
}
else
{
formContext.getControl(fieldName).setNotification("Error retrieving PhoneNumber", uniqueId);
}
},
function (error) {
//Display errormessage
formContext.ui.setFormNotification(error.message, "ERROR", uniqueId);
}
);
},
function (error) {
//Display errormessage
formContext.ui.setFormNotification(error.message, "ERROR", uniqueId);
}
);
}
}
catch(e) {
//Display errormessage
formContext.ui.setFormNotification(e.message, "ERROR", uniqueId);
}
}
//**********************************************************************
//
// Date: 26-10-2021
// Version: 1.0
// Author: M.Faase
// Description: validate the format of a PostalCode
//
//**********************************************************************
function addOnChangeValidatedPostalCode(executionContext, fieldName, countryField, uniqueId) {
//Set form context
var formContext = executionContext.getFormContext();
//Returns the attribute that the control is bound to.
var attribute = formContext.getAttribute(fieldName);
//Attribute bound to the control?
if (attribute === null)
return null;
//Sets a function to be called
attribute.addOnChange(function(executionContext) {validatedPostalCode(formContext, fieldName, countryField, uniqueId)});
}
function validatedPostalCode(formContext, fieldName, countryField, uniqueId) {
try
{
//Retrieve PostalCode
var postalCode = getValue(formContext, fieldName);
//Retrieve country
var countryId = getLookupValue(formContext, countryField);
//Remove message
formContext.getControl(fieldName).clearNotification(uniqueId);
formContext.ui.clearFormNotification(uniqueId);
//Construct request
var req = {};
req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"PostalCode": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"CountryCode": {
"typeName": "Edm.String",
"structuralProperty": 1
}
},
operationType: 0,
operationName: "hso_GeneralCheckPostalCode"
};
};
//PostalCode and Country filled in?
if ((postalCode !== null) && (countryId !== null))
{
Xrm.WebApi.retrieveRecord("dys_country", countryId, "?$select=cnxt_isocode2").then(
function success(detail) {
req.PostalCode = postalCode;
//ISO-code filled in?
if (detail.cnxt_isocode2 !== null)
{
req.CountryCode = detail.cnxt_isocode2;
}
else
{
req.CountryCode = "NL";
}
Xrm.WebApi.online.execute(req).then(
function (data) {
if(data.ok){
data.json().then(function(response){
if (response.ScenarioCode === "CPC001")
{
formContext.getAttribute(fieldName).setValue(response.FormattedPostalCode);
}
else
{
formContext.getControl(fieldName).setNotification(response.Message, uniqueId);
formContext.getAttribute(fieldName).setValue("");
}
})
}
else
{
formContext.getControl(fieldName).setNotification("Error retrieving PostalCode", uniqueId);
}
},
function (error) {
//Display errormessage
formContext.ui.setFormNotification(error.message, "ERROR", uniqueId);
}
);
},
function (error) {
//Display errormessage
formContext.ui.setFormNotification(error.message, "ERROR", uniqueId);
}
);
}
}
catch(e) {
//Display errormessage
formContext.ui.setFormNotification(e.message, "ERROR", uniqueId);
}
}
var namespace = registerNamespace('hso.general');
namespace.addOnChange = addOnChange;
namespace.getValue = getValue;
namespace.getLookupValue = getLookupValue;
namespace.setLookupValue = setLookupValue;
namespace.addOnChangeUpperCase = addOnChangeUpperCase;
namespace.addOnChangeCapitalize = addOnChangeCapitalize;
namespace.addOnChangeCapitalizeFirst = addOnChangeCapitalizeFirst;
namespace.addOnChangeCapitalizeAll = addOnChangeCapitalizeAll;
namespace.addOnChangeValidatedPhoneNumber = addOnChangeValidatedPhoneNumber;
namespace.addOnChangeValidatedPostalCode = addOnChangeValidatedPostalCode;
})(window);