nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Sedm užitečných tipů, jak začít vytvářet vlastní styl slovníku

megan-r · 2024-11-13T20:13:50+00:00

Dictionary styles poskytují vysoce přizpůsobitelný způsob vizualizace dat bohatých na atributy ve vašich mapách a aplikacích. S look-up table jednotlivých částí symbolu, dictionary script propojující hodnoty atributů s klíči…

megan-r

Dictionary styles <\/SPAN>poskytují<\/SPAN> vysoce přizpůsobitelný způsob vizualizace dat bohatých na atributy ve vašich mapách a aplikacích. S <\/SPAN><\/SPAN>look-up table<\/SPAN><\/SPAN><\/STRONG> jednotlivých částí symbolu, <\/SPAN><\/SPAN>dictionary script<\/SPAN><\/SPAN><\/STRONG> propojující hodnoty atributů s klíči symbolů a <\/SPAN><\/SPAN>configuration file<\/SPAN><\/SPAN><\/STRONG> pro jemné doladění, tyto styly lze použít společně s Dictionary Renderer k vytvoření složitých symbolů řízených více atributy ve vašich datech. <\/SPAN><\/SPAN><\/P>\nVytvořil jsem dictionary style pro vrstvu <\/SPAN><\/SPAN>Alternative Fuel Stations layer<\/SPAN><\/SPAN><\/A> v Living Atlas, která poskytuje informace o každé stanici na první pohled. <\/SPAN><\/SPAN> <\/span><\/P>\n<\/span><\/span><\/span><\/P>\nV tomto blogu se podělím o některé z mých nejlepších tipů pro vytváření vlastního custom dictionary style, zatímco se podrobněji podíváme na ten, který jsem vytvořil. Pokud chcete styl prozkoumat během čtení, zde<\/SPAN> jsou<\/SPAN> odkazy<\/SPAN> na <\/SPAN><\/SPAN>the style<\/SPAN><\/SPAN><\/A> a<\/SPAN> web map<\/A> kde je vrstva již nakonfigurována s tímto stylem. <\/SPAN><\/SPAN><\/SPAN><\/SPAN><\/P>\n

Tip 1 6 Shromážděte zdroje k použití při vytváření vašeho stylu <\/SPAN><\/SPAN><\/H3>\nKdykoli začínám vytvářet nový dictionary style, mám připravené své oblíbené zdroje po ruce. Prvním je tento blog od mého kolegy Thada:
Create custom dictionary styles for ArcGIS.
Blog sdílí všechny nástroje a kroky potřebné k vytvoření vašeho stylu od začátku do konce. Mé oblíbené nástroje jsou:

\n\nDB Browser for SQLite, \nVisual Studio Code, \nArcGIS Pro, a \nPodmnožina dat k testování stylu během tvorby.
\n\nKniha Custom Dictionary Style Guide<\\/A> je další skvělé místo, kde začít s podrobnými, krok za krokem instrukcemi pro vytvoření vlastního custom style. Také rád mám po ruce dictionary renderer toolkit<\\/A>. Toolkit je plný zdrojů pro pochopení, vytváření a řešení problémů s dictionary styles, stejně jako několik ukázkové styly, které stojí za prozkoumání.<\/SPAN> <\/SPAN><\/P>\n

