Domino 문서 조회

문서 조회 활동은 문서 필드에 지정된 값과 일치하는 문서를 Lotus® Domino® 서버의 데이터베이스에서 조회하는 데 사용됩니다.

아웃바운드 요청과 함께 전송된 입력 데이터에 다음 중 하나 이상의 기준을 지정할 수 있습니다.
  • 문서 비즈니스 데이터: 맵 입력 섹션에 문서 비즈니스 데이터를 지정하면 커넥터가 맵 입력에서 유효한 모든 데이터를 읽습니다. 커넥터는 데이터베이스에서 유효한 데이터에 일치하는 문서를 검색합니다. 맵 출력 스키마를 사용하여 표시할 수 있는 일치하는 모든 문서가 응답으로 리턴됩니다.
  • ParentDocumentUNID: 유효한 ParentDocumentUNID를 입력 맵핑 섹션에 지정하면 커넥터가 이 상위 문서에 대한 모든 하위 문서를 조회합니다. 맵 출력 스키마를 사용하여 표시할 수 있는 일치하는 모든 문서가 응답으로 리턴됩니다.
  • 데이터 세트 없음: 맵 입력에 데이터를 제공하지 않으면 커넥터는 맵 출력 스키마를 사용하여 표시할 수 있는 문서를 조회합니다.
다음 두 가지 유형의 검색 방법을 기반으로 문서를 검색할 수 있습니다.
  1. 데이터베이스 검색 방법: 문서 선택 기준이 정해지면 기준을 충족하는 데이터베이스의 모든 문서를 리턴합니다. 기본적으로 활동은 데이터베이스 검색 방법을 사용하여 문서를 검색합니다. 명시적으로 검색을 이 유형으로 설정하려면 입력 맵핑 섹션에서 searchType 선택적 매개변수의 값을 NORMAL_SEARCH로 설정하십시오. 이 방법은 다음 유형의 검색 기준을 기반으로 하는 문서 검색을 지원합니다.
    1. 단일 값: 검색 기준에 단일 값을 지정할 수 있습니다. 예를 들어, 커넥터는 검색 필드에 지정된 단일 단어, 숫자 또는 날짜를 기반으로 문서를 조회할 수 있습니다. 다음 지점에서 숫자 및 날짜 유형 필드에 지정할 수 있는 검색 값에 대한 자세한 정보를 찾을 수 있습니다.
      • 숫자: 숫자 유형 필드의 검색 기준으로 두 자리 숫자나 정수 값을 지정할 수 있습니다. 이 검색 기능을 사용하여 숫자 유형 필드가 특정 값에 일치하는 문서를 조회할 수 있습니다. 예를 들어, 직원의 급여가 1234.56인 문서를 조회하려면 1234.56 값을 EmployeeSalary 필드에 입력하십시오.
      • 날짜: 날짜 유형 필드에 검색 기준으로 날짜를 지정할 수 있습니다. 예를 들어, 생일이 1982/11/22인 문서를 조회하려면 Birthday 필드에 1982/11/22 값을 지정하십시오.
    2. 복수 값: Lotus® Domino® 필드 유형의 검색 기준으로 복수 값을 지정할 수 있습니다. 이 기능은 런타임 시 지정된 값으로 문서를 찾을 때 사용할 수 있습니다. 예를 들어, 검색 기준에 지정된 단어와 일치하는 문서를 검색하도록 커넥터를 구성할 수 있습니다.
    3. 서식있는 텍스트 컨텐츠 텍스트 검색: 런타임 시 서식있는 텍스트 컨텐츠가 있는 문서를 검색하기 위한 텍스트를 지정할 수 있습니다. 커넥터는 RichText 필드에 지정된 텍스트를 사용하여 검색을 수행하며 일치하는 모든 문서가 커넥터를 통해 검색됩니다. 커넥터는 RichText 필드에 대한 단일 및 복수 텍스트 컨텐츠 검색을 둘 다 지원합니다. *와 같은 와일드카드 접미부를 제공하여 RichText 필드의 문서를 검색할 수도 있습니다.
    4. 복수 필드를 사용한 검색: 두 개 이상의 필드에 검색 값을 지정할 수 있습니다. 이 구성에서는 활동이 논리 AND 연산자를 사용하여 검색 문자열을 그룹화합니다. 예를 들어, 여러 필드에 단일 값, 복수 값, RichText 또는 ParentDocumentUNID를 지정할 수 있습니다. 활동은 지정된 모든 기준과 일치하는 검색 컨텐츠만 리턴합니다.

  2. 데이터베이스 전체 텍스트 검색/색인화된 검색 방법: 데이터베이스의 모든 문서에 대한 전체 텍스트 검색을 수행합니다. 데이터베이스가 완전히 색인화된 경우, 데이터베이스 검색 방법과 비교하여 색인화된 검색 방법이 더 빠릅니다. 이 방법은 관련성 점수별로 출력 데이터를 정렬합니다. 관련성별로 콜렉션이 정렬될 때 관련성이 가장 높은 것이 첫 번째로 표시됩니다. 명시적으로 검색을 이 유형으로 설정하려면 입력 맵핑 섹션에서 searchType 선택적 매개변수의 값을 FULL_TEXT_SEARCH로 설정하십시오.
    1. 복수 필드를 사용한 검색: 색인화된 검색 방법은 복수 필드를 사용한 검색도 지원합니다. 두 개 이상의 필드에 검색 값을 지정할 수 있습니다. 이 구성에서는 커넥터가 논리 AND 연산자를 사용하여 검색 문자열을 그룹화합니다. 예를 들어, 여러 필드에 단일 값, 복수 값 또는 ParentDocumentUNID>를 지정할 수 있습니다. 커넥터는 지정된 모든 검색 기준의 논리 AND 오퍼레이션을 리턴하는데, 문자열 유형 필드에 대해서는 완전 및 근접 일치를, 숫자 유형 필드에 대해서는 완전 일치를 리턴합니다.
    참고: 색인화된 검색 방법은 RichText, AttachmentsDate 필드에는 작동하지 않습니다.
