Related Lists

Das Feature „Related Lists“ ermöglicht es, Daten innerhalb der Anwendung sowie aus anderen Drittanbieter-Diensten abzurufen und anzuzeigen. Dies ist nützlich, wenn Sie Daten aus verschiedenen Entitäten vergleichen möchten.

Sie können Related Lists für folgende Module erstellen:

• Artikel
• Kunden und Lieferanten
• Verkäufe – Angebote, Rechnungen, Verkaufsaufträge, Retainer-Rechnungen und Gutschriften
• Einkäufe – Ausgaben, Rechnungen, Einkaufsaufträge und Lieferanten-Gutschriften
• Projekte

Ein Related List erstellen

Es gibt zwei Möglichkeiten, ein Related List zu erstellen:

• Mit einem Lookup-Custom-Feld
• Mit einem Deluge-Skript

Mit einem Lookup-Custom-Feld

Das Lookup-Custom-Feld ermöglicht es, Daten aus einem Modul in ein anderes Modul von Zoho Books zu übertragen und dort zu nutzen. Wenn Sie ein Lookup-Feld in einem Modul erstellen, werden die zugehörigen Details als Related List im anderen Modul verfügbar sein.

Mit einem Deluge-Skript

Mit Deluge-Skripten können Sie Zoho Books mit anderen Drittanbietern verbinden, um deren Daten abzurufen.

Um ein Related List mit Deluge zu erstellen:

• Gehe zu Einstellungen in der oberen rechten Ecke.
• Gehe zum Modul, für das du ein Related List erstellen möchtest. In diesem Fall das Modul Kunden und Lieferanten.
• Gehe zur Registerkarte Related Lists.
• Klicke in der oberen rechten Ecke auf + Neue Related List.
• Gib den Namen der Related List ein.
• Wählen Sie Wer kann diese verknüpfte Liste anzeigen? Sie können zwischen Nur ich und Jeder wählen.
• Schreiben Sie ein Deluge-Skript, um Daten aus dem verbundenen Drittanbieter zu erhalten. In diesem Fall aus Zoho Desk.

• Klicken Sie auf Speichern oder auf Speichern und Ausführen, um die Funktion auszuführen.

Die Listen werden unter dem Register „Verknüpfte Listen“ in den entsprechenden Modulen angezeigt.

Hinweis:

• Das Deluge-Skript muss ein Map-Objekt zurückgeben, das die Felder „header_context“ und „data“ enthält, im folgenden Format:

   {
  header_context: [
  {
  key: 'customer_name',
  value: 'Customer Name'
  },
  {
  key: 'invoice_number',
  value: 'Invoice Number
  }
  ],
  data: [
  {
  customer_name: <customer_name>,
  invoice_number: <invoice_number>
  }
  ]
  } 
  

• Es gibt zwei Möglichkeiten, den Wert des Datenknotens anzugeben:
  • Als Zeichenkette anzeigen:

    customer_name: <customer_name>

  • Als Hyperlink anzeigen:

    customer_name: {
    "value": <customer_name>,
    "isExternal":true, // Um den Link in einer separaten Tab zu öffnen.
    "link": <web_url_path>
    } 
    

• Das Deluge-Skript kann ein Map-Objekt zurückgeben, das auch das Feld „page_context“ enthält. Wenn Sie alle Transaktionsdaten auf einmal abrufen, kann dies zu einer längeren Antwortzeit führen. Um dieses Problem zu lösen, kann das Feld „page_context“ hilfreich sein, um die Datensätze pro Seite zu teilen und sie schneller abzurufen. Zum Beispiel können Sie 50 Transaktionsdatensätze für Ihre Kunden in 10 Datensätze pro Seite aufteilen und die benötigten Daten schneller abrufen, indem Sie page_context verwenden.
• Wenn Sie mit dem Deluge-Skript Datensätze pro Seite abrufen möchten, müssen Sie das Feld „page_context“ im zurückgegebenen Wert des Deluge-Skripts hinzufügen und es sollte die folgenden Eigenschaften haben:
  • page: string
  • per_page: string
  • has_more_page: boolean (Soll bei Erreichen des letzten Datensatzes auf false gesetzt werden)

    {
      header_context: [{...}, {...}],
      data: [{...}],
      page_context: {
      per_page: '10',
      page: '1',
      has_more_page: true/false
      }
      } 
    

Eine verknüpfte Liste bearbeiten

Um eine verknüpfte Liste zu bearbeiten:

• Gehe zu Einstellungen in der oberen rechten Ecke.
• Wählen Sie das Modul aus, in dem die verknüpfte Liste vorhanden ist.
• Klicken Sie auf das Register Verknüpfte Listen.
• Bewegen Sie den Mauszeiger über die Liste, die Sie bearbeiten möchten.
• Klicken Sie auf das Dropdown-Icon und wählen Sie Bearbeiten.

