Kartenfenster im Jitterbit App Builder

App Builder verfügt über eine Karten-Bedienfeldoption, die die Anzeige einer Karte unterstützt, auf der Steuerelemente über den geografischen Standort visualisiert werden können. Verschiedene über die Highmaps API bereitgestellte Karten können basierend auf den Daten ausgewählt werden, die angezeigt werden sollen.

Die Namen der Kartenregionen in Ihrem zugrunde liegenden Business-Objekt müssen mit den Kennungen der Highmaps-Quellkarten übereinstimmen. Dies kann besondere Aufmerksamkeit erfordern, um sicherzustellen, dass Ihr Business-Objekt-Schlüssel von der Quellkarte erkannt werden kann.

Wenn Sie beispielsweise ein Geschäftsobjekt mit US-amerikanischen County-Namen haben, sind die County-Namen möglicherweise nicht eindeutig. In diesem Fall müssen Sie über eine Spalte verfügen, die mit dem Schlüssel von Highmaps übereinstimmt.

Nachfolgend sind die Daten zu US-Counties aufgeführt, die aus der Highmaps API abgerufen wurden:

Wenn Ihre Daten einen Bindestrich enthalten, wird die Quellkarte standardmäßig über hc-key verbunden, andernfalls über name. Abhängig von der von Ihnen gewählten Quellkarte kann es Zwischenstandards geben, mit denen die Quellkarte in Ihren bereitgestellten Daten zu verbinden versucht.

Bitte verweisen Sie auf https://api.highcharts.com/highmaps/ für Dokumentation zu den im Kartenfenster bereitgestellten Quellkarten. Sie können auch http://code.highcharts.com/mapdata/ besuchen für Demos der Datensätze.

Kartenfelder ermöglichen es einem Benutzer, in das Diagramm selbst hineinzuzoomen, um einen bestimmten Bereich von Informationen aus dem Diagramm herauszuzoomen. Zum Zoomen klicken Sie mit der linken Maustaste und scrollen vorwärts, dann klicken Sie mit der linken Maustaste und ziehen die Karte in die Richtung, die den gewünschten Fokusbereich in die Mitte des Bildschirms zieht. Zum Herauszoomen klicken Sie mit der linken Maustaste und scrollen rückwärts.

Um ein Kartenfeld zu erstellen, benötigen Sie ein Geschäftsobjekt, das Informationen für die Steuerelemente enthält, die das Diagramm benötigt. Wie bei anderen Diagrammfeldern sind Kategorie und Wert erforderliche Steuerelemente; Farbe und JSON-Optionsobjekt sind optionale Werte, die ebenfalls gespeichert werden können.

Ein Beispiel für ein Geschäftsobjekt hat einen geografischen Standort als Kategorie und eine Menge eines mit dem Standort verknüpften Attributs als Wert.

Beispieldaten

Das zum Erstellen dieser Karte verwendete Geschäftsobjekt verwendet die Northwinds-Tabelle Customers und hat nur zwei Spalten: Country und CountryCount (mit dem Ausdruck Count(1)). Dadurch wird dem Kartenbereich der Ländername und die Anzahl der Kundendatensätze pro Land bereitgestellt.

Die Spalte „Länder“ entspricht der Eigenschaft „Name“ der Highmaps API, was in diesem Fall keine Probleme verursachte, da die Ländernamen eindeutig waren.

So erstellen Sie ein Kartenfeld

Dies setzt voraus, dass Sie bereits über ein Geschäftsobjekt verfügen, das alle Steuerelemente enthält, die Sie für die Arbeit mit dem Kartenfeld benötigen.

1. Erstellen Sie eine dynamische Seite, die das Kartenfeld enthält
2. Fügen Sie der Seite ein Feld hinzu und wählen Sie Karte als Typ
3. Wählen Sie als Quelle das für das Kartenfeld erstellte Geschäftsobjekt

4. Wählen Sie als Kartenquelle eine Karte, die Ihre Daten am besten darstellt.

   • Beispiel ist custom/world/world

5. Fügen Sie die Steuerelemente hinzu, die für den Typ des zu erstellenden Kartenfelds erforderlich sind:

   • Kategorie ist erforderlich. Beispiel: Land
   • Wert ist erforderlich. Beispiel: Länderanzahl
   • JSON-Optionsobjekt ist optional Farbe ist optional

6. Führen Sie die Seite aus und testen Sie das Kartenfeld