Início Rápido: Criar seu primeiro aplicativo com VS Code

Aplica-se a: Desenvolvedor

Use a extensão do Visual Studio Code Embedded do SharePoint para criar um tipo de contêiner padrão para seu primeiro aplicativo. A extensão também configura o aplicativo proprietário, anexa a cobrança do Azure e registra o tipo de contêiner. Em seguida, crie um contêiner e execute um aplicativo de exemplo local.

Este artigo inicia a jornada de compilação. Para obter mais diretrizes de cobrança, consulte Criar e configurar um tipo de contêiner.

Pré-requisitos

Antes de começar, verifique se você tem:

• Visual Studio Code instalado.
• Acesso administrativo a um locatário do Microsoft 365.
• Um locatário com o SharePoint disponível.
• Uma assinatura do Azure e um grupo de recursos que sua conta possa acessar.
• Permissões de Proprietário ou Colaborador na assinatura do Azure.
• Node.js e npm instalados para o aplicativo de exemplo.
• Permissão para conceder consentimento de administrador no Microsoft Entra ID.

Instale a extensão

1. Abra o Visual Studio Code.
2. Abra Extensões na barra de atividades.
3. Pesquisar por SharePoint Embedded.
4. Selecione Instalar.
5. Se a extensão já estiver instalada, atualize-a.
6. Selecione o ícone do SharePoint Embedded na barra de atividades.

Entrar

1. No modo de exibição do SharePoint Embedded, selecione a ação de entrada.
2. Use uma conta de administrador do Microsoft 365.
3. Autenticação completa no navegador.
4. Examine as permissões solicitadas.
5. Selecione Aceitar para conceder consentimento do administrador.
6. Retorne ao Visual Studio Code quando redirecionado.

Depois de entrar, a extensão mostra o modo de exibição de página inicial do SharePoint Embedded.

Criar um tipo de contêiner padrão

Um tipo de contêiner define a relação, os privilégios de acesso, a responsabilidade de cobrança e os comportamentos selecionados para um conjunto de contêineres do SharePoint Embedded.

1. Selecione Criar Tipo de Contêiner.
2. Para o método de cobrança, selecione padrão.
3. Insira um nome de tipo de contêiner.
4. Siga as instruções até que a criação seja concluída.

Use um tipo de contêiner padrão quando a organização proprietária do aplicativo pagar pelo uso do SharePoint Embedded. Para avaliação, escolha avaliação. Para cobrança cliente-locatário, escolha a opção de passagem, que usa a directToCustomer classificação de cobrança.

Crie ou selecione o aplicativo proprietário

Cada tipo de contêiner tem um aplicativo proprietário do Microsoft Entra ID.

1. Crie um novo aplicativo do Microsoft Entra ID ou selecione um ID de aplicativo existente.
2. Se você criar um novo aplicativo, insira o nome dele.
3. Deixe a extensão definir as configurações de desenvolvimento.

Para obter o modelo, consulte Arquitetura de aplicativos do SharePoint Embedded.

Configurar cobrança padrão

Os tipos de contêiner Standard exigem cobrança do Azure. A extensão anexa a cobrança usando uma assinatura do Azure e um grupo de recursos que sua conta pode acessar.

1. Selecione uma assinatura do Azure.
2. Selecione um grupo de recursos.
3. Aguarde a extensão para registrar o provedor de recursos Microsoft.Syntex e anexar a cobrança.

Se você ignorar a configuração de cobrança ou não tiver as permissões necessárias do Azure, a árvore mostrará Cobrança não configurada. Para concluir a configuração posteriormente, clique com o botão direito do mouse no tipo de contêiner. Em seguida, selecione Anexar cobrança.

Registrar o tipo de contêiner localmente

Você deve registrar o tipo de contêiner no locatário consumidor antes que seu aplicativo possa criar contêineres ou acessar conteúdo.

1. Após a criação, siga o prompt para registrar o tipo de contêiner no locatário local.
2. Se a solicitação não estiver visível, clique com o botão direito do mouse no tipo de contêiner e selecione Registrar.
3. Examine as permissões.
4. Ofereça consentimento de administrador no navegador.
5. Retorne ao Visual Studio Code.

O registro configura as permissões que o aplicativo proprietário pode usar em contêineres do tipo de contêiner.

Criar seu primeiro contêiner

1. Na árvore do SharePoint Embedded, expanda o tipo de contêiner.
2. Clique com o botão direito do mouse em Contêineres.
3. Selecione Criar contêiner.
4. Insira um nome de contêiner.
5. Confirme se o contêiner aparece na árvore.

Um contêiner é a unidade básica de armazenamento e o limite de segurança no SharePoint Embedded.

Carregar um aplicativo de exemplo

1. No modo de exibição Inserido do SharePoint, selecione Carregar Aplicativo de Exemplo.
2. Escolha uma amostra do SharePoint Embedded.

1. Examine o aviso sobre segredos locais de texto sem formatação.
2. Se solicitado a criar um segredo do cliente, selecione OK para desenvolvimento local.
3. Deixe a extensão preencher o arquivo de configuração de tempo de execução.

Executar o aplicativo de exemplo

Abra um terminal e execute o aplicativo de exemplo por meio do diretório de exemplo gerado.

cd [your-path]\SharePoint-Embedded-Samples\Custom Apps\boilerplate-typescript-react
npm run start

O exemplo começa:

• Um aplicativo cliente do React.
• Um servidor de aplicativos do Azure Functions.

Aguarde até que ambas as saídas do console apareçam.

Depois:

1. Abrir http://localhost:8080.
2. Entre com a mesma conta de administrador do Microsoft 365.
3. Selecione Contêineres na página inicial.
4. Crie contêineres e carregue arquivos usando a interface do usuário de exemplo.

Solucionar problemas de inicialização

Limpar

Quando terminar de testar:

1. Remova os contêineres de teste que não são mais necessários.
2. Examine os recursos de cobrança do Azure que você criou para este início rápido.
3. Remova os segredos de exemplo locais que não são mais necessários.

Próximas etapas

Saiba mais sobre as opções de tipo de contêiner em Criar e configurar um tipo de contêiner.