Partilhar via


Elemento de MethodInstance no MethodInstances (BDCMetadata esquema)

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Especifica um MethodInstance.

Namespace: http://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Esquema: BDCMetadata

Observação

Os dois casos a seguir em um modelo BDC resultam em um InvalidOperationException em tempo de execução :

  • Duas instâncias de método SpecificFinder que retornam o mesmo conjunto de campos.
  • Duas SpecificFinder método instâncias que tenha o mesmo número de campos e que compartilhar o mesmo número de campos com outra instância de método, como um Finder.
<MethodInstance Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </MethodInstance>

Elementos e atributos

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Atributos

Atributo

Descrição

**Tipo**

Obrigatório.

Especifica o tipo do **MethodInstance**.

A tabela a seguir lista os valores possíveis para este atributo.

Valor

Descrição

Localizador

Um tipo de **MethodInstance** que pode ser chamado para retornar uma coleção de zero ou mais **EntityInstances** de uma **Entity**particular. A entrada **Finder** é definida pelos **FilterDescriptors** contidos no **Method** que contém o **Finder**.

SpecificFinder

Um tipo de **MethodInstance** que pode ser chamado para retornar uma **EntityInstance** específica de uma **Entity** específica dada a sua **EntityInstanceId**. A entrada **SpecificFinder** é definida e ordenada pelos **Identificadores** associados à **Entity**.

GenericInvoker

Um tipo de **MethodInstance** que pode ser chamado para executar uma tarefa específica em um sistema externo. **GenericInvoker** entrada e saída é específica para o **Method**.

Idenumerator

Um tipo de **MethodInstance** que pode ser chamado para retornar os valores **Field** que representam a identidade de **EntityInstances** de uma **Entity*** específica. A entrada **IdEnumerator** é definida pelos **FilterDescriptors** contidos no método que contém o **IdEnumerator** para obter a lista de IDs, que são as chaves exclusivas para cada entidade que deve ser pesquisável. Essa instância de método habilita a pesquisa de dados externos no Microsoft SharePoint Server 2010.

ChangedIdEnumerator

Um tipo de **MethodInstance** que pode ser chamado para recuperar **EntityInstanceIds** de **EntityInstances** que foram modificados em um sistema externo após um tempo especificado.

DeletedIdEnumerator

Um tipo de **MethodInstance** que pode ser chamado para recuperar **EntityInstanceIds** de **EntityInstances** que foram excluídos de um sistema externo após a hora especificada.

Escalar

Um **MethodInstance** que retorna um único valor que você pode invocar no sistema externo. Por exemplo, você pode usar uma instância do método escalar para obter o total de vendas feitas até a data do sistema externo. **Entidades** têm zero ou mais instâncias de método escalar.

AccessChecker

Um tipo de **MethodInstance** que pode ser chamado para recuperar as permissões que a entidade de segurança de chamada tem para cada uma de uma coleção de **EntityInstances** que são identificadas pela **EntityInstanceIds**especificada.

Criador

Um tipo de **MethodInstance** que pode ser chamado para criar uma **EntityInstance**. O conjunto de campos necessários para criar o **EntityInstance** é chamado de Exibição do Criador.

Deleter

Um tipo de **MethodInstance** que pode ser chamado para excluir um **EntityInstance** com uma **EntityInstanceId**especificada.

Atualizador

Um tipo de **MethodInstance** que pode ser chamado para atualizar um **EntityInstance** identificado por uma **EntityInstanceId**especificada. O conjunto de campos necessários para atualizar o **EntityInstance** é conhecido como Modo de Exibição do Updater. O conjunto de campos cujos valores devem ser passados antes que eles forem alterados é conhecido como o modo de exibição de PreUpdater.

StreamAccessor

Um tipo de **MethodInstance** que pode ser chamado para recuperar um campo de **EntityInstance** na forma de um fluxo de dados de bytes.

BinarySecurityDescriptorAccessor

Um tipo de **MethodInstance** que pode ser chamado para recuperar uma sequência de bytes de um sistema externo. A sequência de bytes específica do sistema descreve um conjunto de entidades de segurança e as permissões associadas que cada entidade de segurança tem para a **EntityInstance** identificada por uma **EntityInstanceId**especificada.

BulkSpecificFinder

Um tipo de **MethodInstance** que pode ser chamado para retornar um conjunto de **EntityInstances** específicos de uma **Entity**, dado um conjunto de **EntityInstanceIds**correspondente.

BulkIdEnumerator

Um tipo de **MethodInstance** que pode ser chamado para recuperar informações mínimas sobre os itens externos correspondentes às identidades fornecidas. Esta instância do método pode ser usada para otimizar a sincronização de dados em cache. Esse método deve retornar apenas as identidades e as informações de versão dos itens externos que correspondem a **Identidades**, que o aplicativo de chamada pode comparar com a versão local para identificar se algo foi alterado e, se for o caso, solicitar os itens externos alterados para atualizar os dados armazenados em cache.

**Padrão**

Opcional.

Especifica se o **MethodInstance** é o padrão entre todos **MethodInstances** que compartilham seu tipo dentro do tipo de conteúdo externo contendo (**Entity**).

Valor padrão: **false**

Tipo de atributo: **Boolean**

**ReturnParameterName**

Opcional.

O nome do **Parameter** que contém o **ReturnTypeDescriptor** do **MethodInstance**. O atributo **Direction** do **Parameter** deve ser um atributo **ParameterDirection** com um valor de **Out**, **InOut**ou **Return**.

Esse atributo deve ser especificado para todos os tipos de **MethodInstances** exceto **GenericInvoker**, **Creator**, **Deleter**e **Updater**.

Tipo de atributo: **String**

**ReturnTypeDescriptorLevel**

Opcional.

Isso foi preterido. Use o **ReturnTypeDescriptorPath** em vez disso.

Tipo de atributo: **Integer**

**ReturnTypeDescriptorPath**

Opcional.

O caminho pontilhado do **TypeDescriptor** da Associação.

Tipo de atributo: **String**

**Nome**

Obrigatório.

Especifica o nome do **MethodInstance**.

Tipo de atributo: **String**

**DefaultDisplayName**

Opcional.

Especifica o nome de exibição padrão para o **MethodInstance**.

Tipo de atributo: **String**

**Iscached**

Opcional.

Especifica se o **MethodInstance** é usado com frequência.

Valor padrão: **true**

Tipo de atributo: **Boolean**

Elementos filho

Elemento Descrição
Elemento de LocalizedDisplayNames no MetadataObject (BDCMetadata esquema) Os nomes de exibição localizado do MethodInstance.
Elemento de propriedades no MetadataObject (BDCMetadata esquema) As propriedades do MethodInstance.
Elemento AccessControlList (BDCMetadata esquema) As listas do controle de acesso (ACLs) do MethodInstance.

Elementos pai

Elemento Descrição
Elemento MethodInstances no método (BDCMetadata esquema) O elemento MethodInstances que contém essa MethodInstance.