Word ডকুমেন্টে Custom Properties হলো অতিরিক্ত মেটাডেটা যা ডকুমেন্টের সম্পর্কে অতিরিক্ত তথ্য প্রদান করে, যেমন ডকুমেন্টের লেখক, শব্দ সংখ্যা, বা কাস্টম ডাটা যা ডকুমেন্টের মূল কনটেন্টের বাইরে থাকে। Apache POI ব্যবহার করে আপনি সহজেই Word ডকুমেন্টে Custom Properties যোগ করতে পারেন।

Custom properties ব্যবহার করা হয় যখন আপনি ডকুমেন্টের নির্দিষ্ট বৈশিষ্ট্য বা অতিরিক্ত তথ্য সংরক্ষণ করতে চান, যা পরে ম্যানেজমেন্ট বা ডকুমেন্ট বিশ্লেষণের কাজে লাগতে পারে।

1. Custom Properties কী?

Custom Properties হল এমন প্রোপার্টিজ যা ডকুমেন্টে সাধারণত সংরক্ষিত থাকে না, তবে আপনি যখন বিশেষ কোন কাস্টম তথ্য সংরক্ষণ করতে চান, তখন এগুলি ব্যবহার করা হয়। উদাহরণস্বরূপ, আপনি ডকুমেন্টে "প্রজেক্ট নাম", "ক্লায়েন্ট নাম" বা "প্রকাশের তারিখ" মতো অতিরিক্ত তথ্য যোগ করতে পারেন।

2. Custom Properties যোগ করার প্রক্রিয়া

Apache POI লাইব্রেরি ব্যবহার করে, আপনি XWPFDocument ক্লাসের মাধ্যমে Word ডকুমেন্টে Custom Properties যোগ করতে পারেন। এটি করার জন্য CustomProperties API ব্যবহার করতে হয়।

কোড উদাহরণ: Word ডকুমেন্টে Custom Properties যোগ করা

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
import org.apache.poi.util.IOUtils;
import org.apache.xmlbeans.XmlCursor;

import java.io.FileOutputStream;
import java.io.IOException;

public class CustomPropertiesExample {
    public static void main(String[] args) throws IOException, InvalidFormatException {
        // নতুন Word ডকুমেন্ট তৈরি
        XWPFDocument document = new XWPFDocument();

        // Custom Properties যোগ করা
        addCustomProperties(document);

        // Word ডকুমেন্ট সেভ করা
        try (FileOutputStream out = new FileOutputStream("custom_properties_example.docx")) {
            document.write(out);
        }

        System.out.println("Custom Properties সহ Word ডকুমেন্ট সফলভাবে তৈরি হয়েছে!");
    }

    private static void addCustomProperties(XWPFDocument document) {
        // Custom properties যোগ করার জন্য XML কনটেন্ট
        XmlCursor cursor = document.getProperties().getCustomProperties().newCursor();
        cursor.beginElement("Properties");

        // কাস্টম প্রোপার্টি তৈরি
        cursor.beginElement("Property");
        cursor.insertAttributeWithValue("name", "Project Name");
        cursor.insertAttributeWithValue("value", "Apache POI Project");
        cursor.toNextSibling();

        cursor.beginElement("Property");
        cursor.insertAttributeWithValue("name", "Client Name");
        cursor.insertAttributeWithValue("value", "OpenAI");
        cursor.toNextSibling();

        cursor.endElement(); // Close the "Properties" tag
    }
}

কোড ব্যাখ্যা:

• getProperties().getCustomProperties(): এই কোডটি ডকুমেন্টের কাস্টম প্রোপার্টি সেকশনে প্রবেশ করতে সাহায্য করে।
• XmlCursor: এটি XML ডকুমেন্টের মধ্যে নেভিগেট করার জন্য ব্যবহার হয়, যেখানে আমরা কাস্টম প্রোপার্টি যোগ করি।
• insertAttributeWithValue(): এই মেথডটি কাস্টম প্রোপার্টির নাম এবং মান ইনসার্ট করার জন্য ব্যবহৃত হয়।

এই কোডটি একটি Word ডকুমেন্ট তৈরি করবে, যাতে "Project Name" এবং "Client Name" নামের দুটি কাস্টম প্রোপার্টি থাকবে।

3. Custom Properties এর ব্যবহার

Custom properties সাধারণত ব্যবহার করা হয় Metadata, Tracking, বা Document Management সিস্টেমে। কিছু সাধারণ ব্যবহার নিম্নরূপ:

• ডকুমেন্ট মেটাডেটা: যেমন লেখকের নাম, প্রকাশের তারিখ, বা সংস্করণ।
• প্রজেক্ট সম্পর্কিত তথ্য: যেমন প্রজেক্টের নাম, ক্লায়েন্টের নাম, বা প্রজেক্টের অবস্থা।
• ট্র্যাকিং এবং বিশ্লেষণ: ডকুমেন্টের উপর নির্দিষ্ট কার্যকলাপ বা কাস্টম ট্যাগ।

4. Custom Properties দেখানো বা এক্সেস করা

আপনি যদি ডকুমেন্ট থেকে কাস্টম প্রোপার্টি এক্সেস করতে চান, তবে Apache POI এর Properties API ব্যবহার করে এটি করা সম্ভব। উদাহরণস্বরূপ:

কোড উদাহরণ: Custom Properties এক্সেস করা

import org.apache.poi.xwpf.usermodel.XWPFDocument;
import org.apache.poi.openxml4j.exceptions.InvalidFormatException;
import org.apache.poi.util.IOUtils;
import org.apache.xmlbeans.XmlCursor;

import java.io.FileInputStream;
import java.io.IOException;

public class ReadCustomPropertiesExample {
    public static void main(String[] args) throws IOException, InvalidFormatException {
        // Word ডকুমেন্ট খুলুন
        FileInputStream fis = new FileInputStream("custom_properties_example.docx");
        XWPFDocument document = new XWPFDocument(fis);

        // Custom Properties পড়া
        readCustomProperties(document);

        fis.close();
    }

    private static void readCustomProperties(XWPFDocument document) {
        XmlCursor cursor = document.getProperties().getCustomProperties().newCursor();
        cursor.selectPath("./Property");

        while(cursor.toNextSelection()) {
            String name = cursor.getAttributeText("name");
            String value = cursor.getAttributeText("value");
            System.out.println(name + ": " + value);
        }
    }
}

কোড ব্যাখ্যা:

• getCustomProperties(): কাস্টম প্রোপার্টি পড়তে এবং এক্সেস করতে এই মেথড ব্যবহার করা হয়।
• cursor.selectPath(): এটি XML কন্টেন্টে পথ নির্ধারণ করে এবং কাস্টম প্রোপার্টিগুলি এক এক করে পড়ে।

এই কোডটি ডকুমেন্টের কাস্টম প্রোপার্টিগুলি কনসোলের মাধ্যমে প্রদর্শন করবে।

সারাংশ

Word ডকুমেন্টে Custom Properties যোগ করা এবং এগুলি এক্সেস করার মাধ্যমে আপনি অতিরিক্ত মেটাডেটা সংরক্ষণ করতে পারেন, যা ডকুমেন্টের কার্যকারিতা বৃদ্ধি করে। Apache POI ব্যবহার করে আপনি সহজেই কাস্টম প্রোপার্টি যোগ এবং পরিচালনা করতে পারেন। এর মাধ্যমে আপনি আপনার ডকুমেন্টের তথ্যের বিশ্লেষণ, ট্র্যাকিং এবং ম্যানেজমেন্ট আরও দক্ষতার সাথে করতে পারবেন।