כרטיסי מתנה תומכים ברינדור של תבניות. אם לא מוגדרת תבנית, המערכת תשתמש בתבנית ברירת המחדל.
הגדרת תבנית
תבנית הכרטיס מוגדרת ברמת הכיתה, והיא משמשת להצגת כל אובייקט שמשויך לכיתה. התבנית קובעת אילו שדות יוצגו בחלקים השונים של הכרטיס.
התבנית מחולקת לקטעים הבאים:
Android
פיתוח אתרים
כותרת הכרטיס
Android
|
שם הכרטיס שמוגדר כברירת מחדל
כותרת כרטיס עם לוגו רחב
|
פיתוח אתרים
|
|
שם הכרטיס שמוגדר כברירת מחדל
כותרת כרטיס עם לוגו רחב
|
בקטע של כותרת הכרטיס מוצגים הלוגו, שם המוכר והיתרה. אי אפשר לשנות את ההפניות לשדות שמשמשות לאכלוס שלהם או את המיקום שלהן.
כשמגדירים את השדה של הלוגו הרחב, במכשירי Android כותרת ברירת המחדל של התבנית עם הלוגו ושם המנפיק מוחלפת בלוגו הרחב.
כדי שהתמונה תוצג בצורה אופטימלית בכרטיסים, יש לפעול לפי ההנחיות בנושא תמונות לוגו רחבות כשיוצרים את הלוגו הרוחב בכותרת.
תבנית כרטיס
Android
פיתוח אתרים
הקטע של תבנית הכרטיס משמש להצגת שורות נוספות. השורות האלה יכולות לכלול שדות של נתונים מובְנים מבוססי-טקסט או שדות של מודולים של טקסט.
אפשר לציין את מספר השורות שמגדירות את מספר האובייקטים ברשימה class.classTemplateInfo.cardTemplateOverride.cardRowTemplateInfos[]. הרשימה צריכה להכיל לפחות רכיב אחד, ומומלץ להשתמש בשני רכיבים לכל היותר. כל רכיב חייב להיות מאחד מהסוגים הבאים:
-
oneItem, שמקבל פריט אחד:item
-
twoItems, שמקבלת שני פריטים:startItemendItem
-
threeItems, שמקבל שלושה פריטים:startItemmiddleItemendItem
אפשר להגדיר כל פריט כבורר שדות יחיד (.firstValue), כשני בוררי שדות (.firstValue ו-.secondValue) או כפריט מוגדר מראש (.predefinedItem). מוצגים גם הערכים של השדה שנבחר וגם התוויות התואמות שלהם. כשמגדירים שני בוררי שדות, הערכים של השדות שנבחרו מוצגים עם התו '/'. אותו הדבר חל על התוויות של השדות שנבחרו. פריטים מוגדרים מראש משמשים להגדרת רינדור מורכב יותר.
דוגמת הקוד הבאה מראה איך לשנות את קטעי השורות של תבנית הכרטיס כדי לציין שתי שורות. כל שורה כוללת שלושה פריטים, שכל אחד מהם מפנה לשישה שדות textModuleData בהתאמה אישית ברמת הכיתה ולכותרות שלהם בתור תוויות:
Python
{
... //Rest of class
"textModulesData": [
{
"header": "Label 1",
"body": "Some info 1",
"id": "myfield1"
},
{
"header": "Label 2",
"body": "Some info 2",
"id": "myfield2"
},
{
"header": "Label 3",
"body": "Some info 3",
"id": "myfield3"
},
{
"header": "Label 4",
"body": "Some info 4",
"id": "myfield4"
},
{
"header": "Label 5",
"body": "Some info 5",
"id": "myfield5"
},
{
"header": "Label 6",
"body": "Some info 6",
"id": "myfield6"
}
],
"classTemplateInfo": {
"cardTemplateOverride": {
"cardRowTemplateInfos": [{
"threeItems": {
"startItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield1']"
}]
}
},
"middleItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield2']"
}]
}
},
"endItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield3']"
}]
}
},
}
},{
"threeItems": {
"startItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield4']"
}]
}
},
"middleItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield5']"
}]
}
},
"endItem": {
"firstValue": {
"fields": [{
"fieldPath": "class.textModulesData['myfield6']"
}]
}
},
}
}]
}
}
}
Java
// Rest of class
.setTextModulesData((new ArrayList<TextModuleData>() {
{
add((new TextModuleData()).setHeader("Label 1")
.setBody("Some info 1")
.setId("myfield1"));
add((new TextModuleData()).setHeader("Label 2")
.setBody("Some info 1")
.setId("myfield2"));
add((new TextModuleData()).setHeader("Label 3")
.setBody("Some info 3")
.setId("myfield3"));
add((new TextModuleData()).setHeader("Label 4")
.setBody("Some info 4")
.setId("myfield4"));
add((new TextModuleData()).setHeader("Label 5")
.setBody("Some info 5")
.setId("myfield5"));
add((new TextModuleData()).setHeader("Label 6")
.setBody("Some info 5")
.setId("myfield6"));
}
}))
.setClassTemplateInfo((new ClassTemplateInfo())
.setCardTemplateOverride((new CardTemplateOverride())
.setCardRowTemplateInfos(new ArrayList<CardRowTemplateInfo>() {
{
add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
.setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield1']"));
}
})))
.setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield2']"));
}
})))
.setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield3']"));
}
})))
));
add((new CardRowTemplateInfo()).setThreeItems((new CardRowThreeItems())
.setStartItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield4']"));
}
})))
.setMiddleItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield5']"));
}
})))
.setEndItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.textModulesData['myfield6']"));
}
})))
));
}
})))
PHP
// Rest of class
$textModulesData1 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData1->setBody("Some info 1");
$textModulesData1->setHeader("Label 1");
$textModulesData1->setId("myfield1");
$textModulesData2 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData2->setBody("Some info 2");
$textModulesData2->setHeader("Label 2");
$textModulesData2->setId("myfield2");
$textModulesData3 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData3->setBody("Some info 3");
$textModulesData3->setHeader("Label 3");
$textModulesData3->setId("myfield3");
$textModulesData4 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData4->setBody("Some info 4");
$textModulesData4->setHeader("Label 4");
$textModulesData4->setId("myfield4");
$textModulesData5 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData5->setBody("Some info 5");
$textModulesData5->setHeader("Label 5");
$textModulesData5->setId("myfield5");
$textModulesData6 = new Google_Service_Walletobjects_TextModuleData();
$textModulesData6->setBody("Some info 6");
$textModulesData6->setHeader("Label 6");
$textModulesData6->setId("myfield6");
$textModulesDatas = array($textModulesData1, $textModulesData2, $textModulesData3,
$textModulesData4, $textModulesData5, $textModulesData6);
$startItemField = new Google_Service_Walletobjects_FieldReference();
$startItemField->setFieldPath("class.textModulesData['myfield1']");
$startItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
$startItemFirstValue->setFields(array($startItemField));
$startItem = new Google_Service_Walletobjects_TemplateItem();
$startItem->setFirstValue($startItemFirstValue);
$middleItemField = new Google_Service_Walletobjects_FieldReference();
$middleItemField->setFieldPath("class.textModulesData['myfield2']");
$middleItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
$middleItemFirstValue->setFields(array($middleItemField));
$middleItem = new Google_Service_Walletobjects_TemplateItem();
$middleItem->setFirstValue($middleItemFirstValue);
$endItemField = new Google_Service_Walletobjects_FieldReference();
$endItemField->setFieldPath("class.textModulesData['myfield3']");
$endItemFirstValue = new Google_Service_Walletobjects_FieldSelector();
$endItemFirstValue->setFields(array($endItemField));
$endItem = new Google_Service_Walletobjects_TemplateItem();
$endItem->setFirstValue($endItemFirstValue);
$cardRowTemplate = new Google_Service_Walletobjects_CardRowThreeItems();
$cardRowTemplate->setStartItem($startItem);
$cardRowTemplate->setMiddleItem($middleItem);
$cardRowTemplate->setEndItem($endItem);
$cardRowTemplateInfo1 = new Google_Service_Walletobjects_CardRowTemplateInfo();
$cardRowTemplateInfo1->setThreeItems($cardRowTemplate);
$startItemField2 = new Google_Service_Walletobjects_FieldReference();
$startItemField2->setFieldPath("class.textModulesData['myfield4']");
$startItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
$startItemFirstValue2->setFields(array($startItemField2));
$startItem2 = new Google_Service_Walletobjects_TemplateItem();
$startItem2->setFirstValue($startItemFirstValue2);
$middleItemField2 = new Google_Service_Walletobjects_FieldReference();
$middleItemField2->setFieldPath("class.textModulesData['myfield5']");
$middleItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
$middleItemFirstValue2->setFields(array($middleItemField2));
$middleItem2 = new Google_Service_Walletobjects_TemplateItem();
$middleItem2->setFirstValue($middleItemFirstValue2);
$endItemField2 = new Google_Service_Walletobjects_FieldReference();
$endItemField2->setFieldPath("class.textModulesData['myfield6']");
$endItemFirstValue2 = new Google_Service_Walletobjects_FieldSelector();
$endItemFirstValue2->setFields(array($endItemField2));
$endItem2 = new Google_Service_Walletobjects_TemplateItem();
$endItem2->setFirstValue($endItemFirstValue2);
$cardRowTemplate2 = new Google_Service_Walletobjects_CardRowThreeItems();
$cardRowTemplate2->setStartItem($startItem2);
$cardRowTemplate2->setMiddleItem($middleItem2);
$cardRowTemplate2->setEndItem($endItem2);
$cardRowTemplateInfo2 = new Google_Service_Walletobjects_CardRowTemplateInfo();
$cardRowTemplateInfo2->setThreeItems($cardRowTemplate2);
$cardTemplateOverride = new Google_Service_Walletobjects_CardTemplateOverride();
$cardTemplateOverride->setCardRowTemplateInfos(array($cardRowTemplateInfo1,
$cardRowTemplateInfo2));
$classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
$classTemplateInfo->setCardTemplateOverride($cardTemplateOverride);
$payload->setTextModulesData($textModulesDatas);
$payload->setClassTemplateInfo($classTemplateInfo);
הקוד יוצר כרטיס עם הפורמט הבא של קטע תבנית הקוד:
אם פריט ריק, הוא לא מוצג. למידע נוסף, ראו הפניות לשדות. אם כל הפריטים בשורה ריקם, השורה לא תוצג. אם חלק מהפריטים בשורה ריקים, אבל לא כולם, הפריטים שאינם ריקים מסודרים מחדש ומוצגים בשורה עם פחות פריטים.
אם לא משנים את תבנית הכרטיס, המערכת משתמשת במספר השורות, במספר הפריטים ובהפניות השדות שמוגדרים כברירת מחדל. למידע נוסף, ראו תבנית ברירת מחדל.
אחרי שמגדירים תמונה ראשית, היא יכולה להופיע אחרי השורה הראשונה, אם יש כמה שורות ברשימה cardRowTemplateInfos, או מעל השורה, אם יש רק שורה אחת.
ברקוד הכרטיס
Android
|
|
פיתוח אתרים
|
|
הקטע של קוד הברקוד בכרטיס משמש להצגת טקסט או תמונות נוספים מעל ומתחת לקוד הברקוד. אף אחד מהשדות בקטע הזה הוא שדה חובה.
יש שלושה סלקטורים של שדות שאפשר להשתמש בהם כדי להגדיר שני שדות זה לצד זה מעל לקוד הברקוד ושדה אחד מתחתיו. הם מוצגים ללא תווית, ויכולים להיות שדות של נתונים מובְנים מבוססי-טקסט, שדות של מודול טקסט או שדות של מודול תמונה. אם אתם משתמשים בתמונות, עליהן לעמוד בהנחיות למיתוג.
הברקוד מוגדר לפי סוג וערך. רשימה של סוגי הברקודים הנתמכים מופיעה במאמר חומר עזר. בנוסף, אפשר להציג טקסט מתחת לקוד הברקוד. הטקסט הזה יכול לעזור לכם לסרוק בקלות קודי מוצר, בין היתר.
בדוגמת הקוד הבאה מוסבר איך לשנות את הקטע של הברקוד בכרטיס כדי להציג תמונה מעל הברקוד:
Python
#... rest of class
"imageModulesData": [
{
"mainImage": {
"sourceUri": {
"uri": "http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg",
"description": "Coffee"
}
},
"Id": "myimage"
}
],
"classTemplateInfo": {
"cardBarcodeSectionDetails": {
"firstTopDetail": {
"fieldSelector": {
"fields": [
{
"fieldPath": "class.imageModulesData['myimage'].mainImage"
}
]
}
}
}
}
}
Java
//... rest of class
.setImageModulesData((new ArrayList<ImageModuleData>() {
{
add((new ImageModuleData())
.setId("myimage")
.setMainImage((new Image()).setSourceUri((new ImageUri()).setDescription("Coffee beans")
.setUri("http://farm4.staticflickr.com/3738/12440799783_3dc3c20606_b.jpg"))));
}
}))
.setClassTemplateInfo((new ClassTemplateInfo())
.setCardBarcodeSectionDetails((new CardBarcodeSectionDetails())
.setFirstTopDetail((new BarcodeSectionDetail())
.setFieldSelector((new FieldSelector())
.setFields((new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.imageModulesData['myimage'].mainImage"));
}
})))))
}
PHP
//... rest of class
$imageUri = new Google_Service_Walletobjects_ImageUri();
$imageUri->setUri("https://farm8.staticflickr.com/7340/11177041185_a61a7f2139_o.jpg");
$imageUri->setDescription("Baconrista flights image");
$image = new Google_Service_Walletobjects_Image();
$image->setSourceUri($imageUri);
$imageModulesData = new Google_Service_Walletobjects_ImageModuleData();
$imageModulesData->setMainImage($image);
$imageModulesData->setId("myimage");
$cardBarcodeFieldReference = new Google_Service_Walletobjects_FieldReference();
$cardBarcodeFieldReference->setFieldPath("class.imageModulesData['myimage'].mainImage");
$cardBarcodeFieldSelector = new Google_Service_Walletobjects_FieldSelector();
$cardBarcodeFieldSelector->setFields(array($cardBarcodeFieldReference));
$cardBarcodeDetail = new Google_Service_Walletobjects_BarcodeSectionDetail();
$cardBarcodeDetail->setFieldSelector($cardBarcodeFieldSelector);
$cardBarcodeSectionDetails = new Google_Service_Walletobjects_CardBarcodeSectionDetails();
$cardBarcodeSectionDetails->setFirstTopDetail($cardBarcodeDetail);
$classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
$classTemplateInfo->setCardBarcodeSectionDetails($cardBarcodeSectionDetails);
$payload->setClassTemplateInfo($classTemplateInfo);
$payload->setImageModuleData($imageModulesData);
הקוד יוצר כרטיס בפורמט הבא של קטע הברקוד:
אם לא משנים את הקטע של הברקוד, המערכת משתמשת בשדות ברירת המחדל של הברקוד. מידע נוסף זמין במאמר תבנית ברירת מחדל.
תבנית פרטים
Android
|
|
פיתוח אתרים
|
|
הקטע של תבנית הפרטים הוא רשימה של פריטים class.classTemplateInfo.detailsTemplateOverride.detailsItemInfos[]. הפריטים יכולים לכלול כל סוג של שדות של נתונים מובְנים, שדות של מודולים של טקסט, שדות של מודולים של קישורים, שדות של מודולים של תמונות או הודעות.
אפשר להגדיר כל פריט כבורר שדות יחיד (.firstValue), שני בוררי שדות (.firstValue ו-.secondValue) או פריט מוגדר מראש (.predefinedItem). מוצגים גם הערכים של השדה שנבחר וגם התוויות התואמות שלהם. כשמגדירים שני בוררי שדות, הערכים של השדות שנבחרו מוצגים עם התו '/'. אותו הדבר חל על התוויות של השדות שנבחרו. פריטים מוגדרים מראש משמשים להגדרת רינדור מורכב יותר. שדות של מודול תמונה מוצגים ברוחב מלא בלי תווית.
דוגמת הקוד הבאה מראה איך לשנות את הקטע 'פרטים' של הכרטיס כדי להציג שדה linksModuleData יחיד עם התווית שלו:
Python
//... rest of class
"linksModuleData": {
"uris": [
{
"uri": "http://maps.google.com/",
"description": "Nearby Locations",
"id":"mylink"
}
]
},
"classTemplateInfo": {
"detailsTemplateOverride": {
"detailsItemInfos": [
{
"item":{
"firstValue": {
"fields": [{
"fieldPath": "class.linksModuleData.uris['mylink']"
}]
}
}
}
]
}
}
//... rest of class
Java
//... rest of class
.setLinksModuleData((new ArrayList<LinksModuleData>() {
{
add((new LinksModuleData()).setDescription("Nearby Locations")
.setUri("http://maps.google.com/")
.setId("mylink"));
}))
.setClassTemplateInfo((new ClassTemplateInfo())
.setDetailsTemplateOverride((new DetailsTemplateOverride())
.setDetailsItemInfos(new ArrayList<DetailsItemInfo>(){
{
add((new DetailsItemInfo())
.setItem((new TemplateItem()).setFirstValue((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("class.linksModuleData.uris['mylink']"));
}
}))));
}
}))
//... rest of class
PHP
//... rest of class building
$locationUri = new Google_Service_Walletobjects_Uri();
$locationUri->setUri("http://maps.google.com/");
$locationUri->setDescription("Nearby Locations");
$locationUri->setId("mylink");
$linksModuleData = new Google_Service_Walletobjects_LinksModuleData();
$linksModuleData->setUris(array($locationUri));
$detailItemFieldReference = new Google_Service_Walletobjects_FieldReference();
$detailItemFieldReference->setFieldPath("class.linksModuleData.uris['mylink']");
$detailItemFieldSelector = new Google_Service_Walletobjects_FieldSelector();
$detailItemFieldSelector->setFields(array($detailItemFieldReference));
$detailItem = new Google_Service_Walletobjects_TemplateItem();
$detailItem->setFirstValue($detailItemFieldSelector);
$detailsItemInfo = new Google_Service_Walletobjects_DetailsItemInfo();
$detailsItemInfo->setItem($detailItem);
$cardDetailsTemplateOverride = new Google_Service_Walletobjects_DetailsTemplateOverride();
$cardDetailsTemplateOverride->setDetailsItemInfos(array($detailsItemInfo));
$classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
$classTemplateInfo->setDetailsTemplateOverride($cardDetailsTemplateOverride);
$payload->setClassTemplateInfo($classTemplateInfo);
$payload->setLinksModuleData($linksModuleData);
//... rest of class
הקוד יוצר כרטיס בפורמט הבא של קטע הפרטים:
אם פריט ריק, הוא לא מוצג. למידע נוסף, ראו הפניות לשדות.
אם לא מבטלים את ברירת המחדל של תבנית הפרטים, תוצג רשימת ברירת המחדל של שדות העזר בסדר ברירת המחדל. מידע נוסף זמין במאמר תבנית ברירת מחדל.
תבנית רשימה
|
|
הקטע 'תבנית רשימה' משמש לבחירת השדה שיוצג בתצוגה 'כרטיסים' באפליקציית Google Wallet. הכרטיס מיוצג ברשימה עם הלוגו, צבע הרקע ושלוש שורות.
בדוגמת הקוד הבאה מוסבר איך לשנות את תבנית הרשימה של כרטיס כדי להציג את השדה 'תאריך תפוגת התוקף של אובייקט' של כרטיסים בודדים בשורה הראשונה של תבנית הרשימה:
Python
#... rest of class definition
"classTemplateInfo": {
"listTemplateOverride":{
"firstRowOption": {
"fieldOption":{
"fields": [{
"fieldPath": "object.validTimeInterval.end"
}]
}
}
}
}
}
Java
//... rest of class
.setClassTemplateInfo((new ClassTemplateInfo())
.setListTemplateOverride((new ListTemplateOverride())
.setFirstRowOption((new FirstRowOption())
.setFieldOption((new FieldSelector()).setFields(new ArrayList<FieldReference>(){
{
add((new FieldReference()).setFieldPath("object.validTimeInterval.end"));
}
}))))
//... rest of class
PHP
//... rest of class
$fieldReference = new Google_Service_Walletobjects_FieldReference();
$fieldReference->setFieldPath("object.validTimeInterval.end");
$fieldOption = new Google_Service_Walletobjects_FieldSelector();
$fieldOption->setFields(array($fieldReference));
$firstRowOption = new Google_Service_Walletobjects_FirstRowOption();
$firstRowOption->setFieldOption($fieldOption);
$listTemplateOverride = new Google_Service_Walletobjects_ListTemplateOverride();
$listTemplateOverride->setFirstRowOption($firstRowOption);
$classTemplateInfo = new Google_Service_Walletobjects_ClassTemplateInfo();
$classTemplateInfo->setListTemplateOverride($listTemplateOverride);
$payload->setClassTemplateInfo($classTemplateInfo);
//... rest of class
הקוד יוצר כרטיס עם הגרסה הבאה של תבנית הרשימה:
אפשר להגדיר את שלוש השורות באמצעות בורר שדות. השדות מוצגים ללא תווית.
תוויות
לכל שדות הנתונים המובְנים יש תווית ש-Google מספקת. Google אחראית לספק תרגום לכל אחד מהתוויות האלה בכל השפות הנתמכות.
אפשר להתאים אישית חלק מהתוויות האלה באמצעות אחד מהשדות class.custom<name_of_the_field>Label. כשאתם מתאימים אישית תווית, אתם אחראים לספק תרגומים של התווית הספציפית הזו לכל השפות שבהן אתם רוצים לתמוך.
הפניות לשדות
המערכת משתמשת בהפניות לשדות בחלקים שונים של התבנית, בפורמט class.classTemplateInfo.*.fields[]. הפניה לשדה מכילה רשימה של נתיבים לשדות של נתונים מובְנים, שדות של מודולים של טקסט, שדות של מודולים של קישורים, שדות של מודולים של תמונות או הודעות.
לא כל סוגי הנתיבים מותרים בכל הפניית שדה. לדוגמה, חלק מההפניות לשדות מאפשרות רק נתיבים לשדות של נתונים מובְנים מבוססי-טקסט או לשדות של מודולים של טקסט. שדות מובְנים מבוססי-טקסט הם שדות של נתונים מובְנים מסוג מחרוזת, מחרוזת מותאמת לאזור, תאריך או כסף.
אפשר להשתמש ברשימה כדי להטמיע לוגיקה של חלופה. כלומר, אם הנתיב הראשון ברשימה מתמקד בשדה ריק, המערכת תבדוק את הנתיב הבא. לוגיקת ההחלפה המשנית מיועדת בעיקר לשדות של נתונים מובְנים מבוססי טקסט או לשדות של מודולים של טקסט. אין לשלב סוגי שדות שונים באותה רשימה. מומלץ להשתמש בלוגיקה החלופית בזהירות ובמצבים ספציפיים בלבד, כשצפוי דפוס עקבי של שדות שקיימים באובייקטים מסוימים אבל לא באחרים. ברוב המקרים, קל יותר ליצור כיתות נפרדות לתרחישי שימוש נפרדים.
אם כל הנתיבים ברשימת ההפניות לשדות מנותבים לשדות ריקים, הפריט שמשתמש בהפניה לשדה לא מוצג. אם רוצים שהפריט שמשתמש בהפניה לשדה תמיד יהיה נוכח, צריך לוודא שנתיב אחד לפחות לא ריק. מומלץ להגדיר שדה עם תו מיוחד, כמו '-', כדי לייצג ערך null, גם אם בשדות מסוימים מותר להזין מחרוזות עם רווח בלבד.
כדי להפנות לשדה שמופיע ברשימה, אפשר להשתמש במדד של השדה ברשימה, או שברוב המקרים להשתמש במזהה הפניה. לפריטים ברשימת פריטים שאפשר להפנות אליהם לפי מזהה יש שדה .id. כשיש אפשרות, מומלץ להשתמש במזהה הפניה במקום במדד של השדה ברשימה.
דוגמה לאופן שבו מפנים לשדות שמכילים רשימה.
object.imageModulesData[0].id = my-first-idobject.imageModulesData[1].id = my-second-idclass.detailsTemplateOverride.detailsItemInfos[0].item.firstValue.fields[0].fieldPath = object.imageModulesData[‘my-second-id’]class.detailsTemplateOverride.detailsItemInfos[1].item.firstValue.fields[0].fieldPath = object.imageModulesData[0]
במקרה כזה, הפריט הראשון בקטע הפרטים של הכרטיס הוא התמונה השנייה שהוגדרה באובייקט. לעומת זאת, הפריט השני בקטע הפרטים של הכרטיס הוא התמונה הראשונה שמוגדרת באובייקט.
תבנית ברירת המחדל
Android
|
|
פיתוח אתרים
|
|
בשדות של מודול תמונה, אנחנו מציגים רק שדה אחד של מודול תמונה מהכיתה ושדה אחד של מודול תמונה מהאובייקט. אם אתם צריכים יותר משדה אחד של מודול תמונה בכל אחת מהרמות, תוכלו לשנות את תבנית ברירת המחדל.
בשדות של מודולים של טקסט, אנחנו מציגים רק עד 20 שדות של מודולים של טקסט מהכיתה ו-20 שדות של מודולים של טקסט מהאובייקט. השדות מוצגים באותו הסדר שבו הם מוגדרים במערך. אם אתם צריכים יותר מ-20 שדות של מודולים של טקסט בכל אחת מהרמות, תוכלו לשנות את ברירת המחדל של התבנית.
לגבי הודעות, אנחנו מציגים רק עד 20 הודעות מהכיתה ו-20 הודעות מהאובייקט. אנחנו לא יכולים להבטיח את הסדר שבו יוצגו ההודעות. אם אתם צריכים יותר מ-20 הודעות בכל רמה, או אם אתם רוצים להציע אחריות על הזמנות, תוכלו לשנות את ברירת המחדל של התבנית.
בשדה של מודול הקישורים, אין הגבלה על מספר כתובות ה-URI שאפשר להגדיר. כתובות ה-URI מוצגות בקבוצות לפי הסדר הבא בכל רמה (כיתה או אובייקט):
- קואורדינטות במפה
- מספרי טלפון
- כתובות אימייל
- דפי אינטרנט
לכל קבוצה, מזהי ה-URI מוצגים באותו הסדר שבו הם מוגדרים במערך. אם אתם צריכים סדר אחר, תוכלו לשנות את תבנית ברירת המחדל.
|
|
|