Criação de um projeto CAP

Como mencionado anteriormente, queremos usar o SAP Business Application Studio (BAS) como ambiente de desenvolvimento para criar aplicações CAP para o tempo de execução Node.js. O BAS oferece o benefício de que tudo o que precisamos para o desenvolvimento está disponível pronto para uso. Por exemplo, o Node.js, bem como o kit de desenvolvimento CDS do CAP, já está instalado e pronto para uso.

Assista ao vídeo para saber mais sobre como criar espaços de desenvolvimento e gerar projetos CAP para desenvolver aplicativos usando BAS.

Projetos CAP também podem ser criados com o pacote npm @sap/cds-dk. Este pacote contém o cliente de linha de comando e o kit de ferramentas de desenvolvimento para CAP.

@sap/cds-dk está disponível pronto para ser utilizado em BAS. Os comandos correspondentes podem ser inseridos diretamente em um terminal no BAS. Para abrir um novo terminal, selecione Terminal→Novo Terminal no menu do hambúrguer no canto superior esquerdo do BAS.

@sap/cds-dk fornece comandos para vários estágios de desenvolvimento do CAP, desde a inicialização de novos projetos até sua implantação na nuvem. Use a ajuda do cds para obter uma visão geral de todos os comandos. Usar cds <helpcommand> ou cds <comando> ? para obter ajuda específica. Com cds init pode ser gerado um novo projeto CAP.

O CAP tem configurações padrão para muitas coisas que você precisaria configurar em outros frameworks. O objetivo é fazer as coisas funcionarem sem configuração o máximo possível. Se necessário, você pode substituir essas configurações padrão por uma configuração específica. Por exemplo, você pode substituir os nomes padrão para as pastas acima no arquivo package.json da seguinte forma:

123456789
{ ...
  "cds": {
    "folders": {
      "db": "database/",
      "srv": "services/",
      "app": "uis/"
    }
  }
}

1
{ db: 'db/', srv: 'srv/', app: 'app/' }

O "watch" no cds watch indica que o comando monitora continuamente os arquivos do projeto para alterações. Quando uma alteração é detectada nos arquivos de origem, o servidor é reiniciado automaticamente para refletir essas alterações. Não é necessário interromper e reiniciar manualmente o servidor após modificações.

Enquanto o servidor está sendo executado no modo de observação, ele emite logs no console. Esses logs podem ser úteis para detectar problemas, compreender o fluxo de solicitações e solucionar erros.

1
cds serve all --with-mocks --in-memory?

Quando o cds watch estiver em execução, você pode abrir http://localhost:4004 em um navegador para ver uma página genérica index.html. Esta página é principalmente para fins de desenvolvimento e teste. Em cenários de produção, ela geralmente não é exposta ou substituída por uma interface de usuário adequada.

A página fornece uma lista de todos os pontos de acesso de serviço expostos. Isso torna mais fácil para os desenvolvedores e testadores acessá-los diretamente.

Para cada serviço OData, também existe um link para seu documento $metadata. Clicar nele exibirá os metadados para o serviço, que descrevem os conjuntos de entidades, tipos e outros detalhes do serviço no formato XML.

Para aplicativos Node.js, também há um link de visualização do Fiori na página index.html para cada conjunto de entidades expostas. Um link desse tipo serve dinamicamente para uma página da lista de elementos do SAP Fiori com base no conjunto de entidades correspondente. Considere que isso não está previsto para utilização de produção. Não deve ser uma substituição para uma aplicação de elementos SAP Fiori adequada.

Assista ao vídeo para ver como criar um aplicativo Hello World.

Agora que sabemos como criar projetos CAP em um espaço de desenvolvimento e como testar aplicações CAP localmente, vamos explorar as características básicas do CAP.