Missing documentation for "related lists"

Missing documentation for "related lists"

This question is related to both Zoho Books and Zoho Inventory.

Under settings you can add something called "related lists" to a resource, like items. When I do this I get some sample code of how this is supposed to be implemented:

  2. /*
  3. This is a sample function. It will display the item details.
  4. */
  5. headerData = List();
  6. headerData.add({"key":"name","value":"Name"});
  7. headerData.add({"key":"account_name","value":"Account Name"});
  8. headerData.add({"key":"status","value":"Status"});
  9. headerData.add({"key":"rate","value":"Rate","align":"right"});
  10. details = Map();
  11. details.put("name",{"value":item.get("name"),"isExternal":true,"link":"https://inventory.zoho.com/app#/contacts/" + item.get("item_id")});
  12. details.put("account_name",{"value":item.get("account_name")});
  13. details.put("status",item.get("status"));
  14. details.put("rate",item.get("rate"));
  15. listData = List();
  16. listData.add(details);
  17. resultMap = Map();
  18. resultMap.put("header_context",headerData);
  19. resultMap.put("data",listData);
  20. return resultMap;
But to my knowledge, other than this there is no official documentation and in lack thereof could you clarify what is the use of the following properties:
  1. header_context
  2. data
    1. name
      1. value
      2. isExternal
      3. link
Which of these are optional and which are required? What is their intended use and how will they play into "related lists"?

Many thanks,

Stefan