1. Amplíe los objetos de negocio de Oracle Sales y Service con la colaboración de documentos
  2. Configurar Oracle Sales y la integración de aplicaciones de servicio

Configurar Oracle Sales y la integración de aplicaciones de servicio

En esta sección, agregará la funcionalidad común de la aplicación Oracle Sales and Service necesaria para comunicarse con OCM. Esto implica la creación de nuevos servicios web para comunicarse con las API de REST del documento de OCM, las funciones globales de la aplicación Oracle Sales and Service para llamar a estos nuevos servicios web y un mashup de la aplicación Oracle Sales and Service para exponer esta integración de la interfaz de usuario embebida de OCM.

Crear un sandbox

Para crear un sandbox para implantar los cambios de Oracle Sales y la aplicación de servicio para esta integración:

  1. Inicie sesión como administrador de Oracle Sales y Service.
  2. Haga clic en Icono de hamburguesa en la esquina superior izquierda de la página. Seleccione la opción Configuración del menú y, a continuación, seleccione Entornos de envío.
    A continuación se muestra la descripción de configuration.png
    Descripción de la ilustración configuration.png

  3. En la página Crear sandbox, complete los siguientes campos:
    A continuación se muestra la descripción de createsandbox.png
    Descripción de la ilustración createsandbox.png

    1. En la página Sandboxes, haga clic en Crear sandbox.
    2. En la página Crear sandbox, especifique un nombre para este sandbox en el campo Nombre (por ejemplo, Integración de colaboración de documentos de OCM).
    3. En la lista Todas las herramientas, seleccione la casilla de control Compositor de aplicaciones.
    4. Haga clic en Crear e introducir.
  4. Para introducir el compositor de aplicaciones en el que realizará los cambios de integración de OCM, haga clic en Herramientas en la esquina superior izquierda de la página y, a continuación, seleccione Application Composer en la lista desplegable.
    A continuación se muestra la descripción de toolsmenu.png
    Descripción de la ilustración toolsmenu.png

Crear servicios web

Los servicios web se utilizan para comunicarse con OCM mediante las API de REST del documento de OCM.

OCMCreateFolderService

