Node JS SDK Samples - Layouts Operations
Get Layouts
Get a Layout
const LayoutsOperations = require("@zohocrm/nodejs-sdk-2.0/core/com/zoho/crm/api/layouts/layouts_operations").LayoutsOperations;
const ZCRMLayout = require("@zohocrm/nodejs-sdk-2.0/core/com/zoho/crm/api/layouts/layout").Layout;
const ResponseWrapper = require("@zohocrm/nodejs-sdk-2.0/core/com/zoho/crm/api/layouts/response_wrapper").ResponseWrapper;
const APIException = require("@zohocrm/nodejs-sdk-2.0/core/com/zoho/crm/api/layouts/api_exception").APIException;
class Layout{
/**
* Get Layout
* This method is used to get metadata about a single layout of a module with layoutID and print the response.
* @param {String} moduleAPIName The API Name of the layout's modules
* @param {BigInt} layoutId The ID of the layout to be obtained
*/
static async getLayout(moduleAPIName, layoutId){
//example
//let moduleAPIName = "Leads";
//let layoutId = 3477061000000091055n
//Get instance of LayoutsOperations Class that takes moduleAPIName as parameter
let layoutsOperations = new LayoutsOperations(moduleAPIName);
//Call getLayout method
let response = await layoutsOperations.getLayout(layoutId);
if(response != null){
//Get the status code from response
console.log("Status Code: " + response.statusCode);
if([204, 304].includes(response.statusCode)){
console.log(response.statusCode == 204? "No Content" : "Not Modified");
return;
}
//Get object from response
let responseObject = response.object;
if(responseObject != null){
//Check if expected ResponseWrapper instance is received.
if(responseObject instanceof ResponseWrapper){
let layouts = responseObject.getLayouts();
layouts.forEach(layout => {
if(layout.getCreatedTime() != null){
//Get the CreatedTime of each Layout
console.log("Layout CreatedTime: " + layout.getCreatedTime().toString());
}
//Check if ConvertMapping is not null
if(layout.getConvertMapping() != null){
//Get the MultiModuleLookup map
Array.from(layout.getConvertMapping().keys()).forEach(key => {
console.log(key + ": " + layout.getConvertMapping().get(key));
});
}
if(layout.getModifiedTime() != null){
//Get the ModifiedTime of each Layout
console.log("Layout ModifiedTime: " + layout.getModifiedTime());
}
//Get the Visible of each Layout
console.log("Layout Visible: " + layout.getVisible().toString());
//Get the createdFor User instance of each Layout
let createdFor = layout.getCreatedFor();
//Check if createdFor is not null
if(createdFor != null){
//Get the Name of the createdFor User
console.log("Layout CreatedFor User-Name: " + createdFor.getName());
//Get the ID of the createdFor User
console.log("Layout CreatedFor User-ID: " + createdFor.getId());
//Get the Email of the createdFor User
console.log("Layout CreatedFor User-Email: " + createdFor.getEmail());
}
//Get the Name of each Layout
console.log("Layout Name: " + layout.getName());
//Get the modifiedBy User instance of each Layout
let modifiedBy = layout.getModifiedBy();
//Check if modifiedBy is not null
if(modifiedBy != null){
//Get the Name of the modifiedBy User
console.log("Layout ModifiedBy User-Name: " + modifiedBy.getName());
//Get the ID of the modifiedBy User
console.log("Layout ModifiedBy User-ID: " + modifiedBy.getId());
//Get the Email of the modifiedBy User
console.log("Layout ModifiedBy User-Email: " + modifiedBy.getEmail());
}
//Get the profiles of each Layout
let profiles = layout.getProfiles();
//Check if profiles is not null
if(profiles != null)
{
profiles.forEach(profile => {
//Get the Default of each Profile
console.log("Layout Profile Default: " + profile.getDefault().toString());
//Get the Name of each Profile
console.log("Layout Profile Name: " + profile.getName().toString());
//Get the ID of each Profile
console.log("Layout Profile ID: " + profile.getId().toString());
});
}
//Get the ID of each Layout
console.log("Layout ID: " + layout.getId());
//Get the createdBy User instance of each Layout
let createdBy = layout.getCreatedBy();
//Check if createdBy is not null
if(createdBy != null){
//Get the Name of the createdBy User
console.log("Layout CreatedBy User-Name: " + createdBy.getName());
//Get the ID of the createdBy User
console.log("Layout CreatedBy User-ID: " + createdBy.getId());
//Get the Email of the createdBy User
console.log("Layout CreatedBy User-Email: " + createdBy.getEmail());
}
//Get the sections of each Layout
let sections = layout.getSections();
//Check if sections is not null
if(sections != null)
{
sections.forEach(section => {
//Get the DisplayLabel of each Section
console.log("Layout Section DisplayLabel: " + section.getDisplayLabel());
//Get the SequenceNumber of each Section
console.log("Layout Section SequenceNumber: " + section.getSequenceNumber().toString());
//Get the Issubformsection of each Section
console.log("Layout Section Issubformsection: " + section.getIssubformsection().toString());
//Get the TabTraversal of each Section
console.log("Layout Section TabTraversal: " + section.getTabTraversal().toString());
//Get the APIName of each Section
console.log("Layout Section APIName: " + section.getAPIName());
//Get the ColumnCount of each Section
console.log("Layout Section ColumnCount: " + section.getColumnCount().toString());
//Get the Name of each Section
console.log("Layout Section Name: " + section.getName());
//Get the GeneratedType of each Section
console.log("Layout Section GeneratedType: " + section.getGeneratedType());
//Get the fields of each Section
let fields = section.getFields();
//Check if fields is not null
if(fields != null){
for (let index = 0; index {
console.log(key + ": " + details.get(key));
});
}
//Get the Message
console.log("Message: " + responseObject.getMessage().getValue());
}
}
}
}
static async printField(field){
//Get the ID of each Field
console.log("Field ID: " + field.getId().toString());
//Get the SystemMandatory of each Field
console.log("Field SystemMandatory: " + field.getSystemMandatory().toString());
//Get the Webhook of each Field
console.log("Field Webhook: " + field.getWebhook().toString());
//Get the JsonType of each Field
console.log("Field JsonType: " + field.getJsonType());
//Get the obtained Crypt instance
let crypt = field.getCrypt();
if(crypt != null){
console.log("Crypt Details");
//Get the Crypt Mode
console.log("Mode: " + crypt.getMode());
//Get the Crypt Column
console.log("Column: " + crypt.getColumn());
//Get the Crypt Table
console.log("Table: " + crypt.getTable());
//Get the Crypt Status
console.log("Status: " + crypt.getStatus().toString());
}
//Get the FieldLabel of each Field
console.log("Field FieldLabel: " + field.getFieldLabel());
//Get the obtained Tooltip instance
let toolTip = field.getTooltip();
if(toolTip != null){
//Get the Name of the ToolTip
console.log("Field ToolTip Name: " + toolTip.getName());
//Get the Value of the ToolTip
console.log("Field ToolTip Value: " + toolTip.getValue());
}
//Get the CreatedSource of each Field
console.log("Field CreatedSource: " + field.getCreatedSource());
//Get the FieldReadOnly of each Field
console.log("Field FieldReadOnly: " + field.getFieldReadOnly().toString());
//Get the DisplayLabel of each Field
console.log("Field DisplayLabel: " + field.getDisplayLabel());
//Get the ReadOnly of each Field
console.log("Field ReadOnly: " + field.getReadOnly().toString());
//Get the obtained AssociationDetails instance
let associationDetails = field.getAssociationDetails();
//Check if associationDetails is not null
if(associationDetails != null){
//Get the obtained LookupField instance
let lookupField = associationDetails.getLookupField();
if(lookupField != null){
//Get the ID of the LookupField
console.log("Field AssociationDetails LookupField ID: " + lookupField.getId());
//Get the Name of the LookupField
console.log("Field AssociationDetails LookupField Name: " + lookupField.getName())
}
//Get the obtained LookupField instance
let relatedField = associationDetails.getRelatedField();
if(relatedField != null){
//Get the ID of the relatedField
console.log("Field AssociationDetails RelatedField ID: " + relatedField.getId());
//Get the Name of the relatedField
console.log("Field AssociationDetails RelatedField Name: " + relatedField.getName());
}
}
if(field.getQuickSequenceNumber() != null){
//Get the QuickSequenceNumber of each Field
console.log("Field QuickSequenceNumber: " + field.getQuickSequenceNumber().toString());
}
if(field.getBusinesscardSupported() != null){
//Get the BusinesscardSupported of each Field
console.log("Field BusinesscardSupported: " + field.getBusinesscardSupported().toString());
}
//Check if MultiModuleLookup is not null
if(field.getMultiModuleLookup() != null){
//Get the MultiModuleLookup map
Array.from(field.getMultiModuleLookup().keys()).forEach(key => {
console.log(key + ": " + field.getMultiModuleLookup().get(key));
});
}
//Get the obtained Currency instance
let currency = field.getCurrency();
//Check if currency is not null
if(currency != null){
//Get the RoundingOption of the Currency
console.log("Field Currency RoundingOption: " + currency.getRoundingOption());
if(currency.getPrecision() != null){
//Get the Precision of the Currency
console.log("Field Currency Precision: " + currency.getPrecision().toString());
}
}
if(field.getCustomField() != null){
//Get the CustomField of each Field
console.log("Field CustomField: " + field.getCustomField().toString());
}
//Get the obtained Module instance
let lookup = field.getLookup();
//Check if lookup is not null
if(lookup != null){
//Get the obtained Layout instance
let layout = lookup.getLayout();
//Check if layout is not null
if(layout != null){
//Get the ID of the Layout
console.log("Field ModuleLookup Layout ID: " + layout.getId().toString());
//Get the Name of the Layout
console.log("Field ModuleLookup Layout Name: " + layout.getName());
}
//Get the DisplayLabel of the Module
console.log("Field ModuleLookup DisplayLabel: " + lookup.getDisplayLabel());
//Get the APIName of the Module
console.log("Field ModuleLookup APIName: " + lookup.getAPIName());
//Get the Module of the ModuleLookup
console.log("Field ModuleLookup Module: " + lookup.getModule());
if(lookup.getId() != null){
//Get the ID of the Module
console.log("Field ModuleLookup ID: " + lookup.getId().toString());
}
}
if(field.getVisible() != null){
//Get the Visible of each Field
console.log("Field Visible: " + field.getVisible().toString());
}
if(field.getLength() != null){
//Get the Length of each Field
console.log("Field Length: " + field.getLength().toString());
}
//Get the obtained ViewType instance
let viewType = field.getViewType();
//Check if viewType is not null
if(viewType != null){
//Get the View of the ViewType
console.log("Field ViewType View: " + viewType.getView().toString());
//Get the Edit of the ViewType
console.log("Field ViewType Edit: " + viewType.getEdit().toString());
//Get the Create of the ViewType
console.log("Field ViewType Create: " + viewType.getCreate().toString());
//Get the QuickCreate of the ViewType
console.log("Field ViewType QuickCreate: " + viewType.getQuickCreate().toString());
}
//Get the obtained Module instance
let subform = field.getSubform();
if(subform != null){
//Get the Object obtained Layout instance
let layout = subform.getLayout();
//Check if layout is not null
if(layout != null){
//Get the ID of the Layout
console.log("Field Subform Layout ID: " + layout.getId().toString());
//Get the Name of the Layout
console.log("Field Subform Layout Name: " + layout.getName());
}
//Get the DisplayLabel of the Module
console.log("Field Subform DisplayLabel: " + subform.getDisplayLabel());
//Get the APIName of the Module
console.log("Field Subform APIName: " + subform.getAPIName());
//Get the Module of the Module
console.log("Field Subform Module: " + subform.getModule());
if(subform.getId() != null){
//Get the ID of the Module
console.log("Field Subform ID: " + subform.getId().toString());
}
}
//Get the APIName of each Field
console.log("Field APIName: " + field.getAPIName().toString());
//Get the obtained Unique instance
let unique = field.getUnique();
//Check if unique is not null
if(unique != null){
//Get the Casesensitive of the Unique
console.log("Field Unique Casesensitive : " + unique.getCasesensitive());
}
if(field.getHistoryTracking() != null){
//Get the HistoryTracking of each Field
console.log("Field HistoryTracking: " + field.getHistoryTracking().toString());
}
//Get the DataType of each Field
console.log("Field DataType: " + field.getDataType().toString());
//Get the Object obtained Formula instance
let formula = field.getFormula();
//Check if formula is not null
if(formula != null){
//Get the ReturnType of the Formula
console.log("Field Formula ReturnType : " + formula.getReturnType());
if(formula.getExpression() != null){
//Get the Expression of the Formula
console.log("Field Formula Expression : " + formula.getExpression().toString());
}
}
if(field.getDecimalPlace() != null){
//Get the DecimalPlace of each Field
console.log("Field DecimalPlace: " + field.getDecimalPlace().toString());
}
//Get the MassUpdate of each Field
console.log("Field MassUpdate: " + field.getMassUpdate());
if(field.getBlueprintSupported() != null){
//Get the BlueprintSupported of each Field
console.log("Field BlueprintSupported: " + field.getBlueprintSupported().toString());
}
//Get all entries from the MultiSelectLookup instance
let multiSelectLookup = field.getMultiselectlookup();
//Check if formula is not null
if(multiSelectLookup != null){
//Get the DisplayLabel of the MultiSelectLookup
console.log("Field MultiSelectLookup DisplayLabel: " + multiSelectLookup.getDisplayLabel());
//Get the LinkingModule of the MultiSelectLookup
console.log("Field MultiSelectLookup LinkingModule: " + multiSelectLookup.getLinkingModule());
//Get the LookupApiname of the MultiSelectLookup
console.log("Field MultiSelectLookup LookupApiname: " + multiSelectLookup.getLookupApiname());
//Get the APIName of the MultiSelectLookup
console.log("Field MultiSelectLookup APIName: " + multiSelectLookup.getAPIName());
//Get the ConnectedlookupApiname of the MultiSelectLookup
console.log("Field MultiSelectLookup ConnectedlookupApiname: " + multiSelectLookup.getConnectedlookupApiname());
//Get the ID of the MultiSelectLookup
console.log("Field MultiSelectLookup ID: " + multiSelectLookup.getId());
}
let pickListValues = field.getPickListValues();
if(pickListValues != null){
pickListValues.forEach(pickListValue => {
//Get the DisplayLabel of each PickListValues
console.log("Field PickListValue DisplayValue: " + pickListValue.getDisplayValue());
if(pickListValue.getSequenceNumber() != null){
//Get the SequenceNumber of each PickListValues
console.log(" Field PickListValue SequenceNumber: " + pickListValue.getSequenceNumber().toString());
}
//Get the ExpectedDataType of each PickListValues
console.log("Field PickListValue ExpectedDataType: " + pickListValue.getExpectedDataType());
//Get the ActualValue of each PickListValues
console.log("Field PickListValue ActualValue: " + pickListValue.getActualValue());
if(pickListValue.getMaps() != null){
pickListValue.getMaps().forEach(map => {
//Get each value from the map
console.log(map);
});
}
//Get the SysRefName of each PickListValues
console.log("Field PickListValue SysRefName: " + pickListValue.getSysRefName());
//Get the Type of each PickListValues
console.log("Field PickListValue Type: " + pickListValue.getType());
});
}
let autoNumber = field.getAutoNumber();
//Check if autoNumber is not null
if(autoNumber != null){
//Get the Prefix of the AutoNumber
console.log("Field AutoNumber Prefix: " + autoNumber.getPrefix());
//Get the Suffix of the AutoNumber
console.log("Field AutoNumber Suffix: " + autoNumber.getSuffix());
if(autoNumber.getStartNumber() != null){
//Get the StartNumber of the AutoNumber
console.log("Field AutoNumber StartNumber: " + autoNumber.getStartNumber().toString());
}
}
if(field.getDefaultValue() != null){
//Get the DefaultValue of each Field
console.log("Field DefaultValue: " + field.getDefaultValue().toString());
}
if(field.getSectionId() != null){
//Get the SectionId of each Field
console.log("Field SectionId: " + field.getSectionId().toString());
}
//Check if ValidationRule is not null
if(field.getValidationRule() != null){
//Get the validationRule map
Array.from(field.getValidationRule().keys()).forEach(key => {
console.log(key + ": " + field.getValidationRule().get(key));
});
}
//Check if ConvertMapping is not null
if(field.getConvertMapping() != null)
{
Array.from(field.getConvertMapping().keys()).forEach(key => {
console.log(key + ": " + field.getConvertMapping().get(key));
});
}
}
}
module.exports = {Layout}