Home
Business Logic / Control
Endless possibilities in data processing for your projects.
CONTROL Functions
Functions U
urlEncode()
The function encodes a string into a percent-encoded string to be used within a URL.

Versionsinformationen
Release Notes, Update-Informationen, Zertifizierungen and häufig gestellte Fragen.
Konzepte
Ihr erster Schritt in die moderne und leistungsstarke Prozessvisualisierung.
Deployment
Topics, you need to know, before using WinCC OA.
Sicherheit
Wachsen sie in Bezug auf Cybersecurity über die Norm hinaus.
Engineering
Leistungsstarke Tools für einfache sowie komplexe Engineering-Aufgaben.
Datenmanagement
Klassifizieren, strukturieren und archivieren sie Ihre Daten.
Business Logic / Control
Endless possibilities in data processing for your projects.
- Introduction to CTRL
  An introduction to the product's own programming language Control(CTRL).
- Control Classes
  The overview of classes available in Control.
- Types of Control Functions
  An overview of the types of functions distinguished within Control.
- Control graphics
- CONTROL Functions
  - Funtions A
  - Funtions B
  - Funtions C
  - Funtions D
  - Functions E
  - Functions F
  - Functions G
  - Functions H
  - Functions I
  - Functions J
  - Functions K
  - Functions L
  - Functions M
  - Functions N
  - Functions O
  - Functions P
  - Functions Q
  - Functions R
  - Functions S
  - Functions T
  - Functions U
    - udpClose()
      Closes the connection to a UDP socket.
    - udpOpen()
      Opens a connection to a UDP socket.
    - udpRead()
      Reads the data from a UDP socket.
    - udpWrite()
      Writes data to the passed UDP socket (host).
    - uiConnect()
      The function allows you to connect to a specific event with a callback function and call this callback function in case the connected event is triggerd. This is a similar behavior to e.g. ControlA_D/dpConnect.html
    - uiConnectUserData()
      The function allows to connect to a specific event with a callback function and call this callback function in case the connected event is triggerd. This is a similar behavior to e.g. dpConnect(). Additionally to uiConnect() specific user data can be passed to the callback function.
    - uiDisconnect()
      The function allows to disconnect previously established connections of the functions uiConnect() and uiConnectUserData().
    - uniDynPatternMatch()
      Checks whether particular strings in a dynamic field have a specific pattern.
    - uniFPrintf()
      Writes to a file.
    - uniFPrintfPL()
      Writes to a file similar to uniFPrintf() except changes to the current WinCC OA language before converting.
    - uniFPrintfUL()
      Writes to a file similar to uniFPrintf() except changes to the current Windows user language before converting.
    - uniPatternMatch()
      Checks whether particular string have a specific pattern.
    - uniSPrintf()
      Formats a string.
    - uniSPrintfUL()
      Formats a string.
    - uniStrChange()
      Changes the content of a string at a specific index for a defined count of digits with a replacing string.
    - uniStrExpand()
      Returns a formatted string.
    - uniStrFormat()
      Returns a formatted string.
    - uniStrLen()
      Returns the length of a string.
    - uniStrPos()
      Returns the position of a string within another.
    - uniStrReplace()
      Replaces parts of a string with another string.
    - uniStrTok()
      Searches a string for the first occurrence of any of a set of characters.
    - uniStrToLower()
      Changes a string to lowercase.
    - uniStrToUpper()
      Converts a lower-case string to a string in capital letters.
    - uniSubStr()
      Cuts a string or a character of a certain length (characters) out of another string.
    - unzip()
      The function unpacks a file into a specified directory.
    - uploadPreparedValues()
      The method uploads values from the internal data structure to MindSphere.
    - urlDecode()
      The function decodes a percent-encoded URL into a regular string.
    - urlEncode()
      The function encodes a string into a percent-encoded string to be used within a URL.
    - useQueryRDBDirect()
      The function checks if RDB (Oracle) is used for queries.
    - useRDBArchive()
      The function useRDBArchive() checks if RDB archives are used for the archiving in a project.
    - useRDBGroups()
      The function useRDBGroups() checks if RDB groups are used for archiving.
    - userDefFunc()
      Calls C++ functions.
    - usesTouchScreen()
      Query if the UI is currently using touch-input mode or mouse mode..
    - useValueArchive()
      The function checks whether the valueArchive archiving is used.
    - usr_deleteSetting()
      Deletes a user setting from the configuration management.
    - uss_getGenericSetting()
      Reads all user or user group settings without hierarchy.
    - uss_getMyUsergroup()
      Returns the user group with the lowest position ID.
    - uss_getSpecificSetting()
      Reads a specific user(group) setting without hierarchy.
    - uss_getSpecificUserSetting()
      Reads a specific user setting with hierarchy.
    - uss_getUserSettings()
      Reads all user settings with hierarchy.
  - Functions V
  - Functions W
  - Functions X
  - Functions Y
  - Functions Z