Tip <\/SPAN>2<\/SPAN> 013 Nezapomeňte na vestavěné výchozí symbolové klíče <\/SPAN><\/SPAN><\/SPAN><\/H3>\nKaždá jednotlivá část symbolu má jedinečný klíč definovaný v <\/SPAN>look-up tabulce<\/SPAN><\/STRONG>. Nejlepší způsob, jak vytvářet a upravovat tyto části symbolů, je v ArcGIS Pro. Nejprve přidejte styl do katalogu projektu a poté dvojitým kliknutím otevřete styl Alternative Fuel Stations. Zde najdete všechny části symbolů ve stylu. <\/SPAN> <\/SPAN><\/P>\nNejprve se zaměřme na symboly typu paliva. Existuje 7 symbolů typu paliva a jeden výchozí symbol (k němuž se dostaneme za chvíli), každý s vlastním jedinečným klíčem. S výjimkou výchozího klíče tyto klíče následují formát 2fuel-2 následovaný zkratkou typu paliva nalezenou ve Fuel_Type<\/FONT><\/STRONG> poli. <\/SPAN> <\/SPAN><\/P>\n<\/span><\/P>\n<\/SPAN>dictionary script<\/SPAN><\/STRONG> je Arcade skript, který obsahuje instrukce, jak použít hodnoty atributů k vytvoření symbolových klíčů. Dictionary script používá $feature.Fuel_Typ<\/STRONG>e<\/FONT> k vytvoření klíče typu paliva. Toto je první uvedený klíč, takže když je prvek vyhodnocen, typový klíč je první vrácený. <\/SPAN> <\/SPAN><\/P>\n<\/span><\/P>\nAle co se stane, když <\/SPAN>Fuel_Type<\/STRONG><\/FONT> je prázdné nebo je použito celé jméno, 2lectric2 místo 2LEC2? V těchto hypotetických případech by skript vrátil 2fuel-2 a 2fuel-Electric2, dva klíče, které neexistují v look-up tabulce. Zde přichází na řadu výchozí symbol!<\/SPAN> <\/SPAN><\/P>\nDictionary renderers mají vestavěné výchozí symbolové klíče, které se používají, když první vrácený klíč ve skriptu neexistuje v look-up tabulce. Stačí přidat symbol s následujícím klíčem: 2Invalid_P2 pro body, 2Invalid_L2 pro linie nebo 2Invalid_A2 pro polygony. <\/SPAN><\/P>\nTip <\/SPAN>3<\/SPAN> 013 Měňte hodnoty vlastností symbolů pomocí primitive overrides<\/SPAN><\/SPAN > < \/SPAN>< \/SPAN >< \/H3 >\n< SPAN data - contrast = "none">< SPAN class = "EOP SCXW144453211 BCX0" data - ccp - props = "{& quot ;134233117": stanice specifikuje barvu použitou v přepsání, poColor. Syntaxe pro primitivní přepsání je po:<primitive_name>|<property_name>|<value>. Pro tento styl to znamená, že při kreslení ověřovacího symbolu, pro jakoukoli část symbolu označenou status-color, je Barva nahrazena hodnotou poColor:

Nyní označíme části symbolu názvem primitivu. Toto přepsání bude aplikováno na tah ověřených a neověřených symbolů v look-up tabulce. Z look-up tabulky vyberte symbol Verified a přejděte na kartu Vlastnosti vrstvy. Odtud použijte rozbalovací nabídku prvků k rozkliknutí na Shape Fill symbol, poté upravte tento symbol, abyste se dostali k vlastnostem výplně a tahu. V záložce struktury klikněte na malý symbol štítku vedle tahu a specifikujte status-color jako název primitivu. Nyní opakujte pro neověřený symbol.

S označenými prvky symbolu nyní styl podporuje všech 8 možných kombinací obrysů stavů ověření a provozních stavů pomocí pouhých dvou jednotlivých částí symbolu.
Tip 4 – Využijte konfigurační vlastnosti

Pokud jste obeznámeni s vrstvou Alternative Fuel Stations Living Atlas, možná si říkáte, „počkat chvíli – v těch datech není žádné pole ‚verified‘!“ Chytili jste mě. Používám podmnožinu, kterou jsem upravil, přidáním pole ‚verified‘, které se bude hodit pro budoucí blog. Tento styl pracuje s polem verified, ale možná používáte vrstvu Living Atlas a toto pole ve svých datech nemáte. Proto jsem vytvořil konfigurační vlastnost, která vám umožňuje zahrnout nebo ignorovat ověřovací pole.

