thinkwise-software-factory-maps-component

Configures and maintains maps components in Thinkwise Software Factory models via MCP connectors.

5|Updated Aug 25, 2026
One-click install
npx skills add https://github.com/rkortThinkwise/sf-mcp-skills-temp --skill thinkwise-software-factory-maps-component-rkortthinkwise
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thinkwise-software-factory-maps-component
Source: https://github.com/rkortThinkwise/sf-mcp-skills-temp/tree/main/thinkwise-software-factory-maps-component
Command: npx skills add https://github.com/rkortThinkwise/sf-mcp-skills-temp --skill thinkwise-software-factory-maps-component-rkortthinkwise

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a maps component in a Thinkwise Software Factory model requires coordinating four interdependent entities (map, map_base_layer, map_overlay, map_data_mapping), a strict CoordSets JSON coordinate contract, signed 32-bit ARGB color encoding, and domain-element style matching — all through an MCP connector where wrong assumptions fail silently rather than erroring. ## Core Features & Use Cases - Full entity field reference: Documents every field on map, map_base_layer, map_overlay, and map_data_mapping, including the CoordSets JSON contract, the domain-element-to-map_data_mapping_id matching rule, and the ARGB color encode/decode formula. - Drawable shapes and tab variants: Covers Geometric Type Creation task wiring for user-drawn markers, lines, polygons, rectangles, and circles, plus per-tab-variant override entities and their reset tasks. - External-API pattern: A reference guide details the geocoding/routing pipeline — dummy trigger task, process flow, web_connection endpoints, and SQL Server/PostgreSQL JSON parsing control procedures. - Use Case: Ask your AI assistant to add a map showing customer addresses as styled markers on a table; it uses this skill to create the calculated CoordSets column, the map row, a tile base layer, and one map_data_mapping row per domain element without guessing entity names. ## Quick Start Ask your AI assistant to set up a maps component for a specific table in your Thinkwise Software Factory model, including the tile provider, geometry types, and initial center and zoom.

Frequently Asked Questions about thinkwise-software-factory-maps-component

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a maps component in Thinkwise Software Factory?

Create a calculated column producing CoordSets JSON, then add a map row pointing latitude_longitude_col_id at it, at least one map_base_layer with a tile URL template, and one map_data_mapping row per element of the data-mapping domain. Confirm scope, tile provider, and center/zoom with the user first.

What is the CoordSets JSON format for Thinkwise maps?

CoordSets is a JSON envelope with a CoordSets array of coordinate rings, each point having Lon and Lat keys, for example { "CoordSets": [ [ { "Lon": "5.979388", "Lat": "52.208479" } ] ] }. Circles add a Radius key in meters. The map reads this from the column set in latitude_longitude_col_id.

Why are my Thinkwise map markers showing in the wrong location?

Transposed Lon and Lat values in the CoordSets expression produce valid JSON with silently wrong positions, plotting points thousands of kilometers away. Verify the expression against a row whose real-world location you know, not just that the map renders a pin.

Can map_data_mapping be created through an MCP staging API?

Verified testing showed map_data_mapping could not be created or edited through a metadata-driven staging API because its compound key spans two parents. Treat it as a manual step in the Software Factory UI unless your connector's domain metadata confirms otherwise.

Does the Thinkwise map component support OAuth2-authenticated tile layers?

No, tile layers only support long-lived tokens embedded in the URL such as query-string API keys. For bearer or OAuth2 tile sources, front them with a proxy web service. Outbound API calls via web_connection do support oauth and bearer_token authentication types.

How do I style marker colors in Thinkwise map_data_mapping?

You cannot — for marker geometric types the platform nulls and hides border_color, fill_color, width, and opacity fields. Style markers through the domain element's icon field instead. Color fields only apply to line, polygon, rectangle, and circle types using signed 32-bit ARGB values.