Bij1 CiviCRM migratie extensie (van: https://lab.civicrm.org/partners/civicoop/bij1/bij1migratie)

Go to file

Kiara Grouwstra 065ba3e498 update leden.csv as per view civicrm-export		2023-09-13 16:03:01 +02:00
CRM/Bij1migratie	ignore sociaal tarief	2022-12-06 12:58:45 +01:00
Civi	inclusief mislukt en chargeback	2022-02-07 11:07:30 +01:00
api/v3	comment unused methods	2022-10-15 18:58:26 +02:00
data	update leden.csv as per view civicrm-export	2023-09-13 16:03:01 +02:00
docs	+ mkdocs	2022-11-16 15:58:44 +01:00
form-processors	airtable lid nummer meenemen in migratie	2022-12-06 12:57:57 +01:00
images	add screenshot	2022-10-13 22:23:12 +02:00
mixin	civix upgrade: 22.10.0	2022-11-14 22:09:17 +01:00
sql	initial load	2021-12-02 15:38:17 +01:00
templates/CRM/Bij1migratie/Form	eerste migratie mollie customers	2021-12-09 17:41:13 +01:00
tests/phpunit	update phpunit bits	2022-10-13 20:06:56 +02:00
xml	eerste migratie mollie customers	2021-12-09 17:41:13 +01:00
.woodpecker.yml	ci: steps	2023-08-13 10:17:25 +00:00
LICENSE.txt	initial load	2021-12-02 15:38:17 +01:00
README.md	readme: sample data	2023-07-26 10:48:05 +00:00
bij1migratie.civix.php	civix upgrade: 22.10.0	2022-11-14 22:09:17 +01:00
bij1migratie.php	civix upgrade: 22.10.0	2022-11-14 22:09:17 +01:00
info.xml	civix upgrade: 22.10.0	2022-11-14 22:09:17 +01:00
mkdocs.yml	+ mkdocs	2022-11-16 15:58:44 +01:00
phpunit.xml.dist	update phpunit bits	2022-10-13 20:06:56 +02:00

README.md

bij1migratie

Helps migrate BIJ1's data sources (as CSV) to CiviCRM, including:

Airtable
Mollie
- Customers
- Payments
- Chargebacks

The extension is licensed under AGPL-3.0.

Requirements

Testing

Development

CiviCRM Extension CLI

Documentation

Python

Installation (Web UI)

Learn more about installing CiviCRM extensions in the CiviCRM Sysadmin Guide.

Installation (CLI, Zip)

Sysadmins and developers may download the .zip file for this extension and install it with the command-line tool cv.

cd <extension-dir>
cv dl bij1migratie@https://github.com/FIXME/bij1migratie/archive/master.zip

Installation (CLI, Git)

Sysadmins and developers may clone the Git repo for this extension and install it with the command-line tool cv.

git clone https://github.com/FIXME/bij1migratie.git
cv en bij1migratie

Getting Started

Zorg dat de volgende Civi instellingen ingesteld zijn:
- bij1_basisbedrag
In CiviCRM, onder tab Beheer, ga naar Automation en dan Form processors. Gebruik daar de import knop om de .json files uit map form-processors te importeren.
Onder tab Beheer, ga naar Migratie Bij1 -> CiviCRM, e.g. http://localhost/wp-admin/admin.php?page=CiviCRM&q=civicrm%2Fbij1migratie%2Fform%2Fcsvselect.
Vul het formulier in en start de import (sample data), in volgorde:
- Mollie klanten
- Airtable
- Betalingen
- ChargeBacks

Overview

data/**/*.csv: anonymized source data samples
Mapping/*Mapping.php: match names used in form processors to column positions in source CSVs.
CRM/Bij1migratie/CsvFile.php#sanitize*(): column selection, transformations
CRM/Bij1migratie/Migratie.php#migreer*(): checks, import by API, row-level error logging
form-processors/bij1_*_migratie.json: how to process imported fields

Testing

Static analysis

phpstan analyse .

Unit tests

place this repository in a CiviCRM installation
run:

phpunit tests

Reloading extension code to container

Given an environment variable $CIVICRM_BIJ1_PATH pointing to your local checkout of civicrm-bij1:

export FLDR=/var/lib/docker/volumes/civicrm-bij1_civi-data/_data/wp-content/uploads/civicrm/ext/crm-bij1migratie/
mkdir -p $FLDR
sudo cp -r ./* $FLDR
docker compose -f $CIVICRM_BIJ1_PATH/docker-compose.yml exec civi bash -c "cv ext:enable bij1migratie"

Build (this) documentation

Run:

pip install mkdocs
mkdocs serve

Known Issues

(* FIXME *)