@Platform (Formula Language)

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

Syntax

@Platform( [S PECIFIC ] )

Parameters

[S PECIFIC ]

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 iOS on 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

  • iOSModelType

    Nomad iOS model type, either iPad or iPhone.

  • AppleHardwareIdentifier

    Nomad Apple hardware identifier, for example iPad<model number>.

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".

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.