다음을 통해 공유

사이트 맵 편집

  • 아티클

 

게시 날짜: 2017년 1월

적용 대상: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

기본 또는 특정 앱의 사이트 맵은 다음과 같은 방법으로 편집할 수 있습니다.

  • Microsoft Dynamics 365의 이전 버전을 사용하는 경우 Dynamics 365용 2016년 12월 업데이트(온라인 및 온-프레미스)에 소개된 새 사이트 맵 디자이너 또는 타사 사이트 맵 편집기 사용.

  • SiteMap.SiteMapXml 특성에서 XML을 업데이트하기 위해 프로그래밍 방식으로 SiteMap 엔터티 레코드 업데이트.

  • 내보낸 비관리형 솔루션의 customizations.xml에 있는 SiteMap 노드에서 XML을 수동으로 편집한 다음 솔루션의 관리형 또는 비관리형 솔루션으로 가져오기.

이 항목의 내용

사이트 맵 편집기 사용

프로그래밍 방식으로 사이트 맵 업데이트

사이트 맵 수동 편집

스키마 유효성 검사로 편집

앰퍼샌드 문자 인코딩

오류 복구

사이트 맵 편집기 사용

Dynamics 365용 2016년 12월 업데이트(온라인 및 온-프레미스)를 사용 중인 경우 새 사이트 맵 디자이너를 사용하여 사이트 맵을 만들고 관리할 수 있습니다.추가 정보:앱에 대한 사이트 맵 만들기

그렇지 않은 경우 타사 사이트 맵 편집기 중 하나를 사용하여 기본 사이트 맵을 편집할 수 있습니다. 특정 앱에 대한 사이트 맵이 Dynamics 365용 2016년 12월 업데이트(온라인 및 온-프레미스)에 도입되었으므로 타사 사이트 맵 편집기에서는 비즈니스 앱용 사이트 맵을 제대로 편집하지 못할 수도 있습니다. 기본 사이트 맵을 편집하는 인기 있는 사이트 맵 편집기는 Microsoft Dynamics 365 MVP Tanguy Touzard에서 릴리스한 Dynamics CRM 2011/2013 도구 상자에 포함됩니다.

이러한 응용 프로그램은 사이트 맵을 편집하는 프로세스를 간소화하지만 사이트 맵 XML 스키마를 몇 가지 알고 있어야 합니다. 자세한 내용은 SiteMap XML reference을 참조하십시오.

참고

Microsoft Dynamics 365 기술 지원은 타사 응용 프로그램에 대한 지원을 제공하지 않습니다. 이러한 응용 프로그램에 대한 질문이 있으면 응용 프로그램 게시자에게 문의하십시오.

프로그래밍 방식으로 사이트 맵 업데이트

업데이트하려는 SiteMap 엔터티 레코드를 검색한 다음 레코드의 SiteMap.SiteMapXml 특성에 있는 XML을 업데이트합니다. XML을 편집하기 전에 사이트 맵 XML 스키마를 제대로 이해하고 있어야 합니다. 자세한 내용은 SiteMap XML reference을 참조하십시오.

Update 메서드를 사용하여 프로그래밍 방식으로 SiteMap 레코드를 업데이트하면 지정한 사이트 맵 XML은 레코드의 SiteMap.SiteMapXml 특성에 있는 기존 XML 덮어 쓰게 됩니다.

참고

  • 또한 프로그래밍 방식으로 각 앱의 SiteMap 레코드를 만들고 삭제할 수 있습니다. 특정 앱의 SiteMap 레코드를 만들려면 최소한 다음 특성에 대한 값을 지정해야 합니다.SiteMap.SiteMapNameUnique 및 SiteMap.SiteMapXml. 그러나 특성 앱의 사이트 맵을 프로그래밍 방식으로 만들고 삭제하는 대신 새 사이트 맵 디자이너를 사용하여 특정 앱에 대한 사이트 맵을 만들고 및 삭제하도록 하십시오.추가 정보:앱에 대한 사이트 맵 만들기

  • 기본 SiteMap 레코드는 프로그래밍 방식으로 만들고 삭제할 수 없습니다.SiteMap.IsAppAware 특성을 사용하여 두 종류의 사이트 맵을 구별할 수 있습니다. 0은 기본 사이트 맵을 나타내며 1은 특정 앱의 사이트 맵을 나타냅니다.

사이트 맵 수동 편집

내보낸 비관리형 솔루션의 customizations.xml 파일에 있는 SiteMap 노드를 수동으로 편집한 다음 다시 Dynamics 365로 가져와 사이트 맵을 업데이트할 수 있습니다. 관리형 또는 비관리형 솔루션을 가져오는지 여부에 따라 SiteMap 레코드가 업데이트되는 방법이 달라집니다.

  • 비관리형 솔루션을 가져오면 SiteMap 레코드의 기존 사이트 맵 XML을 덮어씁니다.

  • 관리형 솔루션을 가져오면 최신 변경 내용이 담긴 새 SiteMap 레코드가 생성되며 최신/활성 SiteMap 레코드의 SiteMap.OverwriteTime 특성 값은 DateTime 필드(1900-01-01 00:00:00.000)의 기본 값으로 설정됩니다. 기존 SiteMap 레코드의 SiteMap.OverwriteTime 특성 값은 업데이트될 때 datetime 값으로 설정됩니다.

