Documentação do Oracle Cloud Infrastructure

Instalar e configurar o complemento do Google Sheets

Antes de instalar o complemento do Oracle Autonomous Database para o Google Sheets, faça download do arquivo zip oracleGoogleAddin na sua instância do Database Actions.

Agora você pode exibir um arquivo zip na pasta Downloads do sistema. Extraia o conteúdo do arquivo zip em seu sistema.

Para configurar o complemento do Oracle Autonomous Database para o Google Sheets, importe os arquivos na pasta oracleGoogleAddin para o Script do Google Apps.
Observação

A importação dos arquivos é uma atividade única e, geralmente, isso é feito por um administrador.

Depois de importar ou fazer upload dos arquivos para o Script do Google Apps, siga estas etapas para concluir a configuração do complemento do Oracle Autonomous Database para o Google Sheets:

Tópico principal: Oracle Autonomous Database para Planilhas Google

Fazer upload de arquivos oracleGoogleAddin para o Script do Google Apps usando o Clasp

Para fazer upload de todos os arquivos presentes na pasta oracleGoogleAddin, você deve usar o Projeto de Script Aplicativos de Linha de Comando (clasp).

O Clasp é uma ferramenta de código aberto para desenvolver e gerenciar os projetos de script do Google Apps a partir do seu terminal.
Observação

O fecho é gravado em Node.js e distribuído por meio da ferramenta Gerenciador de Pacotes de Nós (NPM). É necessário instalar o Node.js versão 4.7.4 ou posterior para usar o fecho.
  1. Digite sheet.new na barra de endereços do navegador da Web para abrir o Google Sheets. Verifique se você está conectado com sua conta do Google.
  2. Selecione Script de Aplicativos no menu Extensões. Você pode exibir a janela do editor de Script de Aplicativos.
    A seguir, descrição de apps-script-window.png
    Descrição da ilustração apps-script-window.png

  3. Selecione o arquivo Code.gs na janela do editor de Script de Aplicativos, que já existe por padrão. Clique nos pontos verticais ao lado do arquivo Code.gs. Selecione Excluir para excluir o arquivo Code.gs existente.
  4. Depois de instalar o Node.js, insira o comando npm a seguir no prompt de comando para instalar o fecho. Você deve inserir esse comando no local em que fez download da pasta oracleGoogleAddin e a extraiu.
    C:\Users\username\Desktop\oracleGoogleAddin>npm install @google/clasp -g

    Para executar o comando como um administrador para sistemas baseados em UNIX e Linux, digite o seguinte comando:

    sudo npm install @google/clasp -g

    Depois de instalar o Clasp, o comando estará disponível em qualquer diretório do computador.

  5. Digite o comando a seguir para fazer login e autorizar o gerenciamento dos projetos de Script de Aplicativos da sua conta do Google.
    clasp login
    Depois que esse comando for executado, o sistema iniciará o navegador padrão e solicitará que você acesse sua conta do Google onde seu projeto do Script do Google Apps será armazenado. Selecione Permitir para que o fecho acesse sua Conta do Google.
    Observação

    Se você não tiver ativado a API do Script de Aplicativos no Script do Google Apps, o comando acima não será bem-sucedido. Ative a API visitando o site https://script.google.com/home/usersettings e permitindo o site e ativando a API de Script do Google Apps selecionando o botão Ativado.
  6. No projeto existente do Script do Google Apps, clique nas Definições do Projeto no painel esquerdo. Clique em Copiar para Área de Transferência para copiar o ID do Script em IDs.
  7. Volte para o prompt de comando e insira o seguinte comando com o ID do script copiado na etapa anterior, conforme exibido na imagem abaixo:
    clasp clone <Script ID>
  8. Envie todos os arquivos da sua pasta para os arquivos do Script do Google Apps especificando o seguinte comando:
    clasp push

    Este comando carrega todos os arquivos do projeto de script do seu computador para os arquivos de script do Google Apps.

  9. Vá para a Planilha do Google recém-criada, clique no menu Extensões e selecione Script de Aplicativos. Em Arquivos, você pode exibir todos os arquivos na pasta oracleGoogleAddin.
  10. Depois de importar ou fazer upload dos arquivos para o Script do Google Apps, siga estas etapas para concluir a configuração do complemento do Oracle Autonomous Database para o Google Sheets:

Implantar o script do Google como um aplicativo web

Depois que todos os arquivos da pasta oracleGoogleAddin forem importados ou carregados nos arquivos do Script do Google Apps, você deverá implantar o script do Google como um aplicativo Web.

Para implantar o script do Google como um aplicativo web:
  1. Clique no menu Extensões na Planilha do Google em que você está trabalhando e selecione Script de Aplicativos. Isso abre a janela.
  2. Clique no botão Implantar no canto superior direito e selecione Nova implantação. Uma nova janela de implantação é aberta.
  3. Ao lado de Selecionar tipo, clique no ícone configurações e selecione Aplicativo Web.
  4. Em Configuração, especifique uma Descrição da implantação no campo Descrição. Por exemplo, Implantação de aplicativo Web.
  5. Em Aplicativo Web, selecione a conta do Google que você usou para fazer log-in no menu suspenso Executar como. Opcionalmente, você pode escolher qualquer pessoa que tenha acesso a esta implantação.
  6. Selecione Implantar.
    Observação

    • Se você receber uma janela que solicita autorização de acesso, selecione-a. Isso redirecionará você para a página Contas do Google, onde você deve selecionar sua conta do Gmail.
    • Clique em Avançado e selecione o link Ir para Projeto sem título (inseguro) .
    • Selecionar o link abre uma nova janela, garantindo que você confia no aplicativo. Clique em Permitir para continuar.

    Se você Autorizar o acesso nesse estágio, não precisará seguir as etapas de 2 a 4 em Autorizar Planilhas do Google para usar o Autonomous Database.

  7. Clique em Concluir para fechar a janela Nova Implantação.
  8. Clique no botão Implantar no canto superior direito e selecione Gerenciar Implantações.
  9. Na página Gerenciar Implantações, você pode exibir um URL de aplicativo Web. Use Copiar para Área de Transferência para copiar o URL do aplicativo Web. Por exemplo, aqui está uma amostra do URL do aplicativo Web "https://script.google.com/macros/s/abcdefghijk/exec". Este é o URL de implantação do aplicativo Web.

  10. Salve esse URL, que você usará posteriormente no campo URL de Redirecionamento da Planilha do Google ao fazer download de um arquivo de conexão do Database Actions ou ao criar manualmente uma conexão do Google Sheet com o Autonomous Database.

    Para obter detalhes sobre como selecionar Tipo de Resposta, consulte Fazer Download do Arquivo de Conexão.

  11. Você pode fechar a guia do navegador Apps Script e navegar até a guia do navegador do Google Sheets. Agora você está pronto para criar uma conexão com o Autonomous Database.
  12. Certifique-se de salvar a planilha depois de carregar todos os arquivos no Script de Aplicativos. Clique no botão Atualizar depois de fazer upload de todos os arquivos. Agora você pode exibir um novo menu do Oracle Autonomous Database no Google Sheets.


    Veja a seguir a descrição da pergunta-oracle-menu.png
    Descrição da ilustração ask-oracle-menu.png
    Observação

    Gere os campos OAuth ID do Cliente e OAuth Segredo do Cliente usando a IU.