Bestands-SDK - E-mail .msg-bestanden verwerken (C#)

  • Artikel

Bestands-SDK ondersteunt labelbewerkingen voor MSG-bestanden op een manier die identiek is aan elk ander bestandstype, behalve dat de SDK de toepassing nodig heeft om msG-functievlag in te schakelen. Hier ziet u hoe u deze vlag instelt.

Zoals eerder besproken, is het instantiëren van IFileEngine een instellingsobject vereist. FileEngineSettings FileEngine Instellingen kan worden gebruikt om parameters door te geven voor aangepaste instellingen die de toepassing moet instellen voor een bepaald exemplaar. CustomSettings eigenschap van de FileEngineSettings wordt gebruikt om de vlag in te stellen voor enable_msg_file_type het inschakelen van verwerking van .msg-bestanden.

Vereisten

Als u dat nog niet hebt gedaan, moet u de volgende vereisten voltooien voordat u doorgaat:

Set enable_msg_file_type and use File SDK for labeling .msg file

In vervolg van de quickstart voor initialisatie van bestands-API-toepassingen wijzigt u de code voor de bouw van de bestandsengine zodat deze wordt ingesteld enable_msg_file_type flag en gebruikt u vervolgens de bestandsengine om een MSG-bestand te labelen.

  1. Open de Visual Studio-oplossing die u in de vorige 'Quickstart: Initialisatie van bestands-SDK-toepassingen (C#)' hebt gemaakt.

  2. Open met Solution Explorer het .cs-bestand in uw project dat de implementatie van de Main() methode bevat. Deze wordt standaard ingesteld op dezelfde naam als het project dat het bevat, die u hebt opgegeven tijdens het maken van het project.

  3. Verwijder de implementatie van Main() de functie uit de vorige quickstart. Voeg in de Main() hoofdtekst de volgende code in. In de onderstaande codeblokvlag enable_msg_file_type wordt ingesteld tijdens het maken van de bestandsengine, kan een MSG-bestand vervolgens worden verwerkt door IFileHandler objecten die zijn gemaakt met behulp van de bestandsengine.

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

    Raadpleeg de concepten van bestandshandler voor meer informatie over bestandsbewerkingen.

  4. Vervang de tijdelijke aanduidingen in de broncode met behulp van de volgende waarden:

    Tijdelijke aanduiding Waarde
    <input-file-path> Het volledige pad naar een testinvoerberichtbestand, bijvoorbeeld: c:\\Test\\message.msg.
    <output-file-path> Het volledige pad naar het uitvoerbestand, een gelabelde kopie van het invoerbestand, bijvoorbeeld: c:\\Test\\message_labeled.msg
    <label-id> De labelId die is opgehaald met behulp van bestandsengine, bijvoorbeeld: 667466bf-a01b-4b0a-8bbf-a79a3d96f720.

De toepassing bouwen en testen

Gebruik F6 (Build Solution) om uw clienttoepassing te bouwen. Als u geen buildfouten hebt, gebruikt u F5 (Foutopsporing starten) om uw toepassing uit te voeren.

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