แก้ไขข้อมูลเมตาของไฟล์ PDF โดยใช้ REST API ใน C#

ข้อมูลเมตาของเอกสารคือชิ้นส่วนของข้อมูลเกี่ยวกับเอกสาร เช่น ผู้แต่ง เวลาแก้ไข ฯลฯ ที่จัดเก็บไว้ในเอกสาร ในฐานะนักพัฒนา C# คุณสามารถแก้ไขข้อมูลเมตาดาต้าสำหรับเอกสาร PDF โดยทางโปรแกรมบนคลาวด์ได้อย่างง่ายดาย ในบทความนี้ คุณจะได้เรียนรู้วิธีแก้ไข Metadata ของไฟล์ PDF โดยใช้ REST API ใน C#

หัวข้อต่อไปนี้จะครอบคลุมในบทความนี้:

• การจัดการข้อมูลเมตาของเอกสาร REST API และ .NET SDK
• แก้ไขข้อมูลเมตาของเอกสาร PDF โดยใช้ REST API

การจัดการข้อมูลเมตาของเอกสาร REST API และ .NET SDK

สำหรับการแก้ไขข้อมูลเมตาของเอกสาร PDF ฉันจะใช้ API ของ .NET SDK of GroupDocs.Metadata Cloud ช่วยให้คุณสามารถเพิ่ม แก้ไข ดึงและลบข้อมูลเมตาจากรูปแบบไฟล์มาตรฐานอุตสาหกรรมเกือบทั้งหมด คุณสามารถดำเนินการดังกล่าวใน PDF, Microsoft Word, สเปรดชีต Excel, งานนำเสนอ PowerPoint, อีเมล Outlook, Visio, OneNote, โครงการ, เสียง, วิดีโอ, AutoCAD, ไฟล์เก็บถาวร, JPEG, BMP, PNG และ TIFF นอกจากนี้ยังมี Java SDK เป็น สมาชิกในครอบครัวการจัดการข้อมูลเมตาของเอกสาร สำหรับ Cloud API

คุณสามารถติดตั้ง GroupDocs.Metadata Cloud SDK สำหรับ .NET ลงในโปรเจ็กต์ Visual Studio ของคุณได้จากตัวจัดการ NuGet Package ดังที่แสดงด้านล่าง:

คุณยังสามารถติดตั้งแพ็คเกจ NuGet โดยใช้คำสั่งต่อไปนี้ในคอนโซลตัวจัดการแพ็คเกจ:

Install-Package GroupDocs.Metadata-Cloud

โปรดรับรหัสไคลเอ็นต์และรหัสลับไคลเอ็นต์ของคุณจาก แดชบอร์ด ก่อนที่คุณจะเริ่มทำตามขั้นตอนและตัวอย่างโค้ดที่มีอยู่ เมื่อคุณมีรหัสไคลเอ็นต์และรหัสลับแล้ว ให้เพิ่มรหัสตามที่แสดงด้านล่าง:

string clientID = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string myStorage = "";

Configuration configuration = new Configuration(clientID, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

แก้ไขข้อมูลเมตาของไฟล์ PDF โดยใช้ REST API ใน C#

คุณสามารถตั้งค่าข้อมูลเมตาของเอกสาร PDF โดยทำตามขั้นตอนง่าย ๆ ด้านล่าง:

• อัปโหลด ไฟล์ PDF ไปยังคลาวด์
• อัปเดตข้อมูลเมตาของเอกสาร PDF โดยใช้ C#
• ดาวน์โหลด ไฟล์ผลลัพธ์

อัปโหลดเอกสาร

ขั้นแรก อัปโหลดไฟล์ PDF ไปยัง Cloud โดยใช้ตัวอย่างโค้ดที่ระบุด้านล่าง:

# การเริ่มต้น API
FileApi fileApi = new FileApi(configuration);
string path = @"C:\Files";

var file = Directory.GetFiles(path, "input.pdf", SearchOption.AllDirectories).FirstOrDefault();
if (file.Length != 0)
{
    var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

    var fileStream = File.Open(file, FileMode.Open);

    fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage));
    fileStream.Close();
}

ด้วยเหตุนี้ ไฟล์ PDF ที่อัปโหลด (input.pdf) จะพร้อมใช้งานใน ส่วนไฟล์ ของแดชบอร์ดของคุณบนระบบคลาวด์

อัปเดตข้อมูลเมตาของไฟล์ PDF โดยใช้ C#

คุณสามารถอัปเดตข้อมูลเมตาของไฟล์ PDF โดยทางโปรแกรมโดยทำตามขั้นตอนด้านล่าง

• สร้างอินสแตนซ์ของ MetadataApi
• กำหนดเส้นทางไฟล์ PDF ในโมเดล FileInfo
• กำหนด SetOptions
• ระบุ NewValue และ Type สำหรับ SetPropert
• กำหนด SearchCriteria ระบุ NameOptions ที่จะอัปเดตค่า
• สร้าง SetRequest ด้วย SetOptions
• รับผลลัพธ์โดยเรียกเมธอด MetadataApi.Set()

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีตั้งค่าข้อมูลเมตาตามชื่อคุณสมบัติของเอกสาร PDF โดยใช้ REST API