문서 조회 활동 사용
  1. 프로젝트 분할창에서 오케스트레이션을 마우스 오른쪽 단추로 클릭하고 새 오케스트레이션을 클릭하여 오케스트레이션을 작성하거나 여십시오. 오케스트레이션 분할창이 표시됩니다.
  2. 활동 탭을 선택하고 Domino 폴더를 펼치십시오.
  3. 조회 활동을 Domino 폴더에서 오케스트레이션으로 끌어오십시오. 오케스트레이션의 그래픽 표시가 점검 목록과 같이 표시됩니다.
  4. 엔드포인트 선택을 클릭하고 Domino 엔드포인트를 선택하십시오.

    Domino 엔드포인트 작성 또는 편집에 대한 지시사항은 Domino 활동에 대한 엔드포인트 작성 또는 편집을 참조하십시오.

  5. 점검 목록에서 구성을 클릭하십시오. 구성 분할창이 표시됩니다.
    • 찾아보기를 클릭하여 Domino 데이터베이스 찾아보기 분할창에서 기존 데이터베이스를 선택하십시오. Domino 데이터베이스 찾아보기에 선택한 엔드포인트에 대한 모든 데이터베이스가 표시됩니다.
    • 다음을 클릭하여 Domino 양식 찾아보기 분할창에서 기존 양식을 선택하십시오. Domino 양식 찾아보기는 선택한 Domino 서버의 데이터베이스에 있는 모든 양식을 표시합니다.
      참고: 데이터베이스 이름을 선택한 후에만 다음 단추를 사용할 수 있습니다.
    • 정규 이름이 있는 필드는 쉼표로 구분되는 값으로 John Smith/IBM/COUNTRY와 같은 정규 이름이 있을 수 있는 필드를 허용합니다. 이 필드의 값을 johnsmith@country.ibm.com과 같은 인터넷 메일 주소로 변환하려면 이 필드에 정규 이름을 지정하십시오. 필드 이름의 몇 가지 예로는 To, From, CC, Chair, Required Attendees 등이 있습니다.

  6. 점검 목록에서 입력 맵핑을 선택하십시오. 문서 조회 활동의 선택된 오브젝트에서 생성된 XML 스키마가 활동으로 패널의 request 입력 매개변수 아래에 노드로 표시됩니다.

    다중 데이터베이스에 동일한 양식 유형의 경우, 입력 맵핑에서 선택적 매개변수의 일부로 데이터베이스 이름을 지정할 수 있습니다(여기서 동일한 오케스트레이션을 사용하여 다른 데이터베이스에서 아웃바운드 오퍼레이션을 수행할 수 있음). 이를 수행하려면 표 1에 설명된 databaseName 선택적 매개변수에 데이터베이스 이름을 지정해야 합니다. databaseName 매개변수의 값이 채워지면 databaseName 매개변수에 지정된 데이터베이스에서 아웃바운드 조작이 수행됩니다. 지정된 값이 없는 경우에는 구성 중 지정된 데이터베이스 이름을 사용하여 아웃바운드 조작이 수행됩니다.

    선택적 입력 매개변수는 다음 표에 설명되어 있습니다.

    표 1. 선택적 입력 매개변수
    매개변수 이름 설명
    databaseName databaseName은 문서를 조회하는 데이터베이스 이름입니다. 이 매개변수의 값이 설정되면 구성 패널에 제공된 데이터베이스의 값을 겹쳐씁니다. 이 매개변수는 구조(양식)가 동일한 문서를 동일한 오케스트레이션을 사용하여 다중 데이터베이스에서 조회해야 하는 경우 유용합니다.
    Domino 커넥터는 다른 Domino 서버와의 동적 엔드포인트 연결도 지원합니다. 런타임 중 엔드포인트 페이지에 구성된 서버가 아닌 Domino 서버에 동적으로 연결하려면 dominoConnectionProperties에서 입력 맵핑의 새 선택적 매개변수를 추가하십시오. dominoConnectionProperties의 매개변수는 다음 표에 설명되어 있습니다.
    표 2. 선택적 연결 매개변수
    매개변수 설명
    dominoConnectionProperties 매개변수
    hostName Domino 서버가 실행 중인 시스템의 호스트 이름 또는 IP 주소를 지정합니다.
    diiopPort Java™ 애플릿 또는 애플리케이션이 CORBA를 사용하여 원격으로 Domino 데이터에 액세스할 수 있도록 하는 DIIOP(Domino Internet Inter-ORB Protocol) 포트를 지정합니다. 기본값은 63148입니다.
    username Domino 서버에 연결할 사용자 이름을 지정합니다.
    connectionPool 매개변수
    minimumConnections 통합 어플라이언스가 연결 풀에서 열린 상태로 유지하는 Domino 서버의 최저 연결 수를 지정합니다. 0(영) 값을 입력할 수 있습니다. 기본값은 5입니다.
    maximumConnections 통합 어플라이언스가 연결 풀에서 열린 상태로 유지하는 Domino 서버의 최대 연결 수를 지정합니다. 0(영) 값을 지정하면 최대 연결 수는 무제한입니다. 기본값은 25입니다.
    maxIdleTime 통합 어플라이언스가 연결을 닫기 전에 Domino 서버 연결을 열어 유휴 상태를 유지할 수 있는 시간(분)을 지정합니다. 0(영)을 입력하면 풀에 리턴될 때 연결이 닫히고 유휴 시간이 없습니다. 기본값은 120분입니다.
    maxWait 통합 어플라이언스가 풀에 있는 모든 연결이 사용될 때 연결을 대기하는 시간(초)을 지정합니다. 대기 시간 이후에도 연결되지 않는 경우, 예외가 발생합니다. 기본값은 300초입니다.
    reclaimConnections 커넥터가 유휴 연결이 있는지 확인하는 간격을 지정합니다. 최소 연결 매개변수에 지정된 최소 연결 수에 도달할 때까지 유휴 연결이 재확보됩니다. 기본값은 5분입니다.
    password Domino 서버에 연결할 사용자 이름과 연관된 비밀번호를 지정합니다.
  7. 활동의 입력 매개변수와 오케스트레이션 변수 간의 맵을 작성하십시오.
    참고: 런타임 시 입력 구조의 필수 요소에 값을 제공해야 합니다. 요소에 기본값을 지정하거나 요소를 입력 노드와 연결하여 값을 제공할 수 있습니다. 런타임 시 필수 요소의 값을 제공하지 않으면, 활동에서 웹 관리 콘솔이 보고하는 예외가 발생합니다. 런타임 시 선택적 입력 매개변수를 제공하지 않아도 런타임 중에 예외가 발생하지 않습니다.
  8. 활동에 사용될 검색 유형을 선택하십시오.
    표 3. 검색 유형
    매개변수 이름 설명
    searchType 이 활동에 사용될 검색 유형을 지정합니다. 값은 다음과 같습니다.
    • NORMAL_SEARCH: Domino 데이터베이스 검색 방법을 사용합니다.
    • FULL_TEXT_SEARCH: Domino 데이터베이스 전체 텍스트 검색 유형을 사용합니다.
    값을 지정하지 않으면 NORMAL_SEARCH가 사용됩니다.
  9. 점검 목록에서 출력 맵핑을 선택하십시오. 활동의 응답을 보유하는 데 생성된 XML 스키마가 활동에서 패널의 response 출력 매개변수 아래에 노드로 표시됩니다.

    참고: Domino 문서에 있고 입출력(I/O) 맵핑 구조로 생성되지 않은 동적으로 추가된 필드는 Domino 커넥터에 의해 처리됩니다. 이 활동을 사용하여 문서를 검색할 때 이 필드의 데이터는 AdditionalFields 아래의 출력 맵핑 섹션에서 사용할 수 있습니다.

    queryUsingTimestamp는 시간소인을 기반으로 하는 문서를 조회하는 데 사용되는 매개변수입니다. timestamp 특성은 반복적 특성입니다. timestamp 특성 아래에 groupFields, name, operator, value를 정의할 수 있습니다.

    선택적 출력 매개변수는 다음 표에 설명되어 있습니다.

    매개변수 이름 설명
    queryUsingTimestamp
    timestamp 특성은 다음과 같습니다.
    표 4. timestamp 특성
    특성
    groupFields AND, OR, (,), AND(, OR(, )AND, )OR, )AND(, )OR(와 같이 복수 값을 지정할 수 있습니다. .
    참고: 조건이 여러 개일 수 있습니다. 조건이 여러 개인 경우 groupFields를 사용해야 합니다.
    이름 createdTimestamp 또는 lastModifiedTimestamp 값 중 하나를 지정하십시오.
    operator GREATER_THAN, GREATER_THAN_OR_EQUAL_TO, EQUAL_TO, LESS_THAN, LESS_THAN_OR_EQUAL_TO, NOT_EQUAL_TO 값 중 하나를 지정하십시오.
    value 날짜 및 시간 값을 지정하십시오(예: 26-09-2013 12:05:00 PM EST).
    참고: 시간대를 언급하지 않으면 기본적으로 서버 시간대를 간주합니다.

    참고:
    • NOT_EQUAL_TO 연산자(!=)를 기반으로 한 문서 조회는 전체 텍스트 검색에서 지원되지 않습니다.
    • 시간을 사용한 문서 조회는 전체 텍스트 검색에서 지원되지 않습니다(예: [_RevisionDate] = 05/06/2013 09:30:00).
    • 시간소인에 EQUAL_TO 연산자를 사용한 문서 조회는 일반 검색 유형과 작동하지 않습니다(예: @Modified = [05/06/2013 09:14:22]).
    • 전체 텍스트 검색을 검색 유형으로 사용하여 문서를 검색할 때 DateTime이 아닌 Date만 기반으로 하는 문서를 조회할 수 있습니다. 예를 들어, lastModfiedDateTime >= 05/20/2013 20:00:00은 전체 텍스트 검색에서 지원되지 않습니다.
  10. 출력 매개변수와 오케스트레이션 변수 간의 맵을 작성하십시오.
Domino 문서 조회 활동을 구성했습니다.



피드백 | 주의사항


시간소인 아이콘 마지막 업데이트 날짜: 2013년 11월 6일 수요일