Table of Contents

Search

  1. Preface
  2. Introducing Reference 360
  3. Getting started with Reference 360
  4. Manage system reference data
  5. Manage reference data sets
  6. Manage code lists
  7. Manage code values
  8. Manage crosswalks
  9. Import data
  10. Manage hierarchies
  11. Manage attributes
  12. Manage workflows
  13. Manage jobs
  14. Reference 360 REST API
  15. Glossary

Reference 360

Reference 360

Export value mappings to CSV format with codelist names in the header

Export value mappings to CSV format with codelist names in the header

Export value mappings to CSV format with codelist names in the header.

POST request

To export value mappings in a crosswalk with codelist names in the header, submit a POST request with the following URI:
/rdm-service/external/v3/export
In the request header, you must specify the
Accept
attribute to
application/octet-stream
.
Use the following parameters in the request body to specify the crosswalk value mappings to export:
Field
Type
Description
Delimiter
String
Optional. Delimiter used to separate values. Value must be
COMMA
,
SEMICOLON
,
SPACE
,
TAB
,
PIPE
,
COLON
,
SECTION
,
CIRCUMFLEX
, or
ASTERISK
. Default is
COMMA
.
codepage
String
Code page used for the export file. Value must be
UTF8
or
MS_WINDOWS
. Default is
UTF8
.
decimalSeparator
String
Optional. Decimal separator used for numbers. Value must be
COMMA
or
DOT
. Default is
DOT
.
thousandSeparator
String
Optional. Grouping separator used for numbers. Value must be
COMMA
,
DOT
,
SPACE
,
SINGLEQUOTE
or
NONE
. Default is
NONE
.
dateFormat
String
Format used for dates. Use one of the following formats:
  • DE
    . For dd.mm.yyyy format.
  • ISO
    . For yyyy-mm-dd format.
  • US
    . For mm/dd/yyyy format.
filename
String
File name for the exported file. Value must end with the
.csv
file extension.
containerType
String
Type of asset that contains value mappings. Value must be
crosswalk
.
containerId
String
ID of the crosswalk.
You can find the ID of assets in
Reference 360
or use REST APIs to retrieve the IDs. For more information, see Asset IDs.
pageSize
Number
Optional. Number of records to display on each page. The maximum value is
10000
. Default is
10000
.
page
Number
Optional. Page number to display. Default is
0
.
pit
String
Optional. Date to retrieve the point in time information about the crosswalk. Use the ISO format: yyyy-mm-dd. Default value is the current timestamp in yyyy-mm-dd format.
repeatHeaders
Boolean
Optional. Indicates whether to populate headers in the CSV response for the requested page. Value is
true
or
false
. Default is
true
.
useAssetNameInHeader
Boolean
Indicates to use the AssetName attribute in the header. Value must be
true
.

POST response

The response is a CSV file.

POST example

To export value mappings in a crosswalk with codelist names in the header, you might use the following request:
POST https://use4-mdm.dm-us.informaticacloud.com/rdm-service/external/v3/export HTTP/1.1 Content-Type: application/json Accept: application/octet-stream Content-Length: 454 { "delimiter":"SEMICOLON", "codepage":"UTF8", "decimalSeparator":"COMMA", "thousandSeparator":"DOT", "dateFormat":"ISO", "filename":"testdata.csv", "containerType":"crosswalk", "containerId":"a8ef483f4f448a6ec273d547", "pageSize":10000, "page":0, "pit":"2021-11-09", "repeatHeaders":false, "useAssetNameInHeader":true, }
The following sample response shows the exported data in the CSV format:
HTTP/1.1 200 OK Content-Disposition: attachment;filename=testdata.csv Content-Type: application/octet-stream RDM-PAGE: 0 RDM-TOTAL-NUMBER-OF-ELEMENTS: 10 RDM-NUMBER-OF-ELEMENTS: 10 RDM-PAGE-SIZE: 10000 RDM-FIRST-PAGE: true RDM-LAST-PAGE: true Content-Length: 560 SourceCodelist;TargetCodelist sourceCode0;targetCode0 sourceCode1;targetCode1 sourceCode2;targetCode2 sourceCode3;targetCode3 sourceCode4;targetCode4 sourceCode5;targetCode5 sourceCode6;targetCode6 sourceCode7;targetCode7 sourceCode8;targetCode8 sourceCode9;targetCode9

0 COMMENTS

We’d like to hear from you!