Drawing inventory
Lists .vsdx, .vsd and .vsdm in a folder or library, with pages, last edit and macros. A drawing with VBA does not run in Visio for the web.
Octo for Visio and the company's diagrams
A .vsdx is a ZIP with XML: each shape is a Shape, each link is a Connect. Octo generates org charts from the HR spreadsheet, checks the network diagram against the inventory and draws the process in BPMN from a list of steps, checking the rules before opening Visio. Publishing the org chart, choosing which source counts and approving the process stay with the people in charge.
Six possible deliverables, drawn from the research. All of them start from where the data comes from, all of them check before drawing, and all of them go to review by whoever answers for the drawing.
Lists .vsdx, .vsd and .vsdm in a folder or library, with pages, last edit and macros. A drawing with VBA does not run in Visio for the web.
The HR spreadsheet (id, gestor_id) becomes a .vsdx with boxes and glued connectors, after checking for a single root, an existing manager and cycles.
Reads shapes and Connect from the network diagram and compares them with the inventory: extra equipment, missing equipment, wrong IP, missing link and loose connector.
A list of steps, lanes and decisions is checked (start, ends, gateways, reachability) and drawn with Visio's BPMN stencil, on a workstation with someone in front of it.
Deliverable: .vsdx and PDF for the process ownerLogo, footer, brand color or department name replaced in hundreds of drawings, by editing cells and text in the XML, with a copy before and a diff after.
Deliverable: changed drawings + list of what changedThe generator rejects spreadsheets with CPF (Brazilian taxpayer ID), email, phone or salary; a network diagram with IPs is flagged as sensitive information before it circulates.
Deliverable: a drawing with only what it needs to showThe same Octo cycle, applied to diagrams. Each arm has a narrow role; the ones who publish, choose which source counts and approve the process are people.
Drawings by format, with or without macros, where they are, who edited them and which Visio versions are in use.
HR spreadsheet, network inventory, list of steps, and the field that identifies each shape.
Removes unnecessary personal data, flags macros and network diagrams with IPs, asks for minimum permission.
Files directly for batches and services; COM on a workstation for BPMN and PDF; the company's .vsdx template.
Generators and auditors with a check before drawing and a report after.
Opens it in Visio, checks glue and text and compares counts with the source. "The file opened" is not a check.
Delivers .vsdx and PDF. Publishing on the intranet or sending outside requires a person's approval.
Source of each drawing, date, who approved and the command that generates it again.
Octo does not decide what gets published, does not choose which source counts when they differ, does not store credentials and does not run Visio automation without someone in front of the computer.
The criteria Octo uses to choose, with the reference from Microsoft and from the libraries cited in the research.
| Task | Path | Notes |
|---|---|---|
| Generate drawings in batch, without Visio | XML directly in the .vsdx package | The path Microsoft indicates for services |
| Fill the company template | vsdx library (Python, BSD) | Connector support "still incomplete" |
| Read shapes and links | Shape, Cell, Connect | Follow the relationships, not the file name |
| Draw BPMN with the official stencil | COM: Page.Drop, GlueTo | Professional or Plan 2; workstation with a person |
| Check BPMN rules | Process > Check Diagram | Desktop only; checks only the graphics |
| Export PDF | ExportAsFixedFormat | Graph does not convert Visio to PDF |
| Org chart from a spreadsheet, by hand | Organization Chart Wizard | Excel, text, Exchange or ODBC |
| Store and list drawings | Microsoft Graph, driveItem | No Visio-specific API |
| Interact with a drawing on the web | Visio JavaScript API 1.1 | Classic SharePoint Online pages only, with a deadline |
Three steps. Each one only makes sense after the previous one has shown results on your team.
A proposal, not a promise
Octo shows which drawings exist and which no longer match reality, without changing anything.
Org chart, network and process come from the spreadsheet and the inventory, with a check before drawing.
.vsdx templateEach published drawing has a source, date, who approved and the command that rebuilds it.
Every point below has a source published by Microsoft (Learn and Support), by the package's official repository (PyPI, NuGet, PowerShell Gallery) or in Brazilian federal law. The examples are scripts to follow, not runs. The sources are in the next section.
4
points with a published source, each with its reference shown alongside.
.vsdx in place of .vsd and .vdx, based on OPC and XML; every ShapeSheet cell becomes a Cell element with the N attribute.Source: learn.microsoft.com, Introduction to the Visio file formatvsd or vsdx among the sources for PDF, and it has a 2 MB limit.Source: learn.microsoft.com, driveitem-get-content-formatOcto prepares everything, but it does not sign. The document of record stays with whoever is accountable for it.
Surveys, organizes and produces the files: documents, spreadsheets, presentations, schedules, inventories and check reports, on file and through the APIs, without sending or publishing anything.
Deliverable: material ready to checkWhoever is accountable for the document, the spreadsheet or the schedule checks what Octo delivered before approving. If something doesn't add up, it goes back to Octo with the correction.
Step: checked by the person accountableOcto does not sign, approve or send. The document owner reviews and signs; the project manager approves the baseline; the Microsoft 365 administrator grants consent for permissions; the data protection officer approves anything that goes out with personal data.
Approval: document owner and 365 administratorMicrosoft documentation on learn.microsoft.com and in support, plan and lifecycle pages and the repositories of the libraries cited, consulted on Oct 31, 2026.
The assessment starts with an inventory of the drawings and a read-only check of the network diagram against the inventory. You get what still matches, what has aged and the questions only your team can answer, and you decide with that in hand.