Как извлечь связанный документ из полезной нагрузки проблемы BIM360?

#autodesk-forge #autodesk #autodesk-bim360

#autodesk-forge #autodesk #autodesk-bim360

Вопрос:

Все это сказано в названии, но позвольте мне подробно описать мою проблему:

Я хочу получить документ, связанный с данной проблемой BIM360. Итак, в этом конкретном случае я хочу найти «georef.dwg» (по крайней мере, это хранилище URN версии на BIM360), зная проблему # 31 или # 32.

введите описание изображения здесь

Когда я смотрю на полезную нагрузку из GET issues/:id, вот что я вижу:

 {
   "data":{
      "id":"0f84bfa2-43be-4761-8c84-ff5314fca382",
      "type":"quality_issues",
      "links":{
         "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382"
      },
      "attributes":{
         "created_at":"2020-09-24T13:45:02.754Z",
         "synced_at":"2020-09-24T13:45:02.759Z",
         "updated_at":"2020-09-24T13:45:02.756Z",
         "close_version":null,
         "closed_at":null,
         "closed_by":null,
         "created_by":"TT4KN3D3PWME",
         "opened_at":"2020-09-24T13:45:02.740Z",
         "opened_by":"TT4KN3D3PWME",
         "updated_by":"TT4KN3D3PWME",
         "starting_version":1,
         "title":"Issue for testing georeferencing",
         "description":"",
         "location_description":null,
         "markup_metadata":null,
         "tags":null,
         "target_urn":"urn:adsk.wipprod:dm.lineage:BAu6NmpZRyW913SLf6J6IA",
         "target_urn_page":null,
         "collection_urn":null,
         "due_date":"2020-09-30T00:00:00.000Z",
         "identifier":30,
         "status":"open",
         "assigned_to":"201007062239661",
         "assigned_to_type":"user",
         "answer":null,
         "answered_at":null,
         "answered_by":null,
         "pushpin_attributes":{
            "type":"TwoDRasterPushpin",
            "location":{
               "x":5.710041960416264,
               "y":4.169567131777653,
               "z":0
            },
            "object_id":null,
            "viewer_state":null,
            "created_at":"2020-09-24T13:45:02.766Z",
            "created_by":"TT4KN3D3PWME",
            "created_doc_version":1,
            "external_id":null,
            "attributes_version":2
         },
         "snapshot_urn":"urn:adsk.objects:os.object:ng-issues-prod-86fe431f-012b-4349-939e-cbb0788cfbba/25881168-6246-4c32-9cc2-f31409ce519a",
         "owner":"TT4KN3D3PWME",
         "issue_type_id":null,
         "issue_type":null,
         "issue_sub_type":null,
         "root_cause_id":null,
         "root_cause":null,
         "quality_urns":null,
         "permitted_statuses":[
            "answered",
            "closed",
            "void"
         ],
         "permitted_attributes":[
            "answer",
            "assigned_to",
            "assigned_to_type",
            "description",
            "due_date",
            "location_description",
            "trades",
            "owner",
            "issue_type",
            "issue_type_id",
            "root_cause",
            "root_cause_id",
            "title",
            "status",
            "sheet_metadata",
            "lbs_location",
            "pushpin_attributes",
            "snapshot_urn",
            "close_version",
            "comments_attributes",
            "attachments_attributes",
            "markup_metadata",
            "updated_at",
            "tags",
            "collection_urn",
            "custom_attributes",
            "ng_issue_subtype_id"
         ],
         "comment_count":0,
         "attachment_count":0,
         "permitted_actions":[
            "add_comment",
            "add_attachment"
         ],
         "sheet_metadata":{
            "is3D":false,
            "sheetGuid":"6882be48-6626-5238-d3df-94e9f0a0019d",
            "sheetName":"2D View"
         },
         "lbs_location":null,
         "ng_issue_subtype_id":"1611f9cf-4ba0-43d0-af0b-0047499beb81",
         "ng_issue_type_id":"5830d615-c7fa-4aa3-8f9e-aa520176fa4d",
         "issue_template_id":null,
         "custom_attributes":[
            
         ],
         "trades":null,
         "comments_attributes":null,
         "attachments_attributes":null
      },
      "relationships":{
         "container":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/container",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/container"
            }
         },
         "attachments":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/attachments",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/attachments"
            }
         },
         "changesets":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/changesets",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/changesets"
            }
         },
         "comments":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/comments",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/comments"
            }
         },
         "activity_batches":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/activity-batches",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/activity-batches"
            }
         },
         "root_cause_obj":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/root-cause-obj",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/root-cause-obj"
            }
         },
         "issue_type_obj":{
            "links":{
               "self":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/relationships/issue-type-obj",
               "related":"https://developer.api.autodesk.com/issues/v1/containers/86fe431f-012b-4349-939e-cbb0788cfbba/quality-issues/0f84bfa2-43be-4761-8c84-ff5314fca382/issue-type-obj"
            }
         }
      }
   }
}
  

