User Input Requirements

Oracle Enterprise Communications Platform (Oracle ECP) requires the following rules and conventions for user input.

Table 13-1 Onboarding Input

Field Name Requirements
Device Type
  • Required for devices only.
  • Displays as a drop-down list.
Name
  • Required for both devices and Cloud Connectors.
  • Must be unique per tenant.
  • Allowed number of characters: Minimum 2. Maximum 100.
Connectivity Type
  • Required for devices only.
  • Displays as a drop-down list.
Serial Number
  • Optional for devices.
  • Mandatory for Cloud Connectors.
  • Allowed character length: Minimum: 0. Maximum: 100.
Make
  • Optional for devices. Displays as an input field. Allowed number of characters: Minimum 0. Maximum 100.
  • Optional for Cloud Connectors. Displays a drop-down list.
Model
  • Optional for devices. Displays as an input field. Allowed number of characters: Minimum 0. Maximum 100.
  • Mandatory for Cloud Connectors when you populate Make. Displays a drop-down list.
Device ID
  • Optional field for devices only.
  • ID must be unique per tenant.
  • Allowed characters: Alphanumeric characters, Exclamation mark ( ! ), At sign ( @ ), Pound ( # ), Dollar ( $ ), Percentage ( % ), Caret ( ^ ), Ampersand ( & ), Asterisk ( * ), Parens ( ), Minus ( - ), Underscore ( _ ), Equals ( = ), Plus ( + ), Square brackets ( [ ] ), Curly brackets ({}), Backward slash ( \ ), Pipe ( | ), Semi Colon ( ; ), Single quote ( ' ), Double Quote ( " ), Comma ( , ), Angle brackets (<>), Period ( . ), Question mark ( ? ), Tilde ( ~ ), Back tick( ` )
  • Cannot be a snowflake ID that has a digit (0-9) or uppercase letter (A-Z, excluding the characters I, L,O, and U.
  • Allowed character length is 0 to 100.
  • Does not support a user-provided ID for the Edge Node ID.
MAC Address
  • Optional field.
  • Format: XX:XX:XX:XX:XX:XX or XX-XX-XX-XX-XX-XX or XXXX.XXXX.XXXX.
  • Allowed characters: Hexadecimal 0-9, A-F, a-f.
Primary Internet Connection
  • Read-only field for Cloud Connectors only.
Secondary Internet Connection

  • Optional field for Cloud Connectors only. Displays as check boxes.

Description
  • Optional field.
  • Allowed number of characters: Minimum 0. Maximum 255.
Authentication
  • Displays as option buttons.
  • Values for devices: Client Secret | No Authentication.
  • Values for Cloud Connectors: Certificate | Client Secret.
Device or Edge Will Be Moving
  • Optional. Displays as a check box.
  • Allowed values: Selected (yes) | Unselected (no).
Country
  • Optional.
  • Displays as a drop-down list.
Street Address
  • Mandatory when you select a Country.
  • Allowed character length: Minimum 1. Maximum 100.
  • Can include all characters, including special characters such as "?" and "@."
  • Only one space is allowed between words.
  • Leading and trailing spaces are not allowed.
City/Town
  • Mandatory for addresses in the United States.
  • Optional for addresses outside of the United States.
  • Allowed character length: Minimum 1. Maximum 100.
  • Can include all characters, including special characters such as "?" and "@."
  • Only one space is allowed between words.
  • Leading and trailing spaces are not allowed.
State/Region/Province
For addresses in the United States
  • Mandatory.
  • Select from the drop-down list.
For addresses outside of the United States
  • Optional.
  • Allowed character length: Minimum 0. Maximum 100.
  • Can include all characters, including special characters such as "?" and "@."
  • Only one space is allowed between words.
  • Leading and trailing spaces are not allowed.
Zip/Postal Code
For addresses in the United States, the address code is:
  • Mandatory.
  • Allowed characters: Digits and hyphen.
  • Format: Five digits followed by the hyphen and optional four digits. For example, 12345 or 12345-1234.
For addresses outside of the United States, the address code is:
  • Optional.
  • Allowed character length: Minimum 0. Maximum 20.
Edge Name
  • Displays as a drop-down list for devices.
  • Not applicable for Cloud Connector onboarding.
Serial Number
  • Optional for devices.
  • Mandatory for Cloud Connectors.
  • Allowed character length: Minimum: 0. Maximum: 100.
Latitude
  • Must be between -90° and 90°, supporting up to six decimal places.
Longitude Must be between -180° and 180°, supporting up to six decimal places.

Table 13-2 Other Device and Cloud Connector Related User Inputs

Field Requirements
APN
  • Select a value from the drop-down list.
SMS
  • Must not be all spaces or empty.
  • Allowed character length: Minimum 0. Maximum 160.
IMEI
  • Requires numeric entry. Cannot be all spaces or empty.
  • Allowed length: Minimum 14. Maximum 17.
  • Must be unique across Inventory for the first 14 characters.
ICCID
  • Mandatory when Connectivity Type is Cellular.
  • Allowed characters: Digits, only.
  • Allowed number of digits: 19-20.
Enable MDM
  • Displays for customers onboarded as MDM Tenants only.
  • Check box must be enabled to onboard an MDM-enabled device.

Table 13-3 User Management Input

Field Requirements
First Name
  • Allowed character length: Minimum 1. Maximum 100.
Last Name
  • Allowed character length: Minimum 1. Maximum 100.
Email
  • Allowed character length: Minimum 5. Maximum 100.
  • First character cannot be at sign ( @ ) or a period ( . )
  • Allows only one at sign ( @ ) in the email address.
  • The email address must not end with the at sign ( @ ) or a period ( . ).
Phone Number
  • Allowed character length: Minimum 5. Maximum 100.
  • Special characters allowed: plus( + ), space ( ),hyphen ( - ), dot ( . ), and open and close parentheses ( )
  • Special characters allowed at the start of the phone number: Open parentheses ( and plus ( + ) sign (Hyphen is not allowed at the start of the phone number).