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

File SDK mendukung operasi pelabelan untuk file .msg dengan cara yang sama seperti jenis file lainnya, kecuali bahwa SDK memerlukan aplikasi untuk mengaktifkan bendera fitur MSG. Panduan singkat ini menjelaskan cara menetapkan flag ini.

Seperti yang telah dibahas sebelumnya, menginstansiasi IFileEngine memerlukan objek pengaturan FileEngineSettings. Aplikasi ini menggunakan FileEngineSettings untuk meneruskan pengaturan kustom untuk instans tertentu. Properti CustomSettings dari FileEngineSettings menetapkan flag enable_msg_file_type untuk mengaktifkan pemrosesan berkas .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

Sebagai kelanjutan dari panduan mulai cepat inisialisasi aplikasi File API, ubah kode pembuatan file engine untuk menetapkan enable_msg_file_type flag, lalu gunakan file engine untuk memberi label pada file .msg.

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

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

  3. Hapus implementasi fungsi Main() dari panduan memulai cepat sebelumnya. Di dalam Main() badan, masukkan kode berikut. Dalam blok kode berikut, pembuatan engine file menetapkan bendera enable_msg_file_type. IFileHandler objek yang dibuat dengan menggunakan mesin file kemudian dapat memproses file .msg.

    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);

    MipConfiguration mipConfiguration = new MipConfiguration(appInfo, "mip_data", LogLevel.Trace, false, CacheStorageType.OnDiskEncrypted);
    MipContext mipContext = MIP.CreateMipContext(mipConfiguration);

    // 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 = AssignmentMethod.Standard
    };

    Label label = fileEngine.GetLabelById(labelId);
    fileHandler.SetLabel(label, 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.Label.Name));
    Console.WriteLine("Press a key to continue.");
    Console.ReadKey();

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

    Untuk informasi selengkapnya tentang operasi file, lihat Konsep File Handler.

  4. Ganti nilai placeholder dalam kode sumber dengan nilai berikut:

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

Membangun dan menguji aplikasi

Gunakan F6 (Bangun Solusi) 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.
  • Last updated on