@Platform (Formula Language)

Returns the name of the currently running platform version of Notes, Domino, or Nomad.

Syntax

@Platform( [SPECIFIC] )

Parameters

[SPECIFIC]

Keyword. Optional. Returns more detailed information; for example, the version number in addition to the name of the platform.

Return value

platform

Text or text list. Without the parameter, returns the name of the platform.

  • AIX/64
  • Android
  • iOS
  • Linux/64
  • Macintosh
  • OS/400®
  • UNIX
  • Windows/32
  • Windows/64

When you use the [Specific] keyword, @Platform returns a text list. For platforms other than Nomad, the text list contains the following items:

  • PrimaryOSName

    The detailed platform name.

  • PrimaryOSVersionNumber

    The current version number of the primary operating system. The number is specific; for example, 3.11. For the UNIX platform, @Platform([SPECIFIC]) returns only the specific platform name, not the version number.

  • SecondaryOSName

    The name of the secondary operating system. The values are the same as those for the primary operating system. Most platforms don't have a secondary operating system.

  • SecondaryOSVersionNum

    The current version number of the secondary operating system.

For iOS on Nomad, the text list contains the following items:
  • PrimaryOSName

    The detailed platform name

  • PrimaryOSVersionNumber

    The current iOS version number

  • Device Type (V1.0.9+)

    Either Tablet or Phone

  • The resolution, in pixels, that Nomad is rendering at (V1.0.9+)

    The smaller value comes first and this value does not change with orientation changes. For example: "567,1245".

For Nomad on Android, the text list contains the following items:
  • PrimaryOSName

    This will always return "Android".

  • PrimaryOSVersionNumber

    The current Android OS version number, for example: "8.0.0".

  • DeviceType

    Either "phone" or "tablet".

  • ScreenResolution

    The resolution, in pixels, that Nomad is rendering at. The smaller value comes first and this value does not change with orientation changes. For example: "567,1245".

For Nomad for web browsers, the text list contains the following items:
  • PrimaryOSName

    This will always return "WebBrowser".

  • HostOSName

    The name of the operating system that the browser is running on. This will always be "Macintosh", "Windows" or "Linux".

  • UserAgent

    The full user agent from the browser.

  • ScreenResolution

    The resolution, in pixels, that Nomad is rendering at. The first value is the width and the second value is the height. For example: "1397,775".

Usage

When it is used in column, selection, or scheduled agent formulas, @Platform returns the current platform where the database resides. If the database resides on a server, @Platform returns the server platform; if the database resides locally, @Platform returns the workstation or mobile platform.

Your application may perform certain operations that are not available in all platform versions (such as the DDE-related functions). Rather than receive an error, you could use @Platform to determine whether or not to perform the operation.

You can use @Platform([Specific]) to distinguish between Windows, Unix, and mobile device platforms.

This function returns the server platform only. Use @ClientType to distinguish between Web and Notes/Domino users.

In Web applications, @Platform returns the platform only.