Initialize Connection Context
Properties
- Input
- URL
- Type:
string
- Description: The AIForged API base URL. Default is
https://portal.aiforged.com
. - Default Value:
"https://portal.aiforged.com"
- Type:
- Username
- Type:
string
- Description: Your AIForged username.
- Type:
- Password (Plain Text)
- Type:
string
- Description: Your AIForged password in plain text. Use the secure option if possible.
- Type:
- Password (Secure String, Recommended)
- Type:
SecureString
- Description: Your AIForged password in
System.Security.SecureString
format.
- Type:
- Connection Timeout
- Type:
TimeSpan?
- Description: The API connection timeout.
- Default Value:
TimeSpan.FromMinutes(30)
- Type:
- Proxy Server
- Type:
string
- Description: Proxy server address.
- Type:
- Proxy Username
- Type:
string
- Description: Proxy username.
- Type:
- Proxy Password (Plain Text)
- Type:
string
- Description: Proxy password in plain text.
- Type:
- Proxy Secure Password (Secure String, Recommended)
- Type:
SecureString
- Description: Proxy password in
System.Security.SecureString
format.
- Type:
- Request Logging
- Type:
bool?
- Description: Enable or disable logging of API requests.
- Default Value:
false
- Type:
- Response Logging
- Type:
bool?
- Description: Enable or disable logging of API responses.
- Default Value:
false
- Type:
- Throw on Exception
- Type:
bool?
- Description: Specify whether to throw exceptions.
- Default Value:
true
- Type:
- URL
- Output
- User Info
- Type:
AIForged.API.UserViewModel
- Description: Outputs the user information for the authenticated user.
- Type:
- User Info
Usage
- Setup Activity:
- Add the "Initialize Connection Context" activity to your UiPath workflow.
- Configure the required input arguments:
- URL: Provide the API base URL if different from the default.
- Username: Enter your AIForged username.
- Password or Secure Password: Enter your AIForged password in either plain text or secure string format.
- Optionally, configure:
- Connection Timeout: Set a custom timeout for the API connection.
- Proxy Server and Credentials: Specify proxy settings if required.
- Logging and Exception Handling: Adjust logging and exception handling options as needed.
- Execution:
- The activity executes asynchronously, establishing a connection to the AIForged API and initializing the connection context.
- It uses the provided credentials and configuration to authenticate and set up the context.
- Output:
- The activity outputs an
API.Context
object, which can be used in subsequent activities within the scope. - Additionally, it provides
User Info
, which contains details about the authenticated user.
- The activity outputs an
Considerations
- Security: Use secure strings for passwords to enhance security. Avoid using plain text passwords where possible.
- Proxy Configuration: Ensure proxy settings are correct if your network requires proxy authentication.
- Error Handling: Consider how exceptions should be handled in your workflow, using the
Throw on Exception
property to control behavior.