Delen via

ExecutionState implementeren

Informatie doorgeven aan de MIP SDK om een actie te berekenen die moet worden uitgevoerd, op basis van de huidige status en gewenste status, wordt geïmplementeerd via de mip::ExecutionState klasse. Net als andere klassen in de SDK is het ExecutionState een abstracte klasse en moet deze worden geïmplementeerd door de ontwikkelaar.

Bekijk de volgende voorbeeldbron voor een volledig voorbeeld van een ExecutionState implementatie:

mip::Uitvoeringstoestand Ledematen

ExecutionState toont de volgende virtuele leden. Elk biedt een context voor de beleidsengine om informatie te retourneren over welke acties moeten worden uitgevoerd door de toepassing. Daarnaast kan deze informatie worden gebruikt om controlegegevens aan Microsoft Purview te verstrekken.

Lid Retouren
std::shared_ptr<mip::Label> GetNewLabel() Retourneert het label dat moet worden toegepast op het object.
mip::DataState GetDataState() Retourneert de mip::DataState van het object.
std::pair<bool, std::string> IsDowngradeJustified() Retourneert een std::pair die aangeeft of de downgrade gerechtvaardigd is en de rechtvaardiging ervan.
std::string GetContentIdentifier() Retourneert de inhouds-id. Moet een door mensen leesbare id zijn, die de locatie van het object aangeeft.
mip::ActionSource GetNewLabelActionSource() Retourneert de mip::ActionSource van het label.
mip::AssignmentMethod GetNewLabelAssignmentMethod() Geeft als resultaat de mip::AssignmentMethod van het label
std::vector<std::pair<std::string, std::string>> GetNewLabelExtendedProperties() Retourneert een std::vector van std::pairs van tekenreeksen, die de aangepaste metagegevens bevatten die op het document worden toegepast.
std::vector<std::pair<std::string, std::string>> GetContentMetadata() Retourneert een std::vector van std::pair van tekenreeksen die de huidige inhoudsmetadata bevatten.
std::shared_ptr<mip::ProtectionDescriptor> GetProtectionDescriptor() Retourneert een aanwijzer naar een mip::ProtectionDescriptor
std::string GetContentFormat() Retourneert tekenreeks
mip::ActionType GetSupportedActions() Retourneert mip::ActionTypes voor het label.
std::shared_ptr<mip::ClassificationResults> Retourneert een lijst met classificatieresultaten, indien geïmplementeerd.

Elk moet worden overschreven in een implementatie van een klasse die is afgeleid van mip::ExecutionState. In de voorbeeldtoepassing die hierboven is gekoppeld, wordt dit proces uitgevoerd door een struct genaamd ExecutionStateOptionste implementeren en deze door te geven aan de constructor van de afgeleide klasse.

In het voorbeeld wordt een struct ExecutionStateOptions gedefinieerd als:

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

Elke eigenschap wordt door de toepassing ingesteld en vervolgens ExecutionStateOptions doorgegeven aan de constructor van de klasse die is afgeleid van mip::ExecutionState. Deze informatie wordt gebruikt om de acties te bepalen die moeten worden uitgevoerd. Gegevens die in de mip::ExecutionState rapporten worden verstrekt, worden ook weergegeven in Microsoft Purview-auditrapporten.

Volgende stappen

  • Last updated on