|
|
| Line 1: |
Line 1: |
| == About this page ==
| | #REDIRECT [[Configuration_data_schema]] |
| On this page you'll be able to look up the meaning and opportunities of all the variables (potentially) contained in an MSP Challenge session configuration JSON file. Similar explanations can found in the Configuration Editor application that we ship with the full platform installer. Should some of the documentation on this page be wrong or incomplete, then we encourage you to update it yourself. Just make sure you're logged in and click on Edit Source to get started. Thank you!
| |
| | |
| For each of the JSON objects we provide more explanation and contextualisation under the header of '[purpose]'. Other than that, this page follows the structure of the configuration file to the letter. This means that you should be able to recognize and find all of the headers on this page (e.g. 'metadata', 'datamodel') within any of the MSP Challenge JSON configuration files we ship.{{FAQ group begin|header=metadata}}
| |
| {{FAQ row|q=[purpose]|a=The main object for all things metadata, i.e., data about this data.}}
| |
| {{FAQ row|q=date_modified|a=string with format dd/mm/yyyy representing the date the file was last modified}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=datamodel}}
| |
| {{FAQ row|q=[purpose]|a=The main object for everything that's *not* metadata, but just actual content.}}
| |
| {{FAQ group begin|header=restrictions}}
| |
| {{FAQ row|q=[purpose]|a=Defining information, warning or error messages the user should receive when they are making a plan in which two particular layers collide.}}
| |
| {{FAQ group begin|header=[first_layer_name] {{!}} [second_layer_name]}}
| |
| {{FAQ row|q=[purpose]|a=The two colliding layers in question, for which the information, warning or error message can be defined. The layer names should be separated by a pipe {{!}} character, without spaces. They should be the exact same layer names as defined later on under the header 'meta'.}}
| |
| {{FAQ row|q=message|a=string with message that the user should get when the two layers collide.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=plans}}
| |
| {{FAQ row|q=[purpose]|a=Defining starting plans, i.e., plans ready for implementation from the very start of the session, already put in place upon session creation.}}
| |
| {{FAQ row|q=plan_id|a=unique integer to simply identify the plan with.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=dependencies}}
| |
| {{FAQ row|q=[purpose]|a=Setting up the Impact Tool window's content.}}
| |
| {{FAQ group begin|header=groups}}
| |
| {{FAQ row|q=[purpose]|a=Defining the layers or variables and their groupings that make up the circle diagram that is the Impact Tool.}}
| |
| {{FAQ row|q=name|a=string representing the group of layers or variables shown in the Impact Tool.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=links}}
| |
| {{FAQ row|q=[purpose]|a=Defining the lines that should be drawn between each layer or variable (in turn defined above under 'groups').}}
| |
| {{FAQ row|q=fromId|a=integer of the group entry (the layer or variable defined under 'groups') from with the draw an arrow in the Impact Tool.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=CEL}}
| |
| {{FAQ row|q=[purpose]|a=Defining parameters particular to the CEL energy simulation software.}}
| |
| {{FAQ row|q=grey_centerpoint_color|a=string starting with hash (#) of the 8-digit hexadecimal colour code, the last two representing transparency.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=SEL}}
| |
| {{FAQ row|q=[purpose]|a=Defining parameters particular to the SEL shipping simulation software.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=MEL}}
| |
| {{FAQ row|q=[purpose]|a=Defining parameters particular to the MEL ecosystem simulation software.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=meta}}
| |
| {{FAQ row|q=[purpose]|a=Defining vector and raster data layers that should be shown in the appropriate left-hand side menu.}}
| |
| {{FAQ row|q=layer_entity_value_max|a=optional decimal/float representing the highest greyscale (black to white) value of a raster cell. Default is 1000.0, also when set to null. Other logical value is 255.0.}}
| |
| {{FAQ row|q=layer_property_as_type|a=optional string of the layer geometry feature property that should be read when determining the type, as further defined under layer_type below. Null if irrelevant.}}
| |
| {{FAQ group begin|header=layer_type}}
| |
| {{FAQ row|q=[purpose]|a=Defining which types this particular layer should have (minimum one).}}
| |
| {{FAQ row|q=displayName|a=string representing the name of the type being defined here that the user will actually see.}}
| |
| {{FAQ row|q=value|a=integer representing the highest value of a raster cell. Minimum 0, maximum 255 (requiring layer_entity_value_max to be set to 255.0) or 1000 (default, no layer_entity_value_max setting required).}}
| |
| {{FAQ row|q=map_type|a=optional string, required when layer_property_as_type is not null, representing the value of the layer geometry feature property defined under layer_property_as_type that should be mapped to this type. Null if irrelevant. Can be 'other' indicating a 'catch-all' type if none of the other types can be mapped to. Can also be an integer or float/decimal range, without spaces, and using - (dash) as a separator. E.g. 10-20.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=layer_info_properties}}
| |
| {{FAQ row|q=[purpose]|a=Defining what and how feature property data should be shown to the user when clicking on the feature on the map.}}
| |
| {{FAQ row|q=property_name|a=string referring to the feature property present in the data table of this layer's source data.}}
| |
| {{FAQ row|q=enabled|a=integer, 0 or 1, representing whether this feature property should be shown to the user at all.}}
| |
| {{FAQ row|q=editable|a=integer, 0 or 1, representing whether the user should be able to change feature property value. NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=display_name|a=string of the name that should replace the original property_name when showing it to the user (requires enabled to be 1).}}
| |
| {{FAQ row|q=sprite_name|a=always null, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=update_visuals|a=boolean, always false, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=update_text|a=boolean, always false, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=update_calculation|a=boolean, always false, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=content_type|a=integer, always 0, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=content_validation|a=integer, always 0, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=unit|a=always null, NOT IMPLEMENTED.}}
| |
| {{FAQ row|q=default_value|a=string representing what to show in case the source feature property data's value is null.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=expertise_definitions}}
| |
| {{FAQ row|q=[purpose]|a=Defining expertises that should be selectable from the drop-down list shown when logging on to a session.}}
| |
| {{FAQ group end}}
| |
| {{FAQ group begin|header=objectives}}
| |
| {{FAQ row|q=[purpose]|a=Defining default objectives that should be shown in the Objectives Monitor.}}
| |
| {{FAQ group end}}
| |
| {{FAQ row|q=edition_name|a=string representing the chosen name of the edition that this configuration creates.}}
| |
| {{FAQ group end}}
| |
Co-funded by the European Union.