Configurar o Oracle Sales and Service Application Integration

Nesta seção, você adicionará a funcionalidade comum do aplicativo Oracle Sales and Service necessária para se comunicar com o OCM. Isso envolve a criação de novos serviços Web para comunicação com as funções globais do aplicativo REST do documento OCM, Oracle Sales, and Service para chamar esses novos serviços Web e um mashup do aplicativo Oracle Sales and Service para expor a integração da IU incorporada do OCM.

Criar um Sandbox

Para criar um sandbox para implementar as alterações do Oracle Sales and Service Application para esta integração:

1. Efetue sign-in como administrador do Oracle Sales and Service.
2. Clique em no canto superior esquerdo da página. Selecione a opção Configuração no menu e, em seguida, selecione Sandboxes.
   
   
   Descrição da ilustração configuration.png
   
   
3. Na página Criar Sandbox, preencha os seguintes campos:
   
   
   Descrição da ilustração createsandbox.png
   
   
   1. Na página Sandboxes, clique em Criar Sandbox.
   2. Na página Criar Sandbox, especifique um nome para esse sandbox no campo Nome (por exemplo, Integração do Gerenciamento de Registros do OCM).
   3. Na lista Todas as Ferramentas, marque a caixa de seleção Application Composer.
   4. Clique em Criar e Informar.
4. Para informar o Application Composer no qual você fará alterações na integração do OCM, clique em Ferramentas no canto superior esquerdo da página e selecione Application Composer na lista drop-down.
   
   
   Descrição da ilustração sandboxes.png
   
   

Criar Web Services

Os Web Services são usados para comunicação com o OCM por meio das APIs REST do documento OCM.

OCMCreateRepositoryCollectionService

Para criar o serviço Web Criar Coleção de Repositórios do OCM:

