Home
Special Functions
HTTP Server
The HTTP Server integrates Internet technologies directly into WinCC OA . Implemented as an add-on for the Control Manager, possible applications are many and diverse. The HTTP Server can be used as a web server for static HTML pages including download facility or to generate dynamic HTML pages.
HTTP Server Control Functions
httpDisconnect()
Remove a registered Web-Resource

Special Functions
- Audit Trail panel
- Authentication via Kerberos, basics
  In a more and more networking world, a WinCC OA system could be exposed to different types of attacks. An unauthorized WinCC OA system could connect to the distribution manager or hackers could try to manipulate WinCC OA messages.
- Common Name Service (CNS)
  The plantmodel editor can be used for building and modifying data structures such as views and trees based on CNS and use them within projects easily.
- COM
  COM - Microsoft Interface stands for Component Object Model, a specification for developing modular software components which can be used by each COM compatible application. COM components can be easily integrated in such applications and can even be removed from an application at run time. COM components can be programmed in various different programming languages although C++ is used mostly. The specifications OLE, ActiveX and DirectX are based on the COM technology.
- OLE DB Provider
  OLE DB is a Microsoft specification for accessing data on different computers. It is based on Microsoft's COM technology and is the successor to the older and limited ODBC technology.
- CtrlExtension
  The CtrlExtension allows the addition of custom C++ code.
- CTRL OA Unit
- DBLogger, basics
- Input Recording
- Generic Dialog Framework
  The Generic Dialog Framework is an easy way to generate your own dialogs by adjusting a set of prefabricated panels.
- HTTP Server
  The HTTP Server integrates Internet technologies directly into WinCC OA . Implemented as an add-on for the Control Manager, possible applications are many and diverse. The HTTP Server can be used as a web server for static HTML pages including download facility or to generate dynamic HTML pages.
  - HTTP Server Requirements and Installation
  - HTTPS (SSL Connections)
  - Root Certificate & the Trusted Certification Authorities for Browsers
  - Standard WinCC OA HTML pages
  - HTTP base configuration
  - WinCC OA tag (interpreter string)
  - WinCC OA HTML references
  - Calling HTML references
  - SQL query in the HTTP Server
  - Working with standard WinCC OA HTML pages
  - Creating custom pages
  - HTTP Server Control Functions
    - html_ref()
      This function loads a reference into an HTML reference. The parameters will be replaced.
    - httpAccessLog()
      Creates an httpAccess.log file in the log directory and writes a log line for each HTTP request into the file.
    - httpCloseWebSocket()
      The function closes web sockets.
    - httpConnect()
      Registers a CTRL function as a Web resource
    - httpDisconnect()
      Remove a registered Web-Resource
    - httpGetAllHeaders()
      The function returns a mapping of all HTTP headers.
    - httpGetContent()
      This function extracts the content of the currently processing HTTP-Request.
    - httpGetHeader()
      Returns the value of the header (== key) of the last HTTP message.
    - httpGetLanguage()
      The function checks the stated client connection and returns a matching language ID. The function httpGetLanguageId() can be used to keep the same functionality but have a OaLanguage enum value returned.
    - httpGetLanguageId()
      The function checks the stated client connection and returns a matching OaLanguage enum value. This function provides the same functionality as httpGetLanguage(), but uses the new OaLanguage enum as return value.
    - httpGetMethod()
      The function returns the HTTP method of the last HTTP message.
    - httpGetPort()
      Returns the port and connection used for the HTTP request.
    - httpGetQuery()
      Returns the HTTP query elements as key/value pairs
    - httpGetURI()
      Returns the last from the Client (index) requested URI from the HTTP server.
    - httpMakeParamString()
      Returns a string from the passed arguments that represents the query part of a URL.
    - httpOnConnectionClose()
      The function starts the specified callBack function when the HTTP connection is closed.
    - httpParseDate()
      Allows parsing an RFC-2616 conform date string, e.g. from header "If-Modified-Since".
    - httpReadWebSocket()
      The function reads web sockets.
    - httpSaveFilesFromUpload()
      The function returns the HTTP content of a Blob variable that was received from an HTTP client via an HTML form. The function copies the content of this blob variable (a file) into a directory.
    - httpServer()
      Installs and activates an HTTP server.
    - httpSetMaxAge()
      Defines the time in seconds how long files should be cached by the client.
    - httpSetMaxContentLength()
      Sets the maximum length of a POST request.
    - httpSetMethodHandler()
      The function can be used to redirect an HTTP method to a user-defined CTRL callback function.
    - httpSetPermission()
      The function httpSetPemission() allows to define more fine grained user permissions for a specific URL used with the HTTP Server.
    - httpSetSecondaryAuthSuccess()
      The function is used to check for secondary authentification and implement a login delay.
    - httpSetUlcUserName()
      Sets the userName that will be used for the ULC_UX/ulc_ux_basics.html.
    - httpWriteWebSocket()
      The function writes web sockets.
