Na janela de Configurações do Projeto é possível visualizar informações e alterar diversas propriedades do sistema, seus campos estão dispostos em uma janela com abas e subabas.
Figura 1 - Acesso à aba Geral da janela de Configurações do Projeto
A janela pode ser acessada por três caminhos:
config/
) na árvore de arquivos (destaque 2 da Figura 1.1). Esse arquivo só estará visível ao ativar o Modo Avançado.Figura 1.1 - Acesso as configurações via menu de contexto ou arquivo app.config
As abas Geral, Configurações do Projeto, Cabeçalhos, Configurações de E-mail e Configuração do Proxy sempre serão exibidas, já as demais abas só aparecerão a partir de determinadas configurações.
Exibe diversas informações sobre o sistema e o criador do projeto.
Figura 2 - Aba das Configurações Gerais do projeto
Rota Principal Web: define a página inicial ao abrir a URL da aplicação web. Só é possível alternar entre a página login (Localização: Formulários/Web/login
Endereço: |
) ou qualquer página dentro do diretório Público (Localização: Formulários/Web/Público/
Endereço: |
).
Rota Principal Mobile: define a tela inicial ao abrir a URL da aplicação mobile. Só é possível alternar entre a tela login (Localização: Formulários/Mobile/login
Endereço: |
) ou qualquer tela dentro do diretório Público (Localização: Formulários/Mobile/Público/
Endereço: |
).
Caso você entre em contato com o nosso suporte, os campos de ID's (Projeto, Cópia de trabalho, Usuário e Contratos) podem ser requisitados para facilitar a análise de possíveis problemas. |
Essa aba possui diversos campos de configurações agrupados em subabas (acordeão). Clique sobre as subabas para expandir ou recolher seus campos.
Os campos dessa subaba permitem definir formas de autorização para alguns recursos do projeto (Figura 3).
Figura 3 - Aba Configurações do Projeto - Permissões
<URL do sistema>
/api/cronapi/odata/v2/app/$metadata
Expor Entidades: permite obter os dados diretamente das entidades através do endereço
<URL do sistema>
/api/cronapi/odata/v2/app/<Entidade>
.
É possível restringir o acesso às consultas das entidades para os permissionáveis do sistema através do ícone cadeado no final do campo, esse ícone ficará desabilitado ao desmarcar a caixa de checagem do recurso.
Como informado no tópico "Uso de entidades vs. fonte de dados" do Manual de Boas Práticas, essa opção não é recomendada. |
Permitir da mesma origem: possibilita que o Iframe seja usado apenas por endereços dentro da URL Base. Por exemplo: o endereço "exemplo1.ide.cronapp.io/usuarios
" será aceito, pois a página "usuarios
" está contida no domínio "exemplo1.ide.cronapp.io/
".
O servidor pode sobrescrever as opções colocadas na aplicação, por tanto, caso o comportamento do projeto não esteja como selecionado na aplicação, provavelmente já existe uma configuração pré-definida no servidor. |
,
). ,
).,
). <chave1>~<chave2>~<chaveN>
pessoa
possui a chave estrangeira e pessoa_nome
o display; pessoa
possui a chave estrangeira e não existe campo display.A subaba Autenticação e Segurança possuem campos que permitem definir as formas de autenticação e segurança do sistema.
Figura 3.1 - Aba Configurações do Projeto - Autenticação
Token: token de autenticação da aplicação.
O token possibilita, por exemplo, que um sistema Cronapp servidor possa prover recursos REST privado para um sistema Cronapp cliente, sem a necessidade de autenticação a cada requisição. Para funcionar, é necessário que o campo token nos dois projetos possuam o mesmo valor. Após isso, basta utilizar a constante |
Nenhuma: sem autenticação.
login
das aplicações web e mobile para retirar os links que direcionam para a tela de auto-cadastro do usuário. Veja mais detalhes sobre as páginas de login e cadastre-se na documentação Projeto modelo.Possui campos para definir as regras de segurança das senhas dos usuários do sistema (Figura 3.1).
Vale destacar dois pontos sobre os campos de regras de senhas:
|
O valor " |
abcdefghijklmnopqrstuvwxyz
",ABCDEFGHIJKLMNOPQRSTUVWXYZ
",0123456789
";QWERTY
";A subaba Configurações de Autenticação (destaque 2 da figura 3.2) só será exibida ao selecionar as opções abaixo no campo Autenticação (destaque 1 da figura 3.2).
Figura 3.2 - A subaba Configurações da Autenticação só é exibida ao selecionar determinadas autenticações
Acesse a documentação de cada tipo de autenticação para mais detalhes sobre seus campos de configurações:
Campos para configurações com o Banco de dados do sistema.
Figura 3.3 - Aba Configurações do Projeto - Banco de Dados
Descarregar dados da transação: define como as alterações de dados serão enviadas para o banco de dados em todas as unidades de persistência (Namespaces) do projeto, podendo ser:
É possível alterar o tipo de descarga para um Namespace, em um fluxo específico, com o uso do bloco Definir modo de descarga de dados da transação. |
Possui campos para a seleção dos Temas e skins das aplicações clientes. A primeira linha permite configurar o Tema e Skin da aplicação Web, enquanto a segunda alterna o Tema e Skin da aplicação mobile.
Figura 3.4 - Aba Configurações do Projeto - Tema
Habilita os recursos que estarão disponíveis na janela de recursos do Swagger / Open API.
Figura 3.5 - Aba Configurações do Projeto - Swagger / Open API
<domínio>/api/metadata/
". Caso essa opção esteja desabilitada, será exibido um erro 403
./auth
e /auth/
refresh
) na tela do Swagger, permitindo testar os recursos privados. Permite criar e configurar os cabeçalhos da aplicação. Todas as requisições REST realizadas no projeto incluirão os cabeçalhos adicionados.
Os cabeçalhos cadastrados poderão ser modificados a partir da ferramenta Parâmetros do sistema ou no campo "Variáveis de Ambiente" da janela de configuração da publicação nos Serviços de cloud, entretanto, as chaves utilizadas por essas ferramentas devem possuir características específicas. Acesse suas respectivas documentações para mais detalhes.
Figura 4 - Aba Cabeçalhos
Destaques da Figura 4:
+
): permite adicionar novos cabeçalhos.x
): permite excluir o cabeçalho correspondente.Os campos abaixo são utilizados em conjunto com os recursos de envio automático de senha e recuperação de senha do usuário.
Figura 5 - Aba Configurações de E-mail
Dados do servidor do e-mail (Figura 5).
Dados do remetente (Figura 5).
Permite configurar o proxy que atuará como intermediário para as requisições da aplicação. Os campos desta aba serão utilizados para configurar o host e a porta utilizados na conexão. Importante destacar que essa configuração não estar relacionada com os perfis da aplicação.
Figura 6 - Aba Configuração do Proxy
A aba só será exibida quando o projeto estiver sob controle de versão (GIT).
Figura 7 - Aba Controle de versão
Com exceção do campo URL do Repositório, todos os outros campos permitem atualizações.
A aba só será exibida se a opção Login por Redes Sociais na subaba Autenticação da aba Configurações do Projeto estiver ativa. Ela permite configurar o sign-up por login social para usuários com contas ativas no Cronapp e também nas seguintes redes sociais: Facebook, Github, Linkedin e Google.
É necessário acessar a área de desenvolvedor de cada rede social e configurar a sua aplicação. Para mais detalhes, acesso o tutorial Login por redes sociais.
Figura 8 - Aba Redes Sociais