Usar uma planilha para adicionar dados
Adicione tabelas de dados e registros à sua aplicação carregando Microsoft planilha do Excel.
Antes de Iniciar
Função necessária: admin, sn_app_eng_studio.user
Procedimento
Importar uma planilha
Carregue uma planilha do Excel Microsoft e use-a para criar seu modelo de dados da aplicação.
Antes de Iniciar
- Formatado com colunas horizontais e um rótulo de cabeçalho para cada
- Salvo como um tipo de arquivo XLSX
Função necessária: admin, sn_app_eng_studio.user ou permissões de desenvolvedor delegado. Para obter mais informações, consulte Delegar desenvolvedores usando AES.
Procedimento
- Navegar até Todos > App Engine > App Engine Studio.
- Na página Meus aplicativos, abra seu aplicativo.
-
Ao lado do título Dados, selecione o ícone
).
- Selecione Importar uma planilhae Continuar.
-
Carregue sua planilha e selecione Continuar.
Você pode arrastar o arquivo da planilha para App Engine Studio ou navegar pelo seu computador.
-
Você verá um dos seguintes caminhos:
- Se sua planilha tiver apenas uma guia de planilha, prossiga para a próxima etapa.
- Se a planilha tiver várias guias de planilha, você terá uma lista de planilhas para escolher. Nessa lista de planilhas, você pode selecionar qual guia de planilha adicionar como uma tabela à sua aplicação primeiro.
-
No campo Insira um número de linha para o cabeçalho da tabela, insira o número da linha na qual os cabeçalhos da coluna da planilha estão localizados.
Por exemplo, se os cabeçalhos estiverem na segunda linha, insira 2.
- Opcional:
Para carregar as informações abaixo dos cabeçalhos das colunas na planilha (por exemplo, os dados da sua planilha), selecione a opção Importar dados da planilha.
Para carregar somente os cabeçalhos das colunas, deixe a caixa de seleção desmarcada. Você pode carregar somente os cabeçalhos se pretender usar esta tabela como modelo e não quiser que nenhum outro dado seja adicionado à sua tabela AES.
-
Faça uma das seguintes seleções.
- Se você carregou um arquivo do Excel com várias guias de planilha, selecione Converter em tabela para prosseguir com a conversão da guia de planilha selecionada em uma tabela e prossiga para a próxima etapa.
- Se você carregou um arquivo do Excel com uma única guia de planilha, selecione Continuar.
As opções são exibidas para onde importar seu arquivo. -
Com base no que você deseja fazer com os dados da planilha, navegue até um dos procedimentos a seguir para continuar.
Opção Descrição Criar uma nova tabela diretamente da importação da planilha Consulte Criar nova tabela a partir da importação de planilha para obter as próximas etapas. Crie uma nova tabela estendendo uma tabela existente e usando a importação da planilha para atualizá-la Consulte Criar nova tabela a partir da tabela extensível e importação de planilha para obter as próximas etapas. Use a importação de planilha para atualizar uma tabela da aplicação existente Consulte Modificar tabela existente usando a importação de planilha para obter as próximas etapas.
Criar nova tabela a partir da importação de planilha
Crie novas tabelas diretamente de uma importação de planilha do Excel Microsoft.
Antes de Iniciar
- Importe uma planilha para App Engine Studio. Consulte Importar uma planilha.
Função necessária: admin, sn_app_eng_studio.user ou permissões de desenvolvedor delegado. Para obter mais informações, consulte Delegar desenvolvedores usando AES.
Procedimento
-
Depois de carregar sua planilha conforme descrito em Importar uma planilha, escolha o que você deseja fazer com os dados importados no assistente exibido.
Figura 1. Criar nova tabela a partir de planilha - Selecione Uma nova tabela.
- Escolha Criar nova tabela.
- Selecione Continuar.
-
Revise as propriedades de cada cabeçalho de coluna, usando o menu suspenso Expandir opções para exibir mais propriedades.
Propriedade do cabeçalho da coluna Descrição Rótulo do Campo Rótulo exclusivo para a coluna. Nome do campo Nome do banco de dados da coluna. Tipo Tipo de informação que a coluna contém. Por exemplo, para conter texto sem formatação na coluna, selecione Cadeia de caracteres.
Dependendo do tipo selecionado, preencha os campos adicionais para definir ainda mais a coluna da tabela. Por exemplo, se você selecionar Cadeiade caracteres , defina o limite de caracteres da entrada da cadeia de caracteres. Ou, se você selecionar Opção, defina as opções que os usuários podem escolher.
Consulte Field types.
Limite de caracteres Tamanho máximo das cadeias de caracteres que podem ser armazenadas.
Exibição Opção para definir a coluna como o valor de exibição da tabela. Um campo de referência mostra o valor de exibição da tabela à qual ele está se referindo. Por exemplo, a coluna Aberto por da tabela de tarefas se refere à tabela do usuário. Como o valor de exibição da tabela do usuário é o nome do usuário, o campo Aberto por mostra algo como Beth Anglin ou Joe Employee. Ao selecionar um valor de exibição, escolha a coluna da tabela que atuaria como um título apropriado para registros individuais.
Somente uma coluna pode atuar como o valor de exibição de uma tabela.
Obrigatório Opção para exigir que a coluna contenha um valor antes que um novo registro possa ser salvo. Para adicionar outra coluna à tabela, selecione Adicionar novo campo.
Para excluir uma coluna, selecione o ícone da lixeira ( Ícone da
).
- Selecione Continuar para definir as propriedades da tabela.
-
No formulário, preencha os campos.
Campo Descrição Rótulo da tabela Rótulo exclusivo para identificar a tabela. Nome da tabela Nome do banco de dados da tabela. Um nome de tabela é criado automaticamente depois que você insere um rótulo de tabela. Você pode editar o nome, se necessário. Tornar extensível Opção para permitir que outras tabelas compartilhem dados desta tabela. Para obter mais informações sobre extensão de tabela, consulte Extensão de tabela. Numeração automática Opção para rastrear registros de tabela com um número exclusivo. Se você selecionar esta opção, defina o Prefixo, Número iniciale Número de dígitos. Prefixo Nome abreviado da tabela a ser anexada ao início do número do registro. Por exemplo, se você estiver criando uma tabela "Laptop", o prefixo poderá ser "LPTP" ou "LT".
Número inicial Número para identificar o primeiro registro criado para sua tabela.
Número de algarismos Número máximo de dígitos permitido no número do registro. Este valor determina o maior número de registro possível. Por exemplo, se você inserir 7, o maior número possível será 9999999.
- Selecione Continuar.
-
Controle quem tem acesso para criar, ler, gravar e excluir conteúdo desta tabela adicionando novas funções e/ou definindo as permissões desejadas de Criar, Ler, Gravar e Excluir para as funções existentes.
As funções que você cria na tabela persistem em toda a aplicação e podem ser definidas em outras tabelas adicionadas. Consulte Adicionar segurança da aplicação para obter mais informações sobre como funcionam as permissões de segurança.
Nota:Pelo menos uma função deve ter acesso de leitura para que você possa visualizar a tabela. - Selecione Continuar para adicionar a nova tabela criada a partir da planilha à sua aplicação.
- Opcional:
Converta todas as planilhas restantes se o arquivo contiver várias guias de planilha.
- Nota:Para cada planilha que você deseja converter, será necessário selecionar Converter em tabelae repetir as etapas deste procedimento ou escolher um caminho diferente para a planilha adicional (consulte Criar nova tabela a partir da tabela extensível e importação de planilha ou Modificar tabela existente usando a importação de planilha para obter as etapas).
- Se você não tiver várias planilhas, prossiga para a próxima etapa.
-
Selecione Concluído na tela de resumo.
Como alternativa, para exibir sua tabela em Construtor de tabelas, você pode selecionar Editar tabela(s) na tela de resumo.
O que Fazer Depois
Para obter mais informações sobre como editar suas tabelas de dados em Construtor de tabelas, consulte Construtor de tabelas.
Criar nova tabela a partir da tabela extensível e importação de planilha
Crie uma nova tabela estendendo uma tabela existente e usando uma importação de planilha do Excel Microsoft para atualizá-la ou personalizá-la.
Antes de Iniciar
- Importe uma planilha para App Engine Studio. Consulte Importar uma planilha.
Função necessária: admin, sn_app_eng_studio.user, permissões de desenvolvedor delegadas para "Integração" devem estar presentes para exibir as opções de importação e mapeamento de dados. Para obter mais informações, consulte Delegar desenvolvedores usando AES.
Procedimento
-
Depois de carregar sua planilha conforme descrito em Importar uma planilha, escolha para onde importar seu arquivo no assistente exibido.
Figura 2. Importar para uma nova tabela de dados - Selecione Uma nova tabela.
- Escolha Criar a partir de uma tabela extensível.
- Selecione Continuar.
-
Pesquise e selecione uma Tabela existente para adicionar os dados dessa tabela à sua aplicação e criar uma extensão com lógica de ramificação.
Nota:As tabelas que já estão no app são exibidas primeiro na lista e as tabelas Now Platform recomendadas são exibidas em seguida, junto com uma descrição resumida do tipo de informação que a tabela armazena.
- Selecione Continuar.
-
No formulário, preencha os campos.
Campo Descrição Rótulo da tabela Rótulo exclusivo para identificar a tabela. Nome da tabela Nome do banco de dados da tabela. Um nome de tabela é criado automaticamente depois que você insere um rótulo de tabela. Você pode editar o nome, se necessário. Tornar extensível Opção para permitir que outras tabelas compartilhem dados desta tabela. Para obter mais informações sobre extensão de tabela, consulte Extensão de tabela. Numeração automática Opção para rastrear registros de tabela com um número exclusivo. Se você selecionar esta opção, defina o Prefixo, Número iniciale Número de dígitos. Prefixo Nome abreviado da tabela a ser anexada ao início do número do registro. Por exemplo, se você estiver criando uma tabela "Laptop", o prefixo poderá ser "LPTP" ou "LT".
Número inicial Número para identificar o primeiro registro criado para sua tabela.
Número de algarismos Número máximo de dígitos permitido no número do registro. Este valor determina o maior número de registro possível. Por exemplo, se você inserir 7, o maior número possível será 9999999.
- Selecione Continuar.
-
Controle quem tem acesso para criar, ler, gravar e excluir conteúdo desta tabela adicionando novas funções e/ou definindo as permissões desejadas de Criar, Ler, Gravar e Excluir para as funções existentes.
As funções que você cria na tabela persistem em toda a aplicação e podem ser definidas em outras tabelas adicionadas. Consulte Adicionar segurança da aplicação para obter mais informações sobre como funcionam as permissões de segurança.
Nota:Pelo menos uma função deve ter acesso de leitura para que você possa visualizar a tabela. -
Selecione Continuar.
Nota:Agora sua tabela está pronta para os dados. Na próxima etapa, os campos da sua importação serão correspondidos aos campos da tabela recém-estendida. Você terá a oportunidade de ajustar o mapeamento ou criar novos campos a partir da importação.
-
Selecione Continuar para prosseguir para os campos de mapeamento.
Uma tela é exibida, na qual você pode mapear colunas de campo da planilha de origem à esquerda para colunas de campo na tabela de destino recém-estendida que acabou de criar à direita.
Figura 3. Mapear campos importados -
Você tem as seguintes opções disponíveis durante esta etapa.
Opção Descrição Campos de mapa de lote usando o mapeamento automático Selecione Mapeamento automático para mapear automaticamente os campos da planilha para os campos exibidos na tabela de destino selecionada. O mapeamento automático mapeia entidades de origem para entidades de destino com nome semelhante. Para uma entidade de destino que já foi mapeada, selecionar Mapeamento automático não muda seu valor. Um campo mapeado automaticamente tem um ícone de varinha na cápsula de dados. Mapear campos arrastando e soltando Mapeie os campos da importação para a tabela de destino arrastando cápsulas de dados que representam colunas na planilha importada para a coluna Valor na tabela de destino. Você também pode mapear campos usando o seletor de cápsula à direita de cada campo da tabela de destino.
Mapear campos usando o seletor de dados Mapeie os dados usando o seletor de cápsula (
de cápsula) no lado direito da tabela de destino. Você pode inserir mais de um valor na coluna Valor e também pode inserir texto.
Adicionar opções de transformação Adicione opções de transformação para cada um dos campos de planilha mapeados individuais clicando no ícone) no painel lateral direito. Por exemplo, você pode usar a função de transformação de maiúsculas para mudar uma cadeia de caracteres de entrada para todos os caracteres em maiúsculas. Consulte Transform functions para obter informações sobre como usá-los para ajustar dados dos campos de planilha importados.
Nota:Nem todas as funções de transformação disponíveis no Flow Designer estão disponíveis.Ativar correspondência de registro de dados Especifique os campos em que o sistema deve verificar se há dados correspondentes e, se encontrados, atualize os registros existentes em vez de criar novos, habilitando a alternância de correspondência na tabela de destino. Por exemplo, se uma tabela de destino tiver um campo Número de pedido e um registro com um número de pedido 743, haverá duas opções para lidar com possíveis correspondências.- Se o comutador de alternância Corresponder do campo Número do pedido estiver ativado, o sistema verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, o sistema atualizará o registro existente na tabela de destino.
- Se o comutador de alternância Corresponder do campo Número do pedido estiver desativado, o sistema não verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, o sistema criará um novo registro na tabela de destino. Nesse caso, a tabela de destino terá dois registros, ambos com um número de ordem de 743.
Configurar o comportamento dos campos de referência e de opção Configure o comportamento dos tipos de campo Opção e Referência. - Clique no ícone de engrenagem (ícone de
).
- Em Campo, selecione a coluna de campo para corresponder ao valor do registro de entrada na tabela de destino.
- Em Se não houver nenhum registro correspondente, faça o seguinte, especifique o que fazer se esse registro não for encontrado na tabela de destino.
- Criar uma nova opção/registro: cria a opção ou o registro na coluna de campo correspondente da tabela de destino a partir dos dados importados para o campo.
- Ignorar este campo: ignora o campo na tabela de destino e o deixa nulo.
- Ignorar este registro: ignora a adição do registro inteiro (linha) na tabela de destino.
- Clique em Concluído.
Adicionar novas colunas de campo à tabela de destino Adicione colunas de campo não mapeadas da sua importação para a tabela de destino ou crie novos campos na tabela de destino. - Selecione Adicionar campos acima da tabela de destino à direita.
- Escolha quais campos adicionar à sua tabela de destino marcando a caixa de seleção à esquerda ou selecione Todos para escolher todos eles.
- Você também pode executar as seguintes funções:
- Edite o rótulo do campo importado.
- Edite as propriedades do campo importado selecionando o ícone Editar (
).
- Crie um novo campo clicando em Criar um novo campo no canto superior direito da janela.
- Selecione Adicionar campos para adicionar os campos selecionados à sua tabela de destino.
- Selecione Continuar para criar o mapeamento de importação de dados e atualizar sua tabela de destino.
- Opcional:
Converta todas as planilhas restantes se o arquivo contiver várias guias de planilha.
- Nota:Para cada planilha que você deseja converter, será necessário selecionar Converter em tabelae repetir as etapas deste procedimento ou escolher um caminho diferente para a planilha adicional (consulte Criar nova tabela a partir da importação de planilha ou Modificar tabela existente usando a importação de planilha para obter as etapas).
- Se você não tiver várias planilhas, prossiga para a próxima etapa.
-
Selecione Concluído na tela de resumo.
Como alternativa, para exibir sua tabela em Construtor de tabelas, você pode selecionar Editar tabela(s) na tela de resumo.
O que Fazer Depois
Para obter mais informações sobre como editar suas tabelas de dados em Construtor de tabelas, consulte Construtor de tabelas.
Modificar tabela existente usando a importação de planilha
Use uma importação de planilha do Excel Microsoft para atualizar uma tabela da aplicação existente.
Antes de Iniciar
- Importe uma planilha para App Engine Studio. Consulte Importar uma planilha.
Função necessária: admin, sn_app_eng_studio.user ou permissões de desenvolvedor delegado. Para obter mais informações, consulte Delegar desenvolvedores usando AES.
Procedimento
-
Depois de carregar sua planilha conforme descrito em Importar uma planilha, escolha para onde importar seu arquivo no assistente exibido.
Figura 4. Importar para uma tabela da aplicação existente - Selecione Uma tabela existente.
- Selecione uma tabela de aplicação existente na lista exibida.
-
Selecione Continuar.
Uma tela é exibida, na qual você pode mapear colunas de campo da planilha de origem à esquerda para colunas de campo na tabela da aplicação de destino existente à direita.Nota:Você terá a oportunidade de ajustar o mapeamento ou criar novos campos a partir da importação.
Figura 5. Mapear campos importados -
Você tem as seguintes ações disponíveis para você durante esta etapa.
Opção Descrição Campos de mapa de lote usando o mapeamento automático Selecione Mapeamento automático para mapear automaticamente os campos da planilha para os campos exibidos na tabela de destino selecionada. O mapeamento automático mapeia entidades de origem para entidades de destino com nome semelhante. Para uma entidade de destino que já foi mapeada, selecionar Mapeamento automático não muda seu valor. Um campo mapeado automaticamente tem um ícone de varinha na cápsula de dados. Mapear campos arrastando e soltando Mapeie os campos da importação para a tabela de destino arrastando cápsulas de dados que representam colunas na planilha importada para a coluna Valor na tabela de destino. Você também pode mapear campos usando o seletor de cápsula à direita de cada campo da tabela de destino.
Mapear campos usando o seletor de dados Mapeie os dados usando o seletor de cápsula (
de cápsula) no lado direito da tabela de destino. Você pode inserir mais de um valor na coluna Valor e também pode inserir texto.
Adicionar opções de transformação Adicione opções de transformação para cada um dos campos de planilha mapeados individuais clicando no ícone) no painel lateral direito. Por exemplo, você pode usar a função de transformação de maiúsculas para mudar uma cadeia de caracteres de entrada para todos os caracteres em maiúsculas. Consulte Transform functions para obter informações sobre como usá-los para ajustar dados dos campos de planilha importados.
Nota:Nem todas as funções de transformação disponíveis no Flow Designer estão disponíveis.Ativar correspondência de registro de dados Especifique os campos em que o sistema deve verificar se há dados correspondentes e, se encontrados, atualize os registros existentes em vez de criar novos, habilitando a alternância de correspondência na tabela de destino. Por exemplo, se uma tabela de destino tiver um campo Número de pedido e um registro com um número de pedido 743, haverá duas opções para lidar com possíveis correspondências.- Se o comutador de alternância Corresponder do campo Número do pedido estiver ativado, o sistema verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, o sistema atualizará o registro existente na tabela de destino.
- Se o comutador de alternância Corresponder do campo Número do pedido estiver desativado, o sistema não verificará se há dados correspondentes. Se os dados de origem tiverem um registro com o mesmo número de ordem, o sistema criará um novo registro na tabela de destino. Nesse caso, a tabela de destino terá dois registros, ambos com um número de ordem de 743.
Configurar o comportamento dos campos de referência e de opção Configure o comportamento dos tipos de campo Opção e Referência. - Clique no ícone de engrenagem (ícone de
).
- Em Campo, selecione a coluna de campo para corresponder ao valor do registro de entrada na tabela de destino.
- Em Se não houver nenhum registro correspondente, faça o seguinte, especifique o que fazer se esse registro não for encontrado na tabela de destino.
- Criar uma nova opção/registro: cria a opção ou o registro na coluna de campo correspondente da tabela de destino a partir dos dados importados para o campo.
- Ignorar este campo: ignora o campo na tabela de destino e o deixa nulo.
- Ignorar este registro: ignora a adição do registro inteiro (linha) na tabela de destino.
- Clique em Concluído.
Adicionar novas colunas de campo à tabela de destino Adicione colunas de campo não mapeadas da sua importação para a tabela de destino ou crie novos campos na tabela de destino. - Selecione Adicionar campos acima da tabela de destino à direita.
- Escolha quais campos adicionar à sua tabela de destino marcando a caixa de seleção à esquerda ou selecione Todos para escolher todos eles.
- Você também pode executar as seguintes funções:
- Edite o rótulo do campo importado.
- Edite as propriedades do campo importado selecionando o ícone Editar (
).
- Crie um novo campo clicando em Criar um novo campo no canto superior direito da janela.
- Selecione Adicionar campos para adicionar os campos selecionados à sua tabela de destino.
-
Selecione Continuar para criar o mapeamento de importação de dados e atualizar sua tabela de destino.
Nota:Você será avisado se houver algum campo não mapeado restante na planilha. Você pode mapear esses campos ou continuar sem mapeá-los.
- Opcional:
Converta todas as planilhas restantes se o arquivo contiver várias guias de planilha.
- Nota:Para cada planilha que você deseja converter, será necessário selecionar Converter em tabelae repetir as etapas deste procedimento ou escolher um caminho diferente para a planilha adicional (consulte Criar nova tabela a partir da importação de planilha ou Criar nova tabela a partir da tabela extensível e importação de planilha para obter as etapas).
- Se você não tiver várias planilhas, prossiga para a próxima etapa.
-
Selecione Concluído na tela de resumo.
Como alternativa, para exibir sua tabela em Construtor de tabelas, você pode selecionar Editar tabela(s) na tela de resumo.
O que Fazer Depois
Para obter mais informações sobre como editar suas tabelas de dados em Construtor de tabelas, consulte Construtor de tabelas.