https://github.com/shunkosa/sfdx-cmdt-plugin

A Salesforce CLI plugin that converts CSV to Custom Metadata records
https://github.com/shunkosa/sfdx-cmdt-plugin

custom-metadata metadata-api salesforce salesforcedx sfdx-cli

Last synced: about 2 months ago
JSON representation

A Salesforce CLI plugin that converts CSV to Custom Metadata records

• Host: GitHub
• URL: https://github.com/shunkosa/sfdx-cmdt-plugin
• Owner: shunkosa
• License: mit
• Created: 2018-11-03T08:18:07.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2020-07-21T00:03:38.000Z (over 4 years ago)
• Last Synced: 2024-10-02T08:38:16.894Z (3 months ago)
• Topics: custom-metadata, metadata-api, salesforce, salesforcedx, sfdx-cli
• Language: TypeScript
• Homepage:
• Size: 684 KB
• Stars: 19
• Watchers: 4
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-sfdx-plugins - sfdx-cmdt-plugin

README

        
# sfdx-cmdt-plugin

[![Version](https://img.shields.io/npm/v/sfdx-cmdt-plugin.svg)](https://npmjs.org/package/sfdx-cmdt-plugin)

[![Downloads/week](https://img.shields.io/npm/dw/sfdx-cmdt-plugin.svg)](https://npmjs.org/package/sfdx-cmdt-plugin)

[![License](https://img.shields.io/npm/l/sfdx-cmdt-plugin.svg)](https://github.com/shunkosa/sfdx-cmdt-plugin/blob/master/package.json)

A plugin for Salesforce DX CLI that converts CSV to XML custom metadata records.

## Notice

**The official CLI topic `sfdx force:cmdt` is now available at v49. This plugin is no longer actively maintained.**

## Setup

### Install as plugin

1. Install plugin: `sfdx plugins:install sfdx-cmdt-plugin`

### Install from source

1. Install the SDFX CLI.

2. Clone the repository: `git clone [email protected]:shunkosa/sfdx-cmdt-plugin.git`

3. Install npm modules: `npm install`

4. Link the plugin: `sfdx plugins:link` .

## Use

### Convert

`sfdx cmdt:csv:convert records.csv -t Example__mdt`

(Optional) you can use a column mapping file like Data Loader.

`sfdx cmdt:csv:convert records.csv -t Example__mdt -m mapping.txt`

```

DeveloperName=API Name

Label=Display Label

Field__c=Field

```

You can deploy the converted metadata records by `sfdx force:source:deploy -m CustomMetadata`

### Show list of custom fields

`sfdx cmdt:field:list -t Example__mdt`