Konfigurační soubor je JSON objekt, kde můžete definovat další konfigurační možnosti, které mění způsob kreslení symbolů. Tento styl má více konfiguračních možností, ale začneme s konfigurací use_Verified_Field. Zde jsem specifikoval název konfigurace, výchozí hodnotu, možné hodnoty a krátký popis. Také jsem zahrnul pole Verified jako pole symbolu využívané skriptem slovníku. To můžete opravdu vidět v akci v ArcGIS Pro:

Když je konfigurace use_Verified_Field zapnutá, skript slovníku použije hodnotu v poli verified k vrácení klíče pro plnou nebo čárkovanou čáru. Když je vypnutá, skript slovníku vrátí klíč pro plnou čáru pro všechny prvky. Pro využití hodnoty konfigurační vlastnosti ve skriptu slovníku použijte syntaxi $config.name nebo v tomto případě $config.use_Verified_Field:

Nyní kdokoli používající tento styl k symbolizaci vrstvy může ovládat, zda se používá pole verified.

Tip 5 – Vědět kdy použít pole symbolu nebo textové pole pro popisky

Ta poslední konfigurační vlastnost byla o tom, jak části symbolu jsou vypočítávány pomocí pole symbologie v datech, ale nyní se podívejme na vlastnost pro zapnutí a vypnutí popisků. V vrstvě EV charging stations jsou informace o síti, ke které patří, uvedeny v poli EV_Network. Pokud stanice nepatří do žádné sítě, toto pole je vyplněno hodnotou „Non-networked.“

Nejprve přidejte nový symbol pro popisek do tabulky hledání a poté se ujistěte, že je to symbol tvarového textu na kartě vlastností vrstvy. Pro použití EV network v datech nahraďte textový řetězec názvem pole v závorkách, v tomto případě [EV_Network]:

V konfiguračním souboru jsem vytvořil vlastnost show_EV_Network, abyste mohli zapínat a vypínat popisky. Také jsem určil pole EV_Network jako symbolové pole. Proč ne textové pole, ptáte se? Textová pole fungují skvěle, když chcete označit všechny prvky. Kdybych zvolil použití textového pole, každý prvek by byl označen svou hodnotou EV_Network a EV stanice, které nejsou připojeny k síti, by měly popisek „Non-networked“. Rozhodl jsem se, že chci označit pouze síťové EV stanice, takže jsem to udělal podmínkou ve skriptu slovníku:

Na textová pole nelze přistupovat pomocí skriptu slovníku, což znamená, že nemohou být použita jako proměnné v logice. Protože skript potřebuje použít hodnotu EV_Network k určení, zda vrátit klíč popisku, zahrnul jsem pole EV_Network jako symbolové pole v konfiguračním souboru.

Tip 6 – Používejte jedinečné názvy primitiv

[connector type]_marker (např. J1772_marker, CHAdeMO_marker atd.).

Pokud má tedy stanice dva konektory, J1772 a CHAdeMO, klíče by vypadaly takto:
3 Banner key: background-2
3 Connector type keys: con-J1772;po:J1772_marker|OffsetX|17;` and `con-CHAdeMO;po:CHAdeMO_marker|OffsetX|28;

Na rozdíl od našeho předchozího příkladu s primitive overrides musí mít každá část symbolu jedinečný název primitivu, protože hodnoty offsetu, které se mají aplikovat na každý symbol, aby se nepřekrývaly.

Tip 7 013 Vrátit klíče v pořadí kreslení
V posledním řádku tohoto dictionary skriptu vracíme řetězec klíčů, který klientovi říká, jaké jednotlivé části symbolu použít k vytvoření finálního symbolu. Pořadí, ve kterém se klíče objeví v řetězci, určuje pořadí, ve kterém se části symbolu kreslí. Když se podíváte na finální symbol nakreslený tímto stylem, můžete vidět, že typy konektorů se kreslí nad bannerem a banner se kreslí pod symbolem typu paliva a obrysem, zatímco indikátor přístupnosti se kreslí nahoře:

