AF SDK Reference

AFAdmin.EnableUomCaseSensitivity Method

Save PDF

TABLE OF CONTENTS

AFAdmin.EnableUomCaseSensitivity Method

Save PDF

Last UpdatedNov 18, 2025
3 minute read

Changes configuration of UOM abbreviations from case insensitive to case sensitive in the PI AF SQL Server database.

Namespace: OSIsoft.AF.Diagnostics
Assembly: OSIsoft.AFSDK (in OSIsoft.AFSDK.dll) Version: 3.1.1.1182

Syntax

public static void EnableUomCaseSensitivity(
	PISystem system,
	bool enable
)

Public Shared Sub EnableUomCaseSensitivity ( 
	system As PISystem,
	enable As Boolean
)

Dim system As PISystem
Dim enable As Boolean

AFAdmin.EnableUomCaseSensitivity(system, 
	enable)

public:
static void EnableUomCaseSensitivity(
	PISystem^ system, 
	bool enable
)

static member EnableUomCaseSensitivity : 
        system : PISystem * 
        enable : bool -> unit

Parameters

system: Type: OSIsoft.AFPISystem
The operation will be performed on the specified PISystem.
enable: Type: SystemBoolean
Specify to enable UOM case sensitivity; otherwise specify to disable UOM case sensitivity.

Exceptions

Exception	Condition
InvalidOperationException	This exception is thrown when there exist either UOMs that reference case sensitive UOMs while disabling case sensitivity or UOMs abbreviations that would conflict while disabling case sensitivity.
SecurityException	This exception is thrown when attempting to execute without Admin security rights.
ArgumentNullException	This exception is thrown when attempting to execute on a PISystem that is null or deleted.
NotSupportedException	This exception is thrown when attempting to execute on a PISystem that does not support the AdminFunctionality feature.

Remarks

This method is used to enable or disable the UomCaseSensitive feature in the PI AF SQL Server database. This feature controls support for case-sensitive UOM abbreviations, allowing for abbreviations that differ only by case, such as MV and mV. It is recommended that you review the information in the user guide for Case Sensitive UOM Abbreviations prior to enabling this option.

Use the PISystem.Supports method to check if the PISystem supports the AdminFunctionality feature.

Security Note
Requires the Admin right to execute.

Notes to Callers
This method will error on servers before AF 2018 R2 (2.10.5).

Version Information

AFSDK

Supported in: 3.1.1, 3.1.0, 3.0.2, 3.0.1, 3.0.0, 2.10.11, 2.10.5

AF SDK Reference