User Input Requirements

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

Table 16-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).
Deployment Address Optional when valid deployment coordinates are provided. Select an address from the suggested results.
Deployment Latitude Required. Must be between -90 and 90 degrees and can contain up to six decimal places.
Deployment Longitude Required. Must be between -180 and 180 degrees and can contain up to six decimal places.
Registration address same as deployment location Applies only when Starlink or FirstNet connectivity requires a registration address. Displays as a check box.
Registration Address

Required for Starlink and FirstNet connectivity. Do not provide it for other connectivity. A FirstNet registration address must be in the United States. Select an address from the suggested results.

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.

Table 16-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 16-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).