그리드 카드 작성

격자 카드는 격자 형식으로 다른 데이터 점을 표시합니다. 이 카드를 사용하여 특정 데이터를 강조표시할 수 있습니다.

이 태스크에 대한 정보

그리드 카드의 구조는 다음과 같습니다.
그리드 카드 예제
도구팁
도구 팁은 카드에 표시되는 데이터에 대한 추가 세부사항을 제공합니다.
카드 제목
카드에 지정된 고유 레이블 또는 표제입니다.
값 레이블
조회에서 파생된 값에 지정된 고유 레이블입니다.
푸터 링크
레이블이 있는 클릭 가능한 필드 또는 링크입니다 (예: View all).
카드 빌더 를 사용하여 그리드 카드를 작성할 수 있습니다.

프로시저

  1. 탐색 메뉴에서 카드 빌더를 누르십시오.
  2. 새 카드를 클릭하십시오.

일반 탭에서 카드를 정의하십시오.

  1. 카드에 이름을 지정하십시오.
    카드는 카드 라이브러리에서 해당 이름으로 참조됩니다.
  2. 카드 유형을 선택하십시오.
    Grid을(를) 선택하십시오.

데이터 탭에서 카드에 데이터를 추가하십시오.

  1. 선택사항: 소스 편집기를 사용하여 카드에 표시되는 크기, 머리글, 바닥글 및 데이터를 구성할 수 있습니다. 카드 소스를 편집하려면 소스 편집 아이콘을 클릭하십시오.
    소스 편집기를 사용하면 다른 카드에 대해 복제할 수 있는 카드의 데이터 및 스타일 구성을 복사할 수 있습니다.
    참고: 이 코드를 수정하면 카드 편집기의 스타일 및 데이터 탭에서 작성된 구성을 겹쳐씁니다.
  2. GraphQL 조회를 추가하여 데이터를 검색하십시오.
    추가 를 클릭하고 예제의 조회와 유사한 조회를 작성하십시오. 자세한 정보는 카드에 조회 추가를 참조하십시오.
  3. 조회에서 사용 중인 변수를 정의하십시오.
    QUERY VARIABLES 필드에서 예제의 코드와 유사한 형식을 사용하여 JSON 형식으로 변수를 정의하십시오.
  4. 쿼리를 실행하십시오.
  5. 조회에 대해 데이터가 리턴되는지 확인하십시오.
  6. 변환 탭을 클릭하고 눈금 카드에서 시각화를 위해 데이터를 변환할 코드를 추가하십시오.
    예제 와 유사한 코드를 사용하거나 기본 변환을 사용하십시오.
  7. 완료를 클릭하십시오.
  8. 조회에서 리턴된 데이터의 값을 카드에 추가하십시오.
    추가 를 클릭하고 카드에 표시할 데이터 필드를 선택하십시오.
    1. 편집 을 클릭하고 선택한 값에 대한 레이블을 추가하십시오.
    2. 사용 가능한 목록에서 템플리트를 선택하십시오.
      다음 템플리트를 선택할 수 있습니다.
    • 텍스트: 선택한 값을 텍스트 형식으로 표시합니다.
    • 백분율: 선택한 값을 백분율로 표시합니다.
    • 숫자: 선택한 값을 정수 형식으로 표시합니다.
    • 날짜: 선택한 값을 날짜 형식으로 표시합니다.
    • 링크: 선택한 값에 대한 자세한 페이지 링크를 작성합니다. 선택한 경우 페이지 ID를 추가하고 변수 추가 를 클릭하여 페이지에 변수를 전달하고 페이지에 정보를 로드하십시오.

      페이지 ID를 추가하는 대신 라이브러리에서 페이지를 선택할 수도 있습니다. 페이지를 선택하려면 라이브러리에서 선택을 클릭하십시오. 또는 외부 링크를 추가할 수 있습니다. 클릭하면 이 링크가 새 탭에서 열립니다.

