Implementieren von ExecutionState

Um eine Aktion basierend auf dem aktuellen Zustand und dem gewünschten Zustand zu berechnen, übergeben Sie Informationen durch Implementieren der mip::ExecutionState Klasse an das MIP SDK. Wie bei anderen Klassen im SDK ExecutionState handelt es sich um eine abstrakte Klasse, und der Entwickler muss sie implementieren.

Note

Ein vollständiges Beispiel für eine ExecutionState Implementierung finden Sie in der folgenden Beispielquelle:

Mitglieder von mip::ExecutionState

ExecutionState macht die folgenden virtuellen Mitglieder verfügbar. Jedes Mitglied stellt dem Richtlinienmodul Kontext bereit, damit er Informationen darüber zurückgeben kann, welche Aktionen die Anwendung ausführen soll. Das SDK kann diese Informationen auch verwenden, um Überwachungsinformationen für Microsoft Purview bereitzustellen.

Mitglied Rückkehr
std::shared_ptr<mip::Label> GetNewLabel() Gibt die Bezeichnung zurück, die das SDK für das Objekt anwendet.
mip::DataState GetDataState() Gibt den mip::DataState des Objekts zurück.
std::pair<bool, std::string> IsDowngradeJustified() Gibt ein std::pair zurück, das angibt, ob das Downgrade gerechtfertigt ist und die Begründung angibt.
std::string GetContentIdentifier() Gibt den Inhaltsbezeichner zurück. Verwenden Sie einen lesbaren Bezeichner, der die Position des Objekts angibt.
std::string GetApplicationScenarioId() Gibt einen Bezeichner zurück, der Anwendungsereignisse mit den entsprechenden REST-Anforderungen des Überwachungs- oder Schutzdiensts korreliert.
mip::AssignmentMethod GetNewLabelAssignmentMethod() Gibt die mip::AssignmentMethod der Beschriftung zurück.
std::vector<std::pair<std::string, std::string>> GetNewLabelExtendedProperties() Gibt einen std::vector von std::pairs aus Zeichenfolgen zurück, die die benutzerdefinierten Metadaten enthalten, die das SDK auf das Dokument anwendet.
std::vector<mip::MetadataEntry> GetContentMetadata() Gibt einen std::vector von mip::MetadataEntry -Objekten zurück, die die aktuellen Inhaltsmetadaten enthalten.
std::shared_ptr<mip::ProtectionDescriptor> GetProtectionDescriptor() Gibt einen Zeiger auf einen mip::ProtectionDescriptor zurück.
std::string GetContentFormat() Gibt eine Zeichenfolge zurück.
mip::ActionType GetSupportedActions() Gibt mip::ActionTypes für das Label zurück.
std::shared_ptr<mip::ClassificationResults> GetClassificationResults() Gibt eine Liste der Klassifizierungsergebnisse zurück, falls implementiert.

Überschreiben Sie jedes Member in einer Implementierung einer aus mip::ExecutionState abgeleiteten Klasse. Im vorherigen Beispiel definiert die Beispielanwendung eine Struktur mit dem Namen ExecutionStateOptions und übergibt diese an den Konstruktor der abgeleiteten Klasse.

Das Beispiel definiert eine Struktur namens ExecutionStateOptions:

struct ExecutionStateOptions {
    std::unordered_map<std::string, std::string> metadata;
    std::string newLabelId;
    std::string contentIdentifier;
    mip::ActionSource actionSource = mip::ActionSource::MANUAL;
    mip::DataState dataState = mip::DataState::USE;
    mip::AssignmentMethod assignmentMethod = mip::AssignmentMethod::STANDARD;
    bool isDowngradeJustified = false;
    std::string downgradeJustification;
    std::string templateId;
    std::string contentFormat = mip::GetFileContentFormat();
    mip::ActionType supportedActions;
    bool generateAuditEvent;
};

Legen Sie in der Anwendung jede Eigenschaft fest, und übergeben Sie dann ExecutionStateOptions an den Konstruktor der Klasse, die von mip::ExecutionState abgeleitet ist. Das SDK verwendet diese Informationen, um die auszuführenden Aktionen zu bestimmen. Microsoft Purview Überwachungsberichte zeigen auch Daten an, die in mip::ExecutionState bereitgestellt werden.

Nächste Schritte

  • Zuletzt aktualisiert um