Adobe Sign Search - 작동 방법

개요

Adobe Sign을 사용하면 복합 검색을 통해 사용자 계약 콘텐츠를 찾을 수 있습니다. 관리 페이지의 검색 막대는 선택한 콘텐츠 소스에 대해 제공된 문자열과 일치하는 모든 트랜잭션을 반환합니다.

  • "계약"을 보고 있는 경우 컨텐츠를 검색합니다. 공유 계정을 보고 있는 경우 공유 계정의 컨텐츠를 검색합니다.

아래 필드의 컨텐츠는 트랜잭션이 생성/업데이트될 때 인덱스화됩니다.

  • 제목 - 계약 제목.
  • 메모 - 참가자가 남긴 개인 계약 메모로, 다른 사람에게 보이지 않습니다.
  • 메시지 - 이 참가자에게 표시되는 메시지 목록(공용 및 개인 메시지 모두 포함).
  • 원본 파일 이름 - 계약과 연결된 업로드된 파일의 원본 이름.
  • 이메일 - 수신자(숨은 참조 포함) 또는 발신자의 이메일 주소.
  • 성명 – 수신자(숨은 참조 포함) 또는 발신자의 이름과 성.
  • 직책 – 수신자(숨은 참조 포함) 또는 발신자의 회사 내 직책.
  • 회사 이름 – 수신자(숨은 참조 포함) 또는 발신자의 회사 또는 조직 이름.
  • 수신자 그룹 이름 – 수신자가 속할 수 있는 임시 계약 그룹의 이름.
  • 텍스트 필드 내용 - 양식에 사용자가 제공하는 텍스트 필드 내용.
  • 공유자의 성명 - 계약 공유자의 성명. 공유하지 않는 경우 이것은 사용자의 이름입니다.
  • 공유자의 수신자 그룹 이름 - 계약 공유자의 수신자 그룹 이름. 공유하지 않는 경우 이것은 사용자의 수신자 그룹 이름입니다.
  • 외부 ID - 임의 형식으로, 보통 "<groupID>:<ID>" 형식으로 발신자가 계약에 할당하는 ID. 외부 ID는 계약 생성 API에 대한 호출로 전달됩니다.
  • 외부 그룹 ID - 임의 형식으로 발신자가 계약에 할당하는 그룹 ID로, 보통 외부 ID의 접두어로 사용됩니다. 외부 그룹 ID는 계약 생성 API에 대한 호출로 전달됩니다. 외부 그룹 ID 매개 변수를 설정하는 경우 외부 ID를 설정해야 합니다.

텍스트 검색 작동 방식

