Membuat diagram Visio langsung dari kode Java dapat memperlancar alur kerja dokumentasi dan menghilangkan upaya menggambar manual. Conholdate.Total for Java menyediakan SDK yang kuat yang memungkinkan Anda menghasilkan file Visio secara programatik. Dalam panduan ini kami akan membuat Diagram Visio di Java, menambahkan bentuk dari templat master, menempatkannya, dan menerapkan gaya teks. Pada akhir Anda akan memiliki file VSDX yang siap dibuka dan dapat diedit lebih lanjut di Microsoft Visio.

Persyaratan Pembuatan Diagram Visio

Enterprises sering kali perlu menghasilkan skematik teknis, diagram alur, atau diagram jaringan secara otomatis dari sumber data. Pengembang Java yang membangun dasbor pelaporan, alat konfigurasi, atau pipeline CI sering menghadapi kebutuhan untuk menghasilkan file Visio tanpa intervensi manual. Solusi harus mendukung pembuatan bentuk berbasis master, penempatan yang tepat, dan penataan teks yang sesuai dengan stensil Visio yang ada. Menggambar secara manual di Visia memakan waktu dan rawan kesalahan, terutama ketika diagram harus dihasilkan kembali pada setiap build.

Pendekatan: Pembuatan Diagram Visio dengan Conholdate.Total

Conholdate.Total for Java menawarkan API diagram khusus yang bekerja dengan format VSDX. API ini memungkinkan Anda memuat master stencil, menambahkan bentuk dari master tersebut, memposisikan kembali bentuk melalui properti XForm mereka, melampirkan teks, dan menerapkan gaya teks yang telah ditentukan sebelumnya, semuanya melalui panggilan Java yang sederhana. Dokumentasi untuk kelas diagram tersedia di dokumentasi resmi, dan referensi API lengkap dapat dijelajahi di referensi API. Dengan menggunakan perpustakaan ini Anda dapat mengotomatiskan seluruh alur pembuatan Visio di server atau lingkungan desktop.

Membangun Solusi: Membuat Diagram Visio di Java

Langkah-langkah berikut memandu Anda melalui proses lengkap, mulai dari penyiapan Maven hingga menyimpan file VSDX akhir.

Tambahkan Dependensi Maven dan Impor Kelas

Pertama, konfigurasikan repositori Maven Conholdate dan tambahkan dependensi SDK ke pom.xml Anda.

<repositories>
  <repository>
    <id>conholdate-repo</id>
    <name>Conholdate Maven Repository</name>
    <url>https://repository.conholdate.com/repo/</url>
  </repository>
</repositories>

<dependency>
  <groupId>com.conholdate</groupId>
  <artifactId>conholdate-total</artifactId>
  <version>24.9</version>
  <type>pom</type>
</dependency>

Kelas diagram yang digunakan dalam tutorial ini berada di paket com.aspose.diagram, yang disertakan sebagai bagian dari Conholdate.Total for Java bundle:

import com.aspose.diagram.Diagram;
import com.aspose.diagram.Shape;
import com.aspose.diagram.TypeValue;
import com.aspose.diagram.Txt;
import com.aspose.diagram.SaveFileFormat;

Inisialisasi Diagram dan Muat Bentuk Master

Buat instance Diagram baru, lalu muat file stensil dan pilih master yang ingin Anda gunakan sebagai dasar bentuk Anda. Di sini kami menggunakan master bawaan “Rectangle” dari stensil “Basic Shapes.vss”.

// Create a new instance of a diagram
Diagram diagram = new Diagram();

// Define the name of the master (template) to be used for creating shapes
String masterName = "Rectangle";
diagram.addMaster("Basic Shapes.vss", masterName);

Tambahkan Bentuk dari Master dan Atur Posisinya

Tambahkan bentuk ke diagram menggunakan master, lalu cari bentuk tersebut dengan ID yang dikembalikan oleh addShape sehingga Anda dapat menyesuaikan posisinya.

// Define the dimensions and position for the new shape
double width = 2, height = 2, pinX = 4.25, pinY = 4.5;

// Add a new rectangle shape to the diagram using the specified master
long rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, 0);

// Retrieve the shape by its ID for modification
Shape rectangle = diagram.getPages().get(0).getShapes().getShape(rectangleId);

// Set the position of the shape by modifying its PinX and PinY properties
rectangle.getXForm().getPinX().setValue(5);
rectangle.getXForm().getPinY().setValue(5);

// Set the type of the shape to indicate it is a standard shape
rectangle.setType(TypeValue.SHAPE);

Tambahkan Teks dan Terapkan Gaya Teks

Lampirkan teks ke bentuk dan terapkan salah satu lembar gaya yang telah ditentukan sebelumnya pada diagram sehingga label cocok dengan sisa dokumen.

// Add text to the shape
rectangle.getText().getValue().add(new Txt("Aspose Diagram"));

