Home
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
Standard Object Library
The WinCC OA Standard Object Library (in short: Stdlib) is a base framework that facilitates the creation and use of WinCC OA Libraries. The Stdlib provides templates for creating WinCC OA Libraries and offers a vast range of functions that make the use of a WinCC OA Library in a WinCC OA project easier.
HOOK Functions, Basics
Stdlib hook-Functions
hook_<libraryPrefix>_getInvalidElement()
This function determines the datapoint element that indicates whether a datapoint is invalid.

Version Information
Release Notes, Update information, Certifications and Frequently Asked Questions.
Concepts
Your first step into modern and powerful process visualization.
Deployment
Topics you need to know before using WinCC OA.
Security
Go beyond the norm in cybersecurity.
Engineering
Powerful tools for easy or complex engineering tasks.
Data Management
Classify, structure and archive your data.
Business Logic / Control
Endless possibilities in data processing for your projects.
Data Visualization
User interfaces, Trends and Reports for every purpose and device.
- User Interfaces
  All the available options for visualizing WinCC OA.
- System Overview
  A panel for the diagnostics of a WinCC OA system.
- Alert and Event Screen (AEScreen)
  The alert and event panel (AEpanel) in WinCC OA is a standard panel and allows displaying alerts and events in table format.
- Variable Trend
  A set of panels and scripts used for the simplified display of trend curves and trend groups (up to 16 trend curves).
- Standard Symbols (STD_Symbols)
  Symbol library consisting of graphics objects for the quick display and design of system diagrams.
- Standard Object Library
  The WinCC OA Standard Object Library (in short: Stdlib) is a base framework that facilitates the creation and use of WinCC OA Libraries. The Stdlib provides templates for creating WinCC OA Libraries and offers a vast range of functions that make the use of a WinCC OA Library in a WinCC OA project easier.
  - Requirements and Installation
  - How to create a Standard Object Library
  - How to Create Datapoint Types for the Standard Object Library
  - How to Create a New Standard Object Library Symbol
  - Examples for Standard Object Library Dollar Parameters
  - How to Create a Standard Object Library Faceplate
  - How to Export Library Project Data
  - How to Add a Standard Libary Symbol to a Panel
  - User Authorization in the StdLib
  - [stdlib]
    Settings for the Standard Object Library (Stdlib).
  - Stdlib
  - HOOK Functions, Basics
    - hook Functions
    - Stdlib hook-Functions
      - hook_<libraryPrefix>_addEnableRuleDpes()
        Determines the datapoint elements that are additionally called for rule evaluation for the setting of an elementary symbol to inactive/active.
      - hook_<libraryPrefix>_addHighlightRuleDpes()
        Determines the datapoint elements that are additionally used for rule evaluation in order to set an elementary symbol to highlighted/not highlighted.
      - hook_<libraryPrefix>_addVisibleRuleDpe()
        Determines the datapoint elements which are additionally used for the rule evaluation in order to set an elementary symbol to visible/invisible.
      - hook_<libraryPrefix>_alterInfoAreaDisplay()
        This function allows the icon-ID, and therefore the icon displayed in an information area, to determine when the value of the datapoint element that is connected to an information area changes. Which datapoint elements are connected to a certain information area is determined via the function hook_<LibName>_getInfoAreaDPEs().
      - hook_<libraryPrefix>_fillPopUpMenu()
        This function is used to change the context menu of a symbol or an elementary symbol.
      - hook_<libraryPrefix>_getAlertElement()
        By using this function, the library creator can define were the sum alert of a DPT/DP is located.
      - hook_<libraryPrefix>_getInfoAreaDPEs()
        This function determines the datapoint elements that can change the icon for an information area of a symbol. For detailed information, see also hook_<libraryPrefix>_displayInfoAreaIcon() and hook_<libraryPrefix>_alterInfoAreaDisplay().
      - hook_<libraryPrefix>_getInvalidElement()
        This function determines the datapoint element that indicates whether a datapoint is invalid.
      - hook_<libraryPrefix>_getOperationModeElement()
        This function determines the datapoint node that saves the operating states.
      - hook_<libraryPrefix>_hasDpeAnActiveAdress()
        This function is used to check whether an elementary symbol in a faceplate has a peripheral address.
      - hook_<libraryPrefix>_libEnableElementarySymbol()
        This function returns TRUE when a certain datapoint element is activated.
      - hook_<libraryPrefix>_libHighlightElementarySymbol()
        This function returns TRUE when a certain datapoint element is highlighted.
      - hook_<libraryPrefix>_libVisibleElementarySymbol()
        This function returns TRUE if a certain datapoint element is visible.
Southbound Interfaces
The process connection to the actual machines/sensors.
Northbound Interfaces
Your portal to the cloud or supervising systems.
Web Connectivity / Network Interfaces
Data exchange, APIs and web technologies
User Management
All about authorization, authentication and login-customization.
Availability
How to get your system uptime to the maximum.
Reporting
Create state of the art project reports without limits.
Addons
Useful tools and enhancements for special demands.
Reference Tables
Detailed and extensive content for special project adaptation.
Videos & Tutorials
Explore the capabilities of WinCC OA with our carefully selected collection of video tutorials and guides.
Documentation
Basic information about terms and functions within the documentation.
Support & Services
An experienced team of support agents, consultants and trainers are ready to facilitate active partnerships with our customers, so they can profit from our comprehensive service.
Disclaimer
A brief clarification of liability exclusions or legal notices.

hook_<libraryPrefix>_getInvalidElement()

This function determines the datapoint element that indicates whether a datapoint is invalid.

Synopsis

string hook_ <libraryPrefix>_ getInvalidElement( string dp);

Parameters


Parameter	Description
dp	Datapoint (datapoint element) that indicates whether the data point is invalid.

Default

string hook_stdlib_getInvalidElement(string dp)
{
  if (dpTypeName(dp)=="STDLIB_regler")
  return "STA.ist";
  else
  return "state.val";
}

Instead of "STDLIB_regler", enter the name of the datapoint type. The datapoint element is returned. It indicates whether the datapoint is invalid.

Return Value

Datapoint element name.