dss-dropboxes.md

```py
def process(transaction):
    # use the etl server session token
    session_token = transaction.getOpenBisServiceSessionToken()

    # To find out do SQL on the openBIS DB: select code from data_stores;
    dss = "STANDARD"

    # folder name under the reporting_plugins
    service_key = "reporting_experimental"   

    # some parameters which are handed over
    d = {"param1": "hello", "param2": "from a drop box"}

    # connection to the openbis server returns IQueryApiServer
    s = createQueryApiServer("http://127.0.0.1:8888/openbis/openbis/", "600")

    # Actual call
    # Parameters: String sessionToken, String dataStoreCode,String serviceKey, Map<String, Object> parameters)
    s.createReportFromAggregationService(session_token, dss, service_key, d)
```


Known limitations
-----------------

#### Blocking

Registering/updating a large number of entities can cause other
concurrent operations that try to modify the same or related entities to
be blocked. This limitation applies to both dropboxes and batch
operations triggered from the web UI. Lists of operations that are
blocked are presented below. Each list contains operations that cannot
be performed when a specific kind of entity is being registered/updated.

Experiment:

-   creating/updating an experiment in the same project
-   updating the same space
-   updating the same project
-   updating the same experiment

Sample:

-   creating/updating an experiment in the same project
-   creating/updating a sample in the same experiment
-   updating the same space
-   updating the same project
-   updating the same experiment
-   updating the same sample

Data set:

-   creating/updating an experiment in the same project
-   creating/updating a sample in the same experiment
-   creating a dataset in the same experiment
-   updating the same space
-   updating the same project
-   updating the same experiment
-   updating the same sample

Material:

-   updating the same material