DataWorks：Sensors Data（神策）資料來源

轉換器類型

功能描述

樣本

參數說明

Date2Str

將Date時間類型的資料轉換為String字串類型。

//樣本
"dataConverters":[
    {
        "type": "Date2Str",
        "param": {
            "pattern":"yyyy-MM-dd"
        }
    }
]

pattern（可選）：將Date資料轉換為String類型資料後，String類型資料的時間格式。

Date2Long

將Date時間類型的資料轉換為Long長整數型別。

"dataConverters":[
    {
        "type": "Date2Long"
    }
]

無

Number2Str

將Number數實值型別的資料轉換為String字串類型。

//樣本
"dataConverters":[
    {
        "type": "Number2Str"
    }
]

無

Str2Long

將String字串類型的資料轉換為Long長整數型別。

//樣本
"dataConverters":[
    {
        "type": "Str2Long"
    }
]

無

Str2Date

將String字串類型的資料轉換為Date時間類型。

//樣本
"dataConverters":[
    {
        "type": "Str2Date",
        "param": {
            "pattern":"yyyy-MM-dd",
            "formats":["yyyyMMdd","yyyyMMddHHmmss"]
        }
    }
]

• pattern（可選）：轉換後Date資料的時間格式，內建時間格式包括：yyyy-MM-dd、yyyy-MM-dd HH:mm:ss、yyyy-MM-dd HH:mm:ss.SSSyyyy-MM、yyyyMM、yyyyMMddHHmmss、yyyyMMddHHmmssSSS。

• formats（可選）：其他格式的字串時間數組（資料來源的時間格式可能存在多種，可以彌補pattern的不足）。

BigInt2Date

將BigInt大整數類型的資料轉換為Date時間類型。

//樣本
"dataConverters":[
    {
        "type": "BigInt2Date"
    }
]

無

Str2Int

將String字串類型的資料轉換為Int整數類型。

//樣本
"dataConverters":[
    {
        "type": "Str2Int"
    }
]

無

Str2Double

將String字串類型的資料轉換為Double雙精確度數實值型別。

//樣本
"dataConverters":[
    {
        "type": "Str2Double"
    }
]

無

Str2BigDecimal

將String字串類型的資料轉換為BigDecimal高精度數實值型別。

//樣本
"dataConverters":[
    {
        "type": "Str2BigDecimal"
    }
]

無

IfNull2Default

當欄位值為null時，將欄位值設定為default參數中定義的常量值，並支援根據IfNull2Default轉換器中嵌套的轉換器類型，進一步將欄位常量值轉換為目標資料類型。

//樣本
//如果該列的值為null或者Null 字元串，那麼設定該值為字串類型的2021-07-01，並且將該字串轉換為yyyy-MM-dd格式的時間，再將該時間轉換為long型的毫秒值。
"dataConverters":[
    {
        "type": "IfNull2Default",
        "param": {
            "default": "2021-07-01",
            "dataConverters": [
                {
                    "type": "Str2Date",
                    "param": {
                        "pattern":"yyyy-MM-dd"
                    }
                },
                {
                    "type": "Date2Long"
                }
            ]
        }
    }
]

dataConverters：資料轉換器，將default參數的預設值轉換為type中定義的類型。實現多次資料轉換，多個dataConverters可嵌套使用。

NotNull2Null

如果欄位值為非null的值，可以將欄位值轉換為null。

//樣本
"dataConverters":[
    {
        "type": "NotNull2Null"
    }
]

無

IfElse

if條件運算式，判斷欄位值是否滿足條件，當if條件運算式成立時，在value中定義滿足條件時的欄位傳回值，當if條件運算式不成立時，在else中定義不滿足條件時的欄位傳回值。

//樣本
"dataConverters":[
                  {
                    "type": "IfElse",
                    "param": {
                      "if": "return true;",
                      "value":"if(resolvedValues.get(\"check_card_type\") == 'NAN' && value == null ){return true;} if(resolvedValues.get(\"check_card_type\") == '身份證'){  if(java.util.regex.Pattern.compile(regEx).matcher(value).find() && java.lang.Integer.parseInt(value.substring(6, 10)) >=1900 && java.lang.Integer.parseInt(value.substring(6, 10)) <= nowYear){return true;}} return null;",
                      "sharedPool":"var nowYear = java.time.LocalDate.now().getYear(); var regEx = \"(110|120|310|510|150|650|540|640|450|230|220|210|120|140|630|370|410|320|340|320|340|330|350|360|430|420|440|460|620|610|520|530)\\\\d{7}(0[1-9]|1[0-2])(0[1-9]|[1-2][0-9]|3[0-1])\\\\d{3}(\\\\d|X)\"; "
                    }
                  }
                ]

• if：if條件運算式，使用JavaScript引擎解析，確保傳回值為boolean類型。匯入神策資料的當前欄位，和當前外掛程式擷取到的value值，dataConverters下配置的param參數，以及已解析的列（map結構），會傳遞到if運算式中，可通過targetColumnName、value、param、resolvedValues分別擷取對應的值。

• value：if條件運算式成立時，返迴轉換後的值，使用JavaScript引擎解析，匯入神策資料的當前欄位，和當前外掛程式擷取到的value值，dataConverters下配置的param參數，以及已解析的列（map結構），會傳遞到value運算式中，可通過targetColumnName、value、param、resolvedValues分別擷取對應的值。

• else：if條件運算式不成立時，返迴轉換後的值，使用JavaScript引擎解析，匯入神策資料的當前欄位，和當前外掛程式擷取到的value值，dataConverters下配置的param參數，以及已解析的列（map結構），會傳遞到else運算式中，可通過targetColumnName、value、param、resolvedValues分別擷取對應的值。

• sharedPool：共用區，使用JavaScript引擎解析，該值定義的變數或常量在if、value、else中都能使用。

IfNull2Column

如果欄位值為null，則轉向取targetColumnName配置項的值，作為當前欄位的值。

//樣本
"dataConverters": [
    {
        "type": "IfNull2Column",
        "param": {
            "targetColumnName":"age1"
        }
    }
]

targetColumnName：匯入神策資料的列名。