Dosya SDK'sı - E-posta .msg dosyalarını işleme (C#)

Dosya SDK'sı, .msg dosyaları için etiketleme işlemlerini diğer dosya türleriyle aynı şekilde destekler, ancak SDK'nın MSG özellik bayrağını etkinleştirmek için uygulamaya ihtiyacı vardır. Bu hızlı başlangıçta bu bayrağın nasıl ayarlanacağı gösterilmektedir.

Daha önce açıklandığı gibi, IFileEngine örneğini oluşturmak için FileEngineSettings ayar nesnesi gerekir. Uygulama, belirli bir örnek için özel ayarları iletmek üzere FileEngineSettings kullanır. CustomSettings öğesinin FileEngineSettings özelliği, .msg dosyalarının işlenmesini etkinleştirmek için enable_msg_file_type bayrağını ayarlar.

Önkoşullar

Henüz yapmadıysanız devam etmeden önce aşağıdaki önkoşulları tamamladığınızdan emin olun:

enable_msg_file_type ayarlama ve .msg dosyasını etiketlemek için Dosya SDK'sını kullanma

Dosya API’si uygulama başlatma hızlı başlangıç kılavuzunun devamı olarak, enable_msg_file_type flag değerini ayarlamak için dosya altyapısını oluşturan kodu değiştirin ve ardından dosya altyapısını kullanarak bir .msg dosyasını etiketleyin.

  1. Önceki "Hızlı Başlangıç: Dosya SDK'sı uygulaması başlatma (C#)" içinde oluşturduğunuz Visual Studio çözümünü açın.

  2. Çözüm Gezgini'da, projenizde yönteminin uygulanmasını Main() içeren .cs dosyasını açın. Proje oluşturma sırasında belirlediğiniz isim, varsayılan olarak projeyle aynı olup onu içeren yapıdadır.

  3. Önceki hızlı başlangıçtan Main() işlevinin uygulamasını kaldırın. Main() gövdesine aşağıdaki kodu ekleyin. Aşağıdaki kod bloğunda, dosya altyapısının oluşturulması enable_msg_file_type bayrağını ayarlar. IFileHandler dosya altyapısı kullanılarak oluşturulan nesneler daha sonra bir .msg dosyasını işleyebilir.

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

    Dosya işlemleri hakkında daha fazla bilgi için bkz. Dosya İşleyicisi kavramları.

  4. Kaynak koddaki yer tutucu değerlerini aşağıdaki değerlerle değiştirin:

    Placeholder Value
    <girdi dosya yolu> Bir test girdi mesaj dosyasının tam yolu, örneğin: c:\\Test\\message.msg.
    <çıkış dosyası yolu> Çıkış dosyasının tam yolu; giriş dosyasının etiketli bir kopyasıdır, örneğin: c:\\Test\\message_labeled.msg.
    <label-id> Dosya motoru kullanılarak alınan etiket kimliği, örneğin: 667466bf-a01b-4b0a-8bbf-a79a3d96f720.

Uygulamayı derleme ve test etme

F6'yı (Çözümü Derle) kullanarak istemci uygulamanızı derleyin. Derleme hataları yoksa, uygulamanızı çalıştırmak için F5 (Hata ayıklamayı başlat) kullanın.

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