Promovendo designs REST em seus ambientes de produção

Ao projetar novas partes do seu sistema, sempre recomendamos que você projete essas novas partes em uma instância de desenvolvimento, teste-as completamente e depois transfira esses designs para produção, ao invés de aplicar qualquer novo conteúdo diretamente no ambiente de produção. Isso é particularmente importante ao projetar recursos que usam o comportamento REST.

Para informações sobre o design e o uso do comportamento Serviço Web REST, consulte Vinculando objetos a Serviços Web REST. Para mais detalhes sobre como promover designs REST em seus ambientes de produção, consulte a Comunidade Ivanti.

A criação de um design com o serviço web REST cria um conjunto de novos objetos quando se adiciona o comportamento a um objeto. Você então precisa transferir esses objetos para seus ambientes de produção. Esta seção descreve as etapas necessárias para promover o design, de um ambiente de não produção a um ambiente de produção. Você pode usar Text to Live ou Transferência de Design.

Test to Live

Test to Live permite que você promova todo o design, incluindo objetos, janelas, configurações de conexão REST e definições do Corpo da Solicitação, usando o aplicativo Test to Live.

O corpo da carga REST é armazenado em uma lista de referência no objeto ObjectBody. Test to Live migra apenas NOVAS listas de referência. Portanto, se você atualizar ou excluir qualquer um desses itens, precisará atualizá-los manualmente no sistema de produção. Para obter mais informações sobre como usar o Test to Live, consulte Test to Live.

Transferência de Design

Esta seção descreve como usar a Transferência de Design para promover o design REST a um ambiente de produção. Para obter mais informações sobre a Transferência de Design, consulte Exportando projetos de seu banco de dados com Design Transfer e Importar itens para o banco de dados.

A Transferência de Design não transfere as credenciais do Serviço Web REST ou as definições de conteúdo do corpo, portanto, tenha as seguintes informações prontas para inserção após concluir a importação na Transferência de Design:

• URI do ponto de extremidade
• Os detalhes de autenticação se você escolher Básico ou Chave de API (provedor)
• Os detalhes do mapeamento de resposta, se necessário
• O conteúdo do Corpo da Solicitação

Não adicione o design de objeto ou janela do objeto Corpo da Solicitação ao arquivo da Transferência de Design. Isso causará um erro ao tentar executar a importação.

Você precisa criar dois arquivos de exportação: um para o design do Objeto e outro para os dados da janela e do corpo REST.

Para criar o arquivo de exportação 1, de design do objeto:

1. Inicie o componente Transferência de Design em seu sistema de origem e navegue até a pasta Objetos de Negócio.
2. Expanda a pasta do módulo em que você criou o objeto REST.
3. Expanda a pasta Atributos do objeto de nível superior.
4. Selecione a coleção relacionada ao objeto REST e inclua objetos dependentes.
   Isso também seleciona o objeto REST para inclusão.
5. Expanda a pasta Atributos do objeto REST e certifique-se de que todos os atributos restantes estejam selecionados.
6. Na lista Ações, clique em Exportar itens selecionados e salve o arquivo.

Para criar o arquivo de exportação 2, os dados da janela e do corpo REST:

1. Reinicie o componente Transferência de Design e navegue até a pasta Referência.
2. Expanda a lista de referência e, em seguida, a pasta do módulo que contém o objeto REST.
3. Clique com o botão direito na pasta do objeto e clique em Selecionar.
   Todas as definições do Corpo da Solicitação são selecionadas. Como alternativa, expanda a pasta e selecione as definições necessárias.

Apenas os nomes das definições do corpo da solicitação são transferidos. Você precisa adicionar as definições do corpo da solicitação depois de importar os arquivos da Transferência de Design.

4. Navegue até a pasta Janelas e expanda a pasta do módulo que contém o objeto REST.
5. Expanda a pasta do objeto REST e selecione a janela necessária. Não inclua objetos dependentes.
6. Na lista Ações, clique em Exportar itens selecionados e salve o arquivo.

Agora que você criou os dois arquivos da Transferência de Design, pode importar o design para o sistema de destino.

Para importar o design no sistema de destino:

1. No sistema de destino, abra o componente Transferência de Design e selecione a opção Importar.
2. Na lista Ações, clique em Abrir Arquivo de Importação e selecione o arquivo 1 que você criou acima.
3. Para o aviso Objeto referenciado ausente, selecione Deixar valor não definido e clique em Importar.
   O arquivo é carregado e o objeto Corpo REST é criado.
4. Clique em OK.
5. Na lista Ações, clique em Abrir Arquivo de Importação e selecione o arquivo 2 que você criou acima.
   Vários avisos aparecem após o carregamento.
6. Em todos os avisos de Conflito de objetos no sistema, selecione a opção Não criar novo….
7. Para o aviso Objeto referenciado ausente, selecione Deixar valor não definido.
8. Clique em Importar.
   A janela selecionada para o objeto REST principal é criada, e as entradas selecionadas da lista de referência do Corpo REST são preenchidas.
9. Clique em OK.

A parte da importação de arquivos está concluída. Agora você precisa concluir as atualizações manuais no sistema de destino.

Para concluir as atualizações manuais para a transferência do design:

1. No Designer de Objeto, abra o objeto REST.
2. Exiba as configurações de Serviços Web REST no objeto, adicione os detalhes da conexão e salve as alterações.
3. Em Gerenciador de Janelas, navegue até o módulo, depois ao objeto REST, clique com o botão direito na janela e selecione Disponibilizar no Web Access.
4. Clique com o botão direito no objeto Corpo da Solicitação e crie uma janela adequada para a lista de referência.
5. No componente da Administração, expandir a árvore da Lista de Referência:
   
6. Expanda o módulo que contém o objeto REST e atualize as definições do Corpo da Solicitação conforme necessário. Você também pode adicionar novas aqui.
   O objeto REST e os dados associados estão prontos para uso.