Спрос на эффективные решения для управления документами продолжает расти в геометрической прогрессии. В этой статье мы подробно рассмотрим преимущества и практическое применение использования .NET Cloud API для преобразования HTML в PDF. От оптимизации рабочих процессов до обеспечения совместимости между различными платформами — узнайте, как эта функция может значительно повысить производительность и упростить задачи управления документами.
В этой статье рассматриваются следующие темы:
- API преобразования HTML в PDF
- Преобразование HTML в PDF с помощью C# .NET
- Преобразование HTML-файла в PDF с помощью команд cURL
API преобразования HTML в PDF
Мы собираемся изучить надежные возможности GroupDocs.Conversion Cloud SDK для .NET и его ключевую роль в беспрепятственном выполнении требований преобразования HTML в PDF. Поскольку предприятия и разработчики ищут эффективные решения для управления документами, этот API становится мощным инструментом, предлагающим беспрецедентную простоту и универсальность. Давайте углубимся в то, как этот пакет SDK для преобразования позволяет легко конвертировать HTML-файлы в формат PDF, что упрощает рабочие процессы и повышает производительность.
Теперь, чтобы использовать SDK, первым шагом является его установка. Просто найдите GroupDocs.Conversion-Cloud в диспетчере пакетов NuGet и нажмите кнопку «Установить». Другой вариант — выполнить следующую команду в консоли диспетчера пакетов.
NuGet\Install-Package GroupDocs.Conversion-Cloud -Version 24.2.0
После успешной установки REST API убедитесь, что у вас есть учетные данные API (т. е. идентификатор клиента и секрет клиента).Вы можете посетить это короткое руководство, чтобы узнать, как получить учетные данные API.
Преобразование HTML в PDF с помощью C# .NET
В этом разделе мы подробно рассмотрим, как программно конвертировать HTML в PDF с помощью C# .NET.
- Создайте экземпляр класса «Конфигурация», куда мы передаем учетные данные клиента в качестве аргументов.
var configurations = new Configuration(clientId, clientSecret1);
- Инициализируйте ConvertApi, куда мы передаем объект конфигурации в качестве входного аргумента.
var apiInstance = new ConvertApi(configurations);
- Загрузите входной HTML-файл в облачное хранилище, где мы предоставим имя входному HTML-файлу.
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
- Создайте экземпляр ConvertSettings, в котором мы укажем имя входного HTML, выходной формат как «pdf» и имя результирующего PDF-документа.
var settings = new ConvertSettings{...}
- Вызовите API ConvertDocumentRequest для преобразования HTML в формат PDF. После успешного преобразования полученный PDF-файл сохраняется в облачном хранилище.
var response = apiInstance.ConvertDocument(new ConvertDocumentRequest(settings));
// Дополнительные примеры можно найти на https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-dotnet.
// Получите учетные данные API
string clientId = "4bdefca3-f08c-4088-9ca0-55c38f4b7f22";
string clientSecret1 = "a43c8b4365246a062688a259abe5b469";
// Создайте экземпляр класса Configuration и инициализируйте его с помощью идентификатора клиента и секрета клиента.
var configurations = new GroupDocs.Conversion.Cloud.Sdk.Client.Configuration(clientId, clientSecret1);
// Определите значение ApiBaseUrl, чтобы установить базовый URL-адрес API конвертера HTML в PDF.
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";
// Инициализируйте экземпляр класса ConvertApi с помощью объекта класса Configuration.
var apiInstance = new GroupDocs.Conversion.Cloud.Sdk.Api.ConvertApi(configurations);
// загрузить HTML-файл с локального диска
using (var stream = System.IO.File.OpenRead("converted.html"))
{
// создать экземпляр FileApi
var fileUpload = new FileApi(configurations);
// загрузить входной HTML-файл в облачное хранилище
fileUpload.UploadFile(new UploadFileRequest("input.html", stream));
// создайте ConvertSettings, где мы определим входной HTML и имя результирующего PDF-файла.
var settings = new ConvertSettings
{
StorageName = "internal",
FilePath = "input.html",
Format = "pdf",
OutputPath = "resultant.pdf"
};
// Вызовите метод ConvertDocument для программного преобразования HTML в PDF.
var response = apiInstance.ConvertDocument(new GroupDocs.Conversion.Cloud.Sdk.Model.Requests.ConvertDocumentRequest(settings));
if (response != null && response.Equals("OK"))
{
// распечатать сообщение об успехе
Console.WriteLine("HTMl to PDF conversion completed successfully !");
}
}
Образец PDF-файла, созданный в приведенном выше примере, можно загрузить с сайта resultant.pdf.
HTML в PDF с помощью команд cURL
Другой вариант преобразования HTML в PDF — это комбинация команд GroupDocs.Conversion Cloud и cURL. Преобразование HTML в PDF с помощью GroupDocs.Conversion Cloud с помощью команд cURL предлагает несколько заметных преимуществ, таких как плавный и простой метод преобразования файлов HTML в формат PDF, устраняющий необходимость в сложных ручных процессах. Таким образом, используя Cloud API GroupDocs.Conversion, пользователи могут автоматизировать процесс преобразования, экономя время и усилия при выполнении повторяющихся задач.
Убедитесь, что вы получили свои учетные данные API (ключ приложения и идентификатор безопасности приложения) на панели мониторинга GroupDocs и сгенерировали токен доступа JWT. Как только у нас будет токен JWT, выполните следующую команду cURL, где мы также предоставили свойства для текстового водяного знака, который будет добавлен во время этого процесса преобразования.
curl -v "https://api.groupdocs.cloud/v2.0/conversion" \
-X POST \
-H "accept: application/json" \
-H "authorization: Bearer {accessToken}" \
-H "Content-Type: application/json" \
-d "{ \"StorageName\": \"internal\", \"FilePath\": \"{sourceFile}\", \"Format\": \"pdf\", \"LoadOptions\": { \"Format\": \"html\" }, \"ConvertOptions\": { \"FromPage\": 1, \"PagesCount\": 1, \"Pages\": [ 1 ], \"WatermarkOptions\": { \"Text\": \"GroupDocs.Cloud\", \"FontName\": \"Arial\", \"FontSize\": 4, \"Bold\": false, \"Italic\": true, \"Color\": \"olive\", \"Width\": 10, \"Height\": 6, \"Top\": 100, \"Left\": 100, \"RotationAngle\": 10, \"Transparency\": 0.8, \"Background\": true, \"AutoAlign\": true } }, \"OutputPath\": \"{converted}\"}"
Замените sourceFile
на имя входного HTML-файла, resultantFile
на имя выходного формата PDF, который нужно сгенерировать, а accessToken
на токен JWT, сгенерированный выше.
Бесплатное приложение для преобразования HTML в PDF
На основе API GroupDocs.Conversion Cloud мы разработали онлайн-конвертер HTML в PDF]14. Это бесплатный, легкий, сверхэффективный инструмент, обеспечивающий надежное преобразование HTML в PDF.
Полезные ссылки
Заключение
Мы узнали, что GroupDocs.Conversion Cloud предлагает комплексное, эффективное и надежное решение задач преобразования документов, позволяющее оптимизировать рабочие процессы и повысить производительность. Таким образом, автоматизируя процесс преобразования и обеспечивая согласованность и точность результатов, GroupDocs.Conversion Cloud API упрощает сложные задачи и экономит драгоценное время и ресурсы. Поэтому независимо от того, являетесь ли вы разработчиком, желающим интегрировать возможности преобразования документов в свои приложения, или бизнесом, стремящимся оптимизировать процессы управления документами, наши API предоставляют инструменты, необходимые для достижения успеха.
Статьи по Теме
Мы настоятельно рекомендуем посетить следующие ссылки, чтобы узнать больше о: