Parameter compliant in SDMXREST21RequestBuilder

[luifrancgom]

I want to create/add a SDMX service provider in the following way:

library(rsdmx)

BANREP <- SDMXServiceProvider(agencyId = "BANREP", name = "Banco de la República", 
                              scale    = "national", 
                              country  = "COL", 
                              builder  = SDMXREST21RequestBuilder(regUrl    = "https://totoro.banrep.gov.co/nsi-jax-ws/rest", 
                                                                  repoUrl   = "https://totoro.banrep.gov.co/nsi-jax-ws/rest", 
                                                                  compliant = TRUE, 
                                                                  unsupportedResources = list("metadatastructure",
                                                                                              "hierarchicalcodelist", 
                                                                                              "organisationscheme", 
                                                                                              "agencyscheme", 
                                                                                              "dataproviderscheme", 
                                                                                              "dataconsumerscheme",
                                                                                              "organisationunitscheme",
                                                                                              "metadataflow", 
                                                                                              "reportingtaxonomy", 
                                                                                              "provisionagreement", 
                                                                                              "structureset", 
                                                                                              "process",
                                                                                              "contentconstraint", 
                                                                                              "attachmentconstraint", 
                                                                                              "actualconstraint", 
                                                                                              "allowedconstraint", 
                                                                                              "structure", 
                                                                                              "transformationscheme", 
                                                                                              "rulesetscheme", 
                                                                                              "userdefinedoperatorscheme", 
                                                                                              "customtypescheme", 
                                                                                              "namepersonalisationscheme", 
                                                                                              "vtlmappingscheme",
                                                                                              "metadata")))

But I really don't understant the compliant parameter in SDMXREST21RequestBuilder. How can I exactly know if the web-service is compliant with the SDMX REST web-service specifications?

Reading the documentation of the API it mentions that "This web service, which uses the SDMX standard, is currently configured with the SDMX-ML Generic Data structure version 2.1 ...". Also I know that the following resources are implemented based on what is pointed out in https://github.com/sdmx-twg/sdmx-rest/tree/v1.5.0 and when exploring the API:

• datastructure
• data
• dataflow
• conceptscheme
• codelist
• categoryscheme
• categorisation

Is there a test or additional information do I need to provide to know if the web-service is compliant with the SDMX REST web-service specifications or the only way is to contact BANREP?

[eblondel]

Hi @luifrancgom the compliant is more an indicator I've added, because of the service providers i've plugged in rsdmx were supposed to implement SDMX 2.1 service specification, and then realized that they were not fully compliant, and I wanted to add some note on this. You should not worry much about this parameter.

If you want, we can add your service provider as part of the embedded sdmx service endpoints in rsdmx. You can contribute it in case you want to do it, please open an issue on it, and send me a pull request.

[luifrancgom]

Ok. I will do that. Thank you @eblondel. I am waiting for an inquiry that I send to Banco de la República - Colombia and I will add the provider because I don't work there.

But I will send the pull request. Thank you as always for your help.

[luifrancgom]

I have another question

1. In the case of BANREP for example if you want to build a data query you use something like this:

https://totoro.banrep.gov.co/nsi-jax-ws/rest/data/ESTAT,DF_TRM_DAILY_HIST,1.0/all/all?lastNObservations=5

Where https://totoro.banrep.gov.co/nsi-jax-ws/rest/ is the ws-entry-point. Also in the case of flowRef and for resource with the value data:

https://ws-entry-point/resource/flowRef/key/providerRef?queryStringParameters

You must include ESTAT and not BANREP. I don't know how this will be handle by rsdmx. Should I specify the parameter skipProviderId = FALSE in SDMXREST21RequestBuilder? Also it will be better to specify compliant = TRUE in SDMXREST21RequestBuilder?

Finally I don't know in which part should I include the part about ESTAT.