Adicionar um tipo de conteúdo externo com escopo no SharePoint

Artigo
03/21/2023

Saiba mais sobre tipos de conteúdo externos instalados ou com escopo no nível de suplemento no SharePoint e permitem criar suplementos do SharePoint com riqueza de dados usando fontes de dados externas.

Visão geral dos tipos de conteúdo externo com escopo de suplemento no SharePoint

Em SharePoint 2010, você pode instalar e usar tipos de conteúdo externo apenas no nível do farm. Isso geralmente causa problemas para os desenvolvedores porque o mesmo para aplicativos simples, um administrador tinha que ser envolvidos devido a direitos de acesso que são necessárias para instalar no nível do farm.

No SharePoint, os aplicativos são basicamente isolados em unidades mais autônomas chamadas suplementos. Os suplementos contêm todos os recursos necessários para serem executados. Essa abordagem permite que um aplicativo em execução seja isolado de outros aplicativos. Os benefícios dessa arquitetura são os seguintes:

Você pode criar suplementos alinhados com o novo modelo de aplicativo do SharePoint.
Você pode criar os suplementos que acessarem dados externos do SAP, Netflix e o proprietário e outros tipos de dados sem envolvendo o administrador de locatário.
Acesso aos aplicativos externos é mantido por meio de Business Connectivity Services (BCS), que fornece uma interface consistente e uniforme que pode ser usada por outros aplicativos do SharePoint.

Tipos de conteúdo externo adicionar no escopo fornecem acesso a dados externos de um aplicativo.

Pré-requisitos para trabalhar com tipos de conteúdo externo adicionar no escopo

A seguir estão os requisitos para o desenvolvimento de tipos de conteúdo externo que têm como escopo no nível do suplemento:

Visual Studio 2012
Office Developer Tools para Visual Studio 2012
SharePoint

Para obter informações sobre como configurar seu ambiente de desenvolvimento do SharePoint, consulte Configurar um ambiente de desenvolvimento geral para o SharePoint.

Conceitos básicos do tipo de conteúdo externo adicionar no escopo

Tabela 1 contém alguns conceitos fundamentais que você deve estar familiarizado com ao trabalhar com tipos de conteúdo externo adicionar no escopo.

Tabela 1. Conceitos principais para entender tipos de conteúdo externo com escopo de suplemento

Artigo	Descrição
Tipo de conteúdo externo no Microsoft Office SharePoint Online	Saiba como criar BCS tipos de conteúdo externo.
Suplementos do SharePoint	Saiba mais sobre o novo modelo no SharePoint que permite criar suplementos, que são pequenas soluções fáceis de usar para os usuários finais.
Introdução à criação de Suplementos do Suplementos do SharePoint hospedados no SharePoint	Saiba como criar um básico hospedado no SharePoint suplemento usando o Office Developer Tools para Visual Studio 2012.

O que você pode fazer com tipos de conteúdo externo adicionar no escopo?

O principal motivo para a adição de um tipo de conteúdo externo add no escopo é fornecer acesso aos dados externos de um suplemento individual. Isso permite que você faça o seguinte:

Limitar o acesso aos tipos de conteúdo externo para um aplicativo específico.
Implante tipos de conteúdo externo de um aplicativo.

Criar tipos de conteúdo externo adicionar no escopo

O conceito de um catálogo de metadados baseados em arquivo foi introduzido no SharePoint 2010. Ele permite que você especifique um arquivo que contém o XML necessárias para definir tipos de conteúdo externo. Esse arquivo pode ser implantado em um pacote WSP e pertence somente ao escopo é definido para o aplicativo. Usando esse arquivo de metadados, tipos de conteúdo externo podem ser restritos a nível do suplemento.

No SharePoint, o SPListDataSource foi modificado para adicionar uma propriedade que indica o escopo do aplicativo.

Esta classe serve como a ponte entre SPList e uma lista externa. Use o associado SPList para recuperar dados e campos de entidade. Recupere uma instância de SPListDataSource da propriedade HasExternalDataSource. Quando HasExternalDataSource não é nulo, os dados do objeto SPList são externos ao SharePoint.

Quando você deseja adicionar um tipo de conteúdo externo add no escopo, esta propriedade é definida como Add-in.

A propriedade MetadataCatalogFileName é usada para definir o arquivo de modelo BDC que contém a definição de tipo de conteúdo externo. Essa propriedade pode ser definido de forma declarativa ou programaticamente, mas não no SharePoint usuário (UI) da interface.

O exemplo a seguir mostra como definir a propriedade MetadataCatalogFileName de forma declarativa.


<DataSource>
  <Property Name="Entity" Value="Customer" />
  <Property Name="EntityNamespace" Value="SAP" />
  <Property Name="LobSystemInstanceName" Value="SAPClient1" />
  <Property Name="SpecificFinder" Value="ReadCustomer" />
  <Property Name=" MetadataCatalogFileName" Value="BDCMetadata.bdcm" />
</DataSource>

Observação

[!OBSERVAçãO] Os administradores de site podem instalar a suplementos que usam ECTs no escopo do aplicativo, mas somente administradoresde pode conceder permissões para aplicativos para usar conexões de BCS.

Implantar um add-in-no escopo do tipo de conteúdo externo em um recurso personalizado em um arquivo WSP

Você pode incluir um modelo BDC em um arquivo WSP para implantação. O exemplo a seguir mostra como incluir um modelo BDC no aplicativo.


<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <BdcModel Path="BDCMetadata.bdcm">
  </BdcModel>
</Elements>

Importante

[!IMPORTANTE] Apenas um arquivo de modelo BDC pode ser incluído por suplemento. Enquanto o nome de arquivo neste exemplo é BDCMetadata.bdcm, o arquivo de modelo, na verdade, pode ser qualquer nome escolhido desde que coincide com o nome do arquivo que está no atributo Path do arquivo de modelo BDC.

Observação

[!OBSERVAçãO] São permitidas conexões de protocolo OData de dados aberta somente para adicionar no escopo tipos de conteúdo externo.

Definir as credenciais de segurança para um sistema externo

Para acessar os dados em um sistema externo protegido, você deve configurar o modelo BDC com as credenciais apropriadas.

O exemplo a seguir mostra como definir as credenciais de segurança para um sistema externo em tipos de conteúdo externo adicionar no escopo modificando o arquivo Elements. XML do aplicativo.


<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <BdcModel Path="BDCMetadata.bdcm">
    <LobSystem Name="SAP">
       <LobSystemInstance Name="SAPInst" RequireCredentials="true" CredentialsDescription="Credentials to connect to SAP"/>
    </LobSystem>
    <LobSystem Name="SQL">
       <LobSystemInstance Name="App Database" DataSource="SQL-Azure" RequireCredentials="true" />
    </LobSystem>
  </BdcModel>
</Elements>

Compartilhar via