Get User Data
This guide will help you with the following:
- Syntax
- Example
- Response Format
- Additional Example
- Round Robin Assignment
The details about the users of an extension or vertical solution can be fetched using the zoho.crm.getRecords() deluge task.
Syntax
- <Response> = zoho.crm.getRecords("users", <page Long>, <perPage Long>, <userTypeMap map>);
where,
<Response> is the task response returned as a Map.
<Response> is the task response returned as a Map.
Parameters
Example
Fetch all the active users associated with an extension or vertical solution.
- response = zoho.crm.getRecords("users",1,200,{"type":"ActiveUsers"});
- info response;
Note
If in the above script, an empty map is passed for the variable userTypeMap, then all users will be fetched.
userTypeMap = Map();
response = zoho.crm.invokeConnector("crm.getusers",userTypeMap);
userTypeMap = Map();
response = zoho.crm.invokeConnector("crm.getusers",userTypeMap);
Response Format
- {"users":[{"country":null,"role":{"name":"CEO","id":"2853142000000026005"},"city":null,
- "language":"en_US","locale":"en_US","microsoft":false,"Isonline":false,"Modified_By":
- {"name":"Latha Velu","id":"2853142000000131009"},"street":null,"alias":null,
- "id":"2853142000001501001","state":null,"fax":null,"country_locale":"US",
- "first_name":"Brenda","email":"lathav.spring@gmail.com","Reporting_To":null,
- "zip":null,"created_time":"2019-07-30T11:26:00+05:30","Modified_Time":"2019-07-30T11:26:00+05:30",
- "website":null,"time_format":"hh:mm a","offset":19800000,"profile":
- {"name":"Administrator","id":"2853142000000026011"},"mobile":null,"last_name":null,
- "time_zone":"Asia/Kolkata","created_by":{"name":"Latha Velu","id":"2853142000000131009"},
- "zuid":"663254876","confirm":true,"full_name":"Brenda ","territories":[],
- "phone":null,"dob":null,"date_format":"MM/dd/yyyy","status":"active"},
- {"country":"null","role":{"name":"CEO","id":"2853142000000026005"},"customize_info":
- {"notes_desc":null,"show_right_panel":null,"bc_view":null,"show_home":false,
- "show_detail_view":true,"unpin_recent_item":null},"city":null,"signature":null,
- "name_format":"Salutation,First Name,Last Name","language":"en_US","locale":"en_US",
- "microsoft":false,"personal_account":false,"Isonline":true,"default_tab_group":"0",
- "Modified_By":{"name":"Latha Velu","id":"2853142000000131009"},"street":null,"alias":null,
- "theme":{"normal_tab":{"font_color":"#FFFFFF","background":"#222222"},"selected_tab":
- {"font_color":"#FFFFFF","background":"#00FFFFFF"},"new_background":null,"background":"#F3F0EB",
- "screen":"fixed","type":"default"},"id":"2853142000000131009","state":"null","fax":null,
- "country_locale":"US","first_name":"Latha","email":"latha.v@zohocorp.com","Reporting_To":null,
- "zip":null,"decimal_separator":"en_US","created_time":"2017-11-01T22:37:11+05:30",
- "Modified_Time":"2017-11-01T22:37:11+05:30","website":null,"time_format":"hh:mm a",
- "offset":19800000,"profile":{"name":"Administrator","id":"2853142000000026011"},"mobile":null,
- "last_name":"Velu","time_zone":"Asia/Calcutta","created_by":{"name":"Latha Velu","id":"2853142000000131009"},
- "zuid":"650456410","confirm":true,"full_name":"Latha Velu","territories":[],"phone":"null",
- "dob":null,"date_format":"MM/dd/yyyy","status":"active"}],"info":{"per_page":200,"count":2,
- "page":1,"more_records":false}}
Additional Example
Round Robin Assignment
Assign Leads to your users using the round robin method.
- lead_id = input.lead.get("Leads.ID");
- datamap = map();
- datamap.put("module", "Leads");
- datamap.put("id", lead_id);
- resp = zoho.crm.invokeConnector(("crm.get"), datamap);
- resp1 = (resp.get("response")).toMap();
- datalist = resp1.get("data").toJSONList();
- reqq = datalist.get(0).toMap();
- l_number = (reqq.get(("roundrobinleadassignment0.Lead_Number"))).toLong();
- rule = reqq.get(("roundrobinleadassignment0.Assign_Using_Active_Assignment_Rule"));
- m = map();
- resp = zoho.crm.invokeConnector(("crm.getusers"), m);
- respMap = (resp.get("response")).toMap();
- users = respMap.get("users");
- userList = users.toJSONList();
- userIds = List();
- for each user in userList
- {
- eachUser = user.toMap();
- userIds.add(eachUser.get("id"));
- }
- max_lead_level = (userIds.size()).toLong();
- ans = (abs((l_number % max_lead_level))).toLong();
- if (rule == "true")
- {
- ownerid = userIds.get(ans);
- updateMap = Map();
- updateMap.put("Lead_Owner" : ownerid);
- resp = zoho.crm.update("Leads",lead_id,updateMap);
- }
Response
- {"status_code":200,"response":"{"users":[{"zip":6000049,"phone":9876543210,"fax":null,
- "status":"active","website":"http://www.zoho.com","street":null,"state":"Tamil Nadu",
- "country":"in","city":"Chennai","alias_name":null,"first_name":"Zoho","timezone":"Asia/Calcutta",
- "zuid":"3032021", "email":"platform+demo@zohocorp.com ","dob":22.2.1993,"last_name":Demo,
- "time_format":null, "role":"CEO","user_id":"1297376000000094003","language":"en_US",
- "confirm":true,"mobile":"9500080429","full_name":"Zoho Demo ","profile":"Administrator"},
- {"zip":null,"phone":null,"fax":null,"status":"deleted","website":null,"street":null,
- "state":null,"country":null,"city":null, "alias_name":null,"first_name":"Zoho1",
- "timezone":"Asia/Kolkata","zuid":null,"email":"platform+demo1@zohocorp.com ",
- "dob":null,"last_name":"Demo1","time_format":null,"role":"CEO","user_id":"1297376000000108007",
- "language":"en","confirm":true,"mobile":null,"full_name":"Zoho1 Demo1","profile":"Administrator"}]}"}
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Zoho DataPrep Resources
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Get URL
The get URL Deluge task corresponds to a HTTP GET request. It is normally supported by services to perform read-only operations like fetching data from external websites. By default, it supports websites running in port 80 and 443. Syntax a. To get a ...Data Access - Add Records
This guide will help you with the following: Overview Return Syntax Things to keep in mind Applicable data-type and expression for each field Example Overview The add record deluge task creates a new record with given values in the specified form. ...Data Access - Update records
This guide will help you with the following: Overview Syntax Applicable data-type and expression for each field Things to keep in mind Example Overview The update records deluge task updates(replaces) the value of a specified field with the given ...Data Access - Collection variable
This guide will help you with the following: Overview Declaring a collection variable Aggregate functions Fetch field value from the first record Fetch values of a field from all the records in a collection Updating field value in a collection ...Data types
This guide will help you with the following: Text Number Decimal Boolean Data-time Time List Key-value Text data type The text, or string, datatype represents a sequence of characters. These characters can be text characters, special characters, ...
New to Zoho LandingPage?
Zoho LandingPage Resources