Connect
Use this command to sign on to the Data Server repository. This command is issued from within a Procedure document.
You can use this command with the user ID of an Administrator, or a regular user.
Syntax for Longview authentication
CONNECT User/Password Host Port LID Role [UserGroup] [LanguageCode]
where:
- User/Password is your user ID and password (separated by a forward slash). If the user name contains a space, it must be enclosed in double quotation marks ("").
- Host is the name of the host computer.
- Port is the port number used by the Listener (typically ending in 1).
- LIDis your Longview identifier.
- Role is the name of a symbol access role.
- UserGroup is a user group. This is a mandatory parameter if V3_COMPATIBLE_ACCESS is used for the Role parameter.
- LanguageCode is the optional language code.
where:
- Host is the name of the host computer.
- Port is the port number used by the Listener (typically ending in 1).
- LID is your Longview identifier.
- Role is the name of a symbol access role.
- LanguageCode is the optional language code.
Syntax for ISW platform
If your system is on ISW platform
You must have an Azure Active Directory setup to be able to use this connect syntax.
CONNECT ClientId/Secret AAD Tenant Environment ClientProxyURL LID Role [userGroup] [LangCode]
where:
- ClientID/Secret is the application registered in the Azure Active Directory server that is used to request an access token.
- Tenant is the name of the Azure Active Directory server that is used to populate the AAD URL to request access token.
- Environment is the target B2C platform name that is used to populate the scope of the access token.
- ClientProxyURL is the URL of the client proxy
- LID is your Longview identifier.
- Role is the name of a symbol access role.
- UserGroup is a user group. This is a mandatory parameter if V3_COMPATIBLE_ACCESS is used for the Role parameter.
- LanguageCode is the optional language code.
Syntax example
CONNECT 4c796c6b-21u5-463b-8ddd-c5839e5c41e7/qPa-pz0D8mgi4zDZRR2E AAD AzureServer iswb2c https://localhost:8080/client/ Longview7 V3_COMPATIBLE_ACCESS Administrators
Syntax for ISW platform external authentication (OPENID)
If your system is on ISW platform and are using an external authenticated service account, then the following syntax must be used to be able to connect. The user must also be a service account with Connect to Application Framework authorization.
You must have an external authenticated service using OPENID setup to be able to use this connect syntax.
CONNECT ClientId/Secret OPENID Issuer Environment ClientProxyURL LID Role [userGroup] [LangCode]
where:
- ClientID/Secret is the application registered in the Azure Active Directory server that is used to request an access token.
- Issuer is the external IDP issuer URI server that is used to request the access token.
- Environment is the target B2C platform name that is used to populate the scope of the access token.
- ClientProxyURL is the URL of the client proxy
- LID is your Longview identifier.
- Role is the name of a symbol access role.
- UserGroup is a user group. This is a mandatory parameter if V3_COMPATIBLE_ACCESS is used for the Role parameter.
- LanguageCode is the optional language code.
Syntax example
CONNECT 4c796c6b-21u5-463b-8ddd-c5839e5c41e7/qPa-pz0D8mgi4zDZRR2E OPENID https://prod-u23s.us.auth0.com iswb2c https://localhost:8080/client/ Longview7 V3_COMPATIBLE_ACCESS Administrators