Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

BCF Service

...

...

This service is used for importing a BCF file into Bimplus topics. The necessary attributes & assets such as author, responsible, attachments, comments, view etc are handled and matched according to the Bimplus Topic. The user can also export a single, list of topics or all the topics inside a project into a BCF file. While exporting, the user can decide if he would like to avoid exporting attachments, comments etc via appropriate filters.

Anchor
importBCF_POST
importBCF_POST

 

 

Anchor
importBCF_PUT
importBCF_PUT

Import a BCF file into Bimplus topics
Deck of Cards
idbimImportBCF_PUT
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: issues/bcf

URLhttps://api-dev.bimplus.net/v2/<team_slug>/projects/<project_id>/issues/bcf

Examplehttps://api-dev.bimplus.net/v2/jay-company/projects/c6b53b29-8efd-4069-a033-4b1b18604de8/issues/bcf

Card
labelHTTP Method
 PUT
Card
labelDescription
Import all the topics from a BCF file into Bimplus Topics. The necessary attributes & assets such as author, responsible, attachments, comments, view etc are handled and matched according to the Bimplus Topic. Please note that currently only a PUT function exists which means the API/server takes care of the logic of either creating or updating the related topics.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: multipart/form-data
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK
Code Block
borderColorGreen
langxml
titleResponselangxml
{
    "createdIssues": [
        {
            "id": "1a7e7f92-8af9-4f06-8c96-6f048e925843"
        },
        {
            "id": "f4e42068-333f-4528-baf8-634c463cbff4"
        },
        {
            "id": "38adacfc-19b2-4660-a671-9f4cc413582a"
        },
        {
            "id": "61711135-558e-4c24-bed1-5476d5b74f2d"
        }
    ],
    "bcfAttachment": {
        "objectIds": [
            "c6b53b29-8efd-4069-a033-4b1b18604de8"
        ],
        "fileName": "BIM Validation - Architectural bcf_v1.bcfzip",
        "type": "application/octet-stream",
        "size": 305784,
        "createdAt": "2015-11-03T09:11:56",
        "creator": {
            "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
            "email": null,
            "firstname": null,
            "lastname": null,
            "company": null,
            "fullname": "",
            "displayname": null,
            "info": null,
            "gender": null,
            "phoneWork": null,
            "phoneHome": null,
            "fax": null,
            "mobile": null,
            "birthDate": null,
            "address": {
                "street": "",
                "streetNr": "",
                "zip": "",
                "city": "",
                "country": ""
            },
            "preferedLanguage": null
        },
        "changed": "2015-11-03T09:11:56",
        "changedBy": {
            "id": "71e0ac3b-fa49-e540-ac2f-8caff3dd72ed",
            "email": null
        },
        "hash": "00000000-0000-0000-0000-000000000000",
        "sizeMB": "0,29",
        "id": "00000000-0000-0000-0000-000000000000"
    },
    "createdIssueId": [
        "bf609dae-06b2-42fa-a70b-d2b7ee446e8e",
        "e64160a9-a2f7-46e1-aa81-490b722c47b1",
        "c0977ff7-b336-4a4f-b8e9-fbf406759a0c",
        "19cb3e5a-79c0-4c32-a1fd-f8a0441a9dca"
    ]
}

...

Deck of Cards
idbimExportAllToBCF
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: export/bcf

URLhttps://api-dev.bimplus.net/v2/jay-company/projects/<project_id>/issues/export/bcf

Examplehttps://api-dev.bimplus.net/v2/jay-company/projects/a23123b0-1973-4f5d-92a3-f786b3183901/issues/export/bcf

Card
labelHTTP Method
 GET
Card
labelDescription
 Export all the topics inside a project into a BCF file. The response contains an attachment_id using which the related BCF file can be downloaded.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaders
langxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Card
labelResponse
Code Block
borderColorGreen
langxml
titleStatuslangxml
Status: 200 OK
Code Block
borderColorRed
langxml
titleJSON
langxml
{
    "attachment_id": "34462f62-7c86-46cd-87fd-f33cc1b1dfd4"
}

...

Deck of Cards
idbimExportListToBCF
Card
defaulttrue
labelURL / Resource / JSON Structure
Resource: export/bcf

URLhttps://api-stage.bimplus.net/v2/<team_slug>/issues/export/bcf

Examplehttps://api-stage.bimplus.net/v2/bimplus/issues/export/bcf

Card
labelHTTP Method
 POST
Card
labelDescription
Export a single or a list of Topics inside a project into a BCF file. The issues to be exported are provided in the request. The response contains an attachment_id using which the related BCF file can be downloaded.
Card
labelRequest
Code Block
borderColorGreen
langxml
titleHeaderslangxml
Authorization: BimPlus 9c1874a62c974dcfa75e0132c423a088
Content-Type: application/json
Code Block
lang
borderColorGreen
langxml
titleRequestxml
{
    "issuesId": [
        "5eae7fe7-1cad-4039-8b64-551caea8107a"
    ],
    "bcfFileName": "BCF Export Test-Wall info wrong.bcfzip"
}
Card
labelResponse
Code Block
lang
borderColorGreen
langxml
titleStatusxml
Status: 201 CREATED
Code Block
borderColorGreen
langxml
titleResponselangxml
{
    "attachment_id": "1892ad0c-5301-4b82-928d-8265c214b1cd"
}

...