Como transferir arquivos de um aplicativo App Builder para o SharePoint no Jitterbit App Builder
Este artigo abordará os elementos básicos de configuração necessários para transferir arquivos de um aplicativo App Builder 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 talvez seja necessário fazer alguns ajustes para acomodá-lo adequadamente.
Etapa 1: adicionar o servidor de dados do SharePoint
- Navegue até IDE > Servidores de Dados
- Clique em + Servidor para adicionar um novo Servidor de Dados
- Forneça um Nome do Servidor. Por exemplo: MySharePoint
- Defina Tipo como Microsoft SharePoint
- Insira a URL para o diretório do SharePoint onde você armazenará os arquivos. Por exemplo:
https://yourcompany.sharepoint.com/directory
- Expanda Configurações de Segurança e insira os valores de Nome de Usuário e Senha para que um Usuário autorizado se conecte a este local do SharePoint.
- Clique em Salvar
- Expanda Teste e clique em Testar Conexão para confirmar que o servidor pode ser acessado com as credenciais fornecidas.
Etapa 2: defina o procedimento armazenado uploaddocument como público
- Clique no x para sair do pop-up Servidor e retornar à lista de Servidores de Dados.
- Com o novo Servidor de Dados selecionado, clique no botão Detalhes.
- Clique no botão Procedimentos na Camada de Armazenamento de Dados.
- No painel Procedimentos, clique no ícone de lápis Editar para o registro UploadDocument.
- Marque para habilitar a configuração Público como Ativado.
- Clique no botão Prosseguir para salvar.
Importante
Se você não visualizar os registros de Procedimento ao clicar na tela, talvez seja necessário excluir e recriar o servidor de conexão do SharePoint. O App Builder faz uma chamada inicial, no momento da criação, para um servidor de dados do SharePoint para recuperar informações de Procedimento e Tabela. Se os registros de Procedimento não estiverem visíveis, tente recriar o Servidor de Dados.
Etapa 3: vincule a fonte de dados do SharePoint à fonte de dados do seu aplicativo
- Clique no x para sair do pop-up de procedimentos
- Clique no x para sair do pop-up do Microsoft SharePoint e retornar à lista de servidores de dados
- Selecione o registro Servidor de dados Padrão no painel Servidores de dados
- Clique no botão Detalhes ao lado da entrada Servidor de dados do aplicativo no painel Fontes de dados
- Clique no botão Vincular fontes
- Clique em Criar
- Defina o valor Fonte de dados vinculada como o nome atribuído à nova fonte de dados do SharePoint
- Clique no ícone de marca de seleção para salvar
Etapa 4: adicionar tabela para preparar arquivos para transferência para o SharePoint
Esta etapa é em grande parte opcional; a parte crítica a ser configurada é 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.
- Você precisará de uma Regra que conterá colunas para Nome, Arquivo e Biblioteca. Você pode nomeá-las como quiser.
-
Crie uma tabela na Fonte de Dados do Aplicativo para conter os arquivos a serem enviados. Por exemplo: ReportArchive. Colunas a serem incluídas:
- FilePath
- SharePointFileName
- SharePointLibrary
-
Clique em Eventos na tabela ReportArchive
- Selecione o evento Inserir e clique no ícone Abrir Registro
-
Clique no botão Registrar Existente no painel Ações
- Defina Tipo como Procedimento
- Defina Procedimento como o registro SharePoint Data Source.UploadDocument
-
Clique em Salvar
-
Clique em + Vinculação em Ação (Vinculaçõ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.
Etapa 5: Crie uma regra CRUD para inserir na nova tabela
Esta etapa é opcional. No caso de uso comercial 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 nomeado no SharePoint. Por exemplo: testing.xlsx
- Arquivo - Caminho e nome do arquivo do documento no servidor do App Builder. Por exemplo:
C:\Docs\myfile.xlsx
- Biblioteca - Nome da biblioteca do SharePoint - usar
Shared Documents
para a biblioteca padrão do SharePoint
Etapa 6: adicione a regra CRUD ao evento que cria o documento
- Adicione a regra CRUD após a etapa de criação do documento
- Se desejar remover o documento do Sistema de Arquivos do App Builder após a transferência para o SharePoint, você poderá adicionar outra Ação ao Evento da tabela ReportArchive para fazer isso após o procedimento UploadDocument.