---
sourceDocument: 호주 애플리케이션 빌드 또는 수정
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/application-development

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 애플리케이션 빌드 또는 수정

ft:clusterId :

    - cadev

bundleId :

    - cadev

workflow :

    - Development, Data, and Analytics


---

# 애플리케이션 구성

# 소스 코드의 사용자 지정 애플리케이션 구성 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 20일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 8분

소스 코드의 애플리케이션에 대한 now.config.json 파일에서 사용자 지정 애플리케이션 \[sys_app\]을 구성합니다.
디렉터리 구조와 같은 소스 코드에서 애플리케이션 개발과 관련된 애플리케이션 설정 및 측면을 구성할 수 있습니다. now.config.json 파일에서 다음 매개변수를 추가하여 애플리케이션 설정을 구성합니다.
{#app-config-source-code__table_upn_kqw_zbc__entry__3}

| 매개변수 | 유형 | 설명 |
|-|-|-|
| appOutputDir | 문자열 | 패키징을 위해 빌드 아티팩트를 출력할 디렉터리입니다. pack 및 install 명령은 이 디렉터리를 참조하여 아티팩트를 패키지합니다. 기본값: dist/app |
| 클라이언트디렉터리 | 문자열 | React로 사용자 인터페이스를 개발하기 위한 클라이언트 측 파일이 포함된 디렉터리입니다. 기본값: src/client |
| 의존성 | 객체 | 애플리케이션이 종속된 다른 애플리케이션 범위의 항목입니다. 애플리케이션 범위와 의존성 유형 및 이름 또는 sys_ids 지정해야 합니다. "dependencies": { "<scope>": { "<type>": ["<sys_id or name>"], ... }, ... } 자세한 내용은 [애플리케이션 종속성 다운로드 ServiceNow Fluent](https://servicenow-prod.fluidtopics.net/DWKAXXPFnsoSWW2CQnLrQA#download-app-dependencies "코드에 대한 IntelliSense 지원 및 유효성 검사를 받으려면 다른 애플리케이션 범위의 종속성에 대한 TypeScript 정의를 다운로드합니다.ServiceNow Fluent") 문서를 참조하십시오. |
| fluentDir | 문자열 | 소스 코드에서 애플리케이션 메타데이터를 정의하는 파일(.now.ts)이 포함된 ServiceNow Fluent 디렉터리입니다. 기본값: src/fluent |
| generatedDir | 문자열 | 코드로 변환된 기존 애플리케이션 메타데이터를 포함하여 생성된 ServiceNow Fluent 파일이 포함된 디렉터리입니다.ServiceNow Fluent 이 디렉터리는 매개변수로 fluentDir 정의된 디렉터리를 기준으로 합니다. 기본값: generated |
| ignoreTransformTableList | 배열 | 애플리케이션 메타데이터를 소스 코드로 변환할 때 무시할 테이블 목록입니다. |
| metadataDir | 문자열 | 애플리케이션의 메타데이터를 XML 파일로 포함하는 디렉터리입니다. 기본값: 메타데이터 |
| 모듈 경로 | 객체 | 애플리케이션을 빌드하기 전에 사용자 지정 변환 단계를 사용하는 경우 모듈 소스 파일을 해당 출력 파일에 매핑합니다. 자세한 내용은 [JavaScript 모듈에서 TypeScript를 사용하여 ServiceNow SDK](https://servicenow-prod.fluidtopics.net/hQ~YxQqnskLPbxDP~WAMdQ#using-typescript "를 사용하여 ServiceNow SDKJavaScript 모듈을 생성할 때 TypeScript를 사용합니다.") 문서를 참조하십시오. 경고: 이 매개변수와 `tsconfigPath` 매개변수는 사용할 수 없습니다. 둘 다 구성하면 오류가 발생합니다. |
| packOutputDir | 문자열 | 애플리케이션을 빌드할 때 설치 가능 패키지(.zip 파일)를 출력할 디렉터리입니다. 설치 명령은 이 디렉터리를 참조하여 패키지를 설치합니다. 기본값: target |
| serverModulesDir | 문자열 | 서버 측 스크립트에서 사용하기 위해 JavaScript 모듈에 빌드할 JavaScript 또는 TypeScript 파일이 들어있는 디렉터리입니다. 기본값: src/server |
| serverModulesExcludePatterns | 배열 | JavaScript 모듈을 빌드할 때 제외할 파일 패턴의 목록입니다. 기본값: [ "**/*.test.ts", "**/*.test.js", "**/*.d.ts" ] |
| serverModulesIncludePatterns | 배열 | JavaScript 모듈을 빌드할 때 포함할 파일 패턴 목록입니다. 기본값: [ "**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx", "**/*.cts", "**/*.cjs", "**/*.mts", "**/*.mjs", "**/*.json" ] |
| staticContentDir | 문자열 | 사용자 인터페이스 개발에 사용되는 정적 자산 파일을 출력하는 디렉터리입니다. 기본값: dist/static |
| staticContentPaths | 객체 | 정적 자산 파일의 출력 경로에 대한 클라이언트 측 소스 파일의 맵입니다. |
| DefaultLanguage | 문자열 | 테이블 또는 열의 필드 레이블 \[sys_documentation\]에 대한 기본 언어의 BCP 47 코드입니다. 기본 언어는 여러 언어로 필드 레이블을 해결하는 데 사용됩니다. 기본값: en |
| tableOutputFormat | 문자열 | 코드에서 생성된 테이블 메타데이터 XML에 대한 빌드 아티팩트 유형입니다 ServiceNow Fluent . 유효한 값은 다음과 같습니다. * bootstrap: 빌드 프로세스는 테이블의 루트 요소인 `<database>` , 필드 레이블 XML 파일 \[sys_documentation\], 라이선싱 구성 XML 파일 \[ua_table_licensing_config\] 및 자동 번호 매기기 XML 파일 \[sys_number\]이 포함된 부트스트랩 XML 파일을 출력합니다. * 구성 요소: 빌드 프로세스는 테이블 API의 각 구성요소에 대한 XML 파일을 출력합니다. {#app-config-source-code__ul_ubx_1fb_lgc} 기본값: bootstrap |
| 분류 | 객체 | 생성된 ServiceNow Fluent 파일을 구성하기 위한 구성으로, 테이블 이름을 디렉터리에 매핑하고 대체 디렉터리를 정의합니다. 기본 분류 구성은 표준 테이블 분류를 사용하여 ServiceNow 메타데이터가 처음에 코드로 ServiceNow Fluent 변환될 때 Fluent/생성된 디렉터리 내의 논리적 디렉터리 구조에 생성된 ServiceNow Fluent 파일을 추가합니다. 예: * 비즈니스 규칙\[sys_script\]이 fluent/generated/server-development/business-rule 디렉터리에 추가됩니다. * 스크립트 포함 \[sys_script_include\]이 fluent/generated/server-development/script-include 디렉터리에 추가됩니다. {#app-config-source-code__ul_u3x_vt1_b3c} 기본 매핑을 재정의하거나 추가 매핑을 구성할 수 있습니다. 다음 예시에서 구성은 비즈니스 규칙 \[sys_script\]의 기본 디렉터리와 폴백 폴더를 재정의하고 사용자 지정 테이블의 메타데이터에 대한 추가 매핑을 구성합니다. "taxonomy": { "mapping": { "sys_script": "scripts/server/rules", "custom_table": "my-custom-folder/my-nested-folder" }, "fallbackFolderName": "unclassified" } * 매핑: 테이블 이름을 디렉터리에 매핑하는 객체입니다. 디렉터리 경로는 매개변수로 generatedDir 구성된 디렉터리를 기준으로 하며 하위 디렉터리를 구분하기 위해 소문자, 숫자, 하이픈, 밑줄 및 슬래시만 포함해야 합니다. * fallbackFolderName: 기본 또는 사용자 지정 매핑이 구성되지 않은 테이블에 사용할 디렉터리의 이름입니다. 이 디렉터리 ServiceNow Fluent 내에서 파일은 src/fluent/generated/other/x-unmapped-table/과 같이 테이블의 이름을 딴 하위 디렉터리에 추가됩니다. {#app-config-source-code__ul_p4f_kg5_yhc} 기본: 기본 분류 매핑은 모든 표준 ServiceNow 테이블에 대해 정의되며 애플리케이션의 `now.config.json` 에 사용자 지정 구성이 정의되지 않은 경우 자동으로 적용됩니다. 기본값은 fallbackFolderNameother입니다. |
| trusted모듈 | 배열 | 신뢰할 수 있는(또는 내부) 것으로 식별할 npm 패키지 목록입니다. 신뢰할 수 있는 모듈은 API에 액세스할 수 있습니다.ServiceNow 예: "trustedModules": [ "<package-name>",  // Specific package "@servicenow/*"  // All packages from an organization ] EcmaScript 모듈 \[sys_module\] 테이블에서 신뢰할 수 있는 모듈에 대한 외부 소스 필드가 false로 설정됩니다. 경고: 완전히 신뢰할 수 있는 종속성만 신뢰할 수 있는 모듈로 추가합니다. 유효한 패턴: * `'@servicenow/sdk'`와 같은 정규화된 패키지 이름입니다. * 와일드카드가 있는 조직 프리픽스입니다( `예: '@servicenow/*'` 또는 `'@mycompany/*'`). {#app-config-source-code__ul_e3f_n1y_23c} |
| tsconfig경로 | 문자열 | 빌드 프로세스 중에 TypeScript를 JavaScript로 변환하기 위한 사용자 지정 옵션이 있는 tsconfig.json 파일의 경로입니다. `tsconfigPath`를 지정하면 tsconfig.json 파일을 사용하여 TypeScript에서 진단 결과가 생성됩니다. 경고: 이 매개변수와 `modulePaths` 매개변수는 사용할 수 없습니다. 둘 다 구성하면 오류가 발생합니다. 기본값: . |
[표 1. 지원되는 now.config.json 매개변수]

{#app-config-source-code__table_upn_kqw_zbc}  

## 소스 코드의 애플리케이션 구성 {#app-config-source-code__example_mz3_ffz_q3c}

    {
      "scope": "x_snc_example_app",
      "scopeId": "2f8400eb07426110f736e28f69d3017a",
      "name": "ExampleApp",
      "dependencies": {
        "global": {
          "tables": ["incident"],
          "roles": ["admin"],
        },
        "x_custom": {
          "tables": ["custom_table"]
        }
      },
      "metadataDir": "metadata",
      "fluentDir": "src/fluent",
      "generatedDir": "generated",
      "serverModulesDir": "src/server",
      "clientDir": "src/client",
      "appOutputDir": "dist/app",
      "staticContentDir": "dist/static",
      "packOutputDir": "target",
      "modulePaths": {
          "src/server/*.ts": "dist/server/*.js",
        },
      "staticContentPaths": {
          "src/client/*.html": "dist/static/*.html",
        },
      "ignoreTransformTableList": ["ua_table_licensing_config", "sys_embedded_help_role"],
      "taxonomy": {
            "mapping": {
                "sys_script": "scripts/server/rules",
                "custom_table": "my-custom-folder/my-nested-folder"
            },
            "fallbackFolderName": "unclassified" 
        }
    }

**관련 개념**   

* [애플리케이션 액세스 설정](https://servicenow-prod.fluidtopics.net/AmXP4Z3b12ne0OoNgvX_vQ "애플리케이션 액세스 설정은 한 애플리케이션이 다른 애플리케이션의 자원에 액세스할 수 있는지 여부를 결정합니다.")