V tomto dictionary, když jsou všechny konfigurační vlastnosti zapnuté, jsou klíče vráceny v následujícím pořadí: fuel type, network name, EV banner, EV connector types, verified key, fuel type a access. Klíč fuel type je vrácen dvakrát, protože vestavěný výchozí klíč (Invalid_P) se používá pouze tehdy, když první vrácený klíč produkuje klíč, který není v look-up table. Přidání klíče fuel type podruhé zajišťuje správné pořadí kreslení, ale další možností je upravit části symbolu tak, aby odstranily zbytečné výplňové symboly, které mohou "zakrýt" symboly.
A to je vše - nyní máte všechny mé nejlepší tipy pro vytváření vlastního custom dictionary style! Můžete se do tohoto stylu dále ponořit stažením ho zde nebo začít vytvářet svůj vlastní custom style. Dejte mi vědět v komentářích níže, jaké máte nápady na vytváření custom dictionary styles!

Najděte více příspěvků označených jako

Defense

Intel

Komentáře

AndresCastillo

Once the mobile style has been published as a web style, you can also see the content json in arcgis assistant for the item's resources

AndresCastillo

FYI, DB Browser for sqlite sometimes seems to have an incorrect view of the actual json for an item in the items table:

In that case, it is better to verify the content column of the items table using python's sqlite3 library:

import sqlite3

# Path to your .stylx file
stylx_path = r"D:\ArcGIS_Projects\<name>.stylx"
newlines = "\n" * 5

# Connect to the SQLite database
conn = sqlite3.connect(stylx_path)
cursor = conn.cursor()


# Query the ITEMS table for NAME and CONTENT columns
cursor.execute("SELECT KEY, CONTENT FROM ITEMS")
rows = cursor.fetchall()


# Define the names you want to match
keys_to_match = {"CB2", "CB3"}  # Use a set for fast lookup

# Print each row with clear formatting
for key, content in rows:
    if key in keys_to_match:
        print(f"Key: {key}\nContent: {content}\n{'-'*40}{newlines}")


conn.close()

AndresCastillo

@megan_r

My teammate and I saw that the predefined box sizes can be edited in the items table of the stylx in dbbrowser for SQLite.

Specifically, we must edit the x or y axis for the rings in the markerGraphics key.

{
  "type": "CIMPointSymbol",
  "symbolLayers": [
    {
      "type": "CIMVectorMarker",
      "enable": true,
      "anchorPointUnits": "Relative",
      "dominantSizeAxis3D": "Y",
      "size": 50,
      "billboardMode3D": "FaceNearPlane",
      "frame": {
        "xmin": 0,
        "ymin": 0,
        "xmax": 100,
        "ymax": 100
      },
      "markerGraphics": [
        {
          "type": "CIMMarkerGraphic",
          "geometry": {
            "rings": [
              [
                [80, 60.2],
                [79.6, 62],
                [78.6, 63.6],
                [77, 64.6],
                [75.2, 65],
                [14.8, 65],
                [13, 64.6],
                [11.4, 63.6],
                [10.4, 62],
                [10, 60.2],
                [10, 39.8],
                [10.4, 38],
                [11.4, 36.4],
                [13, 35.4],
                [14.8, 35],
                [75.2, 35],
                [77, 35.4],
                [78.6, 36.4],
                [79.6, 38],
                [80, 39.8],
                [80, 60.2]
              ]
            ]
          },
          "symbol": {
            "type": "CIMPolygonSymbol",
            "symbolLayers": [
              {
                "type": "CIMSolidFill",
                "enable": true,
                "primitiveName": "cbstatus",
                "color": [0, 0, 0, 255]
              },
              {
                "type": "CIMSolidStroke",
                "enable": true,
                "capStyle": "Round",
                "joinStyle": "Round",
                "lineStyle3D": "Strip",
                "miterLimit": 4,
                "width": 4,
                "height3D": 1,
                "anchor3D": "Center",
                "color": [0, 0, 0, 255]
              }
            ],
            "angleAlignment": "Map"
          }
        }
      ],
      "scaleSymbolsProportionally": true,
      "respectFrame": true,
      "clippingPath": {
        "type": "CIMClippingPath",
        "clippingType": "Intersect",
        "path": {
          "rings": [
            [
              [0, 0],
              [100, 0],
              [100, 100],
              [0, 100],
              [0, 0]
            ]
          ]
        }
      }
    }
  ],
  "haloSize": 1,
  "scaleX": 1,
  "angleAlignment": "Display"
}

