Python SDK Samples - Layouts Operations
Get Layouts
Get a Layout
from zcrmsdk.src.com.zoho.crm.api.layouts import *
class Layout(object):
@staticmethod
def get_layout(module_api_name, layout_id):
"""
This method is used to get metadata about a single layout of a module with layoutID and print the response.
:param module_api_name: The API Name of the layout's module
:param layout_id: The ID of the layout to be obtained
"""
"""
example
module_api_name = "Leads"
layout_id = 3477061000000091055
"""
# Get instance of LayoutsOperations Class that takes module_api_name as parameter
layouts_operations = LayoutsOperations(module_api_name)
# Call get_layout method that takes layout_id as parameter
response = layouts_operations.get_layout(layout_id)
if response is not None:
# Get the status code from response
print('Status Code: ' + str(response.get_status_code()))
if response.get_status_code() in [204, 304]:
print('No Content' if response.get_status_code() == 204 else 'Not Modified')
return
# Get object from response
response_object = response.get_object()
if response_object is not None:
# Check if expected FileBodyWrapper instance is received.
if isinstance(response_object, ResponseWrapper):
# Get the list of obtained Layout instances
layouts_list = response_object.get_layouts()
for layout in layouts_list:
if layout.get_created_time() is not None:
# Get the CreatedTime of each Layout
print('Layout CreatedTime: ' + str(layout.get_created_time()))
# Check if ConvertMapping is not None
if layout.get_convert_mapping() is not None:
# Get the ConvertMapping map
for key, value in layout.get_convert_mapping().items():
print(key + " : " + str(value))
if layout.get_modified_time() is not None:
# Get the CreatedTime of each Layout
print('Layout ModifiedTime: ' + str(layout.get_modified_time()))
# Get the Visibility of each Layout
print("Layout Visible: " + str(layout.get_visible()))
# Get the createdFor User instance of each Layout
created_for = layout.get_created_for()
if created_for is not None:
# Get the Name of the created_for User
print("Layout Created For - Name: " + created_for.get_name())
# Get the ID of the created_for User
print("Layout Created For - ID: " + str(created_for.get_id()))
# Get the Name of each Layout
print("Layout Name: " + layout.get_name())
# Get the modifiedBy User instance of each Layout
modified_by = layout.get_modified_by()
# Check if modified_by is not None
if modified_by is not None:
# Get the Name of the modified_by User
print("Layout Modified By - Name: " + modified_by.get_name())
# Get the ID of the modified_by User
print("Layout Modified By - ID: " + str(modified_by.get_id()))
# Get the profiles of each Layout
profiles = layout.get_profiles()
# Check if profiles is not null
if profiles is not None:
for profile in profiles:
# Get the Default of each Profile
print("Layout Profile Default: " + str(profile.get_default()))
# Get the Name of each Profile
print("Layout Profile Name: " + profile.get_name())
# Get the ID of each Profile
print("Layout Profile ID: " + str(profile.get_id()))
print("Layout ID: " + str(layout.get_id()))
# Get the modifiedBy User instance of each Layout
created_by = layout.get_created_by()
# Check if created_by is not None
if created_by is not None:
# Get the Name of the created_by User
print("Layout Created By - Name: " + created_by.get_name())
# Get the ID of the created_by User
print("Layout Created By - ID: " + str(created_by.get_id()))
# Get the sections of each Layout
sections = layout.get_sections()
# Check if sections is not None
if sections is not None:
for section in sections:
# Get the DisplayLabel of each Section
print("Layout Section DisplayLabel: " + str(section.get_display_label()))
# Get the SequenceNumber of each Section
print("Layout Section SequenceNumber: " + str(section.get_sequence_number()))
# Get the Issubformsection of each Section
print("Layout Section Issubformsection: " + str(section.get_issubformsection()))
# Get the TabTraversal of each Section
print("Layout Section TabTraversal: " + str(section.get_tab_traversal()))
# Get the APIName of each Section
print("Layout Section APIName: " + str(section.get_api_name()))
# Get the Name of each Section
print("Layout Section Name: " + str(section.get_name()))
# Get the ColumnCount of each Section
print("Layout Section ColumnCount: " + str(section.get_column_count()))
# Get the GeneratedType of each Section
print("Layout Section GeneratedType: " + str(section.get_generated_type()))
# Get the fields of each Section
fields = section.get_fields()
# Check if fields is not None
if fields is not None:
for field in fields:
Layout.print_field(field)
# Get the properties instance of each Section
properties = section.get_properties()
# Check if properties is not null
if properties is not None:
# Get the ReorderRows of Properties
print("Layout Section Properties ReorderRows: " + str(properties.get_reorder_rows()))
# Get the tooltip instance of the Properties
tool_tip = properties.get_tooltip()
# Check if tooltip is not None
if tool_tip is not None:
# Get the Name of the ToolTip
print("Layout Section Properties ToolTip Name: " + tool_tip.get_name())
# Get the Value of the ToolTip
print("Layout Section Properties ToolTip Value: " + str(tool_tip.get_value()))
# Get the MaximumRows of each Properties
print("Layout Section Properties MaximumRows: " + str(properties.get_maximum_rows()))
print("Layout Status: " + str(layout.get_status()))
# Check if the request returned an exception
elif isinstance(response_object, APIException):
# Get the Status
print("Status: " + response_object.get_status().get_value())
# Get the Code
print("Code: " + response_object.get_code().get_value())
print("Details")
# Get the details dict
details = response_object.get_details()
for key, value in details.items():
print(key + ' : ' + str(value))
# Get the Message
print("Message: " + response_object.get_message().get_value())
@staticmethod
def print_field(field):
# Get the ID of each Field
print('Field ID: ' + str(field.get_id()))
# Get the SystemMandatory of each Field
print("Field SystemMandatory: " + str(field.get_system_mandatory()))
# Get the Webhook of each Field
print("Field Webhook: " + str(field.get_webhook()))
# Get the JsonType of each Field
print("Field JsonType: " + str(field.get_json_type()))
# Get the obtained Crypt instance
crypt = field.get_crypt()
if crypt is not None:
print("Crypt Details")
# Get the Crypt Mode
print("Mode: " + str(crypt.get_mode()))
# Get the Crypt Column
print("Column: " + str(crypt.get_column()))
# Get the Crypt Table
print("Table: " + str(crypt.get_table()))
# Get the Crypt Status
print("Status: " + str(crypt.get_status()))
# Get the FieldLabel of each Field
print("Field FieldLabel: " + str(field.get_field_label()))
tool_tip = field.get_tooltip()
if tool_tip is not None:
# Get the Name of the ToolTip
print("Field ToolTip Name: " + tool_tip.get_name())
# Get the Value of the ToolTip
print("Field ToolTip Value: " + tool_tip.get_value())
# Get the CreatedSource of each Field
print("Field CreatedSource: " + field.get_created_source())
# Get the FieldReadOnly of each Field
print("Field FieldReadOnly: " + str(field.get_field_read_only()))
# Get the DisplayLabel of each Field
print("Field DisplayLabel: " + field.get_display_label())
# Get the ReadOnly of each Field
print("Field ReadOnly: " + str(field.get_read_only()))
# Get the obtained AssociationDetails instance
association_details = field.get_association_details()
if association_details is not None:
# Get the obtained LookupField instance
lookup_field = association_details.get_lookup_field()
if lookup_field is not None:
# Get the ID of the LookupField
print("Field AssociationDetails LookupField ID: " + str(lookup_field.get_id()))
# Get the Name of the LookupField
print('Field AssociationDetails LookupField Name: ' + lookup_field.get_name())
# Get the obtained LookupField instance
related_field = association_details.get_related_field()
if related_field is not None:
# Get the ID of the RelatedField
print("Field AssociationDetails RelatedField ID: " + str(related_field.get_id()))
# Get the Name of the RelatedField
print('Field AssociationDetails RelatedField Name: ' + related_field.get_name())
if field.get_quick_sequence_number() is not None:
# Get the QuickSequenceNumber of each Field
print('Field QuickSequenceNumber: ' + str(field.get_quick_sequence_number()))
if field.get_businesscard_supported() is not None:
# Get the BusinesscardSupported of each Field
print('Field BusinesscardSupported: ' + str(field.get_businesscard_supported()))
# Check if MultiModuleLookup is not None
if field.get_multi_module_lookup() is not None:
# Get the MultiModuleLookup dict
for key, value in field.get_multi_module_lookup().items():
print(key + " : " + str(value))
# Get the obtained Currency instance
currency = field.get_currency()
if currency is not None:
# Get the RoundingOption of the Currency
print("Field Currency RoundingOption: " + str(currency.get_rounding_option()))
if currency.get_precision() is not None:
# Get the Precision of the Currency
print("Field Currency Precision: " + str(currency.get_precision()))
if field.get_custom_field() is not None:
# Get if the Field is a CustomField
print("Field CustomField: " + str(field.get_custom_field()))
lookup = field.get_lookup()
if lookup is not None:
# Get the obtained Layout instance
layout = lookup.get_layout()
# Check if layout is not null
if layout is not None:
# Get the ID of the Layout
print("Field ModuleLookup Layout ID: " + str(layout.get_id()))
# Get the Name of the Layout
print("Field ModuleLookup Layout Name: " + str(layout.get_name()))
# Get the DisplayLabel of the Module
print("Field ModuleLookup DisplayLabel: " + str(lookup.get_display_label()))
# Get the APIName of the Module
print("Field ModuleLookup APIName: " + str(lookup.get_api_name()))
# Get the Module of the ModuleLookup
print("Field ModuleLookup Module: " + str(lookup.get_module()))
if lookup.get_id() is not None:
# Get the ID of the Module
print("Field ModuleLookup ID: " + str(lookup.get_id()))
if field.get_visible() is not None:
# Get the Visible of each Field
print("Field Visible: " + str(field.get_visible()))
if field.get_length() is not None:
# Get the Length of each Field
print("Field Length: " + str(field.get_length()))
view_type = field.get_view_type()
if view_type is not None:
# Get the View of the ViewType
print("Field ViewType View: " + str(view_type.get_view()))
# Get the Edit of the ViewType
print("Field ViewType Edit: " + str(view_type.get_edit()))
# Get the Create of the ViewType
print("Field ViewType Create: " + str(view_type.get_create()))
# Get the QuickCreate of the ViewType
print("Field ViewType QuickCreate: " + str(view_type.get_quick_create()))
subform = field.get_subform()
if subform is not None:
# Get the obtained Layout instance
layout = subform.get_layout()
# Check if layout is not null
if layout is not None:
# Get the ID of the Layout
print("Field Subform Layout ID: " + str(layout.get_id()))
# Get the Name of the Layout
print("Field Subform Layout Name: " + str(layout.get_name()))
# Get the DisplayLabel of the Module
print("Field Subform DisplayLabel: " + str(subform.get_display_label()))
# Get the APIName of the Module
print("Field Subform APIName: " + str(subform.get_api_name()))
# Get the Module of the ModuleLookup
print("Field Subform Module: " + str(subform.get_module()))
if subform.get_id() is not None:
# Get the ID of the Module
print("Field Subform ID: " + str(subform.get_id()))
# Get the APIName of each Field
print("Field APIName : " + field.get_api_name())
# Get the obtained Unique instance
unique = field.get_unique()
if unique is not None:
# Get the Casesensitive of the Unique
print("Field Unique Casesensitive : " + str(unique.get_casesensitive()))
if field.get_history_tracking() is not None:
# Get the HistoryTracking of each Field
print("Field HistoryTracking: " + str(field.get_history_tracking()))
# Get the DataType of each Field
print("Field DataType: " + field.get_data_type())
# Get the Object obtained Formula instance
formula = field.get_formula()
# Check if formula is not null
if formula is not None:
# Get the ReturnType of the Formula
print('Field Formula ReturnType : ' + str(formula.get_return_type()))
if formula.get_expression() is not None:
# Get the Expression of the Formula
print("Field Formula Expression : " + str(formula.get_expression()))
if field.get_decimal_place() is not None:
# Get the DecimalPlace of each Field
print("Field DecimalPlace: " + str(field.get_decimal_place()))
# Get the MassUpdate of each Field
print("Field MassUpdate: " + str(field.get_mass_update()))
if field.get_blueprint_supported() is not None:
# Get the BlueprintSupported of each Field
print("Field BlueprintSupported: " + str(field.get_blueprint_supported()))
multi_select_lookup = field.get_multiselectlookup()
# Check if multiSelectLookup is not None
if multi_select_lookup is not None:
# Get the DisplayValue of the MultiSelectLookup
print("Field MultiSelectLookup DisplayLabel: " + str(multi_select_lookup.get_display_label()))
# Get the LinkingModule of the MultiSelectLookup
print("Field MultiSelectLookup LinkingModule: " + str(multi_select_lookup.get_linking_module()))
# Get the LookupApiname of the MultiSelectLookup
print("Field MultiSelectLookup LookupApiname: " + str(multi_select_lookup.get_lookup_apiname()))
# Get the APIName of the MultiSelectLookup
print("Field MultiSelectLookup APIName: " + str(multi_select_lookup.get_api_name()))
# Get the ConnectedlookupApiname of the MultiSelectLookup
print("Field MultiSelectLookup ConnectedlookupApiname: " + str(multi_select_lookup.get_connectedlookup_apiname()))
# Get the ID of the MultiSelectLookup
print("Field MultiSelectLookup ID: " + str(multi_select_lookup.get_id()))
pick_list_values = field.get_pick_list_values()
if pick_list_values is not None:
for pick_list_value in pick_list_values:
# Get the DisplayValue of each PickListValue
print("Field PickListValue DisplayValue: " + pick_list_value.get_display_value())
if pick_list_value.get_sequence_number() is not None:
# Get the SequenceNumber of each PickListValue
print("Field PickListValue SequenceNumber: " + str(pick_list_value.get_sequence_number()))
# Get the ExpectedDataType of each PickListValue
print("Field PickListValue ExpectedDataType: " + str(pick_list_value.get_expected_data_type()))
# Get the ActualValue of each PickListValue
print("Field PickListValue ActualValue: " + str(pick_list_value.get_actual_value()))
if pick_list_value.get_maps() is not None:
# Get each value from the map
for map in pick_list_value.get_maps():
print(str(map))
# Get the SysRefName of each PickListValues
print("Field PickListValue SysRefName: " + str(pick_list_value.get_sys_ref_name()))
# Get the Type of each PickListValues
print("Field PickListValue Type: " + str(pick_list_value.get_type()))
auto_number = field.get_auto_number()
# Check if autoNumber is not None
if auto_number is not None:
# Get the Prefix of the AutoNumber
print('Prefix: ' + str(auto_number.get_prefix()))
# Get the Suffix of the AutoNumber
print('Suffix: ' + str(auto_number.get_suffix()))
if auto_number.get_start_number() is not None:
# Get the StartNumber of the AutoNumber
print('Start Number: ' + str(auto_number.get_start_number()))
if field.get_default_value() is not None:
# Get the DefaultValue of each Field
print("Field DefaultValue: " + str(field.get_default_value()))
if field.get_section_id() is not None:
# Get the SectionId of each Field
print("Field SectionId: " + str(field.get_section_id()))
# Check if ValidationRule is not None
if field.get_validation_rule() is not None:
# Get the validationRule dict
for key, value in field.get_validation_rule().items():
print(key + " : " + value)
# Check if ConvertMapping is not None
if field.get_convert_mapping() is not None:
# Get the validationRule dict
for key, value in field.get_convert_mapping().items():
print(key + " : " + str(value))