Skripting für Kartenseiten

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 5 Minuten Lesedauer

    • Das Feld Skript im Formular „Kartenseite“ ermöglicht die Verwendung von Attributen oder anwenderdefiniertem Code zum Definieren von Kartenmerkmalen, z. B. Markerdarstellung, Anzeigeinformationen usw.

    Skripting – Zuordnungselementattribute

    Die folgenden Attribute sind verfügbar.
    Hinweis:
    Verwenden Sie zum Erstellen eines Elements auf der Karte Map.addItem(glideRecord) Methode. Übergeben Sie einen gültigen GlideRecord an addItem().
    Attribut Beschreibung
    name Name, der zur Identifizierung verwendet wird.
    latitude Wenn Sie eine Adresse definieren, ist der Breitengrad nicht erforderlich.
    longitude Wenn Sie eine Adresse definieren, ist der Längengrad nicht erforderlich.
    icon URL des Symbols, das für die Markierung angezeigt werden soll. Wenn kein anwenderdefiniertes Symbol angegeben ist, wird die standardmäßige Google-Markierung verwendet.
    Icon_width Breite des Symbols. Der Standardwert ist 32.
    Icon_height Höhe des Symbols. Der Standardwert ist 32.
    table_name Tabelle, deren Datensätze angezeigt werden, wenn auf das Markierungssymbol geklickt wird. Wird mit verwendet sys_idAttribut.
    sys_id SYS_ID des Datensatzes, der angezeigt wird, wenn auf das Markierungssymbol geklickt wird. Wird mit verwendet table_nameAttribut.
    Ansicht Ansicht des Formulars, das im Dialogfeld angezeigt wird, wenn auf das Markierungssymbol geklickt wird.
    HTML Beliebiger HTML-Code für das Popup-Fenster. Wenn verwendet, überschreibt dieser Wert das Dialogfeld.
    Marker_label Optionaler Beschriftungstext des Markierungssymbols.
    Label_Offset_left Optionales Attribut, das mit verwendet wird marker_labelZum Definieren der horizontalen Position der Markierungsbezeichnung. Der Standardwert ist 0.
    Label_Offset_Top Optionales Attribut, das mit verwendet wird marker_labelZum Definieren der vertikalen Position der Markierungsbezeichnung. Der Standardwert ist 0.

    Skripting – anwenderdefiniertes Kartenseitenverhalten für Smartphone

    Wenn Sie von einem Smartphone aus auf die Kartenseite zugreifen möchten, können Sie das anwenderdefinierte Verhalten der Smartphone-Schnittstelle mit festlegen isMobileVariable. Sie können verwenden isMobileVariable zum Festlegen des anwenderdefinierten Verhaltens für die Smartphone-Ansicht der Karte. Sie können beispielsweise verschiedene Werte für festlegen icon_widthUnd icon_heightAttribute wenn isMobileIst „wahr“.

    Standardkartenseitenskript

    Dieses Skript zeigt alle aktiven, kritischen Incident-Standorte an.
    //setup new GlideRecord query on the incident table
var now_GR = new GlideRecord("incident");
//add condition for priority 1
gr.addQuery('priority', '1');
//add condition for active incidents
gr.addActiveQuery();
//execute the query
gr.query();
 
//loop through the list of incidents returned by the query
while (gr.next()) {
 
 //create a new map item to display - linked to the current incident record
 var item = map.addItem(now_GR);
 //add the latitude value from the incident's location
 item.latitude = gr.location.latitude;
 //add the longitude value from the incident's location
 item.longitude = gr.location.longitude;
 //link to the icon image
 item.icon = "http://maps.google.com/mapfiles/kml/pal3/icon51.png";
 //set the icon size
 item.icon_width = "16";
 item.icon_height = "16";
}

    IsMobile-Kartenseitenskript

    Dieses Skript zeigt alle aktiven, kritischen Incident-Standorte mit anwenderdefinierten Einstellungen für Smartphone-Anwender an.
    //setup new GlideRecord query on the incident table
var now_GR = new GlideRecord("incident");
//add condition for priority 1
gr.addQuery('priority', '1');
//add condition for active incidents
gr.addActiveQuery();
//execute the query
gr.query();
 
