如何使用Design Automation在BIM 360云模型中发布新版本文件？

Question

我遇到一个问题，当尝试向BIM 360云端的Revit模型更新新的参数覆盖并发布Revit模型的新版本时。

例如：在BIM 360中名为sample.rvt的最新版本模型为版本1。设置参数后，文件名将保持为sample.rvt，但版本号应变为2。

我已经尝试了以下步骤：

创建bundle app以更新参数

private void DoJob(DesignAutomationData data)
{
    if(data.RevitDoc == null) throw new Exception("DesignAutomationData.RevitDoc存在问题");
    Document doc = data.RevitDoc;
    List inputParams = GetParamsJson();
    string result = SetParameterCommand.Execute(doc, inputParams);
    File.WriteAllText("result.txt", result);
}

创建活动

Activity activitySpec = new Activity()
{
   // 活动定义部分 
   ... 
}

执行工作项

private async Task ExecuteWorkItem(string forgeToken, List inputParams, string projectId, string versionId, string callBackUrl)
{
    ...
}

发布新版本 - 这个步骤遇到了问题，不知道如何实现

对于最后一步，即发布新版本到BIM360模型，在GitHub上我没有找到从保存为bucket中的文件发布BIM360模型新版本的示例代码。如果您有任何C#代码示例，请分享一下，我将非常感激。

harto · Answer

检查以下代码：

private void PostNewVersion(string forgeToken, string projectId, string itemId, string newVersion, string callbackUrl)
{
    RestClient client = new RestClient("https://developer.api.autodesk.com/data/v1/projects/" + projectId + "/versions");
    RestRequest request = new RestRequest(Method.POST);
    request.AddHeader("Authorization", "Bearer " + forgeToken);
    request.AddHeader("Content-Type", "application/json");

    // 准备请求体，包含版本详细信息
    string requestBody = $"{{\"data\": {{\"type\": \"versions\",\"attributes\": {{\"name\": \"YourModelName\",\"extension\": {{\"type\": \"versions:autodesk.bim360:File\",\"version\": \"{newVersion}\"}}}},\"relationships\": {{\"item\": {{\"data\": {{\"type\": \"items\",\"id\": \"{itemId}\"}}}}}}}},\"jsonapi\": {{\"version\": \"1.0\"}}}}";
    request.AddParameter("application/json", requestBody, ParameterType.RequestBody);

    // 执行请求
    IRestResponse response = client.Execute(request);

    // 处理响应
    if (response.StatusCode == HttpStatusCode.Created)
    {
        // 版本创建成功
        string versionId = response.Headers
            .FirstOrDefault(h => h.Name == "Location" && h.Value.ToString().Contains("versions"))
            ?.Value?.ToString();

        // 现在，您可以将存储位置与新版本关联（此示例未展示）
        UpdateStorageLocation(forgeToken, projectId, versionId, callbackUrl);
    }
    else
    {
        // 错误处理
        Console.WriteLine("创建版本时出错: " + response.Content);
    }
}

private void UpdateStorageLocation(string forgeToken, string projectId, string versionId, string callbackUrl)
{
    // 实现更新存储位置的逻辑
    // 使用projects/:project_id/storage端点将模型与新版本关联
    // 请参考Forge Data Management API文档获取详细信息
}

spender · Answer

最后，我在以下文档中找到了解决我的问题的答案：
https://aps.autodesk.com/en/docs/bim360/v1/tutorials/document-management/upload-document-s3/

以下是解决问题的步骤：

创建一个新的存储对象

检查文件项是否存在，并在存在时使用该文件项。

   var items = await GetFolderItems(projectId, folderUrn, accessToken).ConfigureAwait(false);
   var item = items.Cast>()
                   .FirstOrDefault(item => item.Value.attributes.displayName.Equals(filename, StringComparison.OrdinalIgnoreCase));

发布更新版本：
- 如果文件项不存在，则创建新的文件项。
- 如果文件项已存在，则继续使用前一版本中的项目ID，例如urn:adsk.wipprod:dm.lineage:J-CiZHzFTGy-A0-RfhEUMQ。

private static async Task UpdateVersionAsync(string projectId, string itemId, string objectId,
        string filename, string accessToken)
{
    var versionsApi = new VersionsApi();
    versionsApi.Configuration.AccessToken = accessToken;

    // 创建关系对象
    var relationships = new CreateVersionDataRelationships
    (
        new CreateVersionDataRelationshipsItem
        (
            new CreateVersionDataRelationshipsItemData
            (
                CreateVersionDataRelationshipsItemData.TypeEnum.Items,
                itemId
            )
        ),
        new CreateItemRelationshipsStorage
        (
            new CreateItemRelationshipsStorageData
            (
                CreateItemRelationshipsStorageData.TypeEnum.Objects,
                objectId
            )
        )
    );

    // 创建新版本的数据结构
    var createVersion = new CreateVersion
    (
        new JsonApiVersionJsonapi
        (
            JsonApiVersionJsonapi.VersionEnum._0
        ),
        new CreateVersionData
        (
            CreateVersionData.TypeEnum.Versions,
            new CreateStorageDataAttributes
            (
                filename,
                new BaseAttributesExtensionObject
                (
                    "versions:autodesk.bim360:File",
                    "1.0",
                    new JsonApiLink(string.Empty),
                    null
                )
            ),
            relationships
        )
    );

    // 调用API发布新版本
    dynamic versionResponse = await versionsApi.PostVersionAsync(projectId, createVersion).ConfigureAwait(false);
    var versionId = versionResponse.data.id;
    return versionId;
}