사용자 지정된 검색 구성 설정 가져오기 및 내보내기
Microsoft 365의SharePoint 관리자 이상에서는 테넌트, 사이트 모음 및 사이트 간에 사용자 지정된 검색 구성 설정을 내보내고 가져올 수 있습니다. 내보내고 가져오는 설정에는 모든 사용자 지정된 쿼리 규칙, 결과 원본, 결과 유형, 순위 모델 및 사이트 검색 설정이 포함됩니다. Search 서비스 애플리케이션에서 사용자 지정된 검색 구성 설정을 내보내고 설정을 테넌트, 사이트 모음 또는 사이트로 가져올 수도 있습니다. 기본 구성 설정을 내보낼 수 없습니다.
개요
사용자 지정된 검색 구성 설정을 내보낼 때 SharePoint는 XML 형식의 검색 구성 파일을 만듭니다. 이 검색 구성 파일에는 내보내기를 시작하는 테넌트, 사이트 모음 또는 사이트 수준에서 내보낼 수 있는 모든 사용자 지정 검색 구성 설정이 포함됩니다. 사이트 모음에 대한 검색 구성 파일에는 사이트 모음 내의 개별 사이트의 검색 구성 설정이 포함되어 있지 않습니다.
검색 구성 파일을 가져올 때 SharePoint는 가져오기를 시작하는 테넌트, 사이트 모음 또는 사이트에서 사용자 지정된 각 검색 구성 설정을 만들고 사용하도록 설정합니다.
이 표에는 내보내거나 가져올 수 있는 설정이 표시됩니다. 각 설정에 대해 다른 사용자 지정된 검색 구성 설정에 대한 종속성을 찾을 수 있습니다. 사용자 지정된 검색 구성 설정이 다른 수준의 사용자 지정된 검색 구성 설정에 종속된 경우, 예를 들어 사이트 쿼리 규칙이 사이트 모음 수준의 결과 원본에 종속된 경우 모든 관련 수준의 설정을 내보내고 가져와야 합니다.
| 사용자 지정된 검색 구성 설정 | 다른 사용자 지정된 검색 구성 설정에 대한 종속성 |
|---|---|
| 쿼리 규칙. 여기에는 결과 블록, 승격된 결과 및 사용자 세그먼트가 포함됩니다. | 결과 원본, 결과 형식, 검색 스키마, 순위 모델 |
| 결과 원본 | 검색 스키마 |
| 결과 유형 | 검색 스키마, 결과 원본, 표시 템플릿 |
| 검색 스키마 | 없음 |
| 순위 모델 | 검색 스키마 |
가져오기가 실패할 수 있는 조건
검색 구성 파일과 가져오기 대상에 이름이 같은 설정이 있는 경우 이 설정이 발견되면 검색 구성 파일의 가져오기가 실패합니다. 그러나 다음과 같은 예외가 있습니다.
검색 구성 파일을 다시 가져오는 경우에는 검색 구성 파일과 대상에 있는 이름이 같은 설정으로 인해 가져오기가 실패하지 않습니다.
개별 관리 속성 설정이 검색 구성 파일의 속성과 대상 속성에서 동일한 경우에는 이름이 같은 관리 속성으로 인해 가져오기가 실패하지 않습니다.
크롤링된 속성에 대한 매핑 및 별칭이 검색 구성 파일의 관리 속성과 대상 관리 속성에서 서로 다른 경우에는 이름이 같은 관리 속성으로 인해 가져오기가 실패하지 않습니다. 가져오기를 통해 검색 구성 파일의 관리 속성에 대한 별칭 및 매핑이 대상 관리 속성에 대한 별칭 및 매핑에 추가됩니다.
검색 구성 파일에 잘못된 문자가 들어 있는 관리 속성 이름 또는 별칭이 포함된 경우 이러한 관리 속성 이름 또는 별칭이 발견되면 가져오기가 실패합니다.
검색 스키마의 관리 속성 이름 및 별칭은 사이트와 해당 상위 사이트 모음에 대해 고유해야 합니다. 이는 다음을 의미합니다.
검색 구성 파일에 대상 사이트 또는 대상 사이트의 상위 사이트 모음에 있는 관리 속성의 별칭과 이름이 같은 관리 속성이 있는 경우 가져오기가 실패합니다.
검색 구성 파일에 대상 사이트 또는 대상 사이트의 상위 사이트 모음에 있는 관리 속성과 이름이 같은 별칭을 가진 관리 속성이 있는 경우 가져오기가 실패합니다.
참고
가져오기가 실패하기 전에 SharePoint에서 만들고 사용하도록 설정한 사용자 지정된 검색 설정은 계속 사용하도록 설정됩니다.
가져오기가 실패한 경우 실패를 일으킨 조건을 제거하고 검색 구성 파일을 다시 가져옵니다. 예를 들어 가져오려는 쿼리 규칙과 이름이 같은 쿼리 규칙이 이미 있음을 알리는 내용이 메모 열에 표시된 경우 대상 또는 가져오기 파일에서 해당 쿼리 규칙을 제거한 다음 파일을 다시 가져와야 합니다. 이 문서의 뒷부분에서 가져오기가 실패하는 잘못된 문자를 참조하세요.
테넌트에서 사용자 지정된 검색 구성 설정 내보내기
SharePoint 관리 센터의 추가 기능으로 이동하고 조직에 대한 관리자 권한이 있는 계정으로 로그인합니다.
참고
21Vianet(중국)이 운영하는 Office 365를 사용하는 경우 Microsoft 365 관리 센터에 로그인한 다음 SharePoint 관리 센터로 이동하고 더 많은 기능 페이지를 엽니다.
검색에서 열기를 선택합니다.
검색 구성 내보내기 를 선택합니다.
대화 상자에서 저장을 선택합니다.
사이트에서 사용자 지정된 검색 구성 설정 내보내기
사이트에서 설정 설정
선택한 다음 사이트 설정을 선택합니다.
사이트 설정이 표시되지 않으면 사이트 정보를 선택한 다음, 모든 사이트 설정 보기를 선택합니다.사이트 설정 페이지의 검색 섹션에서 구성 내보내기를 선택합니다.
대화 상자에서 저장을 선택합니다.
사이트 모음에서 사용자 지정된 검색 구성 설정 내보내기
사이트에서 설정 설정
선택한 다음 사이트 설정을 선택합니다.
사이트 설정이 표시되지 않으면 사이트 정보를 선택한 다음, 모든 사이트 설정 보기를 선택합니다.사이트 설정 페이지의 사이트 모음 관리 섹션에서 검색 구성 내보내기를 선택합니다.
대화 상자에서 저장을 선택합니다.
테넌트로 사용자 지정된 검색 구성 설정 가져오기
SharePoint 관리 센터의 추가 기능으로 이동하고 조직에 대한 관리자 권한이 있는 계정으로 로그인합니다.
참고
21Vianet(중국)이 운영하는 Office 365를 사용하는 경우 Microsoft 365 관리 센터에 로그인한 다음 SharePoint 관리 센터로 이동하고 더 많은 기능 페이지를 엽니다.
검색에서 열기를 선택합니다.
검색 구성 가져오기 페이지에서 가져올 파일을 찾습니다.
가져오기를 선택합니다.
검색 구성 목록 페이지에서 다음을 확인합니다.
가져온 검색 구성 파일이 목록에 있으며 해당 상태가 가져오기 성공입니다.
파일을 성공적으로 가져오지 않은 경우 Notes 열에서 발생한 작업에 대한 자세한 정보를 제공합니다.
범위 열은 가져온 설정이 올바른 수준, 즉 파일을 가져오려는 수준에 있음을 보여줍니다. 예를 들어 사이트 수준 대신 사이트 모음 수준에서 설정을 가져온 경우 범위 열에 이 정보가 표시됩니다. 범위 열에는 검색 구성 설정이 사용하도록 설정된 수준이 표시됩니다. 수준은 테넌트(테넌트), 사이트 모음(SPSite) 또는 SPWeb(사이트 수준)입니다.
사이트에 사용자 지정된 검색 구성 설정 가져오기
사이트에서 설정 설정
선택한 다음 사이트 설정을 선택합니다.
사이트 설정이 표시되지 않으면 사이트 정보를 선택한 다음, 모든 사이트 설정 보기를 선택합니다.사이트 설정 페이지의 검색 섹션에서 구성 가져오기를 선택합니다.
검색 구성 가져오기 페이지에서 가져올 파일을 찾습니다.
가져오기를 선택합니다.
검색 구성 목록 페이지에서 다음을 확인합니다.
가져온 검색 구성 파일이 목록에 있으며 해당 상태가 가져오기 성공입니다.
파일을 성공적으로 가져오지 않은 경우 Notes 열에서 발생한 작업에 대한 자세한 정보를 제공합니다.
범위 열은 가져온 설정이 올바른 수준, 즉 파일을 가져오려는 수준에 있음을 보여줍니다. 예를 들어 사이트 수준 대신 사이트 모음 수준에서 설정을 가져온 경우 범위 열에 이 정보가 표시됩니다. 범위 열에는 검색 구성 설정이 사용하도록 설정된 수준이 표시됩니다. 수준은 테넌트(테넌트), 사이트 모음(SPSite) 또는 SPWeb(사이트 수준)입니다.
사이트 모음에 사용자 지정된 검색 구성 설정 가져오기
사이트에서 설정 설정
선택한 다음 사이트 설정을 선택합니다.
사이트 설정이 표시되지 않으면 사이트 정보를 선택한 다음, 모든 사이트 설정 보기를 선택합니다.사이트 설정 페이지의 사이트 모음 관리 섹션에서 구성 가져오기 검색을 선택합니다.
검색 구성 가져오기 페이지에서 가져올 파일을 찾습니다.
가져오기를 선택합니다.
검색 구성 목록 페이지에서 다음을 확인합니다.
가져온 검색 구성 파일이 목록에 있으며 해당 상태는 Imported Successfully입니다.
파일을 성공적으로 가져오지 않은 경우 Notes 열에서 발생한 작업에 대한 자세한 정보를 제공합니다.
범위 열은 가져온 설정이 올바른 수준, 즉 파일을 가져오려는 수준에 있음을 보여줍니다. 예를 들어 사이트 수준 대신 사이트 모음 수준에서 설정을 가져온 경우 범위 열에 이 정보가 표시됩니다. 범위 열에는 검색 구성 설정이 사용하도록 설정된 수준이 표시됩니다. 수준은 테넌트(테넌트), 사이트 모음(SPSite) 또는 SPWeb(사이트 수준)입니다.
가져오기가 실패하는 잘못된 문자
관리 속성 또는 별칭에 아래 나열된 문자 중 하나 이상이 포함된 경우 이러한 속성을 포함하는 사용자 지정된 검색 스키마의 가져오기가 실패합니다.
| 문자 | 이름 |
|---|---|
| 공백 | |
| : | 콜론 |
| ; | 세미콜론 |
| , | 쉼표 |
| ( | 여는 괄호 |
| ) | 닫는 괄호 |
| [ | 여는 대괄호 |
| ] | 닫는 대괄호 |
| { | 여는 중괄호 |
| } | 닫는 중괄호 |
| % | 퍼센트 |
| $ | 달러 기호 |
| _ | 밑줄 |
| + | 더하기 기호 |
| ! | 느낌표 |
| * | 별표 |
| = | 등호 |
| & | 앰퍼샌드 |
| ? | 물음표 |
| @ | @ 기호 |
| # | 숫자 기호 |
| \ | 역슬래시 |
| ~ | 물결표 |
| < | 여는 각괄호 |
| > | 닫는 각괄호 |
| | | 파이프 |
| ` | 억음 악센트 |
| ^ | 캐럿 |
| ' | 이스케이프 시퀀스 |
| " | 이스케이프 시퀀스 |
알려진 문제
검색 구성 목록을 로드할 수 없음
검색 구성 파일을 테넌트 관리자 검색 설정 페이지로 가져올 때 검색 구성 목록이 제대로 표시되지 않아 "파일을 찾을 수 없음" 오류가 발생할 수 있습니다.
이 문제는 가져온 검색 구성 파일 목록을 표시하지 못하도록 UI를 차단하고 가져오기 기능을 중단하지 않습니다. 검색 구성이 제대로 가져옵니다.
UI에서 가져온 검색 구성 파일의 상태를 확인할 수 없으므로 SharePoint CSOM API 또는 SharePoint Online REST API와 같이 목록에 액세스하는 다른 방법을 선택할 수 있습니다.
부실 검색 구성 XML 파일을 가져올 수 없음
검색 구성 파일을 오래 전에 내보낸 경우 가져오기가 실패할 수 있습니다.
내보낸 검색 구성 파일이 부실한 경우 먼저 새 검색 구성을 내보낸 다음 검색 구성 파일 목록을 가져오는 데 사용해야 합니다.