TestConnectionBehavior
Specifies the behavior of the test connection operation.
Possible Values
READ_FILE, LIST_FILES, NO_OPERATION, AUTHENTICATE, LIST_OR_READ_FILESData Type
string
Default Value
"AUTHENTICATE"
Remarks
Changes how the provider responds to a test connection operation based on the integration scenario.
LIST_OR_READ_FILES
List and read files from the storage source until at least one is parsed. Fails if none of the files can be parsed (are invalid). Fails if the directory contains no SAS Xpt files. Note: this mode will not read files in sub-directories. This is the most flexible option and works with both directory and file URIs.
READ_FILE
Validates that the URI points to a readable SAS Xpt file. The URI must point to an existing SAS Xpt file, not a directory. This behavior will fail if the file does not exist or contains invalid SAS Xpt content.
LIST_FILES
Validates that the URI points to a directory and lists its contents. Fails if the directory contains no SAS Xpt files.
NO_OPERATION
Performs basic URI validation without accessing files or verifying their existence. This is useful for quickly validating configuration without network or file system operations.
AUTHENTICATE
Validates connection credentials and URI accessibility. For cloud storage, this verifies authentication. For local files, this checks URI format and basic accessibility.
Notes
- The provider is read-only. Unlike write-capable drivers, empty directories will cause failures for LIST_FILES since a connection with no readable files is unusable.
Behavior by URI examples
| URI | NO_OPERATION | READ_FILE | LIST_FILES | LIST_OR_READ_FILES | AUTHENTICATE |
| Directory with XPT files | Success | Failure: URI must point to an existing file | Success | Success | Success |
| Empty directory | Success | Failure: URI must point to an existing file | Failure: URI must point to a non-empty directory | Success | Success |
| Non-existing directory | Success | Failure: URI must point to an existing file | Failure: URI must point to an existing directory | Failure: URI must point to an existing file or directory | Success |
| Valid XPT file | Success | Success | Failure: URI must point to an existing directory | Success | Success |
| Non-existing file | Success | Failure: URI must point to an existing file | Failure: URI must point to an existing directory | Failure: URI must point to valid file or directory | Success |
| Invalid XPT format | Success | Failure: Parsing error | Failure: URI must point to an existing directory | Failure: Parsing error | Success |
| Cloud storage, invalid credentials | Success | Failure: Authentication failed | Failure: Authentication failed | Failure: Authentication failed | Failure: Authentication failed |