Uwaga
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Zestaw SDK plików obsługuje operacje etykietowania dla plików .msg w sposób identyczny z dowolnym innym typem pliku, z tą różnicą, że zestaw SDK potrzebuje aplikacji do włączenia flagi funkcji MSG. W tym miejscu zobaczymy, jak ustawić tę flagę.
Jak wspomniano wcześniej, instancjowanie IFileEngine
wymaga obiektu ustawień FileEngineSettings
. FileEngineSettings może służyć do przekazywania parametrów dla ustawień niestandardowych, które aplikacja musi ustawić dla określonego wystąpienia.
CustomSettings
Właściwość FileEngineSettings
jest używana do ustawienia flagi dla enable_msg_file_type
w celu umożliwienia przetwarzania plików .msg.
Wymagania wstępne
Jeśli jeszcze tego nie zrobiono, przed kontynuowaniem upewnij się, że zostały spełnione następujące wymagania wstępne:
- Complete Quickstart: File SDK application initialization (C#) first, which builds a starter Visual Studio solution. This "How to - process email message .msg files (C#)" quickstart builds on the previous one.
- Zapoznaj się z pojęciami dotyczącymi MIP SDK dla plików e-mail.
- Opcjonalnie: Zapoznaj się z pojęciami dotyczącymi silników plików w zestawie MIP SDK.
- Opcjonalnie: Zapoznaj się z koncepcjami obsługi plików w zestawie MIP SDK.
Set enable_msg_file_type and use File SDK for labeling .msg file
In continuation of File API application initialization quickstart, modify the file engine construction code to set enable_msg_file_type flag
and then use the file engine to label a .msg file.
Open the Visual Studio solution you created in the previous "Quickstart: File SDK application initialization (C#)".
Using Solution Explorer, open the .cs file in your project that contains the implementation of the
Main()
method. Domyślnie ma taką samą nazwę jak projekt zawierający go, który został określony podczas tworzenia projektu.Remove the implementation of
Main()
function from previous quickstart.Main()
Wewnątrz treści wstaw następujący kod. In below code blockenable_msg_file_type
flag is set during file engine creation, a .msg file can then be processed byIFileHandler
objects created using the file engine.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; }
Aby uzyskać więcej informacji na temat operacji na plikach, zapoznaj się z pojęciami dotyczącymi obsługi plików.
Zastąp wartości symboli zastępczych w kodzie źródłowym przy użyciu następujących wartości:
Placeholder Wartość <ścieżka pliku wejściowego> Pełna ścieżka do pliku komunikatu wejściowego testu, na przykład: c:\\Test\\message.msg
.<ścieżka pliku wyjściowego> Pełna ścieżka do pliku wyjściowego, który będzie oznakowaną kopią pliku wejściowego, na przykład: c:\\Test\\message_labeled.msg
.<label-id> The labelId retrieved using file engine, for example: 667466bf-a01b-4b0a-8bbf-a79a3d96f720
.
Kompilowanie i testowanie aplikacji
Skompiluj aplikację kliencą przy użyciu F6 (rozwiązanie kompilacji). Jeśli nie masz błędów kompilacji, użyj F5 (Rozpocznij debugowanie), aby uruchomić aplikację.
Original file: C:\Test.msg
Labeled file: C:\Test_Labeled.msg
Label applied to file: Confidential
Press a key to continue.