ติดตั้งธีม Adventure Works
บทความนี้จะอธิบายวิธีการติดตั้งธีม Adventure Works ใน Microsoft Dynamics 365 Commerce
สำคัญ
ธีม Adventure Works และโมดูลพร้อมใช้งาน ณ การเริ่มใช้งาน Dynamics 365 Commerce รุ่น 10.0.20 ซึ่งจะพร้อมใช้งานจาก Microsoft AppSource
ข้อกำหนดเบื้องต้น
ก่อนที่คุณจะติดตั้งธีม Adventure Works คุณต้องมีสภาพแวดล้อม Dynamics 365 Commerce (Commerce รุ่น 10.0.20 หรือใหม่กว่า) ที่มี Retail Cloud Scale Unit (RCSU) ชุดการพัฒนาซอฟต์แวร์ออนไลน์ของ Commerce (SDK) และไลบรารีโมดูล Commerce สำหรับข้อมูลเกี่ยวกับวิธีการติดตั้ง Commerce SDK และไลบรารีโมดูล ดูที่ ตั้งค่าสภาพแวดล้อมการพัฒนา
ขั้นตอนการติดตั้ง
การติดตั้งธีม Adventure Works ในโปรแกรมประยุกต์ของคุณ
แพคเกจธีม Adventure Works พร้อมใช้งานในฟีด dynamics365-commerce เช่น @msdyn365-commerce-theme/adventureworks-theme-kit อย่างไรก็ตาม แม้ว่าแพคเกจธีม Adventure Works จะเป็นส่วนหนึ่งของฟีดนั้น แต่อยู่ภายใต้ชื่ออื่น ดังนั้น คุณต้องปฏิบัติตามขั้นตอนต่อไปนี้เพื่อเพิ่มรายการทะเบียนสำหรับชื่อ
อัปเดตไฟล์ .npmrc เพื่อให้มีรายการทะเบียนต่อไปนี้ (ถ้ายังไม่ได้รวมรายการ):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/อัปเดตไฟล์ .yarnrc เพื่อให้มีรายการทะเบียนต่อไปนี้ (ถ้ายังไม่ได้รวมรายการ):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
เมื่อต้องการติดตั้งแพคเกจในสภาพแวดล้อมเฉพาะที่ของคุณ ให้เรียกใช้คำสั่ง yarn add THEME_PACKAGE@VERSION จากพร้อมท์คำสั่ง โดยที่ THEME_PACKAGE เป็นแพคเกจชุดรูปแบบ (@msdyn365-commerce-theme/adventureworks-theme-kit) และ VERSION เป็นหมายเลขรุ่นของไลบรารีโมดูลที่ถูกใช้อยู่ รุ่นของแพคเกจชุดรูปแบบและไลบรารีโมดูลต้องตรงกัน เมื่อต้องการค้นหาหมายเลขรุ่นของไลบรารีโมดูลที่ถูกต้องที่จะใช้ ให้เปิดไฟล์ package.json และระบุค่า starter-pack ในส่วน การขึ้นต่อกัน ในตัวอย่างต่อไปนี้ ไฟล์ package.json จะใช้รุ่น 9.32 ของไลบรารีโมดูลซึ่งแมปไปยังรีลีส Dynamics 365 Commerce รุ่น 10.0.22
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
ตัวอย่างต่อไปนี้แสดงวิธีการเรียกใช้คำสั่ง yarn add เพื่อเพิ่มรุ่น 9.32 ของธีม Adventure Works คำสั่งดังกล่าวจะอัปเดตไฟล์ package.json โดยอัตโนมัติ เพื่อให้รวมการขึ้นต่อกัน
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
สำหรับข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดตรุ่นของไลบรารีโมดูล ดูที่ การอัปเดต SDK และไลบรารีโมดูล
สำคัญ
- รุ่นธีมควรตรงกับรุ่นไลบรารีโมดูลเพื่อให้แน่ใจว่าคุณลักษณะทั้งหมดจะทำงานตามที่คาดไว้
- รุ่นขั้นต่ำของไลบรารีโมดูล Commerce และ SDK ควรเป็น 10.0.20 (9.31)
เพิ่มไฟล์แบบอักษรของธีม Adventure Works
หลังจากที่ติดตั้งธีม Adventure Works ในแอปของคุณแล้ว คุณต้องเพิ่มไฟล์แบบอักษรที่ใช้ได้กับธีมนี้ เมื่อต้องการขั้นตอนนี้ให้สมบูรณ์ ให้คัดลอกไฟล์แบบอักษรทั้งหมดจาก \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts ไปยังพาธไดเรกทอรีสาธารณะของโปรแกรมประยุกต์คู่ค้า \public\webfonts
ตั้งค่าทรัพยากรของธีม Adventure Works
ขั้นตอนต่อไปคือการอัปเดตทรัพยากรเริ่มต้นที่ต้องใช้ในธีม เมื่อต้องการขั้นตอนนี้ให้สมบูรณ์ ให้คัดลอกเนื้อหาจากไฟล์ global.json ภายใต้ \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules ไปยังไฟล์ global.json ของโปรแกรมประยุกต์คู่ค้าภายใต้ \src\resources\modules ถ้าไม่มีไดเรกทอรีเป้าหมาย \src\resources อยู่ จะสามารถคัดลอกได้ทั้งหมดจากไดเรกทอรีต้นทาง \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks ไปยังไดเรกทอรีเป้าหมาย \src
ดึงข้อมูลการอัปเดตและตรวจสอบความถูกต้องของธีม
สำหรับข้อมูลเกี่ยวกับวิธีการดึง SDK ไลบรารีโมดูล และการอัปเดตการดำเนินการที่เชื่อมโยงกันอื่นๆ ดูที่ส่วน "ดึงการอัปเดต" ของ SDK และการอัปเดตไลบรารีโมดูล
หลังจากดึงการดำเนินการที่เชื่อมโยงกันล่าสุดแล้ว คุณสามารถรันคำสั่ง yarn start เพื่อเริ่มต้นเซิร์ฟเวอร์โหนดในสภาพแวดล้อมการพัฒนาของคุณ และทดสอบชุดธีม Adventure Works ใหม่ได้ เลือกดูโปรแกรมประยุกต์เฉพาะที่โดยใช้พารามิเตอร์สตริงการสอบถาม ?theme=adventureworks (ตัวอย่างเช่น https://localhost:4000/?theme=adventureworks)