Versions Compared

Version Old Version 6 New Version 7
Changes made by

Andrew DeCarlo

Andrew DeCarlo

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

View all Available Formats

To begin, users will need to know the available packaging formats that RDS supports. To view all the available packaging formats:

...

The formats that RDS supports can be broken down into three categories, data (flat files), metadata (standards compliant metadata XML), and scripts (syntax to recreate the data in databases or statistical packages). To view the formats that are in each category use the category parameter. These lists of formats are designed to allow users to view and choose the format they would like, once they select the format they easily distinguish between different formats. Once a format is chosen users can retrieve the options that will need to be filled out for that format. to configure the output.

Code Block
titleGet Data Formats
http://host/rds/api/package/types?category=data

...

A packaging request will provide Rich Data Services with an array of Format Options format options that can be used to produce the desired files. To create the packaging request the user must:

  1. Get the package request object.

    Code Block
    http://host/rds/api/package
    Code Block
    {
    "orderId": "cce1dcb8-77d3-4676-ac2d-452d89c20424",  // The packages unique order ID which can be used to check the status once the packaging request is submitted
    "options": []                                       // The array of format options, currently empty. 
}
  2. Get and fill out any format options, see the example in the section above. 
     

  3. Add the filled out format options to the package request.

    Code Block
    {
    "orderId": "cce1dcb8-77d3-4676-ac2d-452d89c20424",
    "options": [
        {
            "objectId": "26ac8903-c319-4e3d-874a-08f91673e1bb",
            "type": "FIXED",
            "optionProperties": [
                {
                    "description": "File name",
                    "enumValues": [],
                    "label": "File name",
                    "name": "fileName",
                    "type": "TEXT",
                    "value": "myfile.csvtxt",  // the value has been populated by the user
                    "repeatable": false,
                    "required": true,
                    "readOnly": false
                }
            ]
        },
        ...  // add any additional format options that you want.
    ]
}

  4. Once the package request has been filled out with the desired options it can be passed back to the server

    using a POST.. To be continued

...

  1. through a POST at:

    Code Block
    http://host/rds/api/catalog/{collectionId}/{viewId}/package

Waiting to be able to install commercial license again...