gen_objects2var: Search for Objects Related to a Variable

In restatis: Web API Client for the German Federal Statistical Office Database

Search for Objects Related to a Variable

Description

Function to find objects related to a variable in GENESIS.

Usage

gen_objects2var(
  code = NULL,
  category = c("tables", "statistics", "cubes"),
  detailed = FALSE,
  sortcriterion = c("code", "content"),
  error.ignore = FALSE,
  ...
)

Arguments

code	a string with a maximum length of 15 characters. Code from a GENESIS-Object. Only one code per iteration.
category	a string. Specific object-types: 'tables', 'statistics', and 'cubes'. All three together are possible and the default option.
detailed	a logical. Indicator if function should return the detailed output of the iteration including all object-related information or only a shortened output including only code and object title. The default is detailed = FALSE.
sortcriterion	a string. Indicator if the output should be sorted by 'code' or 'content'. This is a parameter of the GENESIS API call itself. The default is "code".
error.ignore	a logical. Indicator if the function should stop if an error occurs or no object for the request is found or if it should produce a token as response.
...	Additional parameter of the GENESIS API call. These parameters are only affecting the GENESIS API call itself, no further processing.

Value

A list with all recalled elements from GENESIS. Based on the detailed-parameter it contains more or less information, but always includes the code of the object, the title, and the type of the object. This is done to facilitate further processing of the data. Attributes are added to the dataframe describing the search configuration for the returned output.

Examples

## Not run: 
# Find Tables for Variable "Kreise" and return detailed output
object <- gen_objects2var(code = "Kreise", category = "tables", detailed = T)

# Find everything for Variable "GES"
object <- gen_objects2var(code = "GES")
# Default of detailed-parameter is FALSE, and default of the
# category-parameter is to include all object types.

## End(Not run)

restatis documentation built on July 9, 2023, 5:31 p.m.