Partilhar via


attributeMapping resource type

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Define como os valores para o atributo de destino especificado devem fluir durante a sincronização.

Propriedades

Propriedade Tipo Descrição
defaultValue Cadeia de caracteres Valor predefinido a ser utilizado caso a propriedade de origem tenha sido avaliada como null. Opcional.
exportMissingReferences Booliano Apenas para uso interno.
flowBehavior attributeFlowBehavior Define quando este atributo deve ser exportado para o diretório de destino. Os valores possíveis são: FlowWhenChanged e FlowAlways. O padrão é FlowWhenChanged.
flowType attributeFlowType Define quando este atributo deve ser atualizado no diretório de destino. Os valores possíveis são:
  • Always (predefinição)
  • ObjectAddOnly - apenas quando é criado um novo objeto
  • MultiValueAddOnly - apenas quando a alteração está a adicionar novos valores a um atributo de valores múltiplos
  • ValueAddOnly - Se existir um valor atual, apenas flui as operações "Adicionar"; não irá fluir operações "Remover"
  • AttributeAddOnly - Propaga apenas as alterações se não existir nenhum valor atual
  • matchingPriority Int32 Se for superior a 0, este atributo será utilizado para executar uma correspondência inicial dos objetos entre os diretórios de origem e de destino. O motor de sincronização tentará encontrar primeiro o objeto correspondente com o atributo com o valor mais baixo de prioridade correspondente. Se não for encontrado, será utilizado o atributo com a próxima prioridade correspondente e assim sucessivamente, até que seja encontrada uma correspondência ou não restem mais atributos correspondentes. Apenas os atributos que se espera que tenham valores exclusivos, como o e-mail, devem ser utilizados como atributos correspondentes.
    source attributeMappingSource Define como um valor deve ser extraído (ou transformado) do objeto de origem.
    targetAttributeName Cadeia de caracteres Nome do atributo no objeto de destino.

    Representação JSON

    A representação JSON seguinte mostra o tipo de recurso.

    {
      "@odata.type": "#microsoft.graph.attributeMapping",
      "defaultValue": "String",
      "exportMissingReferences": "Boolean",
      "flowBehavior": "String",
      "flowType": "String",
      "matchingPriority": "Integer",
      "source": {
        "@odata.type": "microsoft.graph.attributeMappingSource"
      },
      "targetAttributeName": "String"
    }