"A simple fish" 문자열을 검색하려는 경우

  • Adobe Sign은 공백을 구분 기호로 사용하여 문자열을 "토큰화"합니다. 위의 예제 문자열은 Asimple 및 fish의 세 개 토큰으로 나뉩니다.
    • 문자열 쿼리의 문자는 문자, 숫자 또는 구분자, 세 가지 유형 중 하나에 속합니다.
    • 구분자로 취급되는 문자(공백 제외): ~ ` ! @ # $ % ^ & * ( ) - + = { } [ ] | \ . , : ; " ' < > ? /
      • 마침표, 밑줄 및 아포스트로피는 해당 기호의 앞과 뒤에 있는 문자가 동일한 유형인 경우 토큰의 부분으로 남아 있습니다.
      • 전체 쿼리 문자열을 둘러싸는 따옴표는 구분자가 아니고 리터럴 문자열 값(구문)을 지정합니다.
      • 쿼리 문자열 안에 있는 따옴표는 구분자이고 리터럴 문자열 값을 지정하지 않습니다.
  • 대소문자 구분은 제거됩니다. 예: a, simplefish
  • 검색한 다음 각 토큰의 전체 텍스트를 색인된 값과 일치시킵니다.
    • 계약 제목(아래 참조)에 대한 보다 복잡한 토큰화가 수행됩니다.
  • 포함 검색이 사용되었습니다. 즉, 하나 이상의 검색 가능 필드에서 하나 이상의 토큰과 일치하는 모든 계약이 반환된 데이터 집합에 포함됨을 의미합니다.
    • 반환된 데이터 집합은 가장 관련이 많은 검색 결과가 맨 위에 있는 방식으로 연관성 점수를 기준으로 정렬됩니다.

계약 제목 필드:

위의 설명과 같이, 컨텍스트 구분 문자(vs 명시적 문자)를 주로 토큰화하는 추가적인 "사용자 지정" 토크나이저로 인해 계약 제목 필드의 토큰은 보다 복잡하게 수행됩니다. 이러한 사용자 지정 토크나이저는 다음과 같은 점에서 표준과 다릅니다.

  • 접두사 토큰(최대 10자)이 생성됩니다. 접두사 토큰은 표준 토큰의 증분 문자열입니다. 예: 표준 토큰이 fish인 경우, 증분 토큰은 f, fi, fis fish입니다.
    • 이러한 방식으로 토큰의 첫 번째 문자부터 시작하여 부분 문자열을 검색할 수 있습니다.
    • 중간 문자열 일치는 무시됩니다. 예: rent를 검색하는 경우 단어 apparently는 일치하지 않습니다.
  • 영숫자가 아닌 문자에서 토큰을 분할합니다. 예: 문자열 Super_Duper Super Duper를 생성합니다.
    • 밑줄은 표준 토크나이저에서 구분 기호가 아닙니다.
  • 대소문자 상태 전이에서 토큰을 분할합니다. 예: 문자열 PowerShot은 토큰 Power 및 Shot을 생성합니다.
  • 문자-숫자 상태 전이에서 토큰을 분할합니다. 예: 문자열 XL500은 토큰 XL 500을 생성합니다.
  • 각 토큰에서 선행 또는 후행 구분 기호를 제거합니다. 예: 문자열 XL---42+'Autocoder'XL42 및 Autocoder를 생성합니다.
  • 각 토큰의 끝에서 영어 소유격('s)을 제거합니다. 예: 문자열 Dave's 은 토큰 Dave를 생성합니다.

표준 및 사용자 지정 토크나이저를 조합하면 전체 토큰 문자열(표준 토크나이저 사용) 및 접두어 토큰(사용자 지정 토크나이저 사용)을 검색할 수 있지만, 구분 기호가 포함된 접두어 토큰을 검색할 수 없습니다

예 1: 계약 이름이 My_NDA인 경우

  • 표준 토크나이저는 my_nda와 같은 토큰을 생성합니다.
  • 사용자 지정 토크나이저는 일련의 접두사 토큰인 m, my, n, ndnda를 생성합니다.
  • my_nd를 검색하면 결과가 반환되지 않습니다. 왜냐하면 
    • 표준 토큰화는 접두사 토큰이 아닌 전체 문자열만 생성하기 때문입니다.
    • 사용자 지정 토크나이저는 밑줄을 구분 기호로 사용하므로, 모든 접두사 토큰은 밑줄을 포함하지 않습니다.

예 2: 계약 이름이 XL500인 경우

  • 표준 토크나이저는 xl500과 같은 토큰을 생성합니다.
  • 사용자 지정 토크나이저는 일련의 접두사 토큰인 xxl550 및 500을 생성합니다.
  • xl5을 검색하면 결과가 반환되지 않습니다.
    • 표준 토큰화는 접두사 토큰이 아닌 전체 문자열만 생성하기 때문입니다.
    • 사용자 지정 토크나이저는 문자-숫자 상태 전이를 구분 기호로 사용하므로, 문자에서 숫자로 전이되는 접두사 토큰을 생성할 수 없습니다.

특수 쿼리 구문으로 검색

위 섹션에서 설명한 바와 같이 계약 검색은 계약의 모든 검색 가능한 필드에서 근사 일치를 수행합니다.검색 가능 필드 내용은 토큰화되고, 그런 다음 이러한 토큰이 쿼리 시 쿼리 문자열과 일치합니다. 또한 계약 검색은 이러한 토큰에 대해 최대 10자의 접두어 일치를 수행합니다.그러나, 전체 필드 값의 일치와 필드 값에서 구문 일치는 특수 구문으로만 검색할 수 있습니다.

구문 일치 쿼리:

검색 가능한 모든 필드에서 구문 검색이 필요한 경우 구문 일치 쿼리를 사용해야 합니다.

  • 토큰이 필드에 나타나는 경우(반드시 모든 토큰이 나타날 필요는 없음) 일반 근사 일치 쿼리가 일치하고, 토큰이 함께 나타날 필요가 없으므로 토큰 순서는 상관 없습니다.
  • 구문 일치는 여러 토큰이 동일한 필드에 나타나는 경우 일치시킬 수 있도록 하고, 이러한 토큰은 따옴표 내 지정된 순서대로 나타납니다.

구문 일치 쿼리 구문 형식:

'<phrase_match_query>'

또는

"<phrase_match_query>"

쿼리 구문이 구문 일치 쿼리 구문에 대한 규칙을 따르지 않는 경우에는 계약 검색에서 검색 가능한 모든 필드 간에 일반 근사 일치 쿼리를 수행합니다.

필드 이름 접두어 쿼리:

사용자 계약의 특정 필드 하나만 검색할 때 필드 이름 접두어 조회를 사용해야 합니다. 필드 이름 접두어 쿼리는 필드 이름 접두어와 일반 근사 일치 또는 구문 일치 쿼리를 포함해야 합니다.

필드 이름 접두어 쿼리 구문 형식:

<field_name>:<query>

또는

<field_name>:"<phrase_match_query>"

또는

<field_name>:'<phrase_match_query>'

<field_name>을 지정하지 않으면 해당 구문 일치에 대해 지원되는 모든 필드가 쿼리됩니다. 그렇지 않으면, <field_name> 필드만 쿼리됩니다. 

쿼리 구문이 필드 이름 접두어 쿼리 구문에 대한 규칙을 따르지 않는 경우 계약 검색에서는 전체 쿼리를 검색 쿼리(구문에 따라 근사 일치 또는 구문 일치)로 사용하고 검색 가능한 모든 필드에서 검색을 수행합니다. 

예를 들어, 구문 일치 쿼리:

제목: "Hello World"

계약의 제목을 포함하는 필드에 대해서만 검색을 수행해야 합니다.

다음은 필드 이름 접두어 쿼리에 지원되는 접두어 목록입니다.

필드 이름 접두어는 대소문자를 구분하지 않습니다.

필드 내용

문자열 쿼리 필드 이름 접두어

필드 내용 설명

직함

title*

계약 제목.

메모를 추가합니다

note

참가자가 남긴 개인 계약 메모로, 다른 사람에게 보이지 않습니다.

메시지

message

이 참가자에게 표시되는 메시지 목록(공용 및 개인 메시지 모두 포함).

원본 파일 이름

originalFileName

계약과 연결된 업로드된 파일의 원본 이름.

이메일

email**

수신자(숨은 참조 포함) 또는 발신자의 이메일 주소.

성명

fullName***

수신자(숨은 참조 포함) 또는 발신자의 이름과 성.

직책

jobTitle

수신자(숨은 참조 포함) 또는 발신자의 회사 내 직책.

회사 이름

companyName

수신자(숨은 참조 포함) 또는 발신자의 회사 또는 조직 이름.

수신자 그룹 이름

recipientGroupName

수신자가 속할 수 있는 임시 계약 그룹의 이름.

텍스트 필드 내용

textFieldContent

양식에서 사용자가 제공하는 텍스트 필드 내용.

공유자의 성명 sharerFullName 계약 공유자의 성명. 공유하지 않는 경우 이것은 사용자의 이름입니다.
공유자의 수신자 그룹 이름 sharerRecipientGroupName 계약 공유자의 수신자 그룹 이름. 공유하지 않는 경우 이것은 사용자의 수신자 그룹 이름입니다.
외부 ID

externalId

임의 형식으로, 보통 "<groupID>:<ID>" 형식으로 발신자가 계약에 할당하는 ID. 외부 ID는 계약 생성 API에 대한 호출로 전달됩니다.

외부 그룹 ID

externalGroupId

임의 형식으로 발신자가 계약에 할당하는 그룹 ID로, 보통 외부 ID의 접두어로 사용됩니다. 외부 그룹 ID는 계약 생성 API에 대한 호출로 전달됩니다.

외부 그룹 ID 매개 변수를 설정하는 경우 외부 ID를 설정해야 합니다.

역방향 호환성을 위해, 일부 필드 이름 접두어는 원래 필드 이름 접두어와 기능상 동등한 별칭을 가집니다. 이러한 별칭은 사용되지 않고 결국 제거됩니다.

  *  필드 이름 접두어 'name'이 'title' 대신 사용될 수 있습니다.

 ** 필드 이름 접두어 'participantEmail'이 'email' 대신 사용될 수 있습니다.  

*** 필드 이름 접두어 'participantName'이 'fullName' 대신 사용될 수 있습니다.

반환된 데이터 필터링

내용을 검색하면 레코드가 너무 많이 반환될 수 있습니다.

개별적으로 또는 조합하여 사용할 수 있는 4가지 필터를 사용하면 데이터 세트를 관리 가능한 레코드 목록으로 줄이는 데 도움이 됩니다.

수정 날짜로 필터링

수정 날짜 필터 아이콘은 날짜 범위를 선택하여 데이터 세트를 추가로 줄일 수 있는 옵션을 표시합니다.

  • 모든 날짜
  • 지난 24시간
  • 최근 7일
  • 지난 30일
  • 지난 12개월
  • 사용자 지정 날짜 범위

필드 값으로 필터링

검색 입력 상자(필터 단추의 오른쪽)를 사용하면 매우 특정한 또는 고유한 데이터를 보유할 수 있는 개별 필드에 필터를 적용할 수 있습니다.

검색 가능한 필드 옵션:

  • 모든 필드 - 기본값입니다. 이 옵션은 검색 필드의 정확한 문자열에 대해 모든 필드 옵션을 검색하므로 가장 많은 레코드 세트를 반환합니다.
  • 제목 - 반환되는 데이터 세트를 개체의 제목(예: 계약 이름)에서 문자열이 검색된 레코드로 제한합니다.
  • 참고 - 데이터 세트를 검색 사용자의 개인 메모에 검색된 문자열이 포함된 레코드로 제한합니다.
  • 메시지 - 데이터 세트를 계약의 메시지 필드나 개인 메시지에 검색된 문자열이 포함된 레코드로 제한합니다.
  • 원본 파일 이름 - 원래 업로드한 문서의 파일 이름을 평가하고 일치하는 레코드만 반환합니다.
  • 전자 메일 - 수신자의 전자 메일 주소와 일치합니다.
    • 이 필터는 전자 메일 유효성 검사가 정의된 텍스트를 트랩하지 않습니다.  
  • 성명 - 서명을 적용할 때 수신자가 제공하는 이름 값입니다. 한 개의 이름만 제공하면 값과 일치하는 모든 레코드가 반환됩니다.
    • 이름 값은 수신자가 입력하는 내용에 따라 달라지며 이전 서명 값이나 프로필 이름과 다를 수 있습니다(수신자에게 Adobe Sign 사용자 계정이 있는 경우).
  • 직책 - 직책 필드에 있는 값입니다.
  • 회사 이름 - 회사 필드에 있는 값입니다.
  • 수신자 그룹 이름 - (전송자가 입력한) 수신자 그룹 이름입니다.
  • 텍스트 필드 내용 - 텍스트 입력 필드의 정확한 값입니다. 기본값과 대용량 텍스트 블록에서 발견되는 개별 단어를 포함합니다.

그룹별 필터링

다중 그룹의 사용자가 활성화된 계정은 반환되는 데이터 세트를 해당 그룹에서 보낸 계약으로 제한하는 그룹 필터에 액세스할 수 있습니다.

검색 필터

숨긴 컨텐츠 필터링

숨긴 컨텐츠 검색에 대한 추가 옵션을 사용할 수 있습니다.

숨긴 컨텐츠 검색을 선택한 경우에는 반환된 데이터 세트에 숨겨진 컨텐츠 포함됩니다.

참고:

필터를 선택하면 필터 아이콘 옆에 태그가 표시됩니다. 데이터 세트가 반환되면 임의의 필터 하나를 클릭하여 제거할 수 있습니다.

Adobe 로고

내 계정 로그인