스타일 탭에서 카드의 스타일을 정의하십시오.

  1. 차원에서 카드의 너비 및 높이를 늘리십시오.
  2. 헤더에서 카드에 제목을 추가하고 선택적으로 도구 팁을 추가하십시오.
  3. 바닥글 을 펼치고 바닥글 링크 를 켜짐으로 설정한 후 레이블을 지정하고 페이지 ID를 입력하십시오.

    필드에 페이지 ID를 추가하거나 라이브러리에서 페이지를 선택할 수 있습니다. 페이지를 선택하려면 라이브러리에서 선택을 클릭하십시오. 또는 바닥글에 외부 링크를 추가할 수 있습니다. 클릭하면 이 링크가 새 탭에서 열립니다.

    주: 일부 페이지는 다음과 같이 플래그 지정되어 있습니다.This page requires context.경고 즉, 이러한 페이지에는 페이지에서 컨텐츠를 올바르게 렌더링하기 위한 컨텍스트 변수가 필요하며 이러한 변수는 페이지 컨텍스트에서 누락되어 있습니다. 페이지 컨텍스트 변수를 추가하려면 페이지 컨텍스트 변수 구성을 참조하십시오.

    페이지를 선택한 후 템플리트 변수를 추가하여 페이지 컨텐츠를 동적으로 만들 수 있습니다. 즉, 변수에 따라 사용자 정의된 컨텐츠를 사용하여 동일한 페이지를 여러 번 사용할 수 있습니다.

  4. 저장을 클릭하십시오.

그리드 카드의 경우 조회에서 리턴되는 모든 속성을 표시할 수 있습니다. 조회에 tenantId 변수가 포함되어 있습니다.

query OrderDetail($tenantId: String, $orderId: String) {
  orderDetails: businessObjects(
    hint: {viewId: "graph"}
    simpleFilter: {tenantId: $tenantId, type: Order}
    advancedFilter: {AND: [{EQUALS: [{SELECT: "orderType", type: STRING}, {VALUE: "INBOUND", type: STRING}]}, {EQUALS: [{SELECT: "id", type: STRING}, {VALUE: $orderId, type: STRING}]}]}
  ) {
    edges {
      object {
        ... on Order {
          orderIdentifier
          buyer {
            id
            name
            organizationIdentifier
          }
          vendor {
            id
            name
            organizationIdentifier
          }
          shipFromInstructionLocation {
            locationName
            locationIdentifier
          }
          shipToLocation {
            locationName
            locationIdentifier
          }
          orderType
          orderStatus
          deliveryStatusByDate
          shipmentStatusByDate
          createdDate
          requestedShipDate
          plannedShipDate
          lineCount
          requestedDeliveryDate
          quantity
          plannedDeliveryDelay
          estimatedDeliveryDelay
          quantityUnits
          totalValue
          actualDeliveredDelay
          orderValueCurrency
          requestedShipDate
          sourceLink
          totalShippedQuantity
          actualShipDelay
        }
      }
    }
  }
}

다음 코드는 조회에서 사용할 변수를 정의하는 방법의 예입니다.

{
  "tenantId": "{{ tenantId }}",
  "orderId": "fa15029f-9ef8-432f-93de-1e48fd8bcda3"
}

다음 코드는 쿼리에서 리턴되는 데이터의 예입니다.

{
	"data": {
		"orderDetails": {
			"edges": [
				{
					"object": {
						"orderIdentifier": "1000567497",
						"buyer": {
							"id": "d2eb6aaf-6951-463d-9072-2963bb251123",
							"name": "LightTree",
							"organizationIdentifier": "LightTree",
							"__typename": "Organization"
						},
						"vendor": {
							"id": "2c50b311-ffb7-48d4-9194-c6dbab6b5dbc",
							"name": "Interalloy Corporation",
							"organizationIdentifier": "Interalloy",
							"__typename": "Organization"
						},
						"shipFromInstructionLocation": {
							"locationName": "Interalloy Corporation - Bozeman",
							"locationIdentifier": "Interalloy - Bozeman",
							"__typename": "Location"
						},
						"shipToLocation": {
							"locationName": "LightTree Plant 1 Birmingham",
							"locationIdentifier": "LT-1",
							"__typename": "Location"
						},
						"orderType": "INBOUND",
						"orderStatus": null,
						"deliveryStatusByDate": "NOT_DELIVERED",
						"shipmentStatusByDate": "FULLY_SHIPPED",
						"createdDate": "2021-07-15T00:00:00.000Z",
						"requestedShipDate": "2021-07-22T00:00:00.000Z",
						"plannedShipDate": "2021-07-21T00:00:00.000Z",
						"lineCount": 1,
						"requestedDeliveryDate": "2021-07-26T00:00:00.000Z",
						"quantity": 44,
						"plannedDeliveryDelay": null,
						"estimatedDeliveryDelay": -24,
						"quantityUnits": "EA",
						"totalValue": 132,
						"actualDeliveredDelay": null,
						"orderValueCurrency": "USD",
						"sourceLink": "http://lighttree.com/1000567497",
						"totalShippedQuantity": null,
						"actualShipDelay": 48,
						"__typename": "Order"
					},
					"__typename": "BusinessObjectEdge"
				}
			],
			"__typename": "BusinessObjectsCursor"
		}
	},
	"loading": false,
	"networkStatus": 7
}

