Oracle Integration과 Oracle Content Management 간의 프로세스 통합 구성

사용자 또는 사용자가 문서 및 대화 기능에 액세스하려면 관리자가 Oracle Content Management 및 Oracle Integration에서 설정을 구성해야 합니다.

관리자 권한이 있는 사용자만 두 서비스 간에 연결을 설정할 수 있습니다.

Oracle Content Management와의 연결이 구성되기 전에 생성된 프로세스 애플리케이션의 경우 문서 및 대화 기능이 기본적으로 사용 안함으로 설정됩니다. 개발자는 기존 응용 프로그램에서 이러한 기능을 수동으로 사용으로 설정할 수 있습니다.

성공적인 통합을 위한 액세스 요구 사항

성공적인 통합을 위해 다음 액세스 요구 사항을 확인하십시오.

• Oracle Integration에서 구성된 Oracle Content Management 사용자는 프로세스를 종료할 수 있도록 Oracle Content Management에서 구성된 수신 문서의 폴더인 폴더에 대한 전체 액세스 권한이 있어야 합니다.

• 폴더 시작 프로세스(즉, 폴더 시작 이벤트가 있는 프로세스)의 경우 Oracle Integration에서 구성된 Oracle Content Management 사용자에게 Oracle Integration의 폴더에 액세스하려면 폴더에 대한 관리자 액세스 권한이 있어야 합니다. 예를 들어, [태스크 세부정보] 페이지와 [프로세스 추적] 페이지에서 폴더를 보거나, 외부 애플리케이션에 프로세스 UI 구성요소를 포함할 때 폴더에 접근하거나, Process Mobile 애플리케이션에서 폴더를 보려면 관리자 접근 권한이 필요합니다.

• 폴더의 프로세스 목록에서 프로세스를 확인하고 새 문서가 도착할 때 프로세스 인스턴스를 시작하려면 Oracle Content Management에서 구성된 Oracle Integration 사용자에게 프로세스 개시자 롤을 부여해야 합니다.

프로세스 애플리케이션에서 문서 또는 첨부 파일 사용

Oracle Integration에는 프로세스 애플리케이션에 표준 파일 첨부 기능이 자동으로 포함됩니다. 파일을 업로드하고 프로세스에 첨부할 수 있습니다. Oracle Integration에서 Oracle Content Management를 사용할 경우 파일을 업로드하고, 폴더에 파일을 구성하고, 각 폴더에 대한 액세스를 관리하고, 문서를 업로드하여 프로세스를 시작할 수 있는 문서 기능도 제공됩니다. 또한 각 프로세스 응용 프로그램에는 문서 또는 첨부 파일을 사용할 수 있는 옵션이 있습니다.

프로세스가 애플리케이션 레벨에서 문서 또는 첨부 파일을 사용하는지 여부를 제어합니다. 문서는 기본적으로 사용으로 설정됩니다. 설정은 애플리케이션의 [정보] 창에 있습니다.

enable-docs-app-level-cb.png 그림에 대한 설명

문서 통합이 사용으로 설정된 애플리케이션은 문서 및 문서만 사용할 수 있습니다. 문서 통합이 사용 안함으로 설정된 애플리케이션은 첨부만 사용할 수 있습니다. 기본적으로 응용 프로그램에 대한 문서를 사용 안함으로 설정하여 해당 응용 프로그램에 대한 첨부 파일을 사용으로 설정합니다.

이 설정은 응용 프로그램에 적용됩니다. 애플리케이션에서 문서 또는 첨부 파일을 사용할 수 있지만 둘 다 사용할 수는 없습니다.

첨부 파일의 경우 [UI 사용자 정의] 화면에서 첨부 파일 숨기기 옵션이 선택 취소되어 있는지 확인합니다. 첨부 파일 숨기기 옵션이 선택된 경우 태스크 세부정보 및 시작 양식에서 첨부 파일을 볼 수 없습니다.

REST API를 사용하여 Oracle Integration과 상호 작용하는 경우 프로세스 애플리케이션이 문서 또는 첨부 파일을 사용하는지 여부에 따라 적합한 API를 사용해야 합니다.

• 문서의 경우 /folders REST API를 사용해야 합니다.

• 첨부 파일의 경우 /attachments REST API를 사용해야 합니다.

잘못된 API를 사용할 경우 응용 프로그램은 오류 메시지를 반환하거나 작업을 수행하지 않습니다.

태스크 세부정보에서 첨부를 볼 수 없는 경우 UI 사용자정의 화면에서 옵션을 확인하십시오. 첨부 파일을 보려면 첨부 파일 숨기기 확인란이 선택 취소되어 있는지 확인합니다.

