Làm việc với tài liệu được lưu trữ trong `SharePoint` trực tuyến

Microsoft SharePoint Online là tập hợp các công nghệ dựa trên web giúp các tổ chức dễ dàng lưu trữ, chia sẻ và quản lý thông tin kỹ thuật số. Bạn có thể làm việc với các tài liệu được lưu trữ trong thư mục “Tài liệu được chia sẻ” trong SharePoint bằng cách sử dụng Aspose.Words mạnh mẽ cho .NET của chúng tôi.

Trong bài viết này, chúng tôi sẽ đề cập đến một tình huống phổ biến để chuyển đổi tài liệu được tải lên thư mục “Tài liệu được chia sẻ” sang định dạng PDF và tải tài liệu thu được trở lại thư mục.

cài sẵn

Tham gia Chương trình dành cho nhà phát triển Microsoft 365
Thiết lập hộp cát tức thì theo video hướng dẫn
Tạo thông tin xác thực dựa trên ứng dụng cho SharePoint Online như chi tiết trong Thiết lập hiệu trưởng chỉ dành cho ứng dụng với quyền của người thuê
Tải tài liệu có tên “TestDoc.docx” lên trang liên lạc gốc vào thư mục “Tài liệu được chia sẻ”
Mua giấy phép Aspose.Words hoặc sử dụng Cấp phép và đăng ký

Lưu ý rằng Nếu bạn đã có trang liên lạc gốc SharePoint Online thì hãy bỏ qua các bước 1-2.

Tạo ứng dụng Console

Để đánh giá cách Aspose.Words cho .NET hoạt động với tài liệu SharePoint, bạn cần tạo một ứng dụng bảng điều khiển với các cài đặt phù hợp và triển khai logic để tải xuống tài liệu từ thư mục “Tài liệu được chia sẻ”, xử lý tài liệu đó rồi tải tệp này lên cùng thư mục. Để thực hiện việc này, hãy làm theo hướng dẫn được mô tả trong phần này.

Để thực hiện hướng dẫn, bạn cần tìm và sửa giá trị của các tham số sau, giá trị này sẽ có sau khi hoàn thành các bước trong phần “Đặt trước”:

Mã định danh người thuê nhà – xem cách tìm id người thuê nhà của bạn
Tên người thuê nhà
Mã định danh khách hàng
Bí mật của khách hàng

Lưu ý rằng bí mật khách hàng và mã định danh khách hàng phải được tạo ở bước 3 của phần “Đặt trước”.

Tạo một dự án ứng dụng bảng điều khiển mới

Để tạo một dự án ứng dụng bảng điều khiển mới, hãy làm theo các bước sau:

Trong Visual Studio, tạo một dự án ứng dụng bảng điều khiển mới có tên “SPOnlineExample” cho ngôn ngữ C# và khung đích .NET 6
Thêm các gói sau:
- Microsoft.Extensions.Configuration.Json
- Aspose.Words

Thêm tập tin cấu hình

Để thêm tập tin cấu hình, hãy làm theo các bước sau:

Thêm tệp “appsinstall.json” vào dự án;

Thêm nội dung sau vào file: JSON

{
  "TenantId": "Your tenant id.",
  "TenantName": "Your tenant name.",

  "ClientSecret": "App client secret.",
  "ClientId": "App client id.",

  "AsposeWordsLicensePath": "Path to your Aspose.Words license."
}

Hoàn thành các trường với giá trị tùy chỉnh của bạn.

Thêm ứng dụng khách API REST trực tuyến SharePoint

Tạo một tệp “SPOClient.cs” trong dự án và điền vào nó nội dung sau:

.NET

using System.Net.Http.Json;
using System.Net.Http.Headers;
using System.Security.Authentication;
using System.Text.Json.Serialization;
using Microsoft.Extensions.Configuration;

namespace SPOnlineExample
{
    /// <summary>
    /// Sharepoint online REST API client.
    /// </summary>
    internal class SPOClient
    {
        private readonly string authUrl;
        private readonly string clientId;
        private readonly string resource;
        private readonly string tenantId;
        private readonly HttpClient client;
        private readonly string tenantName;
        private readonly string clientSecret;

        private const string grandType = "client_credentials";
        private const string resourceId = "00000003-0000-0ff1-ce00-000000000000";
    
        // URL templates.
        private static readonly string authUrlTemplate = "https://accounts.accesscontrol.windows.net/{0}/tokens/OAuth/2";
        private static readonly string downloadfileTemplate = "https://{0}.sharepoint.com/_api/web/GetFileByServerRelativeUrl('{1}')/$value";
        private static readonly string uploadfileTemplate =
            "https://{0}.sharepoint.com/_api/web/GetFolderByServerRelativeUrl('{1}')/Files/add(url='{2}',overwrite=true)";
    
        // Access token.
        private string token = string.Empty;
    
