Menggunakan Properti Dokumen di Aspose.Words untuk Java

Pengenalan Properti Dokumen

Properti dokumen merupakan bagian penting dari dokumen apa pun. Properti tersebut menyediakan informasi tambahan tentang dokumen itu sendiri, seperti judul, penulis, subjek, kata kunci, dan banyak lagi. Di Aspose.Words untuk Java, Anda dapat memanipulasi properti dokumen bawaan dan kustom.

Menghitung Properti Dokumen

Properti bawaan

Untuk mengambil dan bekerja dengan properti dokumen bawaan, Anda dapat menggunakan cuplikan kode berikut:

@Test
public void enumerateProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    System.out.println(MessageFormat.format("1. Document name: {0}", doc.getOriginalFileName()));
    System.out.println("2. Built-in Properties");
    for (DocumentProperty prop : doc.getBuiltInDocumentProperties())
        System.out.println(MessageFormat.format("{0} : {1}", prop.getName(), prop.getValue()));
}

Kode ini akan menampilkan nama dokumen dan properti bawaan, termasuk properti seperti “Judul,” “Penulis,” dan “Kata Kunci.”

Properti Kustom

Untuk bekerja dengan properti dokumen khusus, Anda dapat menggunakan cuplikan kode berikut:

@Test
public void addCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    CustomDocumentProperties customDocumentProperties = doc.getCustomDocumentProperties();

    if (customDocumentProperties.get("Authorized") != null) return;

    customDocumentProperties.add("Authorized", true);
    customDocumentProperties.add("Authorized By", "John Smith");
    customDocumentProperties.add("Authorized Date", new Date());
    customDocumentProperties.add("Authorized Revision", doc.getBuiltInDocumentProperties().getRevisionNumber());
    customDocumentProperties.add("Authorized Amount", 123.45);
}

Potongan kode ini menunjukkan cara menambahkan properti dokumen kustom, termasuk nilai boolean, string, tanggal, nomor revisi, dan nilai numerik.

Menghapus Properti Dokumen

Untuk menghapus properti dokumen tertentu, Anda dapat menggunakan kode berikut:

@Test
public void removeCustomDocumentProperties() throws Exception
{
    Document doc = new Document("Your Directory Path" + "Properties.docx");
    doc.getCustomDocumentProperties().remove("Authorized Date");
}

Kode ini menghapus properti khusus “Tanggal Resmi” dari dokumen.

Mengonfigurasi Tautan ke Konten

Dalam beberapa kasus, Anda mungkin ingin membuat tautan dalam dokumen Anda. Berikut cara melakukannya:

@Test
public void configuringLinkToContent() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    builder.startBookmark("MyBookmark");
    builder.writeln("Text inside a bookmark.");
    builder.endBookmark("MyBookmark");

    CustomDocumentProperties customProperties = doc.getCustomDocumentProperties();

    // Tambahkan tautan ke properti konten.
    DocumentProperty customProperty = customProperties.addLinkToContent("Bookmark", "MyBookmark");
    customProperty = customProperties.get("Bookmark");
    boolean isLinkedToContent = customProperty.isLinkToContent();
    String linkSource = customProperty.getLinkSource();
    String customPropertyValue = customProperty.getValue().toString();
}

Potongan kode ini memperagakan cara membuat penanda dalam dokumen Anda dan menambahkan properti dokumen kustom yang tertaut ke penanda tersebut.

Konversi Antar Satuan Pengukuran

Di Aspose.Words untuk Java, Anda dapat mengonversi satuan ukuran dengan mudah. Berikut contoh cara melakukannya:

@Test
public void convertBetweenMeasurementUnits() throws Exception
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);
    PageSetup pageSetup = builder.getPageSetup();

    // Tetapkan margin dalam inci.
    pageSetup.setTopMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setBottomMargin(ConvertUtil.inchToPoint(1.0));
    pageSetup.setLeftMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setRightMargin(ConvertUtil.inchToPoint(1.5));
    pageSetup.setHeaderDistance(ConvertUtil.inchToPoint(0.2));
    pageSetup.setFooterDistance(ConvertUtil.inchToPoint(0.2));
}

Cuplikan kode ini menetapkan berbagai margin dan jarak dalam inci dengan mengubahnya menjadi poin.

Menggunakan Karakter Kontrol

Karakter kontrol dapat berguna saat menangani teks. Berikut cara mengganti karakter kontrol dalam teks Anda:

@Test
public void useControlCharacters()
{
    final String TEXT = "test\r";

    // Ganti karakter kontrol "\r" dengan "\r\n".
    String replace = TEXT.replace(ControlChar.CR, ControlChar.CR_LF);
}

Dalam contoh ini, kami mengganti carriage return (\r) dengan carriage return diikuti dengan line feed (\r\n).

Kesimpulan

Properti dokumen memainkan peran penting dalam mengelola dan mengatur dokumen Anda secara efektif di Aspose.Words untuk Java. Baik itu bekerja dengan properti bawaan, properti kustom, atau menggunakan karakter kontrol, Anda memiliki berbagai alat yang dapat digunakan untuk meningkatkan kemampuan manajemen dokumen Anda.

Pertanyaan yang Sering Diajukan

Bagaimana cara mengakses properti dokumen bawaan?

Untuk mengakses properti dokumen bawaan di Aspose.Words untuk Java, Anda dapat menggunakangetBuiltInDocumentProperties metode padaDocument objek. Metode ini mengembalikan kumpulan properti bawaan yang dapat Anda gunakan berulang-ulang.

Bisakah saya menambahkan properti dokumen khusus ke suatu dokumen?

Ya, Anda dapat menambahkan properti dokumen kustom ke dokumen menggunakanCustomDocumentProperties koleksi. Anda dapat menentukan properti kustom dengan berbagai tipe data, termasuk string, boolean, tanggal, dan nilai numerik.

Bagaimana cara menghapus properti dokumen kustom tertentu?

Untuk menghapus properti dokumen kustom tertentu, Anda dapat menggunakanremove metode padaCustomDocumentPropertieskoleksi, meneruskan nama properti yang ingin Anda hapus sebagai parameter.

Apa tujuan menautkan ke konten dalam dokumen?

Dengan menautkan ke konten dalam dokumen, Anda dapat membuat referensi dinamis ke bagian tertentu dari dokumen. Ini dapat berguna untuk membuat dokumen interaktif atau referensi silang antarbagian.

Bagaimana cara mengkonversi antar satuan pengukuran yang berbeda di Aspose.Words untuk Java?

Anda dapat mengonversi antara unit pengukuran yang berbeda di Aspose.Words untuk Java dengan menggunakanConvertUtil kelas. Menyediakan metode untuk mengonversi satuan seperti inci ke poin, poin ke sentimeter, dan banyak lagi.