Fil-SDK – Bearbeta .msg-filer för e-post (C#)

Fil-SDK stöder etiketteringsåtgärder för .msg-filer på ett sätt som är identiskt med alla andra filtyper, förutom att SDK:t behöver programmet för att aktivera MSG-funktionsflaggan. Här får vi se hur du anger den här flaggan.

Som tidigare nämnts kräver instansiering av ett inställningsobjekt IFileEngine , FileEngineSettings. FileEngine Inställningar kan användas för att skicka parametrar för anpassade inställningar som programmet måste ange för en viss instans. CustomSettingsFileEngineSettings egenskapen för används för att ange flaggan för för enable_msg_file_type att aktivera bearbetning av .msg-filer.

Förutsättningar

Om du inte redan har gjort det måste du slutföra följande krav innan du fortsätter:

• Slutför snabbstart: Fil-SDK-programinitiering (C#) först, som skapar en Visual Studio-startlösning. Den här snabbstarten "How to – process email .msg files (C#)" bygger på den föregående.
• Granska MIP SDK-begrepp för E-postfiler.
• Valfritt: Granska filmotorer i MIP SDK-begreppen .
• Alternativt: Granska filhanterare i MIP SDK-begreppen .

Ange enable_msg_file_type och använd File SDK för att märka .msg-fil

I fortsättningen av snabbstarten för fil-API-programinitiering ändrar du byggkoden för filmotorn för att ange enable_msg_file_type flag och använder sedan filmotorn för att märka en .msg-fil.

1. Öppna Visual Studio-lösningen som du skapade i föregående "Snabbstart: Initiering av fil-SDK-program (C#)".

2. Använd Solution Explorer och öppna .cs-filen i projektet som innehåller implementeringen av Main() metoden. Det är som standard samma namn som det projekt som innehåller det, som du angav när projektet skapades.

3. Ta bort implementeringen av Main() funktionen från föregående snabbstart. Infoga följande kod i brödtexten Main() . I nedanstående kodblocksflagga enable_msg_file_type anges när filmotorn skapas kan en .msg-fil sedan bearbetas av objekt som skapats med hjälp av IFileHandler filmotorn.

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

   Mer information om filåtgärder finns i begreppen Filhanterare.

4. Ersätt platshållarvärdena i källkoden med hjälp av följande värden:

   Platshållare	Värde
   <input-file-path>	Den fullständiga sökvägen till en testinmatningsmeddelandefil, till exempel: c:\\Test\\message.msg.
   <output-file-path>	Den fullständiga sökvägen till utdatafilen, som är en märkt kopia av indatafilen, till exempel: c:\\Test\\message_labeled.msg.
   <etikett-ID>	LabelId som hämtats med filmotorn, till exempel: 667466bf-a01b-4b0a-8bbf-a79a3d96f720.

Skapa och testa programmet

Använd F6 (Build Solution) för att skapa klientprogrammet. Om du inte har några byggfel använder du F5 (Starta felsökning) för att köra programmet.

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