Para crear el servicio web de creación de carpetas de OCM:
  1. Seleccione Configuración común y, a continuación, Servicios web en el menú de navegación izquierdo.
  2. En la página Servicios web, haga clic en el icono Crear un nuevo servicio web.
  3. En el cuadro de diálogo Seleccionar tipo de conexión, seleccione la opción REST y haga clic en Aceptar.
  4. En la página Crear conexión de servicios web REST, complete los siguientes campos:
    A continuación se muestra la descripción de webserviceconnection.png
    Descripción de la ilustración webserviceconnection.png

    1. En el campo Nombre, especifique el nombre de la carpeta como OCMCreateFolderService.
    2. En el campo URL, introduzca la URL de servicio web como https://<OCMServerURL>/documents/api/1.2/folders/##OCMParentFolderId##?name=##OCMFolderName## necesaria para crear la carpeta de OCM. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para esta integración (por ejemplo, https://mycloud.com/documents/api/1.2/folders/##OCMParentFolderId##?name=##OCMFolderName##).
    3. En la sección Esquema de autenticación, seleccione la opción Ninguno tal y como se configurará en el siguiente paso.
    4. En la sección Seleccionar y configurar métodos para recursos, active la casilla de control POST.
    5. En la sección Carga útil de respuesta, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.
  5. Para crear el esquema de autenticación IDCS OAUTH que se utilizará para los servicios web, en la página Crear conexión de servicios web REST, complete los siguientes campos:

    Nota:

    Estos pasos solo son necesarios cuando se crea un servicio web en OCM por primera vez.

    A continuación se muestra la descripción de serviceconnection.png
    Descripción de la ilustración serviceconnection.png

    1. En la sección Esquema de autenticación, seleccione la opción Llamar con IDCS OAUTH.
    2. En el campo URI de token, introduzca la URL de servidor de IDCS https://<idcsServerURL>/oauth2/v1/token. Donde <idcsServerURL> es la URL del servidor de IDCS que se utiliza para esta integración.
    3. En el campo Ámbito, introduzca el ámbito que se copió anteriormente al crear el esquema de autenticación OAUTH de IDCS (por ejemplo, https://BD2F184D9D2344CB8134FCD4CBFF7DF.mycloud.com:443/urn:opc:cec:all).
    4. Para crear la clave de credencial de cliente, complete los siguientes campos:
      1. Seleccione el icono Crear Clave de Credenciales junto al campo Clave de Credenciales de Cliente.
      2. En el campo Clave CSF, introduzca la clave (por ejemplo, Servicios web).
      3. En el campo Nombre de usuario, introduzca el ID de cliente que se copió anteriormente al crear el esquema de autenticación OAUTH de IDCS (por ejemplo, c585b2d3e97c40e491ca99112281e36).
      4. En el campo Contraseña, introduzca el secreto de cliente que se copió anteriormente al crear el esquema de autenticación OAUTH de IDCS (por ejemplo, 768b9513-658e-4854-bac7-2fe72d19011).
      5. Haga clic Aceptar.
    5. Para crear la clave de credencial de OCM para la identidad del conmutador, complete los siguientes campos:
      1. Seleccione el icono Crear Clave de Credenciales junto al campo Clave de Credenciales para Clave de Credenciales.
      2. En el campo Clave CSF, introduzca la clave (por ejemplo, Clave de integración de OCM).
      3. En el campo Nombre de usuario, introduzca el usuario de integración de OCM (el que utilizó para crear la carpeta raíz de OCM anteriormente) que se utiliza para comunicarse con OCM (debe ser un usuario de empresa en OCM).
      4. En el campo Password (Contraseña), escriba la contraseña de usuario de la integración de OCM.
      5. Haga clic Aceptar.
    6. Haga clic en Guardar y cerrar.

OCMSearchUserService

Para crear el servicio web de usuario de búsqueda de OCM, en la página Crear conexión de servicio web REST, complete los siguientes campos:
A continuación se muestra la descripción de searchuser.png
Descripción de la ilustración searchuser.png

  1. En el campo Nombre, especifique el nombre del usuario de búsqueda como OCMSearchUserService.
  2. En el campo URL, especifique la URL del usuario de búsqueda como https://<OCMServerURL>/documents/api/1.2/users/items?info=##userName##. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para esta integración.
  3. En la sección Authentication Scheme (Esquema de autenticación), seleccione la opción Call using IDCS OAUTH (Llamada mediante IDCS OAUTH) y utilice los mismos valores que se utilizaron anteriormente para los parámetros IDCS OAUTH.
  4. En la sección Seleccionar y configurar métodos en recurso, active la casilla de control GET.
  5. En la sección Carga útil de respuesta, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.

OCMSharedFolderUsersService

Para crear el servicio web del usuario de la carpeta compartida de OCM, en la página Crear conexión de servicio web REST, complete los siguientes campos:
A continuación se muestra la descripción de sharedfolder.png
Descripción de la ilustración sharedfolder.png

  1. En el campo Nombre, especifique el nombre del usuario de la carpeta compartida como OCMSharedFolderUsersService.
  2. En el campo URL, especifique la URL del usuario de carpeta compartida como https://<OCMServerURL>/documents/api/1.2/shares/##folderId##/items. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para esta integración.
  3. En la sección Authentication Scheme (Esquema de autenticación), seleccione la opción Call using IDCS OAUTH (Llamada mediante IDCS OAUTH) y utilice los mismos valores que se utilizaron anteriormente para los parámetros IDCS OAUTH.
  4. En la sección Seleccionar y configurar métodos en recurso, active la casilla de control GET.
  5. En la sección Carga útil de respuesta, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.

OCMShareFolderService

Para crear el servicio web de la carpeta de recursos compartidos de OCM, en la página Crear conexión de servicio web REST, complete los siguientes campos:
Descripción de share-folder.png a continuación
Descripción de la ilustración share-folder.png

  1. En el campo Nombre, especifique el nombre del usuario de la carpeta de recursos compartidos como OCMShareFolderService.
  2. En el campo URL, especifique la URL del usuario de la carpeta de recursos compartidos como https://<OCMServerURL>/documents/api/1.2/shares/##folderId##. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para esta integración.
  3. En la sección Authentication Scheme (Esquema de autenticación), seleccione la opción Call using IDCS OAUTH (Llamada mediante IDCS OAUTH) y utilice los mismos valores que se utilizaron anteriormente para los parámetros IDCS OAUTH.
  4. En la sección Seleccionar y configurar métodos para recursos, active la casilla de control POST.
  5. En la sección Carga útil de solicitud, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.
  6. En la sección Carga útil de respuesta, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.

OCMDeleteFolderService

Para crear el servicio web de la carpeta de supresión de OCM, en la página Crear conexión de servicio web REST, complete los siguientes campos:
A continuación se muestra la descripción de deletefolder.png
Descripción de la ilustración deletefolder.png

  1. En el campo Nombre, especifique el nombre de la carpeta como OCMDeleteFolderService que desea suprimir.
  2. En el campo URL, especifique la URL de la carpeta de supresión como https://<OCMServerURL>/documents/api/1.2/folders/##folderId##. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para esta integración.
  3. En la sección Authentication Scheme (Esquema de autenticación), seleccione la opción Call using IDCS OAUTH (Llamada mediante IDCS OAUTH) y utilice los mismos valores que se utilizaron anteriormente para los parámetros IDCS OAUTH.
  4. En la sección Seleccionar y configurar métodos en recurso, active la casilla de control DELETE.
  5. En la sección Carga útil de respuesta, seleccione la opción Ejemplo de código y agregue {} al cuadro de texto de varias líneas.

Crear funciones globales

Las funciones globales se utilizan para ajustar la lógica de negocio en los servicios web para que se puedan utilizar fácilmente en otras ubicaciones.

OCMCreateFolderFunction

Para crear la función global de creación de carpetas de OCM que utilizará el servicio web OCMCreateFolderService:

  1. Seleccione Configuración común y, a continuación, Funciones globales en el menú de navegación izquierdo.
  2. En la página Funciones Globales, haga clic en el icono Agregar una Función Global.
  3. En la página Crear función global, rellene los siguientes campos:
    A continuación se muestra la descripción de globalfunction.png
    Descripción de la ilustración globalfunction.png

    1. En el campo Nombre de función, especifique el nombre de la función como OCMCreateFolderFunction.
    2. Seleccione Cadena en el menú desplegable Devoluciones.
    3. En el campo Descripción, introduzca el texto "Crea una nueva carpeta OCMFolderName en OCM en el OCMParentFolderId especificado y devuelve el ID de carpeta recién creado".
    4. En la sección Parámetros, haga clic en el icono Agregar parámetro.

      En el campo Nombre, especifique el nombre como OCMParentFolderId y seleccione Cadena en el menú desplegable Tipo.

    5. En la sección Parámetros, haga clic en el icono Agregar parámetro.

      En el campo Nombre, especifique el nombre como OCMFolderName y seleccione Cadena en el menú desplegable Tipo.

    6. En el campo Editar script, pegue el siguiente script:
      def OCMFolder = [:]
try {
  OCMFolder = adf.webServices.OCMCreateFolderService.POST(OCMParentFolderId, OCMFolderName)
  println("OCM Folder Created: " + OCMFolder)
  return OCMFolder.id   
} catch (Exception e) {
  println("Create OCM Folder Error: " + e)
}
    7. Haga clic en Guardar y cerrar.

OCMSearchUserFunction

Para crear la función global de usuario de búsqueda de OCM, en una nueva página Crear función global, que se utilizará para acceder al servicio web OCMSearchUserService, rellene los siguientes campos:
A continuación se muestra la descripción de searchuserfunction.png
Descripción de la ilustración searchuserfunction.png

  1. En el campo Nombre de función, especifique el nombre de la función como OCMSearchUserFunction.
  2. Seleccione Cadena en el menú desplegable Devoluciones.
  3. En el campo Descripción, introduzca el texto "Busca un usuario en OCM por el userName especificado y devuelve el ID de usuario".
  4. En la sección Parámetros, en el campo Nombre, especifique el nombre como userName y seleccione Cadena en el menú desplegable Tipo.
  5. En el campo Editar script, pegue el siguiente script:
    def response = [:]
try {
  response = adf.webServices.OCMSearchUserService.GET(userName)
  def responseItems = [:]
  responseItems = response.items
  println("OCM Search User Result: " + responseItems.getAt(0))
  return responseItems.getAt(0).id
} catch (Exception e) {
  println("Search OCM User Error: " + e)
}
  6. Haga clic en Guardar y cerrar.

OCMIsFolderSharedFunction

Para crear la función global de carpeta compartida de OCM, en una nueva página Crear función global, que se utilizará para acceder al servicio web OCMSharedFolderUsersService, complete los siguientes campos:
A continuación se muestra la descripción de ocmis.png
Descripción de la ilustración ocmis.png

  1. En el campo Nombre de función, especifique el nombre de la función como OCMIsFolderSharedFunction.
  2. Seleccione Booleano en el menú desplegable Devoluciones.
  3. En el campo Descripción, introduzca el texto "Devuelve verdadero si el valor OCMUserId especificado se ha compartido con el valor OCMFolderId especificado".
  4. En la sección Parámetros, agregue los siguientes valores:
    Nombre Tipo
    OCMFolderId Cadena
    OCMUserId Cadena
  5. En el campo Editar script, pegue el siguiente script:
    def response = [:]
try {
  response = adf.webServices.OCMSharedFolderUsersService.GET(OCMFolderId)
  def responseItems = [:]
  responseItems = response.items
  for (item in responseItems) {
    if (item['type'] == 'share') {
      if (item['user']['id'] == OCMUserId) {
        return true
      }
    }
  }
  return false
} catch (Exception e) {
  println("OCM Folder Shared Error: " + e)
  return false
}
  6. Haga clic en Guardar y cerrar.

OCMShareFolderFunction

Para crear la función global de carpeta compartida de OCM, en una nueva página Crear función global, que se utilizará para acceder al servicio web OCMShareFolderService, complete los siguientes campos:
A continuación se muestra la descripción de sharefolderfunction.png
Descripción de la ilustración sharefolderfunction.png

  1. En el campo Nombre de función, especifique el nombre de la función como OCMShareFolderFunction.
  2. Seleccione Booleano en el menú desplegable Devoluciones.
  3. En el campo Descripción, introduzca el texto "Comparte el OCMFolderId especificado en OCM con los valores OCMUserId y OCMRole especificados devolviendo true si se realiza correctamente".
  4. En la sección Parámetros, agregue los siguientes valores:
    Nombre Tipo
    OCMFolderId Cadena
    OCMUserId Cadena
    OCMRole Cadena
  5. En el campo Editar script, pegue el siguiente script:
    def params = [:]
params.userID = OCMUserId
params.role = OCMRole
def response = [:]
try {
  response = adf.webServices.OCMShareFolderService.POST(OCMFolderId, params)
  if (response.errorCode == "0") {
    println("OCM Folder Shared: " + OCMFolderId + "(" + OCMUserId + ":" + OCMRole + ")")
    return true
  } else {
    println("Share OCM Folder Failed: " + OCMFolderId + "(" + OCMUserId + ":" + OCMRole + ")")
    return false
  }
} catch (Exception e) {
  println("Share OCM Folder Error: " + e)
  return false 
}
  6. Haga clic en Guardar y cerrar.

OCMDeleteFolderFunction

Para crear la función global de carpeta compartida de OCM, en una nueva página Crear función global, que se utilizará para acceder al servicio web OCMDeleteFolderService, complete los siguientes campos:
A continuación se muestra la descripción de ocmdelete.png
Descripción de la ilustración ocmdelete.png

  1. En el campo Nombre de función, especifique el nombre de la función como OCMDeleteFolderFunction.
  2. Seleccione Booleano en el menú desplegable Devoluciones.
  3. En el campo Descripción, introduzca el texto "Suprime el OCMFolderId especificado en OCM".
  4. En la sección Parámetros, en el campo Nombre, especifique el nombre como OCMFolderId y seleccione Cadena en el menú desplegable Tipo.
  5. En el campo Editar script, pegue el siguiente script:
    def response = [:]
try {
  adf.webServices.OCMDeleteFolderService.DELETE(OCMFolderId)
  println("OCM Folder Deleted: " + OCMFolderId)
  return true
} catch (Exception e) {
  println("Delete OCM Folder Error: " + e)
  return false 
}
  6. Haga clic en Guardar y cerrar.

Crear un mashup

Un mashup es una ventana a una aplicación externa independiente como OCM.

Para crear un Mashup que embeba la interfaz de usuario embebida de OCM para que se pueda exponer en un objeto de negocio de Oracle Sales and Service:

  1. Seleccione Configuración Común y Contenido de Mashup en el menú de navegación izquierdo.
  2. En la página Contenido de Mashup: Aplicaciones Web, haga clic en el botón Registrar Aplicación Web.
  3. En la página Registrar aplicación web, complete los siguientes campos:
    A continuación se muestra la descripción de registerwebapp.png
    Descripción de la ilustración registerwebapp.png

    1. En el campo Nombre, especifique el nombre de la aplicación como OCMEmbeddedFolderUIMashup.
    2. Para el campo Tipo, seleccione la opción Expresión de Groovy.
    3. En el campo Definición de URL, introduzca la URL de la interfaz de usuario embebida de OCM como https://<OCMServerURL>/documents/embed/v2/folder/. Donde <OCMServerURL> es el servidor de Oracle Content Management que se utiliza para la integración.
    4. Haga clic en Guardar y cerrar.