Here is what the rings look like plotted out on a graph:

To modify the width, modify the x coordinates respectively.

AndresCastillo

@megan_r

How can I add the predefined symbol parts for diferently sized banners for the lookup table?

I tried in layout mode, specifying the width and height, but if you change the width, the height also changes:

Element properties:

The styles pane does not give us access to the width of the symbol:

AaronBarkan

@megan_r

Thank you for posting this - really helpful stuff!

I'm having trouble adjusting the size of the symbol through the dictionary script. I want to implement three different size options for my symbology. Following your example with color, I set a primitive name of 'resizable' and added this code to my dictionary script:

var size = "10"; // Default size - 10pt
if ($feature.size == "small") { size = "10"; } // 10pt
else if ($feature.size == "medium") { size = "15"; } // 15pt
else if ($feature.size == "large") { size = "20"; } // 20pt

keys += ";po:resizable|Size|" + size + ";";

However, the symbols still appear to be the same size. I suspect I didn't set the correct primitive name. Do you have an example of how to set the size using a dictionary script?
Thank you!

megan-r

Great question @TheRrrr42 - you can apply multiple overrides to the same symbol!

Here is an example where I vary the color and rotation of the same 'plane' symbol with two different overrides. The script looks like this:

// Arrival airport key 
var plane_color = ''

if ($feature.arrival_airport_iata == 'SAN') { plane_color = '#704489' } // purple
else if ($feature.arrival_airport_iata == 'LAX') { plane_color = '#004DA8' } // blue
else if ($feature.arrival_airport_iata == 'SNA') { plane_color = '#A80084' } // magenta
else { plane_color = '#686868' } // gray

keys = keys + 'plane'
  keys += ';po:plane_direction|Rotation|' + $feature.heading // rotate plane symbol by heading
  keys += ';po:color|Color|' + plane_color + ';' // specify color of plane symbol

When tagging the symbol with the overrides in ArcGIS Pro, the tags actually belong on different "levels" of the symbol. The plane_direction tag is applied on the shape symbol:

And the color override goes a few levels deeper on the embedded polygon symbol:

You would apply the size override on the same level as I applied the rotation override in this example. Hope this helps!

TheRrrr42

@megan_r

Thanks for the writeup and examples. I attended your DevSummit presentation and am trying to implement these with some water utility valve data. I'm looking around in the military styles and the provided style but am having trouble determining if I can use multiple primitive overrides on a single key. Is this possible? For example trying to change the fill color on a marker symbol and the size of that symbol. Do you have any snippets that show the formatting of this?

Thanks!

AndresCastillo

very nice @megan_r , thank you

megan-r

I'm glad you enjoyed the blog, @AndresCastillo!

As Russ mentioned, you can't currently configure a layer with a dictionary style from Web Map Viewer. Please consider submitting an Idea for this capability.

Now for this blog, I used ArcGIS Pro to symbolize the Alternative Fuel Stations feature service with the dictionary web style, then shared the map as a Web Map. When configuring the symbology, I set a scale factor of 2 because I wanted all the symbols to be larger for demonstration purposes, but you can also write an Arcade expression. Here's some documentation on that: ArcGIS Pro - Scale dictionary symbols.

AndresCastillo

Thank you for your reply @RussRoberts !