다음 코드는 데이터에 적용되는 변환의 예입니다. 선택되는 속성은 데이터에서 리턴되는 속성과 일치해야 합니다. 리턴되는 데이터에 대해 모든 계산을 수행할 수 있습니다. 다음 예제에서는 CustomerSupplier 필드에 표시되는 내용을 수정하기 위해 일부 검사가 수행됩니다.


{
	"errors": "{{#? this.errors}}",
	"results": {
		"{{#each data.orderDetails.edges}}": {
			"orderIdentifier": "{{this.object.orderIdentifier}}",
			"lineCount": "{{this.object.lineCount}}",
			"quantityUnits": "{{this.object.quantityUnits}}",
			"shipToLocation": "{{this.object.shipToLocation.locationName}}",
			"estimatedDeliveryDelay": "{{this.object.estimatedDeliveryDelay}}",
			"requestedDeliveryDate": "{{this.object.requestedDeliveryDate}}",
			"orderType": "{{this.object.orderType}}",
			"deliveryStatusByDate": "{{this.object.deliveryStatusByDate}}",
			"totalValue": "{{this.object.totalValue}}",
			"createdDate": "{{this.object.createdDate}}",
			"actualDeliveredDelay": "{{this.object.actualDeliveredDelay}}",
			"orderValueCurrency": "{{this.object.orderValueCurrency}}",
			"requestedShipDate": "{{this.object.requestedShipDate}}",
			"sourceLink": "{{this.object.sourceLink }}",
			"quantity": "{{this.object.quantity }}",
			"totalShippedQuantity": "{{this.object.totalShippedQuantity}}",
			"actualShipDelay": "{{this.object.actualShipDelay}}",
			"shipmentStatusByDate": "{{this.object.shipmentStatusByDate}}",
			"plannedDeliveryDelay": "{{this.object.plannedDeliveryDelay}}",
			"shipFromLocation": "{{this.object.shipFromInstructionLocation.locationName}}",
			"customerId": "{{#? this.object.buyer.id }}",
			"customerTemplateLink": "DEFAULT_CUSTOMER_DETAIL_LAYOUT_TEMPLATE",
			"supplierTemplateLink": "DEFAULT_SUPPLIER_DETAIL_LAYOUT_TEMPLATE",
			"supplierId": "{{#? this.object.vendor.id}}",
			"Customer": [
				{
					"{{#if (this.object.buyer.organizationIdentifier && this.object.buyer.name)}}": "{{this.object.buyer.organizationIdentifier}}, {{this.object.buyer.name}}"
				},
				{
					"{{#elseif this.object.buyer.organizationIdentifier}}": "{{this.object.buyer.organizationIdentifier}}"
				},
				{
					"{{#elseif this.buyer.name}}": "{{this.object.buyer.name}}"
				},
				{
					"{{#else}}": "--"
				}
			],
			"Supplier": [
				{
					"{{#if (this.object.vendor.organizationIdentifier && this.object.vendor.name)}}": "{{this.object.vendor.organizationIdentifier}}, {{this.object.vendor.name}}"
				},
				{
					"{{#elseif this.object.vendor.organizationIdentifier}}": "{{this.object.vendor.organizationIdentifier}}"
				},
				{
					"{{#elseif this.object.vendor.name}}": "{{this.object.vendor.name}}"
				},
				{
					"{{#else}}": "--"
				}
			]
		}
	}
}

다음에 수행할 작업

대시보드 빌더를 사용하여 대시보드에 카드를 추가하십시오.