Export/Import

A funcionalidade Export/Import do Manager foi desenvolvida para facilitar o processo de replicação de APIs, planos e custom interceptors Java e JavaScript entre ambientes.

Esta funcionalidade visa promover a replicação dos objetos entre ambientes, mas dentro de um mesmo Manager. Importações e exportações entre Managers de clientes diferentes, por exemplo, não serão bem-sucedidas.

Exportando objetos

Você só pode exportar um tipo de objeto por vez, mas cada exportação pode conter múltiplos itens. Ou seja, se você for exportar APIs e planos, terá que fazer dois processos de exportação, mas poderá incluir múltiplas APIs e múltiplos planos a cada um deles, respectivamente.

Para exportar objetos:

  1. Clique no botão Export, que abrirá uma janela modal para as seleções necessárias.

  2. Selecione o tipo de objeto desejado (APIs, Plans, Java Interceptors ou JavaScript Interceptors) e clique em Next.
    export

  3. Selecione os itens que deverão ser exportados e clique em Export.
    export2

Um arquivo com o formato JSON será disponibilizado para download e poderá ser reimportado para o Manager através da funcionalidade de Import.

Não modifique manualmente a estrutura ou os campos padrão do arquivo JSON exportado. Alterações como inclusão, remoção ou edição de atributos (por exemplo, mudança na nomenclatura de campos) podem comprometer a integridade dos dados.

O processo de importação pode não validar essas inconsistências, podendo resultar em sobrescrita incorreta de dados, perda de informações (como revisões de APIs) ou indisponibilidade das APIs no ambiente de destino.

Algumas regras são aplicadas no momento da exportação:

  • Se a regra de visibilidade de uma API for visível para Organization, ela será exportada como Organization; porém, opções de visibilidade para Groups ou Only me serão ambas exportadas como Only me.

  • Groups, users e environments vinculados a uma API não serão exportados.

Importando objetos

Para importar objetos:

  1. Clique no botão Import, que abrirá uma janela modal para as seleções necessárias.

  2. Selecione o tipo de objeto correspondente ao arquivo JSON que será importado (APIs, Plans, Java Interceptors ou JavaScript Interceptors) e clique em Select File.
    import

  3. Selecione o arquivo que deverá ser importado da sua máquina e clique em Next.

  4. Selecione os itens do arquivo que você deseja importar e clique em Import.
    import2

Certifique-se de que o arquivo JSON não tenha sido modificado manualmente antes da importação.

Algumas regras são aplicadas no momento da importação:

  • Não é possível importar uma API se ela possuir uma versão (listada em Other Versions) que não esteja presente no Manager no momento da importação.

  • Não é possível importar um plano que contenha uma API vinculada a ele se essa API não estiver presente no Manager no momento da importação.

  • Há retrocompatibilidade de itens exportados e importados entre as versões 3.0.0.0+ e 4.0.0.0+ do Manager, mas não em relação a estas e versões anteriores.
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]