(Update: There may or may not be any such thing as a "unified project". But there is definitely a button on my Account Admin->Projects screen that says "Go to unified projects", hence my confusion. It just takes me to a list of all projects.)
Since some API endpoints are not compatible between the two types of projects, (see https://forge.autodesk.com/en/docs/acc/v1/overview/bim-360-compatibility/compatibility-table/), it would be nice to know, programmatically, which type of project you are dealing with.
The response from https://developer.api.autodesk.com/hq/v1/accounts/:hub_id/projects lists, for example, the exact same details regardless. Is there another call that would give more info?
I know that the BIM 360 projects start with "b.", but not in the above list.
Just poking around, the BIM 360 API endpoint https://developer.api.autodesk.com/hq/v1/accounts/:account_id/projects apparently returns only(?) BIM 360 projects, complete with "b.". But if I want ALL projects, and simply need to know the difference? I could make both calls and parse the differences; but one call with the correct info would be great, if it exists.
The endpoint I meant is: https://forge.autodesk.com/en/docs/data/v2/reference/http/hubs-hub_id-projects-GET/. It is for project information in the general context. The one you pointed out is for getting project information in the context of BIM360.
Data Management is a general API. e.g. you manage your (as a web application) manage models and data in your own buckets (on Forge), this goes with Data Management. BIM360 or ACC or Fusion360 etc is the platform that manages model or data for end users, in a format of more user-orientated structure like hub>>project>>folder>>item>>version etc. These fall into Data Management. BIM 360 API will be more specific in the context of BIM360. e.g. Admin API (like what you are using), Issue API, RFI API, Cost API , Model Coordination API etc.
As to united project, it means the project list managed within Autodesk Construction Cloud (ACC), which includes BIM360 projects and ACC projects. In another word, a united portal to access the two types of projects. To distinguish the two types, the attribute I mentioned in the last email is the indicator. Hope it explains.
Related
I'm trying to get the Discipline Property of a Revit Model uploaded to BIM 360. I was able to get the list of views by GET
https://developer.api.autodesk.com/modelderivative/v2/designdata/URL_SAFE_URN_OF_SOURCE_FILE/metadata
However there is no data on Discipline. Where and how can I get it?
I'm not familiar with "Discipline Properties" in Revit but I can comment on the Forge side of things:
The GET :urn/metadata endpoint simply returns a list of "viewables" that were extracted from the source design file. In case of Revit, these are typically 3D views or 2D sheets. I'm not aware of any other types of viewables that could be extracted by the Model Derivative service.
If the "discipline property" is a property available on some of the Revit elements, you might want to take a look at the GET :urn/metadata/:guid/properties endpoint. This one returns a JSON with properties of objects in one of the extracted viewables. Note that those properties are also accessible from Forge Viewer using its APIs.
In general, the Model Derivative service is trying to extract the "right" amount of information, making sure that the viewer gets all the important data for visualization and analysis, but also making sure that the size of the converted output stays in bounds. If there is some specific information in Revit designs that you need that is not extracted automatically, you can consider using the Design Automation service to process your Revit models in the cloud and extract all the information with your custom Revit plugin.
For a school project I need to display a BIM360 model in the forge viewer. I can't find clear information on whether or not I need to have a BIM360 license to do that. Can I use the API to get the model without my own BIM360 account? (My mentor has the BIM-model in his account)
Also I read that the forge viewer uses the data-derivative API to convert to a it's own format, this uses 0.2 credits every time. Can's I just convert the model once and then store it somewhere?
Thanks,
DrawMen
For you to be able to see and access the model in BIM 360, the owner will have to share it with you.
This forum post seems to indicate that you would indeed need a BIM360 license.
https://forums.autodesk.com/t5/bim-360-support/do-people-need-a-bim-360-design-license-to-use-docs-online/td-p/9573036#:~:text=Anyone%20who%20needs%20to%20review,license%20is%20not%20a%20BYOS
There is a way to share files with publc links, but I don't think this will give you access to a forge viewer. (only the file)
https://bim360basics.com/2020/04/22/public-links-share-bim-360-files-with-anyone/
That being said, depending on the type of file you are trying to view. A lot of Autodesk product now have a feature called "shared view" which let you create a 3ds view for the forge viewer that can be shared with anyone with a URL. It might be worth asking your mentor if he would be willing to create a shared view for you to use.
We have over 3000 projects in our BIM 360 account and need to be able to search for a specific project by name. Currently we are using the GET projects endpoint in the Forge BIM 360 API to create a list of projects and querying the list to find the project. This was working well for a while, but due to a limit of 100 projects returned by the endpoint we have to make multiple calls using the offset parameter. With 3000 projects this requires 30 requests, and we are starting to see a performance hit in some of our applications, which will only get worse over time as we add more projects. Is there a way to call the GET projects endpoint with a filter on project name?
I believe you can call /project/v1/hubs/:hub_id/projects with page[limit]=200, but unfortunate we don't have a filter by name.
I used the TimeLiner plugin for Navisworks to create a 4D timeline. I'm now trying to grab this TimeLiner data from the Forge API. When I log into BIM360, I'm able to load a model into the viewer and see all TimeLiner information within a browser. However, I don't see how I can accomplish this with the Forge API. Is there an available API for this? Or is there another way to grab this info?
Unfortunately, the Timeliner properties are not extracted by Forge service (which BIM 360 is running on), and also some other properties. This blog tells in detail:
https://forge.autodesk.com/blog/updates-navisworks-nwd-translation-engine-coming
Currently, we do have an advanced option to override default configurations to tell NWD/NWC translator if it needs to translate Timeliner properties. BUT, this option is about Forge Model Derivative API ONLY.
While in BIM360 Docs UI, there is no any plan to expose options to let users override default configurations when they upload files. So for now, users uploading NWD/NWC files to BIM 360 Docs will lose Timeliner properties. Consequently, you will have to open those files inside Navisworks to view Timeliner data or take advantage of the Navisworks API to extract the data inside Navisworks. We apologize for the inconvenience.
However, we have legged a wish BIMPLT-698 with BIM360 engineering team to evaluate the possibility of adding options for end-user when they upload the model files. You're welcome to track the updates in the future via sending an email quoting this wish id to the Forge support channel.
Note. Triggering your own translation job to override your desired translation configurations via Forge Model Derivative API on files uploaded to BIM360 will charge you for cloud credits. You will have to consider the extra costs if you want to do so, and see here for the pricing: https://forge.autodesk.com/pricing
I'm trying to read the custom attributes, which are defined at the folder level in BIM360 and then applied to individual file versions.
But I can't find any endpoint that seems to expose them.
Is it still not possible to read/write them?
(I see an Autodesk forum post from April that seems to say no, but I was hoping that they would be visible via the Forge APIs by now?).
Thanks,
Matt
AFAIK, the information of folder/file is provided by Forge Data Management API, this API is used as a common access to many different Autodesk SAAS app like A360 Personal, BIM 360 Team, Fusion Team (formerly known as A360 Team), BIM 360 Docs.
Unfortunately, since the custom attributes are specified only for BIM360 Docs(correct me if I am wrong), so the Folder/Item API of Forge Date Management does not provide that information yet.