// Apply a predefined text style to the shape's text
rectangle.setTextStyle(diagram.getStyleSheets().get(3));

Simpan Diagram ke VSDX

Akhirnya, tulis diagram ke file VSDX yang dapat dibuka di Microsoft Visio.

diagram.save("Visio_out.vsdx", SaveFileFormat.VSDX);

Buat Diagram Visio di Java - Contoh Kerja Penuh - Contoh Kode Lengkap

Kode berikut menunjukkan seluruh alur kerja dari awal hingga akhir.

import com.aspose.diagram.Diagram;
import com.aspose.diagram.Shape;
import com.aspose.diagram.TypeValue;
import com.aspose.diagram.Txt;
import com.aspose.diagram.SaveFileFormat;

public class CreateVisioDiagram {
    public static void main(String[] args) {
        try {
            // Create a new instance of a diagram
            Diagram diagram = new Diagram();

// Define the name of the master (template) to be used for creating shapes
            String masterName = "Rectangle";
            diagram.addMaster("Basic Shapes.vss", masterName);

// Define the dimensions and position for the new shape
            double width = 2, height = 2, pinX = 4.25, pinY = 4.5;

// Add a new rectangle shape to the diagram using the specified master
            long rectangleId = diagram.addShape(pinX, pinY, width, height, masterName, 0);

// Retrieve the shape by its ID for modification
            Shape rectangle = diagram.getPages().get(0).getShapes().getShape(rectangleId);

// Set the position of the shape by modifying its PinX and PinY properties
            rectangle.getXForm().getPinX().setValue(5);
            rectangle.getXForm().getPinY().setValue(5);

// Set the type of the shape to indicate it is a standard shape
            rectangle.setType(TypeValue.SHAPE);

// Add text to the shape
            rectangle.getText().getValue().add(new Txt("Aspose Diagram"));

// Apply a predefined text style to the shape's text
            rectangle.setTextStyle(diagram.getStyleSheets().get(3));

// Save the modified diagram to a file
            diagram.save("Visio_out.vsdx", SaveFileFormat.VSDX);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

Catatan: Contoh kode ini menunjukkan fungsi inti. Sebelum menggunakannya dalam proyek Anda, pastikan untuk memperbarui semua jalur file dan nilai konfigurasi agar sesuai dengan lingkungan Anda yang sebenarnya, verifikasi bahwa semua dependensi yang diperlukan telah terpasang dengan benar, dan uji secara menyeluruh di lingkungan pengembangan Anda. Jika Anda mengalami masalah, silakan merujuk ke dokumentasi resmi atau hubungi tim dukungan untuk bantuan.

Pertimbangan Penyebaran untuk Proyek Diagram Visio

SDK berjalan pada runtime Java 8+ apa pun, menjadikannya cocok untuk layanan backend, pekerjaan batch, atau utilitas desktop. Saat menghasilkan diagram besar, pantau penggunaan heap dan pertimbangkan untuk menggunakan kembali satu instance Diagram untuk beberapa halaman guna mengurangi beban memori. Lisensi yang valid diperlukan untuk produksi; Anda dapat memperoleh lisensi sementara untuk pengujian dari halaman lisensi sementara dan membeli lisensi penuh melalui halaman harga. Pastikan direktori output dapat ditulisi oleh proses yang mengeksekusi kode.

Kesimpulan

Programmatically creating Visio diagrams in Java becomes straightforward with Conholdate.Total for Java. Dengan mengikuti langkah‑langkah di atas, Anda dapat memuat stensil master, menghasilkan file VSDX, menempatkan bentuk secara tepat, dan menerapkan gaya teks yang konsisten. Ingatlah untuk memperoleh lisensi produksi yang tepat dan menguji diagram yang dihasilkan di Microsoft Visio untuk memverifikasi kesetiaan tata letak. Dengan SDK yang tersedia, Anda dapat mengotomatisasi pembuatan diagram di berbagai skenario perusahaan.

FAQs

  • Bagaimana cara membuat Diagram Visio di Java menggunakan template master?
    Gunakan kelas diagram yang disediakan oleh Conholdate.Total for Java, muat stencil dengan addMaster, tambahkan bentuk dari master tersebut dengan addShape, dan simpan file sebagai VSDX.

  • Format file apa yang dihasilkan SDK untuk diagram Visio?
    SDK menghasilkan format VSDX modern, yang sepenuhnya kompatibel dengan Microsoft Visio.

  • Apakah saya memerlukan lisensi untuk menjalankan file Visio yang dihasilkan di produksi?
    Ya. Dapatkan lisensi produksi dari halaman harga dan Anda dapat menggunakan lisensi sementara selama pengembangan.

  • Apakah saya dapat mengintegrasikan pembuatan diagram ini ke dalam layanan web?
    Tentu saja. SDK adalah pustaka Java murni, sehingga Anda dapat memanggilnya dari backend berbasis Java apa pun seperti Spring Boot atau Jakarta EE.

Baca Selengkapnya