Bagikan melalui

File SDK - Memproses file .msg email (C#)

  • Artikel

File SDK mendukung operasi pelabelan untuk file .msg dengan cara yang identik dengan jenis file lainnya, kecuali bahwa SDK memerlukan aplikasi untuk mengaktifkan bendera fitur MSG. Di sini, kita akan melihat cara mengatur bendera ini.

Seperti yang dibahas sebelumnya, instansiasi IFileEngine memerlukan objek pengaturan, FileEngineSettings. FileEngine Pengaturan dapat digunakan untuk meneruskan parameter untuk pengaturan kustom yang perlu diatur aplikasi untuk instans tertentu. CustomSettings properti digunakan FileEngineSettings untuk mengatur bendera untuk enable_msg_file_type mengaktifkan pemrosesan file .msg.

Prasyarat

Jika Anda belum melakukannya, pastikan untuk menyelesaikan prasyarat berikut sebelum melanjutkan:

Atur enable_msg_file_type dan gunakan File SDK untuk pelabelan file .msg

Dalam kelanjutan mulai cepat inisialisasi aplikasi File API, ubah kode konstruksi mesin file untuk diatur enable_msg_file_type flag lalu gunakan mesin file untuk memberi label file .msg.

  1. Buka solusi Visual Studio yang Anda buat di "Mulai Cepat: Inisialisasi aplikasi SDK File (C#)" sebelumnya.

  2. Dengan menggunakan Penjelajah Solusi, buka file .cs dalam proyek Anda yang berisi implementasi Main() metode . Ini default ke nama yang sama dengan proyek yang berisinya, yang Anda tentukan selama pembuatan proyek.

  3. Hapus implementasi Main() fungsi dari mulai cepat sebelumnya. Di dalam isi Main() , masukkan kode berikut. Di bawah bendera blok enable_msg_file_type kode diatur selama pembuatan mesin file, file .msg kemudian dapat diproses oleh IFileHandler objek yang dibuat menggunakan mesin file.

    static void Main(string[] args)
{
    // Initialize Wrapper for File SDK operations.
    MIP.Initialize(MipComponent.File);

    // Create ApplicationInfo, setting the clientID from Azure AD App Registration as the ApplicationId.
    ApplicationInfo appInfo = new ApplicationInfo()
    {
            ApplicationId = clientId,
            ApplicationName = appName,
            ApplicationVersion = "1.0.0"
    };

    // Instantiate the AuthDelegateImpl object, passing in AppInfo.
    AuthDelegateImplementation authDelegate = new AuthDelegateImplementation(appInfo);

    MipContext mipContext = MIP.CreateMipContext(appInfo,"mip_data",LogLevel.Trace,null,null);

    // Initialize and instantiate the File Profile.
    // Create the FileProfileSettings object.
    // Initialize file profile settings to create/use local state.
    var profileSettings = new FileProfileSettings(mipContext, 
                                CacheStorageType.OnDiskEncrypted, 
                                new ConsentDelegateImplementation());

    // Load the Profile async and wait for the result.
    var fileProfile = Task.Run(async () => await MIP.LoadFileProfileAsync(profileSettings)).Result;

    // Create a FileEngineSettings object, then use that to add an engine to the profile.
    var customSettings = new List<KeyValuePair<string, string>>();
    customSettings.Add(new KeyValuePair<string, string>("enable_msg_file_type", "true"));

    // Create a FileEngineSettings object, then use that to add an engine to the profile.
    var engineSettings = new FileEngineSettings("user1@tenant.com", authDelegate, "", "en-US");
    engineSettings.Identity = new Identity("user1@tenant.com");
    //set custom settings for the engine
    engineSettings.CustomSettings = customSettings;

    //Add fileEngine to profile
    var fileEngine = Task.Run(async () => await fileProfile.AddEngineAsync(engineSettings)).Result;

    //Set file paths
    string inputFilePath = "<input-file-path>"; //.msg file to be labeled
    string actualFilePath = inputFilePath;
    string outputFilePath = "<output-file-path>"; //labeled .msg file
    string actualOutputFilePath = outputFilePath;

    //Create a file handler for original file
    var fileHandler = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(inputFilePath, 
                                                                actualFilePath, 
                                                                true)).Result;

    // List labels available to the user and use one of them to label the MSG file.

    foreach (var label in fileEngine.SensitivityLabels)
    {
        Console.WriteLine(string.Format("{0} - {1}", label.Name, label.Id));

        if (label.Children.Count > 0)
        {
            foreach (Label child in label.Children)
            {
                Console.WriteLine(string.Format("\t{0} - {1}", child.Name, child.Id));
            }
        }
    }

    string labelId = "<label-id>"; //label retrieved using file engine

    LabelingOptions labelingOptions = new LabelingOptions()
    {
        AssignmentMethod = options.AssignmentMethod
    };

    fileHandler.SetLabel(labelId, labelingOptions, new ProtectionSettings());

    // Commit changes, save as outputFilePath
    var result = Task.Run(async () => await fileHandler.CommitAsync(outputFilePath)).Result;

    // Create a new handler to read the labeled file metadata
    var handlerModified = Task.Run(async () => await fileEngine.CreateFileHandlerAsync(outputFilePath, 
                                                                    actualOutputFilePath, 
                                                                    true)).Result;

    Console.WriteLine(string.Format("Original file: {0}", inputFilePath));
    Console.WriteLine(string.Format("Labeled file: {0}", outputFilePath));
    Console.WriteLine(string.Format("Label applied to file: {0}", 
        handlerModified.Label.Name));
    Console.WriteLine("Press a key to continue.");
    Console.ReadKey();

    // Application Shutdown
    fileHandler = null;
    handlerModified = null;
    fileEngine = null;
    fileProfile = null;
    mipContext = null;
}

    Untuk detail lebih lanjut tentang operasi file, lihat konsep File Handler.

  4. Ganti nilai tempat penampung dalam kode sumber menggunakan nilai berikut:

    Placeholder Nilai
    <input-file-path> Jalur lengkap ke file pesan input pengujian, misalnya: c:\\Test\\message.msg.
    <output-file-path> Jalur lengkap ke file output, yang akan menjadi salinan berlabel file input, misalnya: c:\\Test\\message_labeled.msg.
    <label-id> LabelId yang diambil menggunakan mesin file, misalnya: 667466bf-a01b-4b0a-8bbf-a79a3d96f720.

Membangun dan menguji aplikasi

Gunakan F6 (Build Solution) untuk membangun aplikasi klien Anda. Jika Anda tidak memiliki kesalahan build, gunakan F5 (Mulai penelusuran kesalahan) untuk menjalankan aplikasi Anda.

    Original file: C:\Test.msg
    Labeled file: C:\Test_Labeled.msg
    Label applied to file: Confidential    
    Press a key to continue.