輸出巨集範例 outbound-macro-examples
如何使用部分通用巨集建立傳出檔案範本的範例。
< >符號，以視覺化方式分隔每個巨集。檔案名稱巨集 file-name-macros
如需可用巨集和定義的清單，請參閱輸出範本巨集。
DPID格式： <SYNC_TYPE>_<ORDER_ID>_ <DPID>_<SYNC_MODE>_<TIMESTAMP>.sync
輸出： ftp_215_ 888_iter_1449756724.sync
MASTER_DPID格式： <SYNC_TYPE>_<ORDER_ID>_<DPID>_ <MASTER_DPID>_<SYNC_MODE>_<TIMESTAMP>.sync
輸出： ftp_215_888_ 20915_iter_1449756724.sync
ORDER_ID格式： <SYNC_TYPE>_ <ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>.sync
輸出： ftp_ 215_888_iter_1449756724.sync
SYNC_MODE格式： <SYNC_TYPE>_<ORDER_ID>_<DPID>_ <SYNC_MODE>_<TIMESTAMP>.sync
輸出：
- 完整：
ftp_215_888_ full_1449756724.sync - 增量：
ftp_215_888_ iter_1449756724.sync
SYNC_TYPE格式： <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_<TIMESTAMP>.sync
輸出：
- FTP：
ftp_215_888_iter_1449756724.sync - https：
http_215_888_iter_1449756724.sync - S3：
s3_215_888_iter_1449756724.sync
TIMESTAMP格式： <SYNC_TYPE>_<ORDER_ID>_<DPID>_<SYNC_MODE>_ <TIMESTAMP>_<admin><.sync>
輸出： ftp_215_888_iter_ 1449756724.sync
標題列巨集 header-macros
如需可用巨集和定義的清單，請參閱輸出範本巨集。
TAB格式： <ORDER_ID> <TAB><SYNC_TYPE>
輸出： 888 full.sync
在輸出中，非列印定位字元會分隔每個元素。
檔案內容巨集 file-content-macros
如需可用巨集和定義的清單，請參閱輸出範本巨集。
DP_UUID格式： <DP_UUID><TAB> <UUID>
輸出： 123456 07955261652886032950143702505894272138
DP_UUID_LIST格式： <UUID><TAB> <DP_UUID_LIST;separator=TAB>
輸出： 07955261652886032950143702505894272138 DP_UUID1 DP_UUID2 DP_UUID3
DPUUIDSREMOVED_SEGMENT_LIST格式： <DP_UUID> <REMOVED_SEGMENT_LIST;separator=" ">
輸出： 123456 105955 101183 101180 101179
SEGMENT_LIST格式： <DP_UUID> <SEGMENT_LIST;separator=" ">
輸出： 123456 105955 101183 101180 101179
if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)endif格式:
{"AdvertiserId":"<PIDALIAS>", "DataCenterId": 2,"TDID":"<DP_UUID>", "Data":[<SEGMENT_LIST:{seg|<OPEN_CURLY_BRACKET>"Name":"<seg.alias>"<CLOSE_CURLY_BRACKET>}; separator=","><if(SEGMENT_LIST && REMOVED_SEGMENT_LIST)><COMMA><endif> <REMOVED_SEGMENT_LIST:{seg|<OPEN_CURLY_BRACKET>"Name":"<seg.alias>", "TtlInMinutes":0<CLOSE_CURLY_BRACKET>}; separator=",">]}
輸出：
//First example {"AdvertiserId":"12345", "DataCenterId": 2, "TDID":"dfd215e4-8d6b-4fdb-90b9-fab4456f2c9d","Data":[{"Name":"4321"}]} //Second example {"AdvertiserId":"12345", "DataCenterId": 2,"TDID":"9099e8fe-abab-5114-abaa-28bdaa0539ca","Data":[{"Name":"4321"},{"Name":"987","TtlInMinutes":0}, {"Name":"654","TtlInMinutes":0}]}
注意：在第一個範例中，巨集只會傳回 SEGMENT_LIST 的資料，因為 REMOVED_SEGMENT_LIST 是空的。 第二個範例會傳回兩個巨集的資料。
SET_ATTRIBUTES格式：
<PID><TAB><UUID><TAB><DP_UUID><TAB> <SET_ATTRIBUTES><TAB><OPT_OUT><TAB><SEGMENT_LIST:{seg|<seg.type>,<seg.alias>,<OUTPUT_ATTRIBUTE_VALUE>,<seg.lastUpdateTime>&}>
輸出：
1159 00088008579683653741516297509717335000 17t0aj01b120hp 1 0 5,103714,1,1344114661000&5,103713,1,1343250661000
TAB格式： <DP_UUID><TAB><DP_UUID_LIST;separator=TAB>
輸出： 123456 UUID1 UUID2 UUID3
在輸出中，非列印定位字元會分隔每個元素。
TRAIT_LIST格式： <PID><TAB><DP_UUID><TAB><SET_ATTRIBUTES><TAB> <TRAIT_LIST;separator="|">
輸出： 1131 12345 1 123|456|789
DPUUID範例
為了協助您瞭解DPUUID巨集如何輸出資料，我們假設有2個DPID對應到DPUUID，如下所示：
- DPID
1111對應至DPUUIDAAAA（時間戳記= 1）和BBBB（時間戳記= 2）。 - DPID
2222對應至DPUUIDCCCC。
基於這些條件，下表列舉了一些可能的格式字串及其輸出。
<DPUUIDS; format="dpids=1111|maxMappings=0|format=json">[["1111","AAAA"],["1111","BBBB"]]<DPUUIDS; format="dpids=1111,2222|maxMappings=1|format=json">[["1111","BBBB"],["2222","CCCC"]]
對於DPID 1111 ，巨集僅對應到DPUUID BBBB ，因為該ID的時間戳記較大。
<DPUUIDS; format="dpids=2222|maxMappings=2|format=json">[["2222","CCCC"]]
即使 maxMappings=2 ，這個巨集也只傳回1個DPID至DPUUID對應，因為指定的DPID只有一個DPUUID。