Refinitiv Data Library for Python

session.platform.Definition object

The session.platform.Definition object allows you to define the platform session you want to create.
Platform sessions can be defined indirectly using the name of a session defined in the configuration file or directly by specifying the other Definition parameters.

Module

refinitiv.data.session.platform

Syntax

session.platform.Definition(
    name, app_key, grant, signon_control,
    deployed_platform_host, deployed_platform_username, dacs_position,
    dacs_application_id
    )

Parameters

Value Description Data Type Optional Default value
name Session name str Yes "default"
app_key Application key str Yes None
grant Grants objects containing the credentials used to authenticate the user (or the machine) when connecting to the data platform. Several kind of grant objects can be used GrantPassword is the most common one. GrantPassword obj. Yes None
signon_control Controls the exclusive sign-on behavior when the user account (or computer account) for this session is concurrently used by another application. When this parameter is set to True, opening this session automatically disconnects the other application. When this parameter is set to False, the opening of this session fails preserving the other application. bool Yes True
deployed_platform_host Host name (or IP) and port to be used to connect to Real-Time Distribution System. str Yes None
deployed_platform_username DACS user name identifying the user when to connecting to a Real-Time Distribution System str Yes None
dacs_position DACS position identifying the terminal when connecting to a Real-Time Distribution System. str Yes None
dacs_application_id Must contain the user's Data Access Control System application ID. For more information, refer to the DACS documentation on my.refinitiv.com str Yes None

Returned value

None.

Usage

The following example demonstrates how to create a Definition object for a platform session named “custom-session” and defined in the configuration file of the library.

import refinitiv.data as rd

definition = rd.session.platform.Definition(name="custom-session")

None