Eine verknüpfte Liste als inaktiv markieren

Sie können eine verknüpfte Liste temporär deaktivieren, indem Sie sie als inaktiv markieren. Hier ist wie:

• Gehe zu Einstellungen in der oberen rechten Ecke.
• Wählen Sie den Modul aus, der die zugehörige Liste enthält.
• Klicken Sie auf die Related Lists-Option.
• Bewegen Sie den Mauszeiger über die zugehörige Liste, die Sie deaktivieren möchten.
• Klicken Sie auf das Dropdown-Icon und wählen Sie Mark as Inactive aus.

Eine zugehörige Liste als aktiv markieren

Um eine inaktive zugehörige Liste als aktiv zu markieren:

• Gehe zu Einstellungen im oberen rechten Bereich.
• Wählen Sie das Modul aus, das die zugehörige Liste enthält.
• Klicken Sie auf die Related Lists-Option.
• Bewegen Sie den Mauszeiger über die inaktive zugehörige Liste, die Sie als aktiv markieren möchten.
• Klicken Sie auf das Dropdown-Icon und wählen Sie Mark as Active aus.

Eine zugehörige Liste löschen

Um eine zugehörige Liste zu löschen:

• Gehe zu Einstellungen im oberen rechten Bereich.
• Wählen Sie das Modul aus, das die zugehörige Liste enthält.
• Klicken Sie auf die Related Lists-Option.
• Bewegen Sie den Mauszeiger über die Liste, die Sie löschen möchten.
• Klicken Sie auf das Dropdown-Icon und wählen Sie Löschen aus.
  
• Klicken Sie auf OK im Popup, um die Aktion zu bestätigen.

Beispielfunktion

Hier ist ein Beispielfunktion für Szenario 2, die es Benutzern von Zoho Books ermöglicht, Kundendaten in Zoho Desk zu sehen:

 searchMap = Map();  
searchMap.put('fullName',customer.get("contact_name"));  
searchMap.put('orgId',XXXXX);//Zoho desk orgId  
searchList = invokeurl  
[  
	url :"https://desk.zoho.in/api/v1/contacts/search"  
	type :GET  
	parameters:searchMap  
	connection:"zohodesk"  
];  
contacts = searchList.get('data').toList();  
contact = contacts.get('0');  
contactId = contact.get('id');  

fromIndex = (page_context.get('page').toNumber() - 1) * page_context.get('per_page').toNumber();  
happinessList = invokeurl  
[  
	url :"https://desk.zoho.in/api/v1/customerHappiness?include=contacts,agents,tickets&department=allDepartment&from=" + fromIndex + "&limit=10&contactId=" + contactId  
	type :GET  
	connection:"zohodesk"  
];  
happinessList = happinessList.get('data').toList();  

headerData = List();  
headerData.add({"key":"ticket.ticketNumber","value":"Ticket Number"});  
headerData.add({"key":"rating","value":"Rating"});  
headerData.add({"key":"feedback","value":"Feedback"});  
headerData.add({"key":"agent.lastName","value":"Agent Last Name"});  

happinessCount = invokeurl  
[  
	url :"https://desk.zoho.in/api/v1/customerHappiness/count?department=allDepartment&contactId=" + contactId  
	type :GET  
	connection:"zohodesk"  
];  
happinessCount = happinessCount.get('allDepartment');  
totalCount = happinessCount.get('okay') + happinessCount.get('bad') + happinessCount.get('good');  

pageContext = Map();
pageContext.put('page',page_context.get('page'));
pageContext.put('per_page',page_context.get('per_page'));
pageContext.put('has_more_page',false);
if(totalCount >= page_context.get('page').toNumber() * page_context.get('per_page').toNumber())
{
	pageContext.put('has_more_page',true);
}

resultMap = Map();
resultMap.put("header_context",headerData);
resultMap.put("data",happinessList);
resultMap.put("page_context",pageContext);
return resultMap; 

Hat dieses Dokument Ihnen geholfen?

Ja

Nein

Hat dieses Dokument Ihnen geholfen?

Geben Sie Ihre Kommentare oder Rückmeldungen zu dieser Seite ein

Geben Sie Ihre E-Mail-Adresse ein

Aktualisieren

Geben Sie die Zeichen aus dem Bild oben ein

Durch Klicken auf 'Absenden' stimmen Sie unseren Datenschutzrichtlinie .

Absenden Abbrechen

Submit

Submit

Vielen Dank für Ihre Rückmeldung!