Documentação do Oracle Cloud Infrastructure

Instalar e configurar o complemento para o Google Sheets

Antes de instalar o complemento do Oracle Autonomous Database para o Google Sheets, faça download do arquivo zip oracleGoogleAddin da 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 para o 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 do 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, use o Projeto de Script de Aplicativos de Linha de Comando (clasp).

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

O fecho é gravado em Node.js e distribuído por meio da ferramenta NPM (Node Package Manager). É necessário instalar o Node.js versão 4.7.4 ou posterior para usar o clasp.
  1. Digite sheet.new na barra de endereços do Web browser para abrir o Google Sheets. Certifique-se de que 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 scripts de aplicativos.
    Descrição da ilustração apps-script-window.png a seguir
    Descrição da ilustração apps-script-window.png

  3. Selecione o arquivo Code.gs na janela do editor de scripts de aplicativos, que já existe por padrão. Clique nos pontos verticais ao lado do arquivo Code.gs. Selecione Deletar para excluir o arquivo Code.gs.
  4. Depois de instalar o Node.js, insira o comando npm a seguir no prompt de comando para instalar o fecho. Informe esse comando no local em que você fez download e extraiu a pasta oracleGoogleAddin.
    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 seu computador.

  5. Insira 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ê faça login na sua conta do Google, onde seu projeto do Google Apps Script será armazenado. Selecione Permitir para obter acesso à sua Conta do Google.
    Observação

    Se você não tiver ativado a API de Script de Aplicativos no Script do Google Apps, o comando acima não será bem-sucedido. Ative a API acessando 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 em Configuraçõ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 faz upload de todos os arquivos do projeto de script do seu computador para os arquivos do 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 Files, você pode ver 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 da 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 da Web:
  1. Clique no menu Extensões na Planilha do Google na qual você está trabalhando e selecione Script de Aplicativos. Esta ação 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 disponibilizaçã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 login na lista suspensa 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 pede para autorizar o acesso, selecione-a. Isso irá redirecioná-lo 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 (não seguro) .
    • Selecionar o link abre uma nova janela, garantindo que você confie no aplicativo. Clique em Permitir para continuar.

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

  7. Clique em Concluído 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 a opção Copiar para a Á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/AKfycbwFITvtYvGDSsrun22g7TrbrfV-bUVoWKs7OrA_3rtRAlmcGFe8bejNprZML7gFPzQ/exec". Este é o URL de implantação de 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 criar manualmente uma conexão da Planilha do Google 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 após fazer upload de todos os arquivos para o 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 nas Planilhas Google.
    A descrição da ask-oracle-menu.png vem a seguir
    Descrição da ilustração ask-oracle-menu.png
    Observação

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