사이트 맵을 편집하려면

  1. 설정을 클릭하고 사용자 지정을 클릭한 후 솔루션을 클릭합니다.

  2. 새로운 또는 기존 비관리형 솔루션에 기본 또는 특정 앱 사이트 맵을 추가합니다. 솔루션에서 왼쪽에 있는 구성 요소 목록에서 클라이언트 확장을 선택합니다.기존 항목 추가를 선택한 후 사이트 맵을 선택합니다. 사이트 맵 목록에서:

    • 기본 사이트 맵을 추가하려면 Site Map을 선택합니다.

    • 특정 앱 사이트 맵을 추가하려면 사용자 지정 비즈니스 앱 사이트 맵을 선택합니다. 대화 상자에 액세스할 수 있는 모든 사용자 지정 비즈니스 앱에 대한 사이트 맵이 표시됩니다. 예를 들어 이 경우에 Contoso Sales App 또는 Contoso Service App을 선택할 수 있습니다.

      Select default or app-specific site map to add

      참고

      특정 앱 사이트 맵은 Dynamics 365용 2016년 12월 업데이트(온라인 및 온-프레미스) 이상을 사용 중이며 Dynamics 365 인스턴스에 사용자 지정 비즈니스 앱이 있는 경우에만 표시됩니다. 동일한 솔루션에 추가할 여러 특정 앱 사이트 맵과 기본 사이트 맵도 선택할 수 있습니다.

    • 솔루션 구성 요소 선택 화면에서 확인을 클릭합니다.

  3. 저장을 클릭하여 솔루션의 변경 내용을 저장합니다.

  4. 솔루션 내보내기를 클릭하고 솔루션 내보내기 마법사의 단계를 따라 솔루션을 내보냅니다.

  5. 솔루션을 내보낸 후 .zip 파일의 압축을 풉니다.

    팁

    압축된 .zip 파일을 백업으로 유지합니다.

  6. customizations.xml 파일에서 다음을 찾습니다.

    • ImportExportXml/SiteMap 아래에서 SiteMap 노드를 찾아 기본 사이트 맵을 편집합니다.

    • ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap 아래에서 SiteMap 노드를 찾아 특정 앱 사이트 맵을 편집합니다.

      팁

      솔루션을 내보내기 전에 솔루션에 여러 특정 앱 사이트 맵을 추가한 경우 ImportExportXml/AppModuleSiteMaps/AppModuleSiteMap 아래의 SiteMapUniqueName 및 SiteMapName 노드를 사용하여 앱 사이트 맵에 대해 편집해야 하는 customizations.xml 파일에 있는 SiteMap 노드를 확인합니다.

  7. 필요에 따라 SiteMap 노드를 편집합니다.

    참고

    XML을 편집하는 것이 스키마 유효성 검사를 제공하는 편집기를 사용하는 것보다 훨씬 쉽습니다. 자세한 내용은 스키마 유효성 검사로 편집을 참조하십시오.

  8. 추출된 모든 솔루션 파일과 편집한 customizations.xml 파일을 포함하여 압축된 새 .zip 파일을 만듭니다.

    팁

    Windows 탐색기에서 모든 파일을 선택합니다. 그런 다음 마우스 오른쪽 단추로 클릭하고 보내기와 압축(ZIP) 폴더를 선택합니다.

  9. 새 솔루션 파일을 가져옵니다.

    1. Microsoft Dynamics 365에서 설정을 클릭하고 사용자 지정을 클릭한 후 솔루션을 클릭합니다.

    2. 가져오기를 클릭합니다.

    3. 찾아보기를 클릭하고 수정된 솔루션 .zip 파일을 찾아서 다음을 클릭한 후 가져오기를 클릭합니다.

    4. 가져오기가 완료되면 닫기를 클릭합니다.

  10. 사용자 지정 항목을 게시합니다.

    팁

    변경 내용이 즉시 표시되지 않으면, 브라우저 페이지를 새로 고칩니다.

스키마 유효성 검사로 편집

더 나은 환경을 위해 customizations.xml 파일을 스키마 유효성 검사를 사용하여 IntelliSense 지원을 제공할 수 있는 응용 프로그램으로 편집합니다. 자세한 내용은 스키마 유효성 검사로 사용자 지정 XML 파일 편집을 참조하십시오.

앰퍼샌드 문자 인코딩

URL을 앰퍼샌드 문자(&)가 포함된 사이트맵에 추가할 때는 그것을 “&”로 대체하여 인코딩해야 합니다. 이 문자를 인코딩하지 않으면 XML 검증이 실패하여 솔루션을 가져올 수 없을 것입니다. 예를 들면 다음과 같습니다.

  • 올바름:
    <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&amp;parameter2=value ">

  • 잘못됨:
    <SubArea Id="new_customSubArea" Url="http://mysite/mypage.aspx?parameter1=value&parameter2=value">

오류 복구

솔루션 가져오기 도구에서는 사이트 맵에 대한 유효성 검사를 수행하지만 오류가 발생하면 기본 사이트 맵이 적용되고 오류 메시지가 표시됩니다. 사이트 맵에서 오류를 수정한 후 다시 가져와야 합니다. 하지만 아직 몇 가지 오류가 발생할 수 있습니다.

수동으로 사용자 지정 비즈니스 앱 사이트 맵을 편집 또는 가져온 후 사용자 지정 비즈니스 앱을 실행할 때 발생할 수 있는 몇 가지 오류는 다음과 같습니다.

  • 사이트 맵에 하위 영역 없음

  • 사이트 맵에 하위 영역이 있지만 사용자에게 볼 수 있는 권한이 없음

  • 잘못된 엔터티(합법적 Dynamics 365 엔터티 이름이 아님)

  • 잘못된 URL

  • 사이트 맵에 대시보드 노드가 있지만 모듈식 비즈니스 앱 정의에 대시보드가 선택되지 않음

참고 항목

사이트 맵 사용자 지정
사이트 맵을 사용하여 응용 프로그램 탐색 변경
사이트 맵을 사용하여 URL에 매개 변수 전달
도움말 및 교육 사이트에 대한 액세스 제어
SiteMap XML reference
SiteMap schema

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 저작권 정보