- DP Identification
- Insights Hub Connector
  The Insights Hub connector allows you to upload data from WinCC OA to Siemens Industrial Cloud Insights Hub and to process data. WinCC OA supports the integration of SCADA data from WinCC OA to Insights Hub.
- Message Compression
  The message compression compresses WinCC OA messages. Data compression means encoding information using fewer bits than an unencoded representation would use through use of specific encoding schemes.
- Node-RED
  Node-RED is a flow-based programming tool that allows the creation of applications in a graphic environment.
- Panel topology/Group alert facility
  Tree structure for process panels with integrated group alert system
- PM Agent
  The PM Add-ons product portfolio enhances the base functionality of the WinCC product range. Now this is also supported by WinCC OA.
- Redundant network connections
  In order to achieve a better fault tolerance WinCC OA Managers can connect to other WinCC OA Managers running on different computers via redundant network connections (this means connecting through two network connections (= IP connection)).
- Redundancy
  The high availability requirements of plant constructors and operators as well as the process and data security can be covered with the redundancy concept of WinCC OA.
- XML Reporting
  The Reporting feature allows you to create reports in XML format. Therefore, add the WinCC OA Reporting Manager to your project. Historical data can be queried via the Reporting manager by using the SOAP (Simple Object Access Protocol) interface. SOAP is a network protocol which allows sending data in XML format between systems.
- Reporting with Panels (Silent print)
- Recipes, basics
  Recipe Management Systems are used for managing and storing the set points and commands of automated systems defined by numerous data point elements. Even when simulating or testing an application, a relatively large number of set points or input values need to be sent to the peripheral devices by the control system. In these and other situations such a tool represents a great simplification.
- REST Reporting API
  The REST Reporting API is integrated into the Standard web server and can be activated via the config entry [restRporting] enabled.
- Scheduler, basics
  The main task of the scheduler is to allow you to create, configure and administrate a number of schedules of either time or event triggered actions.
- Security
- System Use Notification
  You can use the system use notification panel to display an instruction to the user when logging into the WinCC OA system. The user must confirm the notification before logging into the WinCC OA project.
- System Overview
  A panel for the diagnostics of a WinCC OA system.
- Alive mechanism of manager connections
  The alive mechanism in WinCC OA serves for connection controlling between the single managers. Each manager sends alive messages at definable intervals.
- Encryption
- Distributed systems
  Distributed systems in WinCC OA allow to connect two or more autonomous WinCC OA systems via a network.
- Maintenance package, basics
  Maintenance is a necessity wherever different pieces of equipment are used. For example, drives, valves, motors, where it is necessary to perform maintenance work at specific intervals so as to ensure proper functioning. But prolonging the service life of equipment by means of regular maintenance and cost reduction are also key factors in plant engineering and automation technology.
- Wizard Framework
  Used for easy creation of wizards in a uniform layout style. The key elements "Navigation Bar" and "Bottom Bar" can be customized to fit the needs of the custom wizard.
- XML Panel Format
  The XML (Extensible Markup Language) panel format allows creating WinCC OA panels.
- XML-RPC
  XML-RPC (Extensible Markup Language Remote Procedure Call) allows software on different operating systems to make procedure calls over the internet. XML-RPC uses HTTP for the transport and XML for the encoding. It sends the procedure call to a remote server through HTTP. The call is an XML document and it receives the response as XML.
- XMPP
  XMPP (formerly Jabber) is mostly used in chat (instant messaging) applications and allows near real time communication between two or more parties. It can, e.g., be used to push information from a WinCC_OA project server to one or more persons, even allowing the recipient to send a confirmation back to the server.

httpDisconnect()

Remove a registered Web-Resource

Synopsis

inthttpDisconnect( string resourceName);

Parameter


Parameter	Description
resourceName	The URL name, which calls the given CTRL function when requested.

Return value

httpDisconnect() returns 0 on success, otherwise -1.

Error

Errors can be queried with getLastError(). Errors can be:

Too few arguments
No httpServer() is installed
httpConnect() is called from a different script than the httpServer() was installed from
The given resourceName is not registered

Description

The function httpDisconnect() removes the registration of a Web-Resource from the httpServer. The given Web-Resource is then no more available for client requests.

Example

The Web-Resource "/firstExample" shall be removed.

main()
{
  httpDisconnect("/firstExample");
}

Assignment

CTRL PlugIn

Availability

CTRL