Implementando novos aplicativos.

Implementar novos aplicativos para que outros usuários possam usar o aplicativo. Este procedimento explica como implementar aplicativos de sua estação de trabalho local.

Para implementar customizações em um aplicativo existente, consulte Implementando customizações para aplicativos existentes.

Nota: este tópico é aplicável apenas à versão SaaS do Order Hub .

Procedimento

Recupere o Customization folder, Customization client ID, Customization auth key para cada um dos locatários nos quais deseja implementar as customizações.

Pode ser necessário entrar em contato com um administrador para obter o Customization auth key se os locatários já estiverem configurados para customização.. Para obter mais informações, consulte Ativando o menu de customização para um locatário
Recupere o valor JSON do Recurso de Order Hub.
1. Efetue login no Order Hub.
2. Alterne para o locatário de customização no qual você testou suas customizações.
3. Acesse Configurações > Customização.
4. Selecione o item de menu customizado que ativa o aplicativo customizado
5. Se você desejar implementar customizações no locatário de customização no qual testou suas customizações, assegure-se de selecionar Hospedado pela IBM e limpar Ambiente de desenvolvimento local. Caso contrário, o locatário continuará a se conectar ao servidor local.
6. No campo URL relativa URL , inclua o caminho relativo para seu aplicativo / < module-name> / < route-name> que você definiu no arquivo app-config.json. Inicie com uma barra (/) Não é necessário incluir uma barra final.
  
  Por exemplo, /custom-app/custom-page1..
7. Salve todas as alterações.
8. Copie o JSON do campo Json do recurso na UI.
  O JSON da IU é semelhante à amostra a seguir.
```
{
    "featureId": "custom-[Id]", // must be unique
    "state": "ACTIVE",
    "sequence": 0,
    "title": "[Title to display for the custom application]",
    "iconName": "website-20",
    "link": "/[module-name]/[path to new route]",
    "path": "/[path to new route]",
    "hidden": true,
    "allowedRoles": [   //the roles that can access this customization
      "Fulfillment Manager",
      "Tenant Administrator"
    ],
    "description": [
      {
        "locale": "en_US",
        "language": "en",
        "title": "Title to display for the custom feature"
      }
    ],
    "type": "IFRAME"
  }
```
Abra o features.json no diretório raiz do módulo.
Por exemplo, devtoolkit_docker/orderhub-code/custom-app/features.json.. Se o arquivo não existir, crie o arquivo.
Cole o JSON que você copiou da etapa 2.h como um elemento da matriz no arquivo features.json .
Dependendo do conteúdo no features.json, pode ser necessário colocar o código entre colchetes [] para incluir como um elemento de matriz.
Em cada rota, para cada ambiente no qual você deseja implementar customizações, inclua um destino de construção para construir suas customizações.
1. Abra o arquivo package.json de cada rota.
  Por exemplo, devtoolkit_docker/orderhub-code/custom-app/packages/custom-page1/package.json e devtoolkit_docker/orderhub-code/custom-app/packages/custom-page2/package.json..
2. Inclua o comando de destino de construção a seguir para os ambientes nos quais você deseja implementar as customizações:
```
"build-<env>": "yarn build --deploy-url=<customization folder>/<module-name>/<route-name>/",
```
  O valor para <customization folder> é o valor recuperado da etapa 1. Cada ambiente de destino possui um valor da pasta de customização diferente.
  Por exemplo, se você desejar implementar em quatro ambientes; dev1, qa3, preprode prod, inclua o código a seguir:
```
"build-dev1": "yarn build --deploy-url=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app/custom-page1/",
"build-qa3": "yarn build --deploy-url=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app/custom-page1/",
"build-preprod": "yarn build --deploy-url=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app/custom-page1/",
"build-prod": "yarn build --deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app/custom-page1/",
```

Inclua destinos de compilação no arquivo package.json root-config.

Abra a pasta de configuração raiz devtoolkit_docker/orderhub-code/<custom-module-name>/<custom-short-name>-root-config/package.json .

Para cada ambiente no qual você deseja implementar customizações, inclua destinos de compilação semelhantes ao código a seguir.

"build-<env>": "yarn build --env baseHref=<customization folder>/<module-name>/ --env deploy-url=<customization folder>/<module-name>/<route-name>/",

em que < route-name> é a rota padrão.

Por exemplo, se você desejar implementar em quatro ambientes; dev1, qa3, preprode prod, inclua código semelhante à amostra a seguir:

"build-dev1": "yarn build --env baseHref=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app --env deploy-url=/buc-app-customization/T3R4fagafd45aadfaffasf/custom-app/custom-page1/",
"build-qa3": "yarn build --env baseHref=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app --env deploy-url=/buc-app-customization/dbU2K1u4seqrRKwBZTyMp1lUJwqQkJ5A/custom-app/custom-page1/",
"build-preprod": "yarn build --env baseHref=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app --env deploy-url=/buc-app-customization/zdD4uxaf8GRTbzMSg8zU2K/custom-app/custom-page1/",
"build-prod": "yarn build --env baseHref=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app --env deploy-url=/buc-app-customization/balohTK3ang5GmXsRwOSeSidbQOKEw6N/custom-app/custom-page1/",

Execute o seguinte comando para construir o pacote de customização para cada ambiente de destino.
```
yarn build-<env>
```
Por exemplo,
- Para construir para o ambiente do dev1 :
```
yarn build-dev1
```
- Para construir para o ambiente do qa3 :
```
yarn build-qa3
```
Execute o comando a seguir para publicar as customizações no ambiente de destino.
O ambiente de destino é determinado pelo client-id e pelo client-secret Cada ambiente tem um par de ID de cliente-segredo exclusivo..
```
yarn orderhub-cli publish-customization --client-id=<clientId> --client-secret=<clientSecret> --package-name=<module-name>
```
Required Parameters:
- --client-id -O ID do cliente de customização Para obter mais informações sobre como obter o ID e o segredo, consulte Ativando o menu de customização para um locatário.
- --client-secret -O segredo do cliente de customização
- --package-name -A pasta do módulo sob o diretório de construção que contém os arquivos para fazer upload. Esse valor corresponde ao nome do módulo, como custom-app.
Optional Parameters:
- --orderhub-hostname -o nome do host para o servidor da API do Order Hub O padrão é app.omsbusinessusercontrols.ibm.com.
- --proxy-host -O nome do host e a porta do proxy no caso de a máquina de compilação não ter acesso ao nome do host do pedido diretamente.
- --package-only -Indica se o zip do ativo de customização deve ser construído apenas O padrão é false
- --publish-only -Indica se deve ser feito upload de um pacote de customização pré-construído O padrão é false. Se configurado como true, deve-se também especificar o pacote a ser publicado usando o parâmetro -- package-name Para -- package-name, especifique o caminho para <build-dir>/<package-name>.zip. Por exemplo,
```
--publish-only=true --package-name=./dist/custom-app.zip
```
- --build-dir -O diretório que contém o ativo de customização compilado O padrão é dist
Nota: as configurações do menu customizado terão precedência sobre a implementação. Se você fez mudanças na tela do menu customizado para um recurso implementado, exclua o item de menu para reverter para o que foi publicado..

O que fazer depois

Customizações de construção Para obter mais informações, consulte Construindo as customizações