Configurer Oracle Sales and Service Application Integration

Dans cette section, vous allez ajouter les fonctionnalités communes de l'application Oracle Sales and Service nécessaires pour communiquer avec OCM. Cela implique la création de nouveaux services Web pour communiquer avec les API REST de document OCM, les fonctions globales de l'application Oracle Sales et Service pour appeler ces nouveaux services Web, ainsi qu'une combinaison d'applications Oracle Sales et Service pour exposer l'intégration de l'interface utilisateur intégrée OCM.

Créer un modèle d'environnement restreint

Pour créer un modèle d'environnement restreint afin d'implémenter les modifications apportées à l'application Oracle Sales and Service pour cette intégration :

1. Connectez-vous en tant qu'administrateur Oracle Sales and Service.
2. Cliquez sur dans le coin supérieur gauche de la page. Sélectionnez l'option Configuration dans le menu, puis sélectionnez Sandboxes.
   
   
   Description de l'image configuration.png
   
   
3. Sur la page Créer un modèle d'environnement restreint, renseignez les champs suivants :
   
   
   Description de l'image createsandbox.png
   
   
   1. Sur la page Modèles d'environnement restreint, cliquez sur Créer un modèle d'environnement restreint.
   2. Sur la page Créer un modèle d'environnement restreint, indiquez le nom de ce modèle dans le champ Nom (par exemple, Intégration de gestion des enregistrements OCI).
   3. Dans la liste Tous les outils, cochez la case Application Composer.
   4. Cliquez sur Créer et saisir.
4. Pour entrer dans le compositeur d'applications où vous apporterez vos modifications à l'intégration OCM, cliquez sur Outils dans le coin supérieur gauche de la page, puis sélectionnez Application Composer dans la liste déroulante.
   
   
   Description de l'image sandboxes.png
   
   

Créer des services Web

Les services Web permettent de communiquer avec OCM via les API REST de document OCM.

OCMCreateRepositoryCollectionService

Pour créer le service Web de création de collecte de référentiel OCM :

1. Sélectionnez Configuration commune, puis Services Web dans le menu de navigation de gauche.
2. Sur la page Services Web, cliquez sur l'icône Créer un service Web.
3. Dans la boîte de dialogue Sélectionner un type de connexion, sélectionnez l'option REST et cliquez sur OK.
4. Sur la page Créer une connexion de services Web REST, renseignez les champs suivants :
   
   
   Description de l'image collectionservice.png
   
   
   1. Dans le champ Nom, indiquez le nom du dossier OCMCreateRepositoryCollectionService.
   2. Dans le champ URL, entrez l'URL du service Web https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections nécessaire à la création de la collection de référentiels OCM. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour cette intégration (par exemple, https://mycloud.com/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections).
   3. Dans la section Modèle d'authentification, sélectionnez l'option Aucun car elle sera configurée à l'étape suivante.
   4. Dans la section Sélectionner et configurer les méthodes par rapport à la ressource, cochez la case POST.
   5. Dans la section Demande de données traitées, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.
   6. Dans la section Charge utile de réponse, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.
