CLI Import

MrDoc provides several command-line import tools for performing import operations directly on the device where MrDoc is running.

For MrDoc instances deployed via Docker or Docker-Compose, you need to prefix the Python command with `docker exec -it <Container ID or Name>`. For example:  
`docker exec -it mrdoc python manage.py ……`

## Import OnlyOffice Documents

This tool is used to batch import Office files from a specified directory as OnlyOffice documents in MrDoc, associating them with a specified collection and parent document.

### Syntax

```shell
python manage.py import_oo_docs --path <directory_path> --user <username> --project <project_id> [--parent_doc <parent_doc_id>]
```

### Parameter Description

| Parameter       | Required | Description                                                                 |
| --------------- | -------- | --------------------------------------------------------------------------- |
| `--path`        | ✅ Yes    | Local directory path where the files are located. E.g., `D:/office-files/` or `/home/user/docs/` |
| `--user`        | ✅ Yes    | Username of the user creating the documents (must be an existing user in the system) |
| `--project`     | ✅ Yes    | ID of the target project (collection), must be a valid `Project.id`         |
| `--parent_doc`  | ⛔ Optional | Parent document ID for the imported documents. Default is `0` (i.e., directly under the project root) |

### Usage Example

```shell
python manage.py import_oo_docs --path /www/wwwroot/office --user mrdoc --project 3
```

The above command imports Office files from the `/www/wwwroot/office` directory into the collection with ID `3`, using the username `mrdoc`.