GeolinQ
Support Portal

XML Script

GeolinQ XML script automates manual administration procedures by defining operations in a XML script. An XSD is available for the XML script to generate and validate the XML script: https://schema.geolinq.nl/script/expression.xsd. The idea behind the XML script is that users can easily create and adjust scripts themselves. The XML script is executed as a task on the task server after which a log is available of the execution of the script.

Script context

The XML Script consists of a list of operations in a context. Operations can be performed depending on the context. In a data source context for example tenant functions such as CreateTenant cannot be executed.

Context Description
Root Context Context of the root tenant where child tenants are managed.
Tenant Context Context of the tenant where datasources, users, and user groups are managed.
Datasource Context Context of the datasource where datasets, class definitions, processes and screens are managed.

Create a XML script

The XML script is created by adding operations in a XML document with the following structure:

<?xml version="1.0" encoding="UTF-8"?>
<Script xmlns="http://www.geolinq.com/script"> 
  <Header>
    <Name>My Script Title</Name>
  </Header>
  <Operations>
    <CreateTenant>
      ...
    </CreateaTenant>
    <UpdateDatasource>
      ...
    </UpdateDatasource>
    ...
  </Operations>
</Script>

The script has the target namespace http://www.geolinq.com/script and is validated by GeolinQ against an XSD. The script always starts with the Script element followed by a header and a list of operations in a tenant or root tenant context.

The header starts with Header element and in the header the name of the script is mandatory included in the Name element.

The operations in the script are defined between Operations elements of the script. The script runs in the context of the tenant where the task with the script was started. This means that the root tenant context is for the root tenant and the tenant context is for a child tenant.

The XML script might be part of a ZIP file that contains all additional files that are needed during the execution of the script. The script might also be run as an XML file when the script has no references to import files.