Seems then that if I want to apply the dictionary web style to a feature layer in a web map, I will need to do so by adding the renderer to the item data json.

Another note,

when I apply the Pro Desktop Style to the database layer in pro (in other words, not the web feature layer), then publish the web layer as a map image layer (MIL) and feature layer (FL) in the portal, only the MIL retains the dictionary symbology. The feature layer just keeps a basic point symbol.

Interesting though, that both the corresponding map service and feature service rest end point pages BOTH show a basic point symbol for the renderer.

RussRoberts

Hey @AndresCastillo we currently do not support using dictionary web styles in Map Viewers symbol styler experience. We read them into the web map but don't have the experience yet for using them for additional configuration. Thank you for your feedback!

AndresCastillo

I saw the reply by @RhettZufelt in this article, which is great for overwriting a web style with new symbols.

https://community.esri.com/t5/arcgis-online-questions/web-stylx-in-map-viewer/m-p/1474193#M59237

But my issue is that the dictionary web style is not available to choose in map viewer style options.

Note that my web style contains 46 point symbols.

Here are the typeKeywords from the web style item data json,

which match the typeKeywords from the a99d8d715e1e47bea8b5dda31d70caad item that @megan_r uses in her web map:

    "typeKeywords": [
        "ArcGIS Pro",
        "Dictionary",
        "Platform",
        "pointSymbol",
        "Style",
        "Symbology",
        "Symbols",
        "Web Style"
    ],

I looked into the typeKeywords due to @RussRoberts reply on this thread, even though the reply is within the context of a new style workflow only in AGO:

https://community.esri.com/t5/arcgis-online-questions/help-needed-custom-web-styles-not-showing-under/td-p/1527593

AndresCastillo

Hi @megan_r ,

This blog post is excellent.

Thank you for sharing it.

It clearly explains the full workflow to define a custom web symbol.

Question:

Once the style was shared as a web style, how were you able to apply the web style url to the web map operational layer?

I took a look at your web map using ArcGIS Assistant, and the layer renderer shows the url to the web style with item id a99d8d715e1e47bea8b5dda31d70caad.

‎Also, out of curiosity, the blog did not cover the scalingExpressionInfo key of the renderer.

Here is the renderer JSON:

                    "renderer": {
                        "type": "dictionary",
                        "url": "https://www.arcgis.com/sharing/rest/content/items/a99d8d715e1e47bea8b5dda31d70caad",
                        "fieldMap": {
                            "Fuel_Type": "Fuel_Type",
                            "Current_Status": "Current_Status",
                            "Accessability": "Accessability",
                            "EV_Connector_Types": "EV_Connector_Types",
                            "Verified": "Verified",
                            "EV_Network": "EV_Network"
                        },
                        "configuration": {
                            "show_EV_Network": "ON",
                            "show_Connector_Type": "ON",
                            "use_Verified_Field": "ON"
                        },
                        "scalingExpressionInfo": {
                            "expression": "2",
                            "title": ""
                        }
                    }

I am on ArcGIS Enterprise 11.2 (using the newer map viewer), and ArcGIS Pro 3.2.2

I analyzed the Pro Dictionary style with no errors, nor warnings, then published it as a web style.

I shared the web style to the designated and configured portal groups as per this article:

https://support.esri.com/en-us/knowledge-base/problem-the-custom-web-style-is-not-displayed-in-arcgis-000032341#:~:text=Configure%20the%20group%20in%20the,web%20style%20is%20shared%20in.

But, I do not see the dictionary web style available for me to apply to the web map operational layer.

I'd like to symbolize at the web map level, not so much from ArcGIS Pro layer level.

@RussRoberts

Připojte se k diskusi

Přihlášení členové mohou přispívat, sledovat aktualizace a další. Nový zde? Zaregistrujte si bezplatný účet.

Rychlé odkazy

Community Help
Find useful guides, FAQs, and documents to help you navigate and make the most of Esri Community.