Desenvolvimento local

Embora seja possível realizar todas as tarefas relacionadas ao conector usando o ambiente on-line do Apps Script, com o tempo, algumas delas podem se tornar repetitivas e propensas a erros.

A dscc-gen é uma ferramenta assertiva que lida com essas tarefas repetitivas. Assim, você se concentra em questões importantes da empresa, não em erros que podem ser evitados por meio da automação.

Requisitos

Como usar o dscc-gen

A dscc-gen pode criar novos projetos de conector da comunidade ou ser usada com aqueles já existentes.

Conectores atuais

A dscc-gen também pode ser usada com projetos existentes. Primeiro, copie seu scriptId. Depois, execute o comando a seguir, substituindo YOUR_SCRIPT_ID pelo seu scriptId:

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

Você precisará informar alguns detalhes do seu conector. Se você ainda não tiver uma implantação chamada "Produção", ela será criada. Nenhuma parte do seu código será modificada, mas você terá acesso a todos os recursos da dscc-gen.

Novos conectores

Para criar um novo conector da comunidade com a dscc-gen, execute o seguinte comando:

npx @google/dscc-gen connector

Você precisará informar alguns detalhes do seu novo conector. Os novos usuários precisarão autenticar a clasp. A ferramenta clasp é utilizada para criar e modificar projetos do Apps Script na linha de comando.

Após seguir as instruções, a dscc-gen criará um novo projeto do Apps Script e imprimirá um documento com todos os recursos.

O que a dscc-gen faz?

Comando Descrição
npm run open Abra seu projeto no Apps Script.
npm run push Envie suas alterações locais para o Apps Script.
npm run watch Monitore as alterações locais e envie-as ao Apps Script.
npm run prettier Formate seu código usando os padrões da comunidade.
npm run try_latest Abra a implantação com seu código mais recente no Looker Studio.
npm run try_production Abra sua implantação de produção no Looker Studio.
npm run update_production Atualize a implantação de produção para usar o código mais recente.

Como devo usá-la?

A dscc-gen costuma ser utilizada para:

  1. identificar um recurso que você quer adicionar ao seu conector;
  2. executar o npm run watch para que as alterações locais sejam enviadas ao Apps Script;
  3. fazer as mudanças no código usando seu editor de JavaScript favorito;
  4. executar o npm run tryLatest e verificar se o novo recurso está funcionando como esperado;
  5. executar o npm run updateProduction para atualizar sua implantação de produção e usar o novo recurso;
  6. executar o npm run tryProduction e verificar se o novo recurso está funcionando.

Receber o código do script

Para ver seu scriptId, acesse o projeto existente e copie a seção do URL depois de /d/ e antes de /edit. Por exemplo, veja o seguinte URL:

  • URL original: https://script.google.com/a/google.com/d/example-script-id/edit
  • Código do script: example-script-id