Een actie berekenen

Zoals eerder beschreven, zijn de primaire functies van de Beleids-SDK het volgende:

  • beschikbare labels weergeven
  • retourneert een set acties die de toepassing moet uitvoeren, op basis van de huidige en gewenste status

De laatste stap in het proces is het opgeven van een label-id en, optioneel, metagegevens over het bestaande label voor de ComputeActions() functie.

Voorbeeldcode voor dit artikel is beschikbaar op GitHub.

Een actie berekenen voor een nieuw label

Bereken het mip::Actions voor een nieuw label met behulp van de ExecutionStateImpl die zijn gedefinieerd in ExecutionState.

// Replace with valid label ID.
string newLabelId = "d7b93a40-4df3-47e4-b2fd-7862fc6b095c";
sample::upe::ExecutionStateOptions options;

// Resolve desired label id to mip::Label and set in ExecutionStateOptions.
options.newLabel = mEngine->GetLabelById(newLabelId);

// Initialize ExecutionStateImpl with options, create handler, call ComputeActions.
std::unique_ptr<ExecutionStateImpl> state(new ExecutionStateImpl(options));
auto handler = mEngine->CreatePolicyHandler(false); // Don't generate audit event.
auto actions = handler->ComputeActions(*state);

Als alleen de als onderdeel van actions geretourneerde mip::MetadataActions wordt weergegeven, verschijnt:

Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled : true
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate : 2018-10-23T20:39:06-0800
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method : Standard
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name : Contoso FTEs (C)
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId : 94f6984e-8d31-4794-bdeb-3ac89ad2b660
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId : 2266fbe8-a0d9-44e8-bad8-00008f2a0915
Add: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits : 3

De PolicyHandler berekent de acties en retourneert een std::vector van mip::Action. Het is aan de ontwikkelaar van de toepassing om deze metagegevens toe te passen op het bestand of de gegevens.

Opmerking

In het voorgaande voorbeeld wordt alleen de mip::MetadataAction uitvoer weergegeven. Zie de voorbeeldbundels met de policy-SDK-download voor een voorbeeld waarin andere actietypen worden weergegeven.

Bewerkingen berekenen met een bestaand label

Wanneer u de Beleids-SDK gebruikt, leest de toepassing metagegevens uit inhoud. De toepassing biedt deze metagegevens aan de API als onderdeel van mip::ExecutionState. ComputeActions() kan complexere bewerkingen verwerken dan het toepassen van een nieuw label op een niet-gelabeld document. In het volgende voorbeeld ziet u hoe u een label van een gevoeliger label naar een minder gevoelig label omlaaggradeert. Het voorbeeld simuleert dit proces door een door komma's gescheiden tekenreeks met metagegevens te lezen en deze via mip::ExecutionStateaan de API te verstrekken.

Opmerking

In het voorbeeld wordt een hulpprogrammafunctie gebruikt die wordt aangeroepen SplitString(). Zie de SplitString()broncode van de hulpfunctie als voorbeeld.

// Replace with valid label ID.
string newLabelId = "d7b93a40-4df3-47e4-b2fd-7862fc6b095c";

// Comma and Pipe Delimited Metadata.
string metadata = "MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled|true,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate|2018-10-23T21:53:31-0800,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method|Standard,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name|Contoso FTEs (C),MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId|94f6984e-8d31-4794-bdeb-3ac89ad2b660,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId|b56491d9-155f-40ff-866f-0000acd85c31,MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits|7";

// Create ExecutionStateOptions and resolve newLabelId to mip::Label
sample::upe::ExecutionStateOptions options;
options.newLabel = mEngine->GetLabelById(newLabelId);

// Split metadata string by commas, store in vector.
vector<string> metadataPairs = sample::utils::SplitString(metadata, ',');

// Iterate through each string, splitting by the pipe.
// Add each key/value pair to ExecutionStateOptions metadata.
for (const string& metadataPair : metadataPairs) {
    vector<string> keyValue = sample::utils::SplitString(metadataPair, '|');
    options.metadata[keyValue[0]] = keyValue[1];
}

// Initialize ExecutionStateImpl with options, create handler, call ComputeActions
std::unique_ptr<ExecutionStateImpl> state(new ExecutionStateImpl(options));
auto handler = mEngine->CreatePolicyHandler(false); // Don't generate audit event.
auto actions = handler->ComputeActions(*state);

Het voorgaande voorbeeld kan leiden tot verschillende acties. Deze acties zijn afhankelijk van de labels die worden geleverd als invoer en de labelconfiguratie. Het resultaat is minimaal één mip::MetadataAction die de gegevens bevat die moeten worden verwijderd GetMetadataToRemove() en de gegevens die moeten worden toegevoegd.GetMetadataToAdd()

Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Enabled : true
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_SetDate : 2018-10-23T23:59:41-0800
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Method : Standard
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_Name : General
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_SiteId : 94f6984e-8d31-4794-bdeb-3ac89ad2b660
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_ActionId : 447a996b-28ea-482c-b0b5-000075bd4bb3
Add: MSIP_Label_d48d0e60-c766-40d6-96d3-53b2857fe775_ContentBits : 7
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Name
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Enabled
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SiteId
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_SetDate
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_Method
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ContentBits
Remove: MSIP_Label_d7b93a40-4df3-47e4-b2fd-7862fc6b095c_ActionId

Volgende stappen 

  • Last updated on