Home / , , / Technology1 Ci Anywhere Integration

Technology1 Ci Anywhere Integration

This article provides guidance on how to use Geovonic Connect for ArcGIS to link your ArcGIS environment with Technology1™ Ci Anywhere, to interact with Ci Anywhere directly from within your no-code mapping applications. Ci Anywhere is a cloud solution where the data and applications are accessed via APIs.

Geovonic Connect has plugins for Ci Anywhere to deliver these use cases: –

  • Launch Ci Anywhere functions from related map features in your ArcGIS application.
  • Fetch data from Ci Anywhere relating to map features selected in your ArcGIS application.

The process to configure each of these use cases is described in the following sections.

This is a technical implementation guide and assumes the reader has knowledge of integrating with the Technology1 Ci Anywhere API. Additional assistance may be required from a Ci Anywhere specialist or from the Technology1 support team to complete the setup.

LAUNCH CI ANYWHERE FROM ArcGIS

How it works

  1. The user selects one or more properties on the map.
  2. The user selects the launcher tool from the Geovonic Connect widget.
  3. A Ci Anywhere form is opened in a new browser tab displaying records related to the map selection.

For example, the user has selected a property on the map (1 High Street) on the map. Selecting the “Ci Anywhere” launcher tool on the Geovonic Connect widget, will open the Ci Anywhere application showing records relating to 1 High Street.

Prerequisites

  • ArcGIS Feature Layer
    Ci Anywhere is launched from an ArcGIS feature layer using a collection of one or more property or asset IDs. The IDs used in Ci Anywhere must be present as an attribute on the features of your ArcGIS feature layer.
  • URL Pattern
    Details of the form that is to be opened. Below is an example URL that we will be using to open Ci Anywhere.
https://my-env.t1cloud.com/T1Default/CiAnywhere/Web/MY-DB/AssetsCore/AssetMyMaintenance
?f=$ASC.ASSET.MNT
&suite=CES
&SK.AssetRegisterName=MYASSETS
&SK.KeyedAssetNumber=123456

The very last part of the URL (123456) is the Asset ID used in Ci Anywhere. This will be replaced with {{f.MY_ATT}} in your URL template, where MY_ATT is an attribute on your GIS feature layer containing the Technology1 Asset ID.

The remaining components will be specific to your environment such as the asset register name (MYASSETS) and the domain (my-env.t1cloud.com).

It is recommended you test your URL pattern directly in the browser before configuring it in Geovonic Connect.

Admin console configuration

  1. Create a new App Launcher
  2. Use the search tool to find the layer containing your property parcels. This layer must include an attribute(s) that can be used to query Ci Anywhere records.
  3. Give a name for the new App Launcher. For example, “Open CiA Asset”
  4. Select “URL Text Replacement” for the launcher type.
  5. Add the template for your URL using the {{f.MY_ATT}} format for your GIS feature attribute.
    Use the [+] button to select an attribute from the list. It is important that the attribute appears with the format {{f.MY_ATT}}. Do not remove the curly brackets.
  6. Save the App Launcher

FETCH DATA FROM CI ANYWHERE

How it works

  1. The ArcGIS app user selects one or more features on the map.
  2. The Geovonic Connect widget fetches related data records from Ci Anywhere and displays these to the user.

Prerequisites

  • ArcGIS Feature Layer
    An ArcGIS feature layer must exist in the Experience Builder application that has an attribute to be passed as a record ID to Ci Anywhere. This layer will be used by the user to select features on the map, triggering the Geovonic Connect widget to fetch data.
  • Ci Anywhere Web Service
    Geovonic Connect retrieves data from web services exposed by Ci Anywhere.Refer to the TechnologyOne article in your help environment called, “Creating and configuring TechnologyOne web services” for more details. Search for “Web Services” to see the list of enabled web services and their URLs.For example, a web service to read Asset data may look something like: –

    /Asset/ReadForDetails/MY-ASSETS/{ASSET_ID}

    Ci Anywhere includes some ready-to-use web services such as Asset Details which just need to be enabled in your environment. You can also configure custom reports that are then published as web services to build datasets specific to your applications. The default web services require the Ci Anywhere Asset ID to be present on your GIS feature layer; custom reports can be configured to run based on attributes other than the Ci Anywhere Asset ID.

  • Ci Anywhere Client Credentials

Geovonic Connect authenticates against Ci Anywhere using a Client Credentials OAuth flow. This requires an OAuth client ID and secret to be setup in Ci Anywhere.

The OAuth details are configured in Ci Anywhere under the “Site Settings (System Administration)” under the OAuth IdP Clients tile. An OAuth client is usually associated with a service account, although it could be associated with a standard user account.

The account must be part of a rule that has permissions to access the web services being used. Roles are granted access to a web service in Ci Anywhere under the Security tile in the Web Service Definition.

Admin console configuration

DATA SOURCE

  1. Create a new data source.
  2. Give a name for the new data source. For example, “Ci Anywhere”.
  3. Select “TechnologyOne Ci Anywhere” from the connection type menu.
  4. Leave the “Use relay service” option unchecked as Ci Anywhere can be accessed over the public internet.
  5. Fill in the form: –
    • Host – the domain name of your Ci Anywhere server (e.g. my-server.t1cloud.com).
    • Database – the name of the database for your Ci Anywhere data.
    • Version – the version number of the Ci Anywhere API.
    • Credentials – the ID and secret for an OAuth client. See pre-requisites.

LAYER LINK

  1. Create a new layer link
  2. Use the search tool to find the layer containing your target features. This layer must include an attribute that will be passed as a record ID to Ci Anywhere.
  3. Give a name for the new layer link. For example, “CiA Property Details”
  4. Select the sub-layer from the drop-down list. This is a sub-layer within the feature layer you have selected.
  5. From the data source menu, select the data source you created.
  6. Fill in the form: –
    • Web Service URL Pattern – the URL for the web service being accessed.
      Use the [+] button to select add GIS feature attributes to the URL. It is important that the attribute appears with the format {{MY_ATT}}. Do not remove the curly brackets.Note: The prefix /Api/WS/v1/ will be added to all URLs. You should not include this in your URL pattern. An example URL pattern using the GIS_ID attribute from your GIS feature layer might look like:

      Asset/ReadForDetails/MYC/{{GIS_ID}}
    • Test Data – optionally include attribute values that will be used to test the web service request. To perform a test replacing {{GIS_ID}} with the value PB.0001, you would specify {{GIS_ID}}=PB.0001 in the test data section.
  1. Click on “Validate” to test the query. A success message will be displayed. If an error is shown, correct the query and try again.
  2. Click on “Save”. Your layer link is ready for use.

* Technology1 is a trade-mark of TechnologyOne Limited.