Como Transferir Arquivos de um Aplicativo Vinyl para o SharePoint¶

Este artigo percorrerá os elementos básicos de configuração necessários para transferir arquivos de um aplicativo Vinyl para um local do SharePoint.

Observe que o caso de uso comercial descrito neste artigo pode ser um pouco diferente do seu caso de uso específico e pode ser necessário fazer alguns ajustes para acomodá-lo adequadamente.

Etapa 1: Adicionar o Servidor de Dados do SharePoint¶

1. Navegue até IDE > Servidores de dados
2. Clique em + Servidor para adicionar um novo servidor de dados
   • Forneça um Nome do servidor. Por exemplo: MeuSharePoint
   • Defina Tipo como Microsoft SharePoint
   • Insira a URL do diretório do SharePoint onde você armazenará os arquivos. https://yourcompany.sharepoint.com/directory
   • Expanda Configurações de segurança e insira os valores Nome de usuário e Senha para um usuário autorizado se conectar a este local do SharePoint
   • Clique em Salvar
   • Expanda Testing e clique em Test Connection para confirmar se o servidor pode ser acessado com as credenciais fornecidas

Etapa 2: Definir o Procedimento Armazenado UploadDocument Como Público¶

1. Clique no x para sair do pop-up Servidor e retornar à lista de Servidores de Dados
2. Com seu novo servidor de dados selecionado, clique no botão Detalhes
3. Clique no botão Procedimentos da camada de armazenamento de dados
4. No painel Procedimentos, clique no ícone de lápis Editar para o registro UploadDocument
5. Marque para ativar a configuração Público como Ativado
6. Clique no botão Continuar para salvar

Etapa 3 – Vincular a Fonte de Dados do SharePoint à Fonte de Dados do Seu Aplicativo¶

1. Clique no x para sair do pop-up de procedimentos
2. Clique no x para sair do pop-up do Microsoft SharePoint e retornar à lista de servidores de dados
3. Selecione o registro Default Data Server no painel Data Servers
4. Clique no botão Detalhes próximo à entrada do App Data Server no painel Fontes de dados
5. Clique no botão Fontes do link
6. Clique em Criar
7. Defina o valor Fonte de dados vinculada como o Nome atribuído à nova fonte de dados do SharePoint
8. Clique no ícone de marca de seleção para salvar

Etapa 4 - Adicionar Tabela aos Arquivos de Preparação para Transferência para o SharePoint¶

Esta etapa é principalmente opcional, a parte crítica da configuração é onde você registra o procedimento como uma ação. Isso pode ser registrado em um evento personalizado conectado a um botão ou como é descrito neste caso de uso específico. Você pode ter tabelas e/ou regras existentes que deseja usar em seu caso de uso.

1. Você precisará de uma regra que contenha colunas para Nome, Arquivo e Biblioteca. Você pode nomeá-los como quiser.

2. Crie uma tabela na fonte de dados do aplicativo para conter os arquivos a serem carregados. Por exemplo: ReportArchive. Colunas a incluir:

   • Caminho do Arquivo
   • NomeArquivoSharePoint
   • Biblioteca SharePoint

3. Clique em Eventos na tabela ReportArchive

4. Selecione o evento Inserir e clique no ícone Abrir registro

5. Clique no botão Registrar existente no painel Ações

   • Defina Tipo como Procedimento
   • Defina Procedure para o registro SharePoint Data Source.UploadDocument

6. Clique em Salvar

7. Clique em + Vinculação em Ação (ligações explícitas)

   • Adicione três registros para mapear para a tabela Nome, Arquivo e Biblioteca. Os nomes das colunas de origem serão mapeados para os nomes das colunas na tabela.

Passo 5 – Crie uma Regra CRUD para Inserir na Nova Tabela¶

Esta etapa é opcional, no caso de uso de negócios descrito neste artigo é como acionamos a Ação do Evento. Seu caso de uso pode ser diferente.

As 3 colunas precisam destes valores:

• Nome - Nome que você deseja que o arquivo seja chamado no SharePoint. Por exemplo: teste.xlsx
• Arquivo - Caminho e nome do arquivo do documento no servidor Vinyl. Por exemplo: C:\Docs\myfile.xlsx
• Biblioteca - Nome da biblioteca do SharePoint - uso Shared Documents para biblioteca padrão do SharePoint

Passo 6 – Adicione a Regra CRUD ao Evento Que Cria o Documento¶

• Adicione a Regra CRUD após a etapa que cria o documento
• Se desejar remover o documento do Vinyl File System após a transferência para o SharePoint, você pode adicionar outra ação ao evento da tabela ReportArchive para fazer isso após o procedimento UploadDocument.