Home
Basic usage
Creating a new basic, single-threaded, single-user application with the 1010data .NET SDK includes setting up your application framework, establishing a session, submitting a query, receiving results, and cleaning up the session.
Establishing a session
A 1010data Insights Platform session is an instance of a particular user ID logged into the platform within a certain environment. A session is comprised of a dedicated set of resources that can serve a single request at a time.
Connecting via proxy
If your application is connecting to the Insights Platform via a proxy server, your gateway string needs to be modified to include the proxy server's address (MYCORPORATEPROXYADDRESS)

Basic usage
Creating a new basic, single-threaded, single-user application with the 1010data .NET SDK includes setting up your application framework, establishing a session, submitting a query, receiving results, and cleaning up the session.
- Setting up an application
  Your application setup includes referencing any required libraries, including the 1010data .NET SDK, and creating a class that contains all of the functions that interact with the 1010data Insights Platform, the Main method, and any additional functions contained within.
- Establishing a session
  A 1010data Insights Platform session is an instance of a particular user ID logged into the platform within a certain environment. A session is comprised of a dedicated set of resources that can serve a single request at a time.
  - Login Types
    The login type determines what happens when the application establishes a connection to the Insights Platform and another session is currently active.
  - Connecting via proxy
    If your application is connecting to the Insights Platform via a proxy server, your gateway string needs to be modified to include the proxy server's address (MYCORPORATEPROXYADDRESS)
- Running a query
  Your application should act as an intermediary between your users and the platform to pass in a query and receive the queried data.
- Accessing the results of a query
  After querying the 1010data Insights Platform, your application receives a set of results, which can be accessed via the Table object.
- Cleaning up a session
  If your application uses the using keyword, which implements the IDisposable interface, the Session object is automatically cleaned up at the end of the using block. If your application does not implement using, then you need to release the session when you've completed the transaction.

Connecting via proxy

If your application is connecting to the Insights Platform via a proxy server, your gateway string needs to be modified to include the proxy server's address (MYCORPORATEPROXYADDRESS)

Depending on your proxy server's configuration, you may also need to include:

user name (PROXY_USERNAME)
password (PROXY_PASSWORD)
port (PORT)

The proxy server's information is added to the beginning of the gateway string between square brackets ([]).

[https://PROXY_USERNAME:PROXY_PASSWORD@
MYCORPORATEPROXYADDRESS:PORT]https://www2.1010data.com/cgi-bin/gw

If you're unsure of whether or not you need to specify a proxy server, or you need your proxy server credentials, contact your corporate technology support team or IT department.

Note: This example does not use square brackets ([]) to denote variables.

Examples

Some proxy servers will require a full set of credentials, for example:

[https://aHamilton:g3n3ricPWD@my.corporate.proxy:8080]https://www2.1010data.com/cgi-bin/gw

A proxy server may only require a user name, for example:

[https://hGranger@my.corporate.proxy:8080]https://www2.1010data.com/cgi-bin/gw

A proxy server may not require any credentials or a port number, for example:

[https://my.corporate.proxy]https://www2.1010data.com/cgi-bin/gw