mirror of https://github.com/snachodog/mybuddy.git
Add basic import/export documentation to README
This commit is contained in:
parent
d0b33c2b1b
commit
773491205e
47
README.md
47
README.md
|
@ -23,6 +23,9 @@ guess work.
|
||||||
- [Manual](#manual)
|
- [Manual](#manual)
|
||||||
- [Configuration](#configuration)
|
- [Configuration](#configuration)
|
||||||
- [Languages](#languages)
|
- [Languages](#languages)
|
||||||
|
- [Import/Export](#import-export)
|
||||||
|
- [Export](#export)
|
||||||
|
- [Import](#import)
|
||||||
- [API](#api)
|
- [API](#api)
|
||||||
- [Authentication](#authentication)
|
- [Authentication](#authentication)
|
||||||
- [`GET` Method](#get-method)
|
- [`GET` Method](#get-method)
|
||||||
|
@ -390,6 +393,50 @@ create/update translations.
|
||||||
|
|
||||||
:tr: Turkish
|
:tr: Turkish
|
||||||
|
|
||||||
|
## Import/Export
|
||||||
|
|
||||||
|
Baby Buddy uses the [django-import-export application](https://django-import-export.readthedocs.io/)
|
||||||
|
to provide import and export functionality.
|
||||||
|
|
||||||
|
### Export
|
||||||
|
|
||||||
|
Export actions are accessible from Baby Buddy's "Database Admin" area (the
|
||||||
|
Django admin interface). For example, to export all diaper change entries from
|
||||||
|
Baby Buddy as an Excel file:
|
||||||
|
|
||||||
|
1. Log in as a user with "staff" access.
|
||||||
|
|
||||||
|
1. From the user menu, click "Database Admin" under the "Site" heading.
|
||||||
|
|
||||||
|
1. Click "Diaper Changes" in the list of data types.
|
||||||
|
|
||||||
|
1. Click the "Export" button above the filters list on the right side of the
|
||||||
|
screen.
|
||||||
|
|
||||||
|
1. Select the "xlxs" format and click "Submit"
|
||||||
|
|
||||||
|
Note: any applied filters will also filter the exported entries. Alternatively,
|
||||||
|
on the Diaper Change list screen (step 3 above), it is possible to select one
|
||||||
|
or many individual records and select "Export selected Diaper Changes" from the
|
||||||
|
"Actions" list.
|
||||||
|
|
||||||
|
### Import
|
||||||
|
|
||||||
|
Import actions are accessible from Baby Buddy's "Database Admin" area (the
|
||||||
|
Django admin interface). From the list of entry types in the Database Admin,
|
||||||
|
select the type to import and click the "Import" button on the list page. The
|
||||||
|
import screen for a particular type will list the fields generally expected to
|
||||||
|
be present for an import. Multiple file types -- including csv, xlsx, etc. --
|
||||||
|
are supported for the import.
|
||||||
|
|
||||||
|
The import pages do not provide *detailed* information about the required data
|
||||||
|
and formats. When an import is attempted, all rows will be checked for errors
|
||||||
|
and any issues will be reported on screen and will need to be resolved before
|
||||||
|
the import can be performed.
|
||||||
|
|
||||||
|
See the [example import files](core/tests/import) used for tests to get an idea
|
||||||
|
of the expected data format.
|
||||||
|
|
||||||
## API
|
## API
|
||||||
|
|
||||||
Baby Buddy uses the [Django REST Framework](https://www.django-rest-framework.org/)
|
Baby Buddy uses the [Django REST Framework](https://www.django-rest-framework.org/)
|
||||||
|
|
Loading…
Reference in New Issue