Arquitetura, Engenharia e Construção, Repost
Tempo de leitura: 3 minutos
Estudo de caso: PDFs copiados dentro da pasta Plans do BIM 360
Autor: João Martins/Autodesk – Artigo original: https://aps.autodesk.com/blog/copied-pdfs-inside-bim360-plans-folder
Introdução
Quando carregamos arquivos PDF para a pasta Plantas BIM 360 (ou qualquer uma de suas subpastas), obtemos os documentos associados gerados e visíveis através da IU (Interface do usuário).
O arquivo original também está lá, disponível através do endpoint GET Folder contents.
A forma de diferenciá-los é por meio da propriedade “attribute.extension.type” da versão do arquivo.
Obtemos os valores “versions: autodesk.bim360:File” para arquivos e versões originais: “autodesk.bim360.Document” para os documentos gerados.
Como podemos recuperar o tipo de documento e arquivo?
Para mostrar como podemos recuperar os tipos Documento e Arquivo, vamos usar o exemplo abaixo:
Aqui temos um PDF de uma página carregado para a pasta Plantas e uma subpasta (Subplans).
Se chamarmos o endpoint GET Folder contents para a pasta Plantas neste caso, receberemos o Documento “Sample Document” V1 (com versões de tipo de extensão: “autodesk.bim360.Document”) e o Arquivo “Sample Document” V1 (com versões de tipo de extensão: “autodesk.bim360:File”).
O documento pode ser obtido por meio do tutorial de exportação de PDF do documento (observe que isso é específico para arquivos PDF e você pode incluir marcações e hiperlinks), enquanto o arquivo pode ser baixado por meio de download de arquivos do tutorial BIM360.
Até agora tudo bem.
Também temos comportamentos diferentes com documentos copiados e este foi um caso que levamos ao time de Platform Services (obrigado João pelo apoio com a resolução).
Podemos verificar essa diferença por meio do exemplo abaixo:
E se tivermos copiado os documentos?
Agora vamos copiar o primeiro documento para a pasta “Subplans”.
Se chamarmos o GET Folder contents com a urn da pasta “Subplans”, receberemos apenas o “Sample Document” V1 (com versões de tipo de extensão: autodesk.bim360.Document). Isso acontece porque o arquivo original não está disponível na pasta “Subplans” (nunca foi carregado lá).
Para obter o arquivo original, precisamos chamar GET Version Relationships com o id da versão.
Na resposta, obteremos “data.meta.extension.type: ‘derived:autodesk.bim360: CopyDocument’ “, indicando que este documento foi copiado de outro.
A partir daí, podemos verificar “data.meta.fromId: << ID do arquivo orginal >>” e chamar GET Version Relationships com o ID do documento original.
Quando fizermos isso, obteremos “data.meta.extension.type: ‘derived:autodesk.bim360: FileToDocument‘ “, indicando que este é o relacionamento entre o arquivo original e o documento gerado.
A partir daí, podemos usar fromId: << ID do arquivo original >> para filtrar os itens incluídos e encontrar o arquivo original.
No caso de você ter cópias sucessivas de um documento (cópia da cópia), você precisará chamar o GET Version Relationships recursivamente.
Artigo original: https://aps.autodesk.com/blog/copied-pdfs-inside-bim360-plans-folder
Sobre o Autor:
JOÃO MARTINS – DEVELOPER ADVOCATE na Autodesk
Joined the Developer Advocates team in 2020, João works mostly with .NET application. He is a Civil Engineer graduate with experience in software development. You can count on him to help you with your AEC related topics.
Edit: O nome do produto foi alterado de "Autodesk Forge" para "Autodesk Platform Services" em novembro de 2022. Mais informações em: https://aps.autodesk.com/blog/autodesk-forge-becoming-autodesk-platform-services