ColumnsApi: Columns operations

In factset.analyticsapi.engines: 'FactSet' Engines API Client

Description

factset.analyticsapi.engines.Columns

Format

An R6Class generator object

Methods

GetPAColumnById Get PA column settings This endpoint returns the default settings of a PA column.

• @param id character

• @returnType Column
  

• On encountering errors, an error of subclass ApiException will be thrown.

• status code : 200 | Expected response, returns settings of a PA column.

• return type : Column

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  Age	Standard HTTP header. Header will specify the age of columns list cached response.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 400 | Invalid column Id.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 401 | Missing or invalid authentication.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 403 | User is forbidden with current credentials

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 404 | Column not found.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 406 | Unsupported Accept header. Header needs to be set to application/json.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 500 | Server error. Log the X-DataDirect-Request-Key header to assist in troubleshooting.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 503 | Request timed out. Retry the request in sometime.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

GetPAColumns Get PA columns This endpoint lists all the PA columns that can be applied to a calculation.

• @param name character

• @param category character

• @param directory character

• @returnType named list( ColumnSummary )
  

• On encountering errors, an error of subclass ApiException will be thrown.

• status code : 200 | Expected response, returns a list of PA columns

• return type : map(ColumnSummary)

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  Age	Standard HTTP header. Header will specify the age of columns list cached response.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 401 | Missing or invalid authentication.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 403 | User is forbidden with current credentials

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 406 | Unsupported Accept header. Header needs to be set to application/json.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 500 | Server error. Log the X-DataDirect-Request-Key header to assist in troubleshooting

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

• status code : 503 | Request timed out. Retry the request in sometime.

• response headers :

  X-RateLimit-Remaining	Number of requests left for the time window.
  X-FactSet-Api-Request-Key	Key to uniquely identify an Analytics API request. Only available after successful authentication.
  X-RateLimit-Reset	Number of seconds remaining till rate limit resets.
  X-RateLimit-Limit	Number of allowed requests for the time window.
  X-DataDirect-Request-Key	FactSet's request key header.

Public fields

apiClient

Handles the client-server communication.

Methods

Public methods

• ColumnsApi$new()

• ColumnsApi$GetPAColumnById()

• ColumnsApi$GetPAColumnByIdWithHttpInfo()

• ColumnsApi$GetPAColumns()

• ColumnsApi$GetPAColumnsWithHttpInfo()

• ColumnsApi$clone()

---

Method new()

Usage

ColumnsApi$new(apiClient)

---

Method GetPAColumnById()

Usage

ColumnsApi$GetPAColumnById(id, ...)

---

Method GetPAColumnByIdWithHttpInfo()

Usage

ColumnsApi$GetPAColumnByIdWithHttpInfo(id, ...)

---

Method GetPAColumns()

Usage

ColumnsApi$GetPAColumns(name = NULL, category = NULL, directory = NULL, ...)

---

Method GetPAColumnsWithHttpInfo()

Usage

ColumnsApi$GetPAColumnsWithHttpInfo(
  name = NULL,
  category = NULL,
  directory = NULL,
  ...
)

---

Method clone()

The objects of this class are cloneable with this method.

Usage

ColumnsApi$clone(deep = FALSE)

Arguments

deep

Whether to make a deep clone.

Examples

## Not run: 
####################  GetPAColumnById  ####################

library(factset.analyticsapi.engines)
var.id <- 'id_example' # character | Unique identifier for a column

#Get PA column settings
api.instance <- ColumnsApi$new()

#Configure HTTP basic authorization: Basic
# provide your username in the user-serial format
api.instance$apiClient$username <- '<user-serial>'; 
# provide your api key generated using the developer portal
api.instance$apiClient$password <- '<api_key>';

result <- tryCatch(
            api.instance$GetPAColumnById(var.id),
            ApiException = function(ex) ex 
         )
# In case of error, print the error object 
if(!is.null(result$ApiException)) {
  cat(result$ApiException$toString())
} else {
# deserialized response object
response.object <- result$content
# response headers
response.headers <- result$response$headers
# response status code
response.status.code <- result$response$status_code
}


####################  GetPAColumns  ####################

library(factset.analyticsapi.engines)
var.name <- 'name_example' # character | 
var.category <- 'category_example' # character | 
var.directory <- 'directory_example' # character | 

#Get PA columns
api.instance <- ColumnsApi$new()

#Configure HTTP basic authorization: Basic
# provide your username in the user-serial format
api.instance$apiClient$username <- '<user-serial>'; 
# provide your api key generated using the developer portal
api.instance$apiClient$password <- '<api_key>';

result <- tryCatch(
            api.instance$GetPAColumns(name=var.name, category=var.category, 
                                      directory=var.directory),
            ApiException = function(ex) ex 
         )
# In case of error, print the error object 
if(!is.null(result$ApiException)) {
  cat(result$ApiException$toString())
} else {
# deserialized response object
response.object <- result$content
# response headers
response.headers <- result$response$headers
# response status code
response.status.code <- result$response$status_code
}



## End(Not run)

factset.analyticsapi.engines documentation built on Feb. 2, 2020, 5:06 p.m.