Please note that this repo is no longer supported — consider using medic-conf instead.

Overview

Medic Bulk Utils is a set of command line tools and documentation to help manage large amounts of Medic Mobile data.

The following command line tools are installed with this package:

• medic-stats
• medic-import
• medic-format-csv
• medic-csv-to-json
• medic-update-embedded
• medic-extend-properties
• medic-export-mysql-query

Requirements

The minimal requirements to run these tools and example projects are NodeJS and GNU Make. Almost every Unix based system on the planet has a make binary preinstalled, typing make -v in your terminal should provide version information and confirms it's installed.

On OSX, GNU Make is bundled with the Xcode Command Line Tools, run xcode-select --install from the terminal and choose Install if you only want the command line tools installed and not the full Xcode package.

Getting Started

A new project typically begins with a spreadsheet of raw data that you want to update or add (import). This might be an export from a database or maintained some other way.

Create a directory for your project, name it whatever you want:

mkdir medic-projects-493 && \
cd medic-projects-493

Create your package.json (using -y to accept defaults):

npm init -y

Install this dependency:

npm install --save medic-bulk-utils

Project Templates

This repo is bundled with a set of project templates for common tasks. This is a good starting point for your projects. You can just copy and modify these files in your working directory to get started. Each project template also includes a Makefile so after installing you can execute make to run the example.

• Import users
• Import users with related data
• Import contacts (places and people)
• Import records
• Migrations

Example:

cp -i node_modules/medic-bulk-utils/project-templates/import-users/* .
make

Then read the instructions:

cat Readme