Metadata dokumen adalah informasi tentang dokumen seperti penulis, waktu pengeditan, dll. Yang disimpan di dalam dokumen. Sebagai pengembang C#, Anda dapat dengan mudah mengedit informasi metadata untuk dokumen PDF secara terprogram di cloud. Pada artikel ini, Anda akan mempelajari cara mengedit Metadata file PDF menggunakan REST API di C#.
Topik-topik berikut akan dibahas dalam artikel ini:
Dokumen Metadata Manipulasi REST API dan .NET SDK
Untuk mengedit metadata dokumen PDF, saya akan menggunakan .NET SDK of GroupDocs.Metadata Cloud API. Ini memungkinkan Anda untuk menambah, mengedit, mengambil, dan menghapus metadata dari hampir semua format file standar industri. Anda dapat melakukan operasi seperti itu pada PDF, Microsoft Word, spreadsheet Excel, presentasi PowerPoint, email Outlook, Visio, OneNote, Proyek, audio, video, AutoCAD, arsip, JPEG, BMP, PNG, dan TIFF. Ini juga menyediakan Java SDK sebagai anggota keluarga manipulasi metadata dokumen untuk Cloud API.
Anda dapat menginstal GroupDocs.Metadata Cloud SDK untuk .NET ke proyek Visual Studio Anda dari manajer Paket NuGet seperti yang ditunjukkan di bawah ini:
Instal GroupDocs.Metadata Cloud melalui NuGet Package Manager
Anda juga dapat menginstal Paket NuGet menggunakan perintah berikut di konsol Package Manager:
Install-Package GroupDocs.Metadata-Cloud
Dapatkan ID Klien dan Rahasia Klien Anda dari dashboard sebelum Anda mulai mengikuti langkah-langkah dan contoh kode yang tersedia. Setelah Anda memiliki ID klien dan Rahasia, tambahkan kode seperti yang ditunjukkan di bawah ini:
string clientID = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string myStorage = "";
Configuration configuration = new Configuration(clientID, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
Edit Metadata File PDF menggunakan REST API di C#
Anda dapat mengatur metadata dokumen PDF dengan mengikuti langkah-langkah sederhana yang diberikan di bawah ini:
- Unggah file PDF ke Cloud
- Perbarui Metadata Dokumen PDF menggunakan C#
- Unduh file yang dihasilkan
Unggah Dokumen
Pertama, unggah file PDF ke Cloud menggunakan contoh kode yang diberikan di bawah ini:
# inisialisasi 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();
}
Hasilnya, file PDF yang diunggah (input.pdf) akan tersedia di bagian file dasbor Anda di cloud.
Perbarui Metadata File PDF menggunakan C#
Anda dapat memperbarui metadata file PDF secara terprogram dengan mengikuti langkah-langkah di bawah ini.
- Buat instance MetadataApi
- Tetapkan jalur file PDF dalam model FileInfo
- Tentukan SetOptions
- Berikan NewValue dan Type untuk SetPropert
- Tentukan SearchCriteria, berikan NameOptions untuk memperbarui nilainya
- Buat SetRequest dengan SetOptions
- Dapatkan hasil dengan memanggil metode MetadataApi.Set().
Contoh kode berikut menunjukkan cara menyetel metadata menurut nama properti dokumen PDF menggunakan REST API.
# inisialisasi api
var apiInstance = new MetadataApi(configuration);
try
{
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
FilePath = "input.pdf",
StorageName = myStorage
};
// Tentukan Opsi Setel
var options = new SetOptions
{
FileInfo = fileInfo,
Properties = new List<SetProperty>
{
new SetProperty
{
NewValue = "hello",
Type = "String",
SearchCriteria = new SearchCriteria
{
NameOptions = new NameOptions
{
Value = "Keywords"
}
},
}
}
};
// Tentukan Setel Permintaan
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);
}
Tetapkan Metadata berdasarkan Nama Properti
Cuplikan kode berikut menunjukkan cara mencocokkan nama properti persis dengan menyetel properti ExactPhrase ke True:
# inisialisasi api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
FilePath = "input.pdf",
StorageName = myStorage
};
// Tentukan Opsi Setel
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
}
}
},
}
}
};
// Tentukan Setel Permintaan
var request = new SetRequest(options);
var response = apiInstance.Set(request);
Tetapkan Metadata dengan Mencocokkan Nama Properti yang Tepat
Cuplikan kode berikut menunjukkan cara menentukan kriteria pencarian menggunakan Ekspresi reguler untuk menyediakan MatchOptions:
# inisialisasi api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
FilePath = "input.pdf",
StorageName = myStorage
};
// Tentukan Opsi Setel
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
}
}
},
}
}
};
// Tentukan Setel Permintaan
var request = new SetRequest(options);
var response = apiInstance.Set(request);
Tetapkan Metadata dengan Mencocokkan Nama Properti dengan Ekspresi Reguler
Cuplikan kode berikut menunjukkan cara memperbarui metadata dengan memberikan nilai properti:
# inisialisasi api
var apiInstance = new MetadataApi(configuration);
var fileInfo = new GroupDocs.Metadata.Cloud.Sdk.Model.FileInfo
{
FilePath = "input.pdf",
StorageName = myStorage
};
// Tentukan Opsi Setel
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"
}
},
}
}
};
// Tentukan Setel Permintaan
var request = new SetRequest(options);
var response = apiInstance.Set(request);
Tetapkan Metadata dengan Mencocokkan Nilai Properti
Unduh File yang Diperbarui
Contoh kode di atas akan menyimpan file PDF yang diperbarui di cloud dan dapat diunduh menggunakan contoh kode berikut:
# inisialisasi 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);
}
Coba Daring
Silakan coba alat manipulasi Metadata PDF online gratis berikut, yang dikembangkan menggunakan API di atas.
https://products.groupdocs.app/metadata/pdf
Kesimpulan
Pada artikel ini, Anda telah mempelajari cara mengedit Metadata dokumen PDF di cloud. Artikel ini juga menjelaskan cara mengunggah file PDF secara terprogram di cloud dan kemudian mengunduh file yang diperbarui dari cloud. Anda dapat mempelajari lebih lanjut tentang API Cloud Manipulasi GroupDocs.Metadata menggunakan dokumentasi. Kami juga menyediakan bagian Referensi API yang memungkinkan Anda memvisualisasikan dan berinteraksi dengan API kami secara langsung melalui browser. Jika ada ambiguitas, jangan ragu untuk menghubungi kami di forum.