Skip to main content

Configure AVEVA CONNECTâ„¢ Streams

availability
Feature availability by platform, plan type, and user type
Platform:AvailableWebNot availableMobile
Plan Type:Not availableBasicNot availableEssentialNot availablePremiumAvailableEnterprise
User Type:Not availableRequesterNot availableFull UserAvailableAdministrator

The streams and properties you select for your connector instance define which AVEVA CONNECT data MaintainX® reads and how it reads each value. Each property you select becomes a tag in MaintainX. A limit of 1,000 properties per connector instance keeps data volume within platform limits.

Prerequisites​

  • MaintainX connector instance: Created in MaintainX when you set up the integration. For more information, see Set Up the AVEVA CONNECT Integration.
  • AVEVA CONNECT streams: Streams configured in your AVEVA CONNECT namespace for the data you want to bring into MaintainX.

Identify Your AVEVA CONNECT Streams​

Before you select streams, gather the following information about the data you want to bring into MaintainX:

  • Streams: The streams that hold the data you want. MaintainX displays streams as a tree based on their dot-separated IDs.
  • Value properties: The properties that hold the readings. A stream can have more than one value property.
  • Timestamp property: The DateTime property that records when each reading occurred. If a stream has more than one, you choose which to use. For more information, see Choose Timestamp Properties.
  • Data types: The data type of each value property. For more information, see Supported Data Types.

Supported Data Types​

MaintainX supports the following AVEVA CONNECT data types for value properties:

  • Boolean
  • String
  • Integer types: SByte, Byte, Int16, UInt16, Int32, UInt32, Int64, and UInt64
  • Floating-point types: Single and Double

MaintainX doesn't support properties of the following types as values: Char, Decimal, DateTime, DateTimeOffset, Guid, TimeSpan, Version, nullable types, and arrays. MaintainX disables these properties in the stream tree, and a message appears when you hover over them to explain why.

Add Streams to the Connector Instance​

You select streams when you create a connector instance. You can return at any time to add or remove streams. For more information, see Edit a Connector Instance.

  1. In the Choose data streams section, browse the streams, or enter a keyword or wildcard to search.
  2. Expand a stream to see its properties. Nested properties appear as folders.
  3. If a stream has more than one DateTime property, choose its timestamp property. For more information, see Choose Timestamp Properties.
  4. Select the properties you want to bring into MaintainX. You can also select a stream or folder to select the eligible properties inside it. Folder selection applies only to results you've loaded.
  5. Review your selection. The review lists each stream ID, property, and timestamp property.
  6. Select Subscribe data streams, or select Save if you're editing an existing connector instance.
note

You can select up to 1,000 properties for each connector instance. The selection bar shows how many properties you've selected. If you select more than the limit, you can't continue until you deselect enough properties. Timestamp properties don't count toward the limit.

Choose Timestamp Properties​

AVEVA CONNECT doesn't enforce a fixed structure for a stream's data. A stream's properties can use any names, so MaintainX can't assume which property holds the timestamp and which holds the reading itself.

When you select a stream, MaintainX reads its properties and asks you to identify:

  • Timestamp property: The property that represents when the reading occurred.
  • Value property: The property that represents the reading itself.

Only a DateTime property can be a timestamp property. Nullable DateTime, DateTimeOffset, and TimeSpan properties, and numeric timestamps such as Unix milliseconds, aren't valid. If a stream has no valid timestamp property, you can't select it.

If a stream has more than one DateTime property, you must choose one before you can select the stream or its folder. MaintainX uses your choice to interpret every subsequent update for that stream.

Map Tags to Meters​

At this point, MaintainX has stream data flowing in, but each tag still needs to be mapped to a meter before it can update readings, trigger work orders, or power automations. Smart tag mapping uses AI to suggest a meter, unit, and asset for each tag, so you don't have to configure every mapping manually.

For more information, see Map Tags to Meters.

note

Some existing connector instances use the auto-create meters feature instead of smart tag mapping. For those connector instances, MaintainX creates a meter for each tag and gives the meter the same name as the tag. Smart tag mapping isn't available for them. For more information, contact your MaintainX representative.

Verify Data Is Flowing​

After you map your tags to meters, confirm that readings are reaching MaintainX.

  1. From the sidebar, select Asset Monitoring > Meters.
  2. From the list, find a meter that's mapped to one of your AVEVA CONNECT tags.
  3. Select the meter to open it.
  4. In the Readings section, select See All Readings to confirm new readings are arriving.

Allow a few minutes after you subscribe to your streams for the first readings to arrive. After that, readings arrive as stream values update in AVEVA CONNECT. If no readings appear, see Not Seeing Data in MaintainX.