.. Netfiles API Documentation

Initial Dataroom Loading
========================

After authenticating at the Netfiles server using the :doc:`Check Identity </calls/checkidentity>` call
you will receive a list of datarooms to which this user has access.

This list is composed of all datarooms he/she has access to **regardless of whether the user has access
on tablet or not**.

In order to see whether he/she has access on the tablet, you will need to check the ``AccessAllowed`` attribute for
each dataroom.

If this is set to ``true``, successive :doc:`Get Children </calls/getchildren>` calls will succeed. Otherwise
they will fail and you will have wasted a call.

Identifying Dataroom Type
-------------------------

You can identify a dataroom's type by analyzing the ``AccountType`` attribute. There are (for my knowledge) following
types:

+---------------+-----------------------------------------------------------------------------------------------+
| Type          | Description                                                                                   |
+===============+===============================================================================================+
| standard      | A standard dataroom containing document and folders.                                          |
+---------------+-----------------------------------------------------------------------------------------------+
| business      | Dataroom of type "Business Plus"                                                              |
+---------------+-----------------------------------------------------------------------------------------------+
| dealroom      | Dataroom of type "Dealroom" - meant to be used for M&A-Projects                               |
+---------------+-----------------------------------------------------------------------------------------------+
| dataroom      | Standard dataroom                                                                             |
+---------------+-----------------------------------------------------------------------------------------------+
| boardroom     | Dataroom of type "boardroom"                                                                  |
+---------------+-----------------------------------------------------------------------------------------------+

Accessing Standard Objects
--------------------------

You can access the standard objects such as files & folders in a dataroom using the path ``<dataroompath>/projectfiles``.
This is the same as clicking on *Documents* (*Dokumente*) in the Web-UI.

After that you just have to follow the hierarchy to find you items. Please check out the documentation for futher
information.

Accessing Board Room
--------------------

In order to access the Boardroom-specific objects such as :doc:`Meeting Collections </meetings/meetingcollection>`,
:doc:`Meeting </meetings/meeting>` or :doc:`Meeting Topic </meetings/meetingtopic>` you have to use a different path
syntax:

    <dataroom>/meetings

If, e.g., you want to access the *Q1/2021* meeting (="q1_2021") of the *Executive Board* (="executive_board") in
*Overall Board Meetings* (="overall_board_meetings") in dataroom *Imdat AG* (="imdatag") you would make the
following call (s. :doc:`Prerequisites </pre_req>` ) :

::

    GET https://app.netfiles.de/imdatag/meetings/overall_board_meetings/executive_board/q1_2021;internal&action=json...


Accessing Meeting Minutes
-------------------------

The **meeting minutes** are stored under each meeting topic and can be reached using following call:

::

    GET https://app.netfiles.de/imdatag/meetings/<meeting>/<meetingtopic>/minutes;internal&action=json&method=getObject...

The meeting minutes belong to each meeting topic and are HTML-formatted with limited HTML tags support.