# การเริ่มต้น API
var apiInstance = new MetadataApi(configuration);

try
{
    var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
    {
        FilePath = "input.pdf",
        StorageName = myStorage
    };
    
    // กำหนดตัวเลือกชุด
    var options = new SetOptions
    {
        FileInfo = fileInfo,
        Properties = new List<SetProperty>
        {
            new SetProperty
            {
                NewValue = "hello",
                Type = "String",
                SearchCriteria = new SearchCriteria
                {
                    NameOptions = new NameOptions
                    {
                        Value = "Keywords"
                    }
                },
            }
        }
    };
    
    // กำหนดคำขอชุด
    var request = new SetRequest(options);

    var response = apiInstance.Set(request);
    Console.WriteLine($"Count of changes: {response.SetCount}");
    Console.WriteLine("Resultant file path: " + response.Path);
}
catch (Exception e)
{
    Console.WriteLine("Exception while calling MetadataApi: " + e.Message);
}

ข้อมูลโค้ดต่อไปนี้แสดงวิธีจับคู่ชื่อคุณสมบัติโดยตั้งค่าคุณสมบัติ ExactPhase เป็น True:

# การเริ่มต้น API
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// กำหนดตัวเลือกชุด
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "This is title",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "Title",
                    MatchOptions = new MatchOptions
                    {
                        ExactPhrase = true
                    }
                }
            },
        }
    }
};

// กำหนดคำขอชุด
var request = new SetRequest(options);

var response = apiInstance.Set(request);

ข้อมูลโค้ดต่อไปนี้แสดงวิธีกำหนดเกณฑ์การค้นหาโดยใช้นิพจน์ทั่วไปเพื่อให้ MatchOptions:

# การเริ่มต้น API
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// กำหนดตัวเลือกชุด
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "new value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                NameOptions = new NameOptions
                {
                    Value = "^Tit.*",
                    MatchOptions = new MatchOptions
                    {
                        IsRegex = true
                    }
                }
            },
        }
    }
};

// กำหนดคำขอชุด
var request = new SetRequest(options);

var response = apiInstance.Set(request);

ข้อมูลโค้ดต่อไปนี้แสดงวิธีการอัปเดตข้อมูลเมตาโดยระบุค่าคุณสมบัติ:

# การเริ่มต้น API
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
    FilePath = "input.pdf",
    StorageName = myStorage
};

// กำหนดตัวเลือกชุด
var options = new SetOptions
{
    FileInfo = fileInfo,
    Properties = new List<SetProperty>
    {
        new SetProperty
        {
            NewValue = "Simply set by Property Value",
            Type = "String",
            SearchCriteria = new SearchCriteria
            {
                ValueOptions = new ValueOptions
                {
                    Value = "Windows User",
                    Type = "String"
                }
            },
        }
    }
};

// กำหนดคำขอชุด
var request = new SetRequest(options);

var response = apiInstance.Set(request);

ดาวน์โหลดไฟล์ที่อัปเดต

ตัวอย่างโค้ดด้านบนจะบันทึกไฟล์ PDF ที่อัปเดตบนคลาวด์และสามารถดาวน์โหลดได้โดยใช้ตัวอย่างโค้ดต่อไปนี้:

# การเริ่มต้น API
var fileApi = new FileApi(configuration);
var file = "metadata\\set_metadata\\input_pdf\\input.pdf";
var downloadRequest = new DownloadFileRequest(file, myStorage);

Stream downloadResponse = fileApi.DownloadFile(downloadRequest);
using (var fileStream = File.Create("C:\\Files\\sample_input.pdf"))
{
    downloadResponse.Seek(0, SeekOrigin.Begin);
    downloadResponse.CopyTo(fileStream);
}

ลองออนไลน์

โปรดลองใช้เครื่องมือจัดการข้อมูลเมตา PDF ออนไลน์ฟรีต่อไปนี้ ซึ่งพัฒนาโดยใช้ API ข้างต้น

https://products.groupdocs.app/metadata/pdf

บทสรุป

ในบทความนี้ คุณได้เรียนรู้วิธีแก้ไข Metadata ของเอกสาร PDF บนคลาวด์ บทความนี้ยังอธิบายวิธีการอัปโหลดไฟล์ PDF บนระบบคลาวด์โดยทางโปรแกรม จากนั้นดาวน์โหลดไฟล์ที่อัปเดตจากระบบคลาวด์ คุณสามารถเรียนรู้เพิ่มเติมเกี่ยวกับ GroupDocs.Metadata Manipulation Cloud API โดยใช้ เอกสารประกอบ เรายังมีส่วน API Reference ที่ช่วยให้คุณแสดงภาพและโต้ตอบกับ API ของเราได้โดยตรงผ่านเบราว์เซอร์ ในกรณีที่มีความคลุมเครือ โปรดติดต่อเราได้ที่ ฟอรัม

ดูสิ่งนี้ด้วย

• จัดการ Metadata ของเอกสารโดยใช้ Java & .NET