        public SPOClient(IConfigurationRoot appConfig)
        {
            tenantId = appConfig[nameof(tenantId)];
            clientSecret = appConfig[nameof(clientSecret)];
            tenantName = appConfig[nameof(tenantName)];
    
            authUrl = string.Format(authUrlTemplate, tenantId);
            clientId = $"{appConfig[nameof(clientId)]}@{tenantId}";
            resource = $"{resourceId}/{tenantName}.sharepoint.com@{tenantId}";
    
            client = new HttpClient();
        }
    
        public async Task Authorize()
        {
            var formContent = new FormUrlEncodedContent(new[]
            {
                new KeyValuePair<string, string>("grant_type", grandType),
                new KeyValuePair<string, string>("client_id", clientId),
                new KeyValuePair<string, string>("client_secret", clientSecret),
                new KeyValuePair<string, string>("resource", resource)
            });
    
            var response = await client.PostAsync(authUrl, formContent);
            var responseData = await response.Content.ReadFromJsonAsync<AuthRespose>();
    
            if (!response.IsSuccessStatusCode || responseData == null)
                throw new AuthenticationException(responseData?.Description);
    
            token = responseData.Token;
        }
    
        public async Task<Stream> DownloadFile(string relativeFilePath)
        {
            var url = string.Format(downloadfileTemplate, tenantName, relativeFilePath);
            using var request = CreateRequest(url, HttpMethod.Get);
    
            var response = await client.SendAsync(request);
    
            if (!response.IsSuccessStatusCode)
            {
                var errorData = await response.Content.ReadAsStringAsync();
                throw new Exception(errorData);
            }
    
            var fileStream = await response.Content.ReadAsStreamAsync();
            return fileStream;
        }
    
        public async Task UploadFile(string relativeFolderPath, string fileName, Stream fileData)
        {
            var url = string.Format(uploadfileTemplate, tenantName, relativeFolderPath, fileName);
            using var request = CreateRequest(url, HttpMethod.Post);
    
            request.Headers.Add("IF-MATCH", "*"); // Overwrite any changes.
            request.Content = new StreamContent(fileData);
    
            var response = await client.SendAsync(request);
    
            if (!response.IsSuccessStatusCode)
            {
                var errorData = await response.Content.ReadAsStringAsync();
                throw new Exception(errorData);
            }
        }
    
        private HttpRequestMessage CreateRequest(string url, HttpMethod httpMethod)
        {
            var request = new HttpRequestMessage(httpMethod, url);
            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
    
            return request;
        }
    
        private class AuthRespose
        {
            public string Error { get; set; } = string.Empty;
    
            [JsonPropertyName("error_description")]
            public string Description { get; set; } = string.Empty;
    
            [JsonPropertyName("access_token")]
            public string Token { get; set; } = string.Empty;
        }
    }
}

Thêm logic kịch bản vào chương trình

Di chuyển nội dung sau vào tệp “Program.cs”:

.NET

using Aspose.Words;
using Aspose.Words.Saving;
using Microsoft.Extensions.Configuration;

namespace SPOnlineExample
{
    public static class Program
    {
        static async Task Main(string[] args)
        {
            // The example below downloads the file "testdoc.docx" from the shared documents folder.
            // Converts it to PDF and uploads conversion result to the same folder.

            var appConfig = GetAppConfig();
            var client = new SPOClient(appConfig);
    
            await client.Authorize();
            var fileStream = await client.DownloadFile("/Shared%20Documents/TestDoc.docx");
    
            var lic = new License();
            lic.SetLicense(appConfig["AsposeWordsLicensePath"]);
            var doc = new Document(fileStream);
    
            using var outputStream = new MemoryStream();
            var saveOptions = new PdfSaveOptions();
            doc.Save(outputStream, saveOptions);
    
            await client.UploadFile("/Shared%20Documents", "TestDoc.pdf", outputStream);
    
            Console.WriteLine("Done. Press any key to complete.");
            Console.ReadKey();
        }
    
        private static IConfigurationRoot GetAppConfig()
        {
            // Build configuration
            return JsonConfigurationExtensions.AddJsonFile(
                    new ConfigurationBuilder().SetBasePath(Directory.GetCurrentDirectory()),
                    "appsettings.json")
                .Build();
        }
    }
}

Thực hiện ví dụ đã tạo và kiểm tra kết quả

Cuối cùng, chạy ví dụ đã tạo và kiểm tra kết quả bạn nhận được:

Biên dịch dự án
Chạy ứng dụng console

Do đó, tệp “TestDoc.pdf” phải được đặt trong thư mục “Tài liệu được chia sẻ” của trang liên lạc gốc.

Xem thêm

Bài viết Kết xuất để biết thêm thông tin về định dạng trang cố định và bố cục theo luồng
Bài viết Chuyển đổi sang định dạng trang cố định để biết thêm thông tin về bố cục trang
Bài viết Chỉ định tùy chọn hiển thị khi chuyển đổi sang PDF để biết thêm thông tin về cách sử dụng lớp PdfSaveOptions

Tuần tự hóa tài liệu trong cơ sở dữ liệu Làm việc với tài liệu được đánh dấu bằng nhãn nhạy cảm