PowerPoint.SensitivityLabelAbacAttribute interface
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Representa um atributo de controle de acesso baseado em atributo (ABAC) disponível para seleção em um rótulo de confidencialidade habilitado para ABAC.
Comentários
Conjunto de APIs: PowerPointApi BETA (SOMENTE VISUALIZAÇÃO)
Usada por
- PowerPoint.SensitivityLabelTryUpdateOptions: abacAttributes
- PowerPoint.SensitivityLabelsCatalog: getAttributes
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/powerpoint/preview-apis/manage-sensitivity-labels.yaml
// Get available ABAC attributes and describe the kind of value each attribute accepts.
const container = document.getElementById("abac-attributes");
while (container.firstChild) {
container.removeChild(container.firstChild);
}
await PowerPoint.run(async (context) => {
const labelCatalog: PowerPoint.SensitivityLabelsCatalog = context.sensitivityLabelsCatalog;
if (!labelCatalog) {
console.warn("The sensitivity label catalog isn't available.");
return;
}
labelCatalog.load("getLabelingCapabilities");
await context.sync();
const capabilities: PowerPoint.LabelingCapability[] = labelCatalog.getLabelingCapabilities;
if (capabilities.indexOf(PowerPoint.LabelingCapability.attributeBasedAccessControlEnabled) === -1) {
console.warn("ABAC attributes aren't enabled or available for the current user.");
return;
}
const catalogAttributes: OfficeExtension.ClientResult<PowerPoint.SensitivityLabelAbacAttribute[]> =
labelCatalog.getAttributes();
await context.sync();
if (catalogAttributes.value.length === 0) {
console.log("No ABAC attributes are available in the sensitivity label catalog.");
return;
}
console.log("Available ABAC attributes:");
catalogAttributes.value.forEach((attribute: PowerPoint.SensitivityLabelAbacAttribute) => {
let dataTypeDescription: string;
switch (attribute.dataType) {
case PowerPoint.SensitivityLabelAbacAttributeDataType.booleanValue:
dataTypeDescription = "Boolean";
break;
case PowerPoint.SensitivityLabelAbacAttributeDataType.dateValue:
dataTypeDescription = "Date";
break;
case PowerPoint.SensitivityLabelAbacAttributeDataType.numberValue:
dataTypeDescription = "Number";
break;
case PowerPoint.SensitivityLabelAbacAttributeDataType.stringValue:
dataTypeDescription = "String";
break;
case PowerPoint.SensitivityLabelAbacAttributeDataType.unknown:
dataTypeDescription = "Unknown";
break;
default:
dataTypeDescription = `Unrecognized (${attribute.dataType})`;
break;
}
console.log(`ABAC attribute: ${attribute.displayName}`, {
dataType: attribute.dataType,
dataTypeDescription,
displayOrder: attribute.displayOrder,
isActive: attribute.isActive,
isMultiValued: attribute.isMultiValued,
values: attribute.values.map((attributeValue: PowerPoint.SensitivityLabelAbacAttributeValue) => ({
displayName: attributeValue.displayName,
displayOrder: attributeValue.displayOrder,
id: attributeValue.id,
isActive: attributeValue.isActive
}))
});
});
addAttributeOptions(catalogAttributes.value);
});
Propriedades
| data |
Obtém o tipo de dados do atributo ABAC. |
| display |
Obtém o nome de exibição do atributo ABAC. Os suplementos são responsáveis por apresentar a interface do usuário localizada e voltada para o usuário. |
| display |
Obtém a ordenação recomendada desse atributo ABAC quando exibido para um usuário. |
| is |
Obtém se este atributo ABAC está ativo.
|
| is |
Obtém se mais de um valor pode ser selecionado para esse atributo ABAC.
|
| values | Obtém os valores selecionáveis para esse atributo ABAC. |
Detalhes da propriedade
dataType
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém o tipo de dados do atributo ABAC.
dataType: PowerPoint.SensitivityLabelAbacAttributeDataType | "Unknown" | "StringValue" | "BooleanValue" | "NumberValue" | "DateValue";
Valor da propriedade
PowerPoint.SensitivityLabelAbacAttributeDataType | "Unknown" | "StringValue" | "BooleanValue" | "NumberValue" | "DateValue"
Comentários
displayName
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém o nome de exibição do atributo ABAC. Os suplementos são responsáveis por apresentar a interface do usuário localizada e voltada para o usuário.
displayName: string;
Valor da propriedade
string
Comentários
displayOrder
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém a ordenação recomendada desse atributo ABAC quando exibido para um usuário.
displayOrder: number;
Valor da propriedade
number
Comentários
isActive
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém se este atributo ABAC está ativo.
true se o atributo estiver ativo; caso contrário, false.
isActive: boolean;
Valor da propriedade
boolean
Comentários
isMultiValued
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém se mais de um valor pode ser selecionado para esse atributo ABAC.
true se houver seleção múltipla; caso contrário, false.
isMultiValued: boolean;
Valor da propriedade
boolean
Comentários
values
Observação
Esta API é fornecida como uma versão prévia para desenvolvedores e pode ser alterada com base nos comentários que recebemos. Não use esta API em um ambiente de produção.
Obtém os valores selecionáveis para esse atributo ABAC.
values: PowerPoint.SensitivityLabelAbacAttributeValue[];