Я не вижу там никакой информации, которая позволила бы мне получить «georef.dwg», но BIM360, очевидно, это делает… Я вижу targetUrn , но это не URN версии элемента BIM360.

Когда я создаю проблему в файле Revit, я получаю что-то, issue.attributes.pushpin_attributes.viewer_state.seedURN что, похоже, указывает на правильную версию URN, но не при создании проблем в dwg.

Ответ №1:

target_urn — это правильный путь. В этом примере я создаю проблему с Drawing1.dwg в своей учетной записи.

Из содержимого папки BIM360docs я получил это

 {
    "id": "urn:adsk.wipprod:dm.lineage:_3AoTpMBQDm060PABvgQKg",
    "name": "Drawing1.dwg",
    "type": "items",
    "state": true,
    …
}
  

Из API проблем я получил следующее: (Я удалил все нерелевантные свойства)

 [
    {
        "created_at": "2020-10-01T14:05:06.524Z",
        "synced_at": "2020-10-01T14:05:06.528Z",
        …
        "starting_version": 6,
        "title": "cyrille",
        "target_urn": "urn:adsk.wipprod:dm.lineage:_3AoTpMBQDm060PABvgQKg",
        "target_urn_page": null,
        …
        "pushpin_attributes": {
            "type": "TwoDRasterPushpin",
            "location": {
                "x": 2.8286987422505243,
                "y": 5.8554650473401395,
                "z": 0
            },
            ….
        },
        …
        "sheet_metadata": {
            "is3D": false,
            "sheetGuid": "6882be48-1234-5238-d3df-94e9f000019d",
            "sheetName": "2D View"
        },
        ….
        "id": "ae09c72c-8236-6895-ba27-0141bf6aae97"
    }
]
  

Смотрите target_urn = urn:adsk.wipprod:dm.lineage:_3AoTpMBQDm060PABvgQKg, который соответствует моему идентификатору элемента = urn:adsk.wipprod:dm.lineage:_3AoTpMBQDm060PABvgQKg

starting_version предоставит вам нужную версию элемента BIM360docs.

Комментарии:

1. Действительно, спасибо. Сбивает с толку то, что целевой «URN» на самом деле является элементом «Id». Мне также интересно, почему «pushpin_attributes.viewer_state» пуст для .dwg, а не для .rvt. Когда я нажимаю на проблему в BIM360, кажется, что средство просмотра восстанавливает состояние, отображающее конкретную проблему…

2. @Philippe — Чтобы ответить на первую часть вашего вопроса, в нем содержится ссылка на элемент, потому что проблема начинается с версии, но может завершиться на другой (жизненный цикл проблемы), поэтому к элементу проще, чем к версии. Что касается вашего 2-го вопроса, он относится к snapshot_urn, если вам нужно, я могу узнать, как запросить его, дайте мне знать.