APIs & services / Reporting datasets (rtld)

Nine-principles adoption figures for the cadre.

Endpointtoday's app

Call: GET /rtld/api/dataset/v1/execute?name=PlusOneCadreAnalytics9Principles
Service: Reporting datasets (rtld)
Features: Analytics dashboard
When: Periodic 12 h and on demand
Auth: X-SESSIONID set by CoreAPI (dooNowOrThrow)
In the App Service: GET /analytics/dashboard

Use case

FetchAnalyticsDataWorker calls it after PlusOneCadreAnalytics for a cadre with no VO filter. The nine-principles adoption counts are stored in SharedPreferences KEY_ANALYTICS_9_PRINCIPLE_DATA and shown in OverallMisFragment. A failure stores an empty list.

Headers

Header	Value	Notes
`X-SESSIONID`	<session token>	Not set by the call site. AuthInterceptor (OkHttpClientInterceptor) adds it from AndroidSessionManager. On a 401 or 400 it invalidates the token, gets a fresh one and retries once.

Parameters

Param	In	Required	Example	Notes
`name`	query	Yes	`PlusOneCadreAnalytics9Principles`	Dataset name. The rtld executor (/rtld/api/dataset/v1/execute) picks the dataset by this query param.
`version`	query	Yes	`1`	Dataset version. Always 1.
`format`	query	Yes	`json`	Response format. Always json, so the body is a JSON array of row objects.
`params`	query	Yes	`CadreLogin=9XXXXXXXX1`	Dataset input parameters as KEY=value pairs joined with "--". CadreLogin = user login before "@@". This dataset uses camel-case CadreLogin, not CADRE_LOGIN.

Request

No body. cadre params

Response

Example response body (synthetic data)

[
  {
    "CadreLogin": "9XXXXXXXX1",
    "PMDSKIT": 12,
    "S2SKIT": 8,
    "PMDS in Pelletisation Mode": 5,
    "100% Chemical Free Practices": 30,
    "Natural Growth Promoters": 22,
    "Beejamrutham": 40,
    "Ghanajeevamrutham": 35,
    "Dhravajeevamrutham": 33,
    "Botanical Extracts or Kasayams": 18
  }
]

Field	Type	Notes
`CadreLogin`	string	Cadre login (or VO for the VO-wise variant).
`PMDSKIT, S2SKIT`	number	Farmers who received PMDS / S2S kits.
`PMDS in Pelletisation Mode`	number	Key with spaces; mapped via @SerializedName.
`100% Chemical Free Practices, Natural Growth Promoters, Beejamrutham, Ghanajeevamrutham, Dhravajeevamrutham, Botanical Extracts or Kasayams`	number	Adoption counts for each natural-farming principle; shown in OverallMisFragment.

Errors

Status	When	What the app does
`401 / 400`	Session token expired or rejected	AuthInterceptor refreshes the token and retries once; if the retry also fails, Empty list stored; the nine-principles section shows nothing.
`5xx`	Dataset query failed on the server	Empty list stored; the nine-principles section shows nothing.
`network error`	No connectivity or timeout	Empty list stored; the nine-principles section shows nothing.

Source

app/src/main/java/org/platformcommons/urvi/datasource/network/retrofit/APIInterface.kt
app/src/main/java/org/platformcommons/urvi/datasource/service/FetchAnalyticsDataWorker.kt
app/src/main/java/org/platformcommons/urvi/datasource/network/responsedto/Analytics9PrinciplesDto.kt
app/src/main/java/org/platformcommons/urvi/view/dashboard/OverallMisFragment.kt