Oracle Content Management에서 Oracle Integration 설정 구성

Oracle Content Management의 문서에 대해 Oracle Integration을 사용으로 설정합니다.

1. 관리자로 Oracle Content Management에 사인인합니다.
2. 관리 메뉴에서 통합을 선택합니다.
3. 애플리케이션 아래에서 Oracle Integration을 선택하여 서비스를 사용으로 설정하고 다음 값을 설정합니다.
   • 서비스 URL: 사용자가 애플리케이션에 대해 액세스할 수 있는 REST 서비스의 URL이며 bpm/api/4.0/processes로 끝납니다(예: https://servicename/bpm/api/4.0/processes).
   • 서비스 사용자: Oracle Content Management에서 사용할 프로세스를 소유하는 사용자의 전자메일 주소를 입력합니다.
   • 서비스 비밀번호: 사용자 비밀번호를 입력합니다.

작업 단계가 완료되면 정의된 프로세스에 따라 파일을 관리할 수 있습니다. 수신 문서의 경우 사용자는 해당 문서에 대해 지정된 역할(제공자, 다운로더 또는 뷰어)을 기반으로 작업을 수행할 수 있습니다.

Oracle Content Management에서 프로세스를 시작하면 프로세스를 실행하기 위해 다음 페이로드가 전송됩니다.

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

개발자는 개발하는 프로세스에 대한 다음 요구 사항을 알고 있어야 합니다.

• Oracle Content Management 문서 시작 이벤트를 사용하는 프로세스여야 합니다.
• 프로세스를 배포할 때 사용자가 프로세스를 트리거할 수 있는 권한을 가지도록 통합을 사용으로 설정하도록 지정된 사용자와 프로세스를 공유해야 합니다.
• 파일을 업로드한 사용자가 작업을 시작한 사용자로 표시하려면 프로세스에서 startedby 필드에 전달된 값을 개시자의 표시 이름으로 사용해야 합니다.

Oracle Integration에서 문서 설정 구성

관리자는 Oracle Integration과 Oracle Content Management 간의 접속도 구성해야 합니다. Oracle Content Management에 대한 URL 및 사인인 인증서와 같은 정보를 입력해야 합니다.

Oracle Integration에서 설정을 구성하려면 다음을 수행합니다.

1. Oracle Integration 탐색 창에서 내 작업을 누르고 작업 영역을 누른 다음 관리를 누릅니다.
2. Services(서비스)를 누릅니다.
3. Oracle Content Management 섹션에서 다음 정보를 입력합니다.
   • URL: Oracle Content Management의 웹 주소입니다. 서비스 관리자는 서비스를 사용할 준비가 되면 Oracle Cloud 시작 전자메일을 받습니다. 전자메일에는 Oracle Content Management에 대한 URL이 있습니다. 예를 들어 https://your_service_name.com/ddocument입니다.
   • ID 도메인: Oracle Content Management가 속한 ID 도메인의 이름입니다. ID 도메인을 제공하지 않고 Oracle Content Management(문서 기능의 경우)에 대한 접속을 성공적으로 구성할 수 있습니다.
   • 사용자 및 비밀번호: Oracle Content Management에 액세스할 수 있는 사용자의 계정 인증서 이 사용자 계정은 서비스 간 접속을 테스트하는 데 사용됩니다. 런타임 중에도 서비스에 접속하고 폴더 생성과 같은 모든 런타임 작업을 수행하는 데 사용됩니다.

   중요:

   대화를 사용하여 협업하려면 여기서 지정하는 사용자에게 다음 역할이 지정되어야 합니다.

   service_instance_name.CECIntegrationUser

   Oracle Cloud 내 서비스 애플리케이션을 사용하여 사용자에게 롤을 지정합니다.

4. 테스트를 누릅니다.

   구성 설정을 변경할 때마다 입력한 값이 올바른지 확인하는 것이 좋습니다. Oracle Content Management에서 연결이 성공적으로 설정되었는지 확인하려고 합니다.

   메시지, 오류 및 경고가 포함될 수 있는 테스트 결과를 검토합니다.

5. 계속하려면 다음 옵션 중 하나를 선택합니다.
   • 오류 또는 경고가 있는 경우 필요에 따라 변경한 다음 테스트를 다시 눌러 새 값을 확인합니다. 설정을 변경할 때마다 테스트를 반복합니다.
   • 접속 테스트에 성공하면 저장을 눌러 구성 설정을 저장합니다.
   • 취소하고 마지막에 저장한 값으로 돌아가려면 복원을 누릅니다.