표현식 빌더 개요

표현식 빌더는 다음 두 영역으로 구성됩니다.

  • 팔레트에서는 표현식에 삽입할 필드를 선택할 수 있습니다.
  • 편집기에서는 표현식을 작성할 수 있습니다.

왼쪽에 팔레트가 있고 오른쪽에 편집기가 있는 표현식 빌더

표현식 빌더 액세스

표현식 빌더는 두 가지 모드로 액세스할 수 있습니다.

  • 읽기 전용 모드: 표현식 논리를 변경하지 않고도 볼 수 있습니다. 읽기 전용 모드에서는 표현식을 복사 또는 다운로드하거나, 텍스트로 캡처하거나, 테스트할 수 있지만 편집할 수는 없습니다.
  • 편집 모드: 표현식을 생성하고 편집할 수 있습니다. 편집 모드에서는 표현식 빌더 툴바 섹션에 나열된 모든 기능을 수행할 수 있습니다.

두 모드 중 하나에서 표현식 빌더에 액세스하려면 비즈니스 논리가 적용되는 컨텍스트(예: 파생 속성)에서 표현식 정의 표현식 정의 버튼 버튼을 누릅니다. 표현식 빌더가 열리는 모드는 표현식 빌더에 액세스한 검사기에서 사용했던 모드에 따라 달라집니다. 검사기에서 편집 모드를 사용한 경우 표현식 빌더는 편집 모드로 열립니다. 검사기에서 편집 모드를 사용하지 않은 경우 표현식 빌더는 읽기 전용 모드로 열립니다.

표현식 빌더 툴바

표현식 빌더의 툴바를 사용하면 표현식 조건 복사 및 붙여넣기, 파일에서 표현식 로드, 표현식 테스트 등의 기능을 수행할 수 있습니다. 다음 기능을 사용할 수 있습니다.

  • 복사(복사 버튼): 표현식을 복사합니다. 전체 표현식 복사하여 붙여넣기을 참조하십시오.
  • 붙여넣기(붙여넣기 버튼): 표현식을 붙여넣습니다. 전체 표현식 복사하여 붙여넣기를 참조하십시오.
  • 텍스트로 표현식 캡처(캡처 버튼): 표현식의 텍스트 버전을 클립보드에 복사합니다.
  • 파일에서 로드(파일에서 로드 버튼): JSON 파일에서 표현식을 로드합니다. 파일에서 표현식 로드를 참조하십시오.
  • 파일에 저장(파일에 저장 버튼): 현재 표현식을 JSON 파일에 저장합니다. 파일에 표현식 저장을 참조하십시오.
  • 표현식 테스트(표현식 테스트 버튼): 현재 표현식을 테스트합니다. 표현식 테스트를 참조하십시오.
  • 실행취소(실행취소 버튼): 이전에 수행된 작업을 되돌립니다.
  • 재실행(재실행 버튼): 이전에 실행취소된 작업을 복원합니다.

용어

표현식 빌더를 사용하는 경우 다음 개념을 알고 있으면 유용합니다.

  • 표현식은 명령문이라는 하나 이상의 논리 행으로 구성됩니다.
  • 명령문은 표현식의 논리를 제어하는 불연속적 명령어 항목입니다. 명령문의 유형은 다음 세 가지입니다.
    • Return 명령문은 값을 반환합니다.
    • If 명령문은 해당 조건이 True인 경우 수행할 명령문 목록을 지정합니다. If 명령문에 Else 및 Else If 명령문을 추가하여 조건에 따라 확장할 수 있습니다.
    • 설명을 사용하여 표현식 부분에 주석을 추가할 수 있습니다(예: 내용이 변경된 위치 확인). 설명은 참고용으로만 제공되며 표현식이 실행될 때 평가되지 않습니다.

  • 표현식 항은 값으로 평가되는 객체 및 연산자로 구성됩니다. 다음 예에서는 표현식이 노드 이름과 하이픈, 노드 설명 순으로 연결하여 별칭 속성 값을 파생시킵니다.


    반환 node name concat 하이픈 node properties core description

    이 표현식에는 다음과 같이 표현식 항 아이콘으로 각각 표시되는 세 개의 표현식 항(및 네번째 항을 추가할 선택사항 자리 표시자)이 있습니다.

    • Node.name.concat(
    • -(하이픈 문자)
    • Node.properties.Core.Description

    표현식 항은 표현식 빌더에서 노란색 배경으로 표시되며, 각 표현식 항은 명령문 내에서 이동 또는 삭제될 수 있습니다. 표현식 내에서 표현식 항을 복사하여 붙여넣을 수도 있습니다. 표현식으로 복사하여 붙여넣기를 참조하십시오.

  • 객체는 값을 나타내는 표현식의 요소입니다. 각 객체에는 해당 객체에 사용할 수 있는 추가 객체, 메소드 및 속성을 결정하는 데이터 유형이 있습니다. 예를 들어 표현식에서 sourceNode 객체를 선택하는 경우 표현식 빌더에는 dimension 또는 name과 같이 노드 데이터 유형에 적용 가능한 필드만 표시됩니다. 표현식 항 데이터 유형를 참조하십시오.

    표현식에서 객체를 선택한 후 해당 객체에 대한 속성 및 메소드를 선택하여 표현식을 더 구체적으로 지정할 수 있습니다.

    • 속성은 객체 측면을 설명합니다. 예를 들어 dimension 객체에는 name이라는 속성이 있습니다.
    • 메소드는 객체에 대한 작업을 수행합니다. 예를 들어 concat 메소드는 문자열을 연결하고 length 메소드는 문자열의 길이를 반환합니다. 일부 메소드에는 메소드의 입력 매개변수인 인수가 있습니다. 레이블에서는 필수 입력(예: 문자열 값)을 설명합니다.
  • 연산자는 표현식에서 논리 비교를 수행합니다. 표현식 빌더는 AND 및 OR 연산자를 지원합니다.
  • 리터럴은 표현식에 수동으로 입력하는 상수 값입니다. 예를 들어 If Account.Type = E, return Expense 명령문에서 "E" 및 "Expense" 둘 다 리터럴입니다.

용어에 익숙해질 수 있도록 표현식의 예를 살펴보겠습니다.


If FCGL_Account Type is E, return Expense, else return Non-Expense 표현식

이 표현식은 기업 Planning 계정 차원과 Financials Cloud GL 계정 차원 간에 매핑되는 노드 유형 변환기에 대한 것입니다. 이 표현식이 작성되면 다음과 같이 읽습니다.

PLN.Variance Reporting 속성의 경우 소스 노드 속성 FCGL.Account Type이 "E"인 경우 "Expense"를 반환합니다. 아닌 경우 "Non-Expense"를 반환합니다.

스크린샷의 이 표현식에는 다음 요소가 포함되어 있습니다.

  1. 세 개의 명령문:
    • If FCGL.Account Type equals "E"
    • Return "Expense"
    • Return "Non-Expense"

    주:

    이 표현식을 빌드하는 경우 Else If 명령문을 추가할 필요가 없습니다. 표현식이 실행되면 IF 명령문이 True가 아닌 경우 논리가 다음 명령문으로 이동합니다. 표현식 빌드를 참조하십시오.
  2. 네 개의 표현식 항:
    • FCGL.Account Type equals
    • "E"
    • "Expense"
    • "Non-Expense"
  3. 한 개의 객체: sourceNode
  4. 두 개의 속성: FCGL.Account Type 및 properties
  5. 한 개의 메소드: equals
  6. 세 개의 리터럴: E, Expense, Non-Expense