Registrar um novo tema

Crie e registre seu próprio tema para customizar aplicativos para seu locatário. Ao configurar um aplicativo, selecione o seu tema criado pelo usuário para exibir as páginas com suas customizações. É possível ter um tema diferente para cada aplicativo ou diversos aplicativos podem usar o mesmo tema.

Antes de começar

  1. Obtenha um token de acesso. Consulte "Gerenciamento de temas".
  2. Baixe um tema com API.

Sobre esta tarefa

Faça download de um tema existente e use-o como um modelo para criar seu novo tema. O tema padrão pode ser usado como um modelo ao criar um novo tema. Mantenha a mesma estrutura de diretório.

Procedimento

  1. Extraia o arquivo compactado do tema a partir de “Baixar um tema com API” e modifique os arquivos para criar um novo tema personalizado para o seu Verify locatário.
  2. Crie um arquivo de tema compactado com a mesma estrutura de diretórios do arquivo baixado na etapa 1 para seus arquivos de tema personalizados.
  3. Para registrar seu novo tema, faça upload do arquivo de tema compactado com suas customizações de volta para seu locatário.
    curl -X POST --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F configuration=@<JSON configuration file> 'https://<tenant>/v1.0/branding/themes' -F 'files=@<update_theme_file>.zip' -H 'Authorization: Bearer <access_token>'
    onde:
    <JSON configuration file>
    A carga útil de configuração de registro de tema, um objeto JSON codificado por sequência. Exemplo
    {
    "name": "string",
    "description": "string (optional)",
    }
    <tenant>
    O nome de domínio completo atribuído à sua Verify assinatura.
    <update_theme_file>
    O nome do arquivo de tema compactado com a estrutura de tema formatada.
    <access_token>
    O valor do token de acesso que você recebeu na seção "Gerenciamento de temas".
    Um novo tema é registrado com seu locatário. Um themeId exclusivo é gerado.
  4. Opcional: Siga a lista de temas para ver o tema recém-registrado no seu tenant. É possível fazer download do tema com customized_only=true para verificar a lista de arquivos customizados. Para obter mais informações, consulte Baixar um tema com a API.
  5. Para usar o novo tema em seu aplicativo, defina o campo “Tema” nas configurações do aplicativo com o nome do novo tema. Para obter mais informações, consulte a seção “Configurando os detalhes básicos do aplicativo ”.
    Seu aplicativo agora usará o tema selecionado.

exemplo

curl -X POST --header 'Content-Type: multipart/form-data' --header 'Accept: application/json' -F configuration=@config.json 'https://companyAppTest.verify.ibm.com/v1.0/branding/themes' -F 'files=@theme_file.zip' -H 'Authorization: Bearer JUHn05z35P4Kd9QaCLHFEyMGEbzeCOo0faBefI9w'