5. Pour créer le modèle d'authentification OAUTH IDCS qui sera utilisé pour les services Web, dans la page Créer une connexion de services Web REST en cours, renseignez les champs suivants :

   Remarque :

   Ces étapes ne sont requises que lorsque vous créez pour la première fois un service Web dans OCM.
   
   
   
   Description de l'image idcsoauth.png
   
   
   1. Dans la section Modèle d'authentification, sélectionnez l'option Appeler à l'aide d'IDCS OAUTH.
   2. Dans le champ URI de jeton, entrez l'URL du serveur IDCS https://<idcsServerURL>/oauth2/v1/token. Où <idcsServerURL> est l'URL du serveur IDCS utilisé pour cette intégration.
   3. Dans le champ Portée, entrez la portée qui a été copiée ci-dessus lors de la création du modèle d'authentification OAUTH IDCS (par exemple, https://BD2F184D9D2344CB8134FCD4CBFF7DF.mycloud.com:443/urn:opc:cec:all).
   4. Pour créer la clé d'informations d'identification client, renseignez les champs suivants :
      1. Sélectionnez l'icône Create Credential Key en regard du champ Client Credential Key.
      2. Dans le champ Clé CCSF, entrez la clé (par exemple, Services Web Fusion).
      3. Dans le champ Nom utilisateur, entrez l'ID client copié ci-dessus lors de la création du modèle d'authentification OAUTH IDCS (par exemple, c585b2d3e97c40e491ca99112281e36).
      4. Dans le champ Mot de passe, entrez la clé secrète client copiée ci-dessus lors de la création du modèle d'authentification OAUTH IDCS (par exemple, 768b9513-658e-4854-bac7-2fe72d19011).
      5. Cliquez sur OK.
   5. Pour créer la clé d'informations d'identification OCM pour changer d'identité, renseignez les champs suivants :
      1. Sélectionnez l'icône Create Credential Key en regard du champ Credential Key for Credential Key.
      2. Dans le champ Clé CCSF, entrez la clé (par exemple, Clé d'intégration OCM).
      3. Dans le champ Nom utilisateur, entrez l'utilisateur d'intégration OCM (celui que vous avez utilisé pour vous connecter à OCM précédemment pour créer le référentiel de ressources de base) utilisé pour communiquer avec OCM (il doit s'agir d'un utilisateur d'entreprise dans OCM).
      4. Dans le champ Mot de passe, entrez le mot de passe de l'utilisateur intégration OCM.
      5. Cliquez sur OK.
   6. Cliquez sur Enregistrer et fermer.

OCMGetDocumentsByFolderIdService

Pour créer le service Web Obtenir un document par ID de dossier OCM dans une nouvelle page Créer une connexion de service Web REST, renseignez les champs suivants :

Remarque :

Ce service Web n'est requis que si l'objet métier Oracle Sales and Service a l'option de résolution et a été configuré avec l'intégration de document OCM. Pour plus d'informations sur l'intégration de documents, reportez-vous à En savoir plus sur l'extension des objets métier Oracle Sales and Service avec la collaboration sur les documents.

Description de l'image folderidservice.png

1. Dans le champ Nom, indiquez le nom OCMGetDocumentsByFolderIdService.
2. Dans le champ URL, indiquez l'URL https://<OCMServerURL>/documents/api/1.2/folders/##folderId##/search/items?querytext=fItemType%3cMATCHES%3e%60File%60. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour cette intégration.
3. Dans la section Modèle d'authentification, sélectionnez l'option Appeler à l'aide d'IDCS OAUTH et utilisez les mêmes valeurs que celles utilisées ci-dessus pour les paramètres OAUTH IDCS.
4. Dans la section Sélectionner et configurer les méthodes par rapport à la ressource, cochez la case GET.
5. Dans la section Charge utile de réponse, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.

OCMBulkOperationsService

Pour créer le service Web Opérations en masse OCM dans une nouvelle page Créer une connexion de service Web REST, renseignez les champs suivants :

Description de l'illustration bulkoperations.png

1. Dans le champ Nom, indiquez le nom OCMBulkOperationsService.
2. Dans le champ URL, indiquez l'URL https://<OCMServerURL>/content/management/api/v1.1/bulkItemsOperations. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour cette intégration.
3. Dans la section Modèle d'authentification, sélectionnez l'option Appeler à l'aide d'IDCS OAUTH et utilisez les mêmes valeurs que celles utilisées ci-dessus pour les paramètres OAUTH IDCS.
4. Dans la section Sélectionner et configurer les méthodes par rapport à la ressource, cochez la case POST.
5. Dans la section Demande de données traitées, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.

OCMRepositoryCollectionPermissionsService

Pour créer le service Web Autorisations de collecte du référentiel OCM dans une nouvelle page Créer une connexion de service Web REST, renseignez les champs suivants :

Description de l'illustration permissionservice.png

1. Dans le champ Nom, indiquez le nom OCMRepositoryCollectionPermissionsService.
2. Dans le champ URL, indiquez l'URL https://<OCMServerURL>/content/management/api/v1.1/repositories/##OCMRepositoryId##/collections/##OCMCollectionsId##/permissions. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour cette intégration.
3. Dans la section Modèle d'authentification, sélectionnez l'option Appeler à l'aide d'IDCS OAUTH et utilisez les mêmes valeurs que celles utilisées ci-dessus pour les paramètres OAUTH IDCS.
4. Dans la section Sélectionner et configurer les méthodes par rapport à la ressource, cochez la case GET.
5. Dans la section Charge utile de réponse, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.

OCMPermissionOperationsService

Pour créer le service Web Opérations d'autorisation OCM dans une nouvelle page Créer une connexion de service Web REST, renseignez les champs suivants :

Description de l'illustration operationservice.png

1. Dans le champ Nom, indiquez le nom OCMPermissionOperationsService.
2. Dans le champ URL, indiquez l'URL https://<OCMServerURL>/content/management/api/v1.1/permissionOperations?links=none. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour cette intégration.
3. Dans la section Modèle d'authentification, sélectionnez l'option Appeler à l'aide d'IDCS OAUTH et utilisez les mêmes valeurs que celles utilisées ci-dessus pour les paramètres OAUTH IDCS.
4. Dans la section Sélectionner et configurer les méthodes par rapport à la ressource, cochez la case POST.
5. Dans la section Demande de données traitées, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.
6. Dans la section Charge utile de réponse, sélectionnez l'option Exemple de code et ajoutez {} à la zone de texte multiligne.

Créer une application composite

Un composite est une fenêtre dans une application externe indépendante telle qu'OCM.

Pour créer une combinaison afin d'intégrer l'interface utilisateur intégrée OCM afin qu'elle puisse être exposée dans un objet métier Oracle Sales and Service :

1. Sélectionnez Configuration commune et Contenu composite dans le menu de navigation de gauche.
2. Sur la page Contenu composite : Applications Web, cliquez sur le bouton Inscrire une application Web.
3. Dans la page Inscrire une application Web, renseignez les champs suivants :
   
   
   Description de l'image mashup.png
   
   
   1. Dans le champ Nom, indiquez le nom de l'application OCMEmbeddedAssetsUIMashup.
   2. Pour le champ Type, sélectionnez l'option Expression Groovy.
   3. Dans le champ Définition d'URL, entrez l'URL d'interface utilisateur intégrée OCM sous la forme https://<OCMServerURL>/documents/embed/v2/assets. Où <OCMServerURL> est le serveur Oracle Content Management utilisé pour l'intégration.
   4. Cliquez sur Enregistrer et fermer.