- CtrlExtension
  Die CtrlExtension ermöglicht das Hinzufügen von benutzerdefiniertem C++-Code.
- CTRL-Debugger
  Der CTRL-Debugger ermöglicht ein Debuggen der Pogrammiersprache Control. Der Debugger kann über ein eigenes Panel verwendet werden, welches es auch erlaubt die Variablen zu beinflussen, Breakpoints zu setzen, usw.
- SQL in CONTROL
  Mit den Datenbankfunktionen besteht eine Möglichkeit, Werteabfragen von Datenpunkten und -elementen schnell durchzuführen.
- API Manager
  Das API von WinCC OA (Application Programming Interface) bietet eine Reihe von Funktionen, die es ermöglichen, dieses Prozessleitsystem um spezielle Manager zu erweitern.
Datenvisualisierung
User Interfaces, Trends und Reports für jeden Zweck und jedes Gerät.
Southbound Interfaces
Der Prozessanschluss zu den echten Maschinen/Sensoren.
Northbound Interfaces
Ihr Portal zur Cloud oder übergeordneten Systemen.
Konnektivität / Netzwerk Schnittstellen
Datenaustausch, APIs und moderne (Web) Technologien.
Benutzerverwaltung
Alles über Autorisierung, Authentifizierung und Login-Anpassung.
Verfügbarkeit
Wie sie maximale Systemverfügbarkeit erreichen können.
Reporting
Erstellen sie "State of the art"-Reports ohne Limits.
Erweiterungen
Nützliche Werkzeuge und Erweiterungen für spezielle Anforderungen.
Referenztabellen
Detaillierte und umfangreiche Inhalte für spezielle Projektanpassungen.
Videos & Tutorials
Erkunden Sie die Möglichkeiten von WinCC OA mit unserer sorgfältig ausgewählten Sammlung von Video-Tutorials und Anleitungen.
Dokumentation
Grundlegende Informationen über Bezeichnungen und Funktionsweisen innerhalb der Dokumentation.
Disclaimer
Erläuterungen zu Haftungsausschlüssen oder rechtlichen Hinweisen.

urlEncode()

The function encodes a string into a percent-encoded string to be used within a URL.

Synopsis

string urlEncode(string decoded);

Parameters


Parameter	Description
decoded	A string to encode.

Return value

The function returns a percentage-encoded string.

Description

In some cases when using webservices (e.g. posting a Tweet on Twitter), you need to percent-encode a string. This is required when calling the netPost() function with "Content-Type", "application/x-www-form-urlencoded".

Therefore, you need the functions: urlDecode() and urlEncode(). The function urlEncode() encodes the decoded parameter into URL encoding format and urlDecode() decodes it back to a string.

For more information on URL encoding, see https://en.wikipedia.org/wiki/URL_encoding.

Encoding example

Note: This is a code excerpt!

 
// ...
string content = "code=" + urlEncode(query.code) +
"&grant_type=authorization_code" +
"&client_id=" + urlEncode(CLIENT_ID) +
"&redirect_uri=" + urlEncode(REDIRECT_URI) +
"&code_verifier=" + urlEncode(oauth2_code_verifier);
                
mapping result;
netPost("https://api.twitter.com/2/oauth2/token", 
makeMapping("headers", makeMapping("Authorization", "Basic " + base64Encode(CLIENT_ID + ":" + CLIENT_SECRET),
"Content-Type", "application/x-www-form-urlencoded"),"content", content), result);
// ...

Availability

UI, CTRL