Ще одна новина для Cloud Developers! GroupDocs запустила Document Metadata Manipulation Cloud API. Це збагачує рішення для керування метаданими документів GroupDocs. Рішення вже використовується розробниками .NET і Java як локальні API для розробників і як безкоштовний онлайн-додаток для редагування метаданих документів для перегляду та редагування метаданих документів будь-якими користувачами.
Хмарний API для обробки метаданих
GroupDocs.Metadata Cloud API разом із пакетами SDK, які дозволяють розробникам маніпулювати (додавати, видаляти, оновлювати, видобувати та переглядати) метадані понад 50 форматів файлів.
GroupDocs.Metadata дозволяє отримувати доступ до метаданих файлів і працювати з ними різними способами, наприклад:
- Можлива назва тегу
- Назва власності
- Вартість власності
- Точна відповідність фразі
- Збіг з регулярним виразом
- Повне дерево метаданих
- Тег
Щоб отримати набагато краще уявлення про функції та продукт, ви завжди можете відвідати посібник розробника в розділі документація.
Підтримувані формати документів
Ви можете виконувати операції з документами, якими можуть бути будь-які документи текстового процесора, електронні таблиці, презентації, аудіо- та відеофайли, зображення, PDF, електронні книги, малюнки та багато іншого. Нижче наведено формати файлів, які наразі підтримуються API GroupDocs і, сподіваємося, відповідатимуть вашим вимогам. Ви можете будь-коли переглянути документацію, щоб дізнатися про всі підтримувані формати документів або будь-які вказівки.
Метадані – SDK і зразки
Разом із REST API для редагування метаданих для Cloud GroupDocs також надає SDK з відкритим кодом, тому їх можна самостійно налаштувати відповідно до вимог. Розробники можуть використовувати cURL для взаємодії з GroupDocs.Metadata Cloud API, а також можуть використовувати відповідні пакети SDK для прискорення розробки. Це допомагає розробникам перестати турбуватися про низькорівневі деталі створення запиту та обробки відповідей. Згадані нижче SDK разом із прикладами коду доступні на GitHub:
У цьому блозі. Я використовую код Java, щоб показати, як грати з властивостями метаданих документів. Далі я покажу лише один із способів вилучення, додавання, видалення та зміни метаданих. Ви також можете детально переглянути приклади C# та інші способи в документації та відповідних репозиторіях GitHub.
Видобуток метаданих із файлів у Java або .NET
API дозволяє видобувати метадані ваших документів за допомогою різних параметрів, зокрема вилучення:
- Усе дерево властивостей метаданих
- За вказаним тегом, назвою або значенням
Для вашої допомоги приклади роботи доступні на GitHub. Я завантажив приклад groupdocs.app, який показує, скільки ви можете видобувати та створювати власні програми метаданих за допомогою C# та Java.
Витягніть ціле дерево властивостей метаданих у Java
Після встановлення з’єднання з вашим хмарним сховищем ви можете витягти все дерево властивостей метаданих за допомогою кількох згаданих нижче рядків коду. Тут я видобуваю дерево властивостей електронної таблиці Excel за допомогою Java SDK для хмари. Ви можете легко досягти цього за допомогою будь-якого іншого доступного SDK.
// Set File Path
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents"+ File.separator +"input.xlsx");
// Set Options to extract the metadata from any file.
ExtractOptions options = new ExtractOptions();
options.setFileInfo(fileInfo);
// Send a Request with options to extract metadata and received the response.
ExtractRequest request = new ExtractRequest(options);
ExtractResult response = apiInstance.extract(request);
Друк цілого дерева метаданих у Java
// That's it. You have received the whole Metadata Tree. Now you can use it the way you like.
for (MetadataProperty entry : response.getMetadataTree().getInnerPackages().get(0).getPackageProperties()){
System.out.println("\\n" + entry.getName() + ": " + entry.getValue());
if (entry.getTags() == null)
continue;
// Print Tags
for (Tag tagItem : entry.getTags()) {
System.out.println("=== Tag for Property ===");
System.out.println("Name :" + tagItem.getName());
System.out.println("Category: " + tagItem.getCategory());
}
}
Вихід
FileFormat: 2
=== Tag for Property ===
Name :FileFormat
Category: Content
MimeType: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
=== Tag for Property ===
Name :FileFormat
Category: Content
SpreadsheetFileFormat: 3
=== Tag for Property ===
Name :FileFormat
Category: Content
Усі інші різні способи вилучення метаданих можна побачити на будь-якому з наступних ресурсів:
- Документація
- Приклади C# для вилучення метаданих - GitHub
- Приклади Java для вилучення метаданих - GitHub
Додайте метадані за допомогою Java або .NET
REST API метаданих GroupDocs дозволяє додавати метадані до документів із такими функціями:
- Властивості метаданих можуть містити різні типи значень, наприклад String, DateTime, Integer, Double, Boolean
- Властивості можна додавати різними способами:
- Додати властивість метаданих за назвою:
- Частина імені
- Точна фраза
- Збіг регулярного виразу
- Додати властивість метаданих за тегом:
- Точний тег
- Можлива назва тегу
- Додати властивість метаданих за назвою:
Додайте властивість метаданих за точним тегом у Java
Нижче ви можете побачити приклад вихідного коду для додавання властивості метаданих за допомогою точного тегу:
AddOptions options = new AddOptions();
ArrayList<AddProperty> properties = new ArrayList<AddProperty>();
AddProperty property = new AddProperty();
SearchCriteria searchCriteria = new SearchCriteria();
TagOptions tagOptions = new TagOptions();
// Set Tag name and category
Tag tag = new Tag();
tag.setName("Printed");
tag.setCategory("Time");
// Set Tag
tagOptions.setExactTag(tag);
searchCriteria.setTagOptions(tagOptions);
//Set Date for Value
Date date = new Date();
DateFormat dateFormat = new SimpleDateFormat("MM-dd-yyyy hh:mm:ss");
// Setting the Add Property
property.setSearchCriteria(searchCriteria);
property.setValue(dateFormat.format(date));
property.setType("datetime");
properties.add(property);
// Set Properties of AddOptions
options.setProperties(properties);
// Select the document to add metadata property
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Sending the request and fetch response after adding the metadata property
AddRequest request = new AddRequest(options);
AddResult response = apiInstance.add(request);
// Printing the Changes Count and Path of changed file.
System.out.println("Count of changes: " + response.getAddedCount());
System.out.println("Resultant file path: " + response.getPath());
Результат: після додавання метаданих за тегом
Count of changes: 1
Resultant file path: metadata/add\_metadata/documents/input\_docx/input.docx
Усі інші різні способи додавання метаданих можна побачити на будь-якому з наступних ресурсів:
Видаліть метадані за допомогою Java або .NET
Майже з аналогічними параметрами додавання властивостей метаданих ви також можете видалити властивості метаданих зі своїх документів.
- Властивості метаданих можуть містити різні типи значень, наприклад String, DateTime, Integer, Double, Boolean.
- Властивості метаданих можна видалити/видалити такими різними способами:
- Видалити властивість метаданих за назвою:
- Частина імені
- Точна фраза
- Зіставлення регулярного виразу
- Видалити властивість метаданих за тегом:
- Точний тег
- Можлива назва тегу
- Видалити властивість метаданих за назвою:
Видалення метаданих за допомогою регулярного виразу (Regex) у Java
Нижче ви можете побачити приклад вихідного коду для видалення властивостей метаданих, які відповідають наданому регулярному виразу:
// Name Options
NameOptions nameOptions = new NameOptions();
nameOptions.setValue("^\[N\]ame\[A-Z\].\*");
// Match Options
MatchOptions matchOptions = new MatchOptions();
matchOptions.setIsRegex(true);
nameOptions.setMatchOptions(matchOptions);
// Remove Metadata Options and Search Criteria
RemoveOptions options = new RemoveOptions();
SearchCriteria searchCriteria = new SearchCriteria();
// Search Criteria
searchCriteria.setNameOptions(nameOptions);
options.setSearchCriteria(searchCriteria);
// Set fileInfo for the source document
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.docx");
options.setFileInfo(fileInfo);
// Send request to remove and receive the response
RemoveRequest request = new RemoveRequest(options);
RemoveResult response = apiInstance.remove(request);
// In response, you can get the path of the updated document with the removed properies.
System.out.println("Count of changes: " + response.getRemovedCount());
System.out.println("Resultant file path: " + response.getPath());
Результат: після видалення метаданих регулярним виразом
Count of changes: 1
Resultant file path: metadata/remove\_metadata/documents/input\_docx/input.docx
Усі інші різні способи видалення метаданих можна побачити на будь-якому з наступних ресурсів:
- Документація
- Приклади C# для видалення метаданих - GitHub
- Приклади Java для видалення метаданих - GitHub
Оновіть метадані за допомогою Java або .NET
Окрім додавання, видалення та вилучення метаданих, REST API дозволяє різними способами оновлювати наявні властивості метаданих. Нижче я покажу, як можна оновити властивість метаданих будь-якого документа за допомогою коду Java, вказавши можливу назву тегу властивості. Я використав електронну таблицю Excel, щоб оновити її тег метаданих творця. Ви можете досягти того ж у C# за допомогою .NET API.
Оновіть метадані за можливою назвою тегу за допомогою Java
SetOptions options = new SetOptions();
ArrayList<SetProperty> properties = new ArrayList<SetProperty>();
SetProperty property = new SetProperty();
SearchCriteria searchCriteria = new SearchCriteria();
// Set Tag Options and Possible Tag Name
TagOptions tagOptions = new TagOptions();
tagOptions.setPossibleName("creator");
searchCriteria.setTagOptions(tagOptions);
//Set the new Value and Type and then add the property
property.setSearchCriteria(searchCriteria);
property.setNewValue("GroupDocs");
property.setType("string");
properties.add(property);
options.setProperties(properties);
// Select the file to update its metadata properties
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("documents/input.xlsx");
options.setFileInfo(fileInfo);
// Send Request and catch the Response
SetRequest request = new SetRequest(options);
SetResult response = apiInstance.set(request);
// Print the Response Fields
System.out.println("Changes count: " + response.getSetCount());
System.out.println("Resultant file path: " + response.getPath());
Результат: після зміни метаданих за допомогою можливої назви тегу
Count of changes: 1
Resultant file path: metadata/set\_metadata/documents/input\_xlsx/input.xlsx
Ви можете завантажити оновлений документ зі шляху, указаного у відповіді. Крім того, ви можете оновити наявні властивості подібними способами, як-от додавання та видалення метаданих. Приклади та пояснення можна переглянути на наступних ресурсах GroupDocs.Metadata Cloud API.
Давай поговоримо
Це короткий огляд GroupDocs.Metadata Cloud API. Тепер ви можете створювати власну програму, використовуючи вищезазначені функції. Ми будемо раді, якщо ви зв’яжетеся з нами на форумі, щоб обговорити, вирішити проблему або поділитися своїм відгуком. Дякую.