ExecutionState implementeren

Als u een actie wilt berekenen op basis van de huidige status en de gewenste status, geeft u informatie door aan de MIP SDK door de mip::ExecutionState klasse te implementeren. Net als andere klassen in de SDK is ExecutionState dit een abstracte klasse en moet de ontwikkelaar deze implementeren.

Note

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

• execution_state_impl.h
• execution_state_impl.cpp

leden van mip::ExecutionState

ExecutionState toont de volgende virtuele leden. Elk lid biedt context aan de beleidsengine, zodat deze informatie kan retourneren over welke acties de toepassing moet uitvoeren. De SDK kan deze informatie ook gebruiken om controlegegevens te verstrekken aan Microsoft Purview.

Lid	Retouren
std::shared_ptr<mip::Label> GetNewLabel()	Retourneert het label dat de SDK van toepassing is 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. Gebruik een door mensen leesbare id die de locatie van het object aangeeft.
std::string GetApplicationScenarioId()	Retourneert een id die toepassingsgebeurtenissen correleert met de bijbehorende REST-aanvragen voor de audit- of beveiligingsservice.
mip::AssignmentMethod GetNewLabelAssignmentMethod()	Geeft de mip::AssignmentMethod van het label terug.
std::vector<std::pair<std::string, std::string>> GetNewLabelExtendedProperties()	Geeft een std::vector met std::pairs van tekenreeksen terug die de aangepaste metagegevens bevatten die de SDK op het document toepast.
std::vector<mip::MetadataEntry> GetContentMetadata()	Retourneert een std::vector van mip::MetadataEntry-objecten die de huidige metagegevens van inhoud bevatten.
std::shared_ptr<mip::ProtectionDescriptor> GetProtectionDescriptor()	Retourneert een aanwijzer naar een mip::ProtectionDescriptor.
std::string GetContentFormat()	Retourneert een tekenreeks.
mip::ActionType GetSupportedActions()	Retourneert mip::ActionTypes voor het label.
std::shared_ptr<mip::ClassificationResults> GetClassificationResults()	Retourneert een lijst met classificatieresultaten, indien geïmplementeerd.

Overschrijf elk lid in een implementatie van een klasse die is afgeleid van mip::ExecutionState. In de voorgaande voorbeeldtoepassing implementeert de voorbeeldtoepassing een struct genaamd ExecutionStateOptions en geeft die struct door aan de constructor van de afgeleide klasse.

In het voorbeeld wordt een struct gedefinieerd met de naam 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;
};

Stel elke eigenschap in de toepassing in en geef ExecutionStateOptions deze door aan de constructor van de klasse die is afgeleid van mip::ExecutionState. De SDK gebruikt deze informatie om te bepalen welke acties moeten worden uitgevoerd. Microsoft Purview auditrapporten bevatten ook gegevens in mip::ExecutionState.

Volgende stappen 

• Meer informatie over het bepalen van rekenacties voor een nieuw of bestaand label, op basis van de huidige en gewenste status.
• Download de voorbeelden van de Policy SDK van GitHub en probeer de Beleids-SDK uit.