1. Escolha Configuração Comum e Serviços Web no menu de navegação esquerdo.
2. Na página Web Services, clique no ícone Criar um novo Web Service.
3. Na caixa de diálogo Selecionar Tipo de Conexão, selecione a opção REST e clique em OK.
4. Na página Criar Conexão de Web services REST, preencha os seguintes campos:
   
   
   Descrição da ilustração collectionservice.png
   
   
   1. No campo Nome, especifique o nome da pasta como OCMCreateRepositoryCollectionService.
   2. No campo URL, informe o URL do web service como https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections, que é necessário para criar a coleção de repositórios do OCM. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para essa integração (por exemplo, https://mycloud.com/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections).
   3. Na seção Esquema de Autenticação, selecione a opção Nenhum, pois ela será configurada na próxima etapa.
   4. Na seção Selecionar e Configurar Métodos no Recurso, marque a caixa de seleção POST.
   5. Na seção Carga Útil da Solicitação, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.
   6. Na seção Payload de Resposta, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.
5. Para criar o esquema de autenticação OAUTH do IDCS que será usado para os web services, na página atual Criar Conexão de Web services REST, preencha os seguintes campos:

   Observação:

   Essas etapas só são necessárias quando você está criando um serviço Web para o OCM pela primeira vez.
   
   
   
   Descrição da ilustração idcsoauth.png
   
   
   1. Na seção Esquema de Autenticação, selecione a opção Chamar usando o IDCS OAUTH.
   2. No campo URI do Token, digite o URL do servidor IDCS https://<idcsServerURL>/oauth2/v1/token. Em que <idcsServerURL> é o URL para o servidor IDCS usado para essa integração.
   3. No campo Escopo, informe o escopo que foi copiado acima ao criar o esquema de autenticação OAUTH do IDCS (por exemplo, https://BD2F184D9D2344CB8134FCD4CBFF7DF.mycloud.com:443/urn:opc:cec:all).
   4. Para criar a chave de credencial do cliente, preencha os seguintes campos:
      1. Selecione o ícone Criar Chave de Credencial ao lado do campo Chave de Credencial do Cliente.
      2. No campo Chave do CSF, informe a chave (por exemplo, Fusion Web Services).
      3. No campo Nome do Usuário, informe o ID do cliente que foi copiado acima ao criar o esquema de autenticação OAUTH do IDCS (por exemplo, c585b2d3e97c40e491ca99112281e36).
      4. No campo Senha, informe o segredo do cliente que foi copiado acima ao criar o esquema de autenticação OAUTH do IDCS (por exemplo, 768b9513-658e-4854-bac7-2fe72d19011).
      5. Clique em OK.
   5. Para criar a chave de credencial do OCM para alternar a identidade, preencha os seguintes campos:
      1. Selecione o ícone Criar Chave de Credencial ao lado do campo Chave de Credencial para Chave de Credencial.
      2. No campo Chave do CSF, digite a chave (por exemplo, Chave de Integração do OCI).
      3. No campo Nome do Usuário, digite o usuário de integração do OCM (o que você usou para fazer login no OCM anteriormente para criar o repositório de ativos base) que é usado para se comunicar com o OCM (este deve ser um usuário corporativo no OCM).
      4. No campo Senha, informe a senha de usuário de integração do OCM.
      5. Clique em OK.
   6. Clique em Salvar e Fechar.

OCMGetDocumentsByFolderIdService

Para criar o serviço Web Obter Documento por ID de Pasta do OCM em uma nova página Criar Conexão de Serviço Web REST, preencha os seguintes campos:

Observação:

Este serviço Web só será necessário se o objeto de negócios Oracle Sales and Service tiver a opção de resolução e tiver sido configurado com a integração do Documento OCM. Consulte Saiba Mais Sobre como Estender Objetos de Negócios do Oracle Sales and Service com Colaboração de Documentos para obter mais informações sobre a Integração de Documentos.

Descrição da ilustração folderidservice.png

1. No campo Nome, especifique o nome como OCMGetDocumentsByFolderIdService.
2. No campo URL, especifique o URL como https://<OCMServerURL>/documents/api/1.2/folders/##folderId##/search/items?querytext=fItemType%3cMATCHES%3e%60File%60. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para essa integração.
3. Na seção Esquema de Autenticação, selecione a opção Chamar usando o IDCS OAUTH e use os mesmos valores usados acima para os parâmetros do IDCS OAUTH.
4. Na seção Selecionar e Configurar Métodos no Recurso, marque a caixa de seleção GET.
5. Na seção Payload de Resposta, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.

OCMBulkOperationsService

Para criar o serviço Web de Operações em Massa do OCM em uma nova página Criar Conexão de Serviço Web REST, preencha os seguintes campos:

Descrição da ilustração bulkoperations.png

1. No campo Nome, especifique o nome como OCMBulkOperationsService.
2. No campo URL, especifique o URL como https://<OCMServerURL>/content/management/api/v1.1/bulkItemsOperations. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para essa integração.
3. Na seção Esquema de Autenticação, selecione a opção Chamar usando o IDCS OAUTH e use os mesmos valores usados acima para os parâmetros do IDCS OAUTH.
4. Na seção Selecionar e Configurar Métodos no Recurso, marque a caixa de seleção POST.
5. Na seção Carga Útil da Solicitação, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.

OCMRepositoryCollectionPermissionsService

Para criar o web service Permissões de Coleta do Repositório do OCM em uma nova página Criar Conexão de Web Service REST, preencha os seguintes campos:

Descrição da ilustração permissionservice.png

1. No campo Nome, especifique o nome como OCMRepositoryCollectionPermissionsService.
2. No campo URL, especifique o URL como https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections/##OCMCollectionsId##/permissions. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para essa integração.
3. Na seção Esquema de Autenticação, selecione a opção Chamar usando o IDCS OAUTH e use os mesmos valores usados acima para os parâmetros do IDCS OAUTH.
4. Na seção Selecionar e Configurar Métodos no Recurso, marque a caixa de seleção GET.
5. Na seção Payload de Resposta, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.

OCMPermissionOperationsService

Para criar o web service Operações de Permissões do OCM em uma nova página Criar Conexão de Web Service REST, preencha os seguintes campos:

Descrição da ilustração operationservice.png

1. No campo Nome, especifique o nome como OCMPermissionOperationsService.
2. No campo URL, especifique o URL como https://<OCMServerURL>/content/management/api/v1.1/permissionOperations?links=none. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para essa integração.
3. Na seção Esquema de Autenticação, selecione a opção Chamar usando o IDCS OAUTH e use os mesmos valores usados acima para os parâmetros do IDCS OAUTH.
4. Na seção Selecionar e Configurar Métodos no Recurso, marque a caixa de seleção POST.
5. Na seção Carga Útil da Solicitação, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.
6. Na seção Payload de Resposta, selecione a opção Exemplo de Código e adicione {} à caixa de texto de várias linhas.

Criar um Mashup

Um Mashup é uma janela para um aplicativo externo independente, como o OCM.

Para criar um Mashup para incorporar a UI incorporada do OCM para que ela possa ser exposta em um objeto de negócios do Oracle Sales and Service:

1. Escolha Configuração Comum e Conteúdo do Armazenamento em Dinheiro no menu de navegação esquerdo.
2. Na página Conteúdo de Mashup: Aplicativos Web, clique no botão Registrar Aplicativo Web.
3. Na página Registrar Aplicativo Web, preencha os seguintes campos:
   
   
   Descrição da ilustração mashup.png
   
   
   1. No campo Nome, especifique o nome do aplicativo como OCMEmbeddedAssetsUIMashup.
   2. Para o campo Tipo, selecione a opção Expressão Groovy.
   3. No campo Definição do URL, informe o URL da UI incorporada do OCM como https://<OCMServerURL>/documents/embed/v2/assets. Onde <OCMServerURL> é o servidor do Oracle Content Management usado para integração.
   4. Clique em Salvar e Fechar.