# moleculer-ra-data-provider > Moleculer.services data provider for react-admin Latest version **1.6.1** (published 2022-04-28) · MIT license · 0 weekly downloads ## Install ```sh npm install moleculer-ra-data-provider pnpm add moleculer-ra-data-provider yarn add moleculer-ra-data-provider bun add moleculer-ra-data-provider ``` ## Health **Score 15/100 (F)** — status: abandoned. Positive: no vulnerabilities. Warnings: low downloads; no types; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 1.6.1 | | Published | 2022-04-28 | | First published | 2020-11-17 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | none | | Module format | CommonJS | | Dependencies | 1 | | Unpacked size | 29.2 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 3 | | Author | Alpes Digital | | Maintainers | alpesdigital | | Keywords | microservices, react-admin, moleculer, moleculer.services, data, provider, javascript, api, client | ## Links - npm: https://www.npmjs.com/package/moleculer-ra-data-provider - Repository: https://github.com/alpesdigital/moleculer-ra-data-provider - Homepage: https://github.com/alpesdigital/moleculer-ra-data-provider#readme - Issues: https://github.com/alpesdigital/moleculer-ra-data-provider/issues - npm.io page: https://npm.io/package/moleculer-ra-data-provider ## Dependencies (1) - [query-string](https://npm.io/package/query-string.md) ^6.13.7 ## Alternatives - [launchdarkly-js-client-sdk](https://npm.io/package/launchdarkly-js-client-sdk.md) — 2.5M weekly downloads - [@elastic/elasticsearch](https://npm.io/package/@elastic/elasticsearch.md) — 2.1M weekly downloads - [@c8y/client](https://npm.io/package/@c8y/client.md) — 15.3K weekly downloads - [@signaldb/maverickjs](https://npm.io/package/@signaldb/maverickjs.md) — 1.7K weekly downloads - [@bbc/http-transport-cache](https://npm.io/package/@bbc/http-transport-cache.md) — 1.2K weekly downloads ## Recent versions - 1.6.1 (latest) — 2022-04-28 - 1.6.0 — 2022-04-28 - 1.5.2 — 2020-12-18 - 1.5.1 — 2020-12-07 - 1.5.0 — 2020-12-07 - 1.4.0 — 2020-12-04 - 1.3.1 — 2020-11-22 - 1.3.0 — 2020-11-20 - 1.2.1 — 2020-11-18 - 1.2.0 — 2020-11-18 - 1.1.1 — 2020-11-17 - 1.1.0 — 2020-11-17 - 1.0.1 — 2020-11-17 - 1.0.0 — 2020-11-17 ## README # moleculer-ra-data-provider [![Build Status](https://travis-ci.org/alpesdigital/moleculer-ra-data-provider.svg?branch=main)](https://travis-ci.org/alpesdigital/moleculer-ra-data-provider) [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Falpesdigital%2Fmoleculer-ra-data-provider.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Falpesdigital%2Fmoleculer-ra-data-provider?ref=badge_shield) [![NPM](https://img.shields.io/npm/v/moleculer-ra-data-provider.svg?maxAge=3600)](https://www.npmjs.com/package/moleculer-ra-data-provider) [![NPM Downloads](https://img.shields.io/npm/dw/moleculer-ra-data-provider)](https://www.npmjs.com/package/moleculer-ra-data-provider) A [Moleculer](https://moleculer.services) compatible data provider for [React Admin](https://marmelab.com/react-admin/). Convert on-the-fly data exchanged with Moleculer micro-services in order to use them directly in your React-Admin components like List, Edit, Create .... ## Features Supported actions: * `CREATE` * `GET_ONE` * `GET_LIST` * `GET_MANY` * `GET_MANY_REFERENCE` * `UPDATE` * `UPDATE_MANY` * `DELETE` * `DELETE_MANY` ## Installation ```sh # via npm npm install moleculer-ra-data-provider # OR via yarn yarn add moleculer-ra-data-provider ``` ## Usage Import this package, set the base url and pass it as the dataProvider to react-admin. ```javascript //in app.js import React from "react"; import { Admin, Resource } from "react-admin"; import { ListGuesser } from 'react-admin'; // example import moleculerDataProvider from 'moleculer-ra-data-provider'; const dataProvider = moleculerDataProvider('http://localhost:13000/api'); const App = () => ( // example displaying a list received from http://localhost:3000/api/myusers ); export default App; ``` ## Option renameFields You can rename a field name in a resources. This is usefull when a moleculer service return both an **`_id`** and an **`id`**. Example 1: the field **`id`** moleculer service 'trades' is renamed into **`uuid`** (leaving the place for a copy of **`_id`**) ```javascript //in app.js const dataProvider = moleculerDataProvider('http://localhost:13000/api', {renameFields: {"trades": {"id":"uuid"} }}); ``` In this case, data provided (by moleculer) *{_id:1, id:"A"}* becomes (in react-admin) *{id:1, uuid:"A"}* In case of create/update, the reverse operation is done: react-admin *{id:1, uuid:"B"}* becomes *{_id:1, id:"B"}* ## Option idFields You can specify the **`_id`** field name (duplicated as **`id`** for react-admin) for some/all resources Example 1: the moleculer service 'orders' is using **`uuid`** instead of **`_id`** ```javascript //in app.js const dataProvider = moleculerDataProvider('http://localhost:13000/api', {idFields: {"orders": "uuid" }}); ``` Example 2: the moleculer service 'orders' is using **`uuid`** instead of **`_id`**, others are using **`myId`** ```javascript //in app.js const dataProvider = moleculerDataProvider('http://localhost:13000/api', {idFields: {"orders": "uuid", "DEFAULT": "myId" }}); ``` Example 3: Combined renameFields and idFields: **`trades.id2`** becomes **`trades.uuid`**, **`trades._id`** becomes **`trades.id2`**, in all other resources, use **`id2`** as db key (moleculer default is **`_id`**) ```javascript //in app.js const dataProvider = moleculerDataProvider('http://localhost:13000/api', {renameFields: {"trades": {"id2":"uuid"} }, idFields: {"trades": "id2", "DEFAULT": "id1" }}); ``` ## Licence MIT [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Falpesdigital%2Fmoleculer-ra-data-provider.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Falpesdigital%2Fmoleculer-ra-data-provider?ref=badge_large) --- _Source: https://npm.io/package/moleculer-ra-data-provider · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._