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

Fil-SDK stöder etiketteringsåtgärder för .msg filer på samma sätt som andra filtyper, förutom att SDK:t behöver programmet för att aktivera MSG-funktionsflaggan. Den här snabbstarten visar hur du anger den här flaggan.

Som tidigare nämnts kräver instansiering IFileEngine inställningsobjektet FileEngineSettings . Programmet använder FileEngineSettings för att skicka anpassade inställningar för en viss instans. Egenskapen CustomSettings för FileEngineSettings anger enable_msg_file_type-flaggan för 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:

Ange enable_msg_file_type och använd File SDK för etikettering .msg fil

Som fortsättning på fil-API:s snabbstartsguide för 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. I Prieskumník riešení öppnar du filen .cs 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 följande kodblock anger skapande av filmotor flaggan enable_msg_file_type . IFileHandler objekt som skapas med hjälp av filmotorn kan sedan bearbeta en .msg fil.

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

    Mer information om filåtgärder finns i Filhanterarbegrepp.

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

    Platshållare Värde
    <inmatningsfil-sökväg> Den fullständiga sökvägen till en testinmatningsmeddelandefil, till exempel: c:\\Test\\message.msg.
    <utdata-fil-sökväg> 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> Etikett-ID:t som hämtas med hjälp av 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 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.
  • Uppdaterades senast