//loop through the list of incidents returned by the query
while (gr.next()) {
 
 //create a new map item to display - linked to the current incident record
 var item = map.addItem(now_GR);
 //add the latitude value from the incident's location
 item.latitude = gr.location.latitude;
 //add the longitude value from the incident's location
 item.longitude = gr.location.longitude;
 //link to the icon image
 item.icon = "http://maps.google.com/mapfiles/kml/pal3/icon51.png";
 
 //set the icon size (use smaller icons for smartphone users)
 if (isMobile) {
   item.icon_width = "12";
   item.icon_height = "12";
 }
 else { 
   item.icon_width = "16";
   item.icon_height = "16";
 }
}

    Erweitertes Kartenseitenskript

    Dieses Skript zeigt die Anzahl der offenen Incidents nach Standort an. Die Größe des Symbols hängt von der Anzahl der offenen Incidents für den Standort ab. Mit dem HTML-Parameter werden auch der Standortname und die Anzahl der Incidents sowie ein Link zur Liste der zugehörigen Incidents angezeigt. 
    //get the instances url so we can link back to it
var uri = gs.getProperty("glide.servlet.uri");
//create an aggregate query on the incident table
var count = new GlideAggregate('incident');
//set condition for active incidents
count.addQuery('active', 'true');
//set aggregate field to location to get count by location
count.addAggregate('COUNT', 'location');
//execute the query
count.query();
 
//loop through the results
while (count.next()) {
 
 //get the current record's location
 var loc = count.location;
 //get the count of incidents for this location
 var locCount = count.getAggregate('COUNT', 'location');
 //only display location is there are active incidents
 if (locCount > 0) {
 //create new new map item for this location
 var item = map.addItem(count);
 //set lat/long from the location record
 item.latitude = loc.latitude;
 item.longitude = loc.longitude;
 //build the link to the list of incidents for the location
 var link = 'href=' + uri + 'incident_list.do?sysparm_query=active%3Dtrue^location%3D' + loc;
 //build the html value to be displayed when you click the map icon
 item.html='<a ' + link + '>' + loc.getDisplayValue() + ' (' + locCount + ')</a>';
 //link to the icon image
 item.icon = "http://maps.google.com/mapfiles/kml/pal3/icon51.png";
 //set the size of the icon based on the number of active incidents
 if (locCount < 5) {
 item.icon_width = "12";
 item.icon_height = "12";
 }
 else if (locCount < 15) {
 item.icon_width = "16";
 item.icon_height = "16";
 }
 else {
 item.icon_width = "32";
 item.icon_height = "32";
 }
 }
}

    Beschriftungsskript für Kartenseitenmarkierung

    Mit Markerbezeichnungen können Sie Markierungen dynamischen Text hinzufügen. In diesem Beispiel wird die Anzahl der aktiven Incidents an jedem Standort angezeigt.
    Abbildung : 1. Kartenmarkerbezeichnungen
    //get the instances url so we can link back to it
var uri = gs.getProperty("glide.servlet.uri");
//create an aggregate query on the incident table
var count = new GlideAggregate('incident');
//set condition for active incidents
count.addQuery('active', 'true');
//set aggregate field to location to get count by location
count.addAggregate('COUNT', 'location');
//execute the query
count.query();
 
//loop through the results
while (count.next()) {
 
 //get the current record's location
 var loc = count.location;
 //get the count of incidents for this location
 var locCount = count.getAggregate('COUNT', 'location');
 //only display location is there are active incidents
 if (locCount > 0) {
 //create new new map item for this location
 var item = map.addItem(count);
 //set lat/long from the location record
 item.latitude = loc.latitude;
 item.longitude = loc.longitude; 
 
 //create a marker label with the count
 item.marker_label = locCount;
 //define label offset for proper position
 item.label_offset_left = -4;
 item.label_offset_top = -20;
 
 //option to define table and record for label hyperlink
 //setting table and sys_id will override the use of html parameter
 //item.table = 'cmn_location';
 //item.sys_id = loc;
 
 //build the link to the list of incidents for the location
 var link = 'href=' + uri + 'incident_list.do?sysparm_query=active%3Dtrue^location%3D' + loc;
 //build the html value to be displayed when you click the map icon
 item.html='<a ' + link + '>' + loc.getDisplayValue() + ' (' + locCount + ')</a>';
 
 //link to the icon image
 item.icon = "images/red_marker.png";
 //set the size of the icon based on the number of active incidents
 item.icon_width = 24;
 item.icon_height = 24;
 
 }
}