웹 도구로 Notebook 발행

10.9.1부터 ArcGIS Notebooks는 웹 도구로 Notebooks를 발행할 수 있습니다. 웹 도구 발행 권한이 있는 관리자 및 Notebook 작성자는 소유한 Notebooks를 웹 도구로 발행할 수 있습니다. 웹 도구로 Notebook을 발행하면 ArcGIS Notebook Server 머신에 비동기 지오프로세싱 서비스가 생성되고 웹 도구로 등록됩니다. Notebook과 웹 도구 간에는 일대일 관계, 즉 Notebook당 하나의 웹 도구만 발행할 수 있으며 웹 도구 항목에는 상위 Notebook과 동일한 공유 권한이 할당됩니다. 웹 도구는 RESTful 비동기 지오프로세싱 서비스를 사용할 수 있는 모든 클라이언트 응용프로그램에서 사용할 수 있습니다.

웹 도구로 Notebook 발행은 런타임 버전 6.0 이상의 Notebooks에서 지원됩니다. Notebook의 런타임 정보를 확인하려면 Notebook 편집기의 상단 리본 또는 Notebook 항목 페이지의 설정 탭에서 정보 버튼을 클릭합니다. Notebook 런타임에 대한 자세한 내용은 사용 가능한 Python 라이브러리 확인을 참고하세요.

10.9.1에서 Notebook 편집기에는 Notebook에 대한 입력 및 결과 매개변수를 구성할 수 있는 새로운 기능이 포함됩니다. 입력 매개변수는 Notebook이 웹 도구로 실행될 때 사용자 입력을 위해 표면화하려는 Notebook의 입력 변수에 해당합니다. 결과 매개변수는 웹 도구 결과로 반환하려는 Notebook의 결과 변수에 해당합니다. 하나 이상의 입력 또는 결과 변수를 등록하고 Notebook을 발행하면 해당 매개변수는 해당 웹 도구에 대한 입력 또는 결과 매개변수로 사용할 수 있게 됩니다.

비고:

Notebook을 웹 도구로 발행할 때 입력 또는 결과 매개변수를 정의할 필요는 없습니다. 예를 들어 itemId에서 참조하는 피처 레이어와 같이 사전 정의된 입력 및 결과로 작업을 수행하는 Notebooks에는 입력 또는 결과 매개변수가 필요하지 않을 수 있습니다.

비고:

문자열(String), 정수(Long), 더블(Double), 불린(Boolean), 피처 모음(Feature set), 레코드 모음(Record set), 날짜(Date), 선형 단위(Linear unit) 데이터 유형이 입력 또는 결과 매개변수로 지원됩니다. 자세한 내용은 ArcGIS Notebook Server REST API 문서의 지오프로세싱 서비스 데이터 유형을 참고하세요.

웹 도구가 실행되면 ArcGIS Notebook Server에서는 사용자 개입 없이 새 컨테이너를 열고 Notebook을 실행하여 Notebook Server 머신에서 Notebook을 자동으로 실행합니다. Notebook 권한이 있고 Notebook을 공유한 사용자는 웹 도구에 접근하여 실행할 수 있습니다. 필수 Notebook 권한 외에도 Notebook 실행에 필요한 기타 권한이 필요합니다.

비고:

웹 도구로 공유할 Notebook을 작성할 때 Notebook이 입력 데이터로 작업 영역 디렉터리의 파일을 참조하는 경우 Notebook 또는 웹 도구를 공유한 다른 사용자가 해당 파일에 접근할 수 있게 됩니다. Notebook에 입력 데이터로 참조해야 하는 파일이 있는 경우 Portal for ArcGIS의 공유 포털 항목을 통해 파일을 참조하거나 ArcGIS Notebook Server에 등록된 사용자 설정 데이터 디렉터리에서 파일을 업로드하고 참조할 수 있습니다.

ArcGIS Notebook Server는 기본 설정에 따라 각 ArcGIS Notebook Server 머신당 최대 10개의 비대화형 Notebook을 동시에 실행하도록 구성됩니다. 여기에는 웹 도구, 예약 작업, executeNotebook API, 웹후크 트리거로 트리거된 실행이 포함됩니다. 필요한 경우 관리자는 이러한 제한을 늘릴 수 있습니다.

비고:

Notebook 편집기에 매개변수 또는 발행 옵션이 표시되지 않는 경우 웹 도구 발행 권한이 없거나 Notebook의 소유자가 아닌 것입니다. 새로 생성된 Notebook을 사용하는 경우 Notebook이 저장될 때까지 매개변수 및 발행 옵션이 표시되지 않습니다.

입력 매개변수 구성

입력 매개변수는 Notebook이 웹 도구로 실행될 때 표면화하려는 Notebook의 입력 변수를 나타냅니다. Notebook 편집기의 매개변수 창을 사용하여 입력 매개변수를 구성하고 변수로 Notebook에 추가할 수 있습니다.

1. Notebook 편집기에서 매개변수를 클릭합니다.
2. 추가를 클릭합니다.
3. 방향에 대해 입력을 선택합니다.
4. 변수 이름에 이름을 입력합니다.

   비고:

   이름은 Notebook 코드에 있거나 Notebook에 이미 구성되어 있는 변수 이름과 일치해야 합니다.

5. 웹 도구 매개변수의 표시 이름에 이름을 입력합니다.
6. 데이터 유형 드롭다운 메뉴에서 입력 매개변수의 데이터 유형을 선택합니다.
7. 입력 매개변수의 Default value에 값을 입력합니다. 지원되는 데이터 유형의 기본 값 구문에 대해서는 지오프로세싱 서비스 데이터 유형을 참조하세요.
8. Description에 입력 매개변수에 대한 설명을 입력합니다.
9. 저장을 클릭하여 입력 매개변수를 저장합니다.
10. 입력 매개변수를 더 추가하려면 1~9단계를 반복합니다.
11. 입력 매개변수를 모두 추가한 후 Notebook에서 매개변수를 삽입할 셀을 선택하고 변수로 삽입을 클릭합니다.
12. 저장을 클릭하여 Notebook을 저장합니다.

결과 매개변수 구성

Notebook 편집기의 매개변수 창에서 결과 매개변수를 구성하여 웹 도구로 발행된 Notebook에 대한 결과를 구성할 수 있습니다.

1. Notebook 편집기에서 매개변수를 클릭합니다.
2. 추가를 클릭합니다.
3. Direction 매개변수에 대해 결과를 선택합니다.
4. Variable name에 이름을 입력합니다.

   비고:

   이름은 Notebook 코드에 있거나 Notebook에 이미 구성되어 있는 변수 이름과 일치해야 합니다.

5. 웹 도구 매개변수의 Display name에 이름을 입력합니다.
6. Data type 드롭다운 메뉴에서 결과 매개변수의 데이터 유형을 선택합니다.
7. 결과 매개변수의 Default value에 값을 입력합니다. 지원되는 데이터 유형의 기본 값 구문에 대해서는 지오프로세싱 서비스 데이터 유형을 참조하세요.
8. Description에 결과 매개변수에 대한 설명을 입력합니다.
9. 저장을 클릭하여 결과 매개변수를 저장합니다.
10. Notebook에서 셀을 선택합니다. 추가 버튼을 클릭하여 웹 도구에 대한 결과를 작성할 Python 코드 조각을 추가합니다.

    Notebook 하단 근처, 결과가 생성되는 셀 아래의 셀을 선택하는 것을 권장합니다.

11. 추가된 코드 조각을 검사하여 결과 변수 이름이 Notebook에 정의된 결과와 일치하는지 확인한 후 코드 조각을 추가로 조정합니다.
12. 결과 매개변수를 추가하려면 1~11단계를 반복합니다.
13. 저장을 클릭하여 Notebook을 저장합니다.

웹 도구 발행

Notebook 편집기의 발행 창에서 웹 도구로 Notebook을 발행할 수 있습니다.

1. Notebook의 최신 복사본이 발행되도록 Notebook을 저장합니다.
2. Notebook의 셀을 대화형으로 직접 실행하여 오류가 없는지 확인합니다.

비고:

결과 매개변수에 대한 코드 조각이 포함된 셀은 인터랙티브 모드에서 실행되지 않으므로 건너뜁니다.
3. Notebook 편집기 리본에서 발행을 클릭합니다.
4. 발행 창의 Title 및 Description 필드에 웹 도구의 제목과 설명을 입력합니다.
5. 입력 매개변수와 결과 매개변수를 확인합니다.
6. 발행을 클릭하여 웹 도구로 Notebook을 발행합니다.
7. 웹 도구가 발행되면 세부정보 보기를 클릭하여 웹 도구의 항목 세부정보 페이지를 봅니다.

웹 도구 삭제

웹 도구 항목을 삭제하여 Notebook에서 발행된 지오프로세싱 서비스를 삭제할 수 있습니다.

1. Notebook 편집기의 상단 리본에서 발행을 클릭합니다.
2. 세부정보 보기를 클릭하여 웹 도구의 항목 세부정보 페이지를 봅니다.
3. 설정을 클릭합니다.
4. 항목 삭제를 클릭하고 ArcGIS Notebook Server에 발행된 웹 도구 항목 및 지오프로세싱 서비스를 제거할 것인지 확인합니다.

기존의 입력 또는 결과 매개변수 편집

Notebook 편집기의 매개변수 창에서 기존의 입력 또는 결과 매개변수를 변경할 수 있습니다.

비고:

Notebook이 이미 웹 도구로 발행된 경우 매개변수 창에서 편집 활성화 토글 버튼을 클릭해야 매개변수를 변경할 수 있습니다. Notebook이 웹 도구로 발행된 후에 매개변수를 변경하는 경우에는 이러한 변경으로 인해 웹 도구를 사용하는 모든 웹 앱이 잠재적으로 중단될 수 있으므로 주의해야 합니다.

1. Notebook 편집기의 상단 리본에서 매개변수를 클릭합니다.
2. 매개변수 옆의 옵션 버튼을 클릭하고 편집을 클릭합니다.
3. 매개변수를 업데이트하고 저장을 클릭합니다.
   1. 입력 매개변수가 업데이트되면 입력 변수가 있는 기존 셀을 수동으로 지우거나 제거하고 해당 단계를 반복하여 입력 매개변수를 변수로 Notebook에 삽입합니다.
   2. 결과 매개변수가 업데이트되면 결과 변수에 해당하는 코드 조각을 수동으로 지우고 해당 단계를 반복하여 결과 매개변수에 대한 코드 조각을 Notebook에 추가합니다.
4. 저장을 클릭하여 Notebook을 저장합니다.

기존의 입력 또는 결과 매개변수 삭제

매개변수 창에서 기존의 입력 또는 결과 매개변수를 삭제할 수 있습니다.

1. Notebook 편집기의 상단 리본에서 매개변수를 클릭합니다.
2. 매개변수 옆의 옵션 버튼을 클릭하고 삭제를 클릭합니다.
3. 삭제를 클릭하여 매개변수를 영구적으로 제거합니다.
4. Notebook에서 입력 변수 또는 결과 코드 조각을 수동으로 지우거나 제거합니다.
5. 저장을 클릭하여 Notebook을 저장합니다.

맵 범위 사용

Map Viewer Classic에서 웹 도구를 실행하면 아래와 같이 맵 범위가 다른 입력 매개변수와 함께 context라는 Python 변수로 Notebook에 전달됩니다.

context = {
    "extent": {
        "ymin": -25203428.462408017,
        "xmin": -46101923.491795965,
        "ymax": 25203428.462407943,
        "xmax": 46101923.491795965,
        "spatialReference": {
            "wkt": "PROJCS[\"WGS_1984_Web_Mercator_Auxiliary_Sphere\",GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137.0,298.257223563]],PRIMEM[\"Greenwich\",0.0],UNIT[\"Degree\",0.0174532925199433]],PROJECTION[\"Mercator_Auxiliary_Sphere\"],PARAMETER[\"False_Easting\",0.0],PARAMETER[\"False_Northing\",0.0],PARAMETER[\"Central_Meridian\",0],PARAMETER[\"Standard_Parallel_1\",0.0],PARAMETER[\"Auxiliary_Sphere_Type\",0.0],UNIT[\"Meter\",1.0]]"
        },
    }
}

context 변수 값을 사용하여 Notebook에서 공간 분석 워크플로의 범위를 설정할 수 있습니다. Notebook을 웹 도구로 발행하기 전에 맵 범위로 공간 분석 워크플로를 테스트하려면 context 변수를 기본값으로 선언합니다.

발행할 준비가 되면 context 변수를 선언하는 셀 뒤에 입력 매개변수를 변수로 삽입합니다.

웹 도구 문제 해결

Notebook을 웹 도구로 발행한 후 ArcGIS Notebook Server 서비스 디렉터리에서 작업을 실행하여 웹 도구가 실행되는지 확인할 수 있습니다.

1. 웹브라우저에서 ArcGIS Notebook Server 서비스 디렉터리 https://notebookserver.domain.com/webadaptorcontext/rest/services을 엽니다.
2. 웹 도구의 소유자로 로그인합니다.
3. 서비스를 확인하고 작업 페이지로 이동합니다.
4. 작업 제출을 클릭합니다.
5. 모든 입력 매개변수를 입력하고 작업 제출을 클릭합니다.
6. 필요한 경우 작업 세부정보 다시 확인 링크를 클릭하여 작업 상태를 확인합니다.

   웹 도구가 완료되면 결과에 대한 링크가 제공됩니다. Notebook 실행의 HTML 미리 보기는 기본 설정에 따라 완료한 실행과 실패한 실행 모두에 대한 결과로 제공됩니다.

7. Notebook의 HTML 미리 보기를 다운로드하여 웹 도구를 실행하는 동안 문제가 있는지 확인합니다.
8. 웹 도구가 실패하면 Notebook 편집기에서 Notebook이 실행되는지 확인합니다.