Asset Extractor
- Last UpdatedMay 15, 2023
- 2 minute read
The Asset Extractor is a tool you can use to read assets within a feature layer and insert those assets into your PI System.
Two versions of the Asset Extractor are available: an online version and a downloadable version. The desktop version can extract features from map layers hosted on secure map services (HTTPS) and unsecured map services (HTTP), and can handle larger amounts of data. The online version is accessed directly from PI Integrator for Esri ArcGIS and is often the easiest version to use. However, the online version does not support the extraction of data from map layers that are hosted on unsecured map services; only secure map services are supported. In addition, the online version is unable to extract features from very large map layers. If you attempt to extract large amounts of data or to extract data from a non-secure map service, you will be prompted to download and use the desktop version. The desktop version is available for Windows Vista and later versions and does not require installation.
If you are an Esri ArcGIS user and you are just getting started with the PI System, you probably have assets that are defined in ArcGIS but not in the PI System. While ArcGIS assets consist mostly of metadata such as location information, PI System assets might include data and analytics from the PI System in addition to metadata. You use PI Integrator for Esri ArcGIS to augment and enrich PI assets. To use PI Integrator for Esri ArcGIS effectively, you must have rich PI Assets that expose PI System data. You use the Asset Extractor as the first step towards converting your existing Esri ArcGIS asset metadata and getting started building rich assets in the PI System.
The Asset Extractor will read and include any geometry information that is included with the target Map Layer. This includes the feature shape, the feature shape type (Point, Polygon, and so on), and coordinate systems. These fields are placed in an AF category called Geometry. For geometries of type Point, values for Latitude and Longitude are included. Note that in some cases, the Attribute names of Latitude and Longitude and the default unit of measure of degrees might not apply. You must modify these fields manually in PI Asset Framework as necessary. Any existing fields (that is, if your map layer already has a field called Latitude) are not overwritten; the Extractor-generated fields are given a unique name such as Latitude1. You should choose which fields to keep and use; you can also rename fields as appropriate.
Note: The Asset Extractor is not compatible with Esri ArcGIS Enterprise 10.7.x and later.