หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
บทความนี้อธิบายวิธีการติดตั้งธีม Adventure Works ใน Microsoft Dynamics 365 Commerce
สำคัญ
ธีมและมอดูล Adventure Works พร้อมให้ใช้งานเริ่มต้นด้วยการเผยแพร่ Dynamics 365 Commerce เวอร์ชัน 10.0.20 คุณสามารถรับได้จาก Microsoft Marketplace
Prerequisites
ก่อนที่คุณจะติดตั้งธีม Adventure Works คุณต้องแน่ใจว่าคุณมีสภาพแวดล้อมแบบ Dynamics 365 Commerce (Commerce เวอร์ชัน 10.0.20 หรือใหม่กว่า) ที่มี Retail Cloud Scale Unit (RCSU) ชุดการพัฒนาซอฟต์แวร์ออนไลน์ Commerce (SDK) และไลบรารีโมดูล Commerce สําหรับข้อมูลเกี่ยวกับวิธีการติดตั้ง Commerce SDK และโมดูลไลบรารี ดูตั้งค่าสภาพแวดล้อมการพัฒนา
ขั้นตอนการติดตั้ง
การติดตั้งธีม Adventure Works ในโปรแกรมประยุกต์ของคุณ
ฟีดข้อมูล dynamics365-commerce มีชุดธีม Adventure Works เป็น @msdyn365-commerce-theme/adventureworks-theme-kit อย่างไรก็ตาม แพคเกจใช้เนมสเปซที่แตกต่างกัน ดังนั้น คุณต้องเพิ่มรายการรีจิสทรีสําหรับ namespace
ปรับปรุงแฟ้ม .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/adventureworks-theme-kit) และ เวอร์ชัน ด้วยหมายเลขเวอร์ชันของไลบรารีโมดูลที่คุณกําลังใช้ ตรวจสอบให้แน่ใจว่าเวอร์ชันของแพคเกจธีมและไลบรารีโมดูลตรงกัน หากต้องการค้นหาหมายเลขเวอร์ชันของไลบรารีโมดูลที่ถูกต้อง ให้เปิดไฟล์ 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 และการอัปเดตไลบรารีโมดูล
หลังจากที่คุณดึงดูด dependencies ล่าสุด ให้เรียกใช้คำสั่ง yarn start เพื่อเริ่มเซิร์ฟเวอร์ Node ในสภาพแวดล้อมการพัฒนาของคุณและทดสอบธีม Adventure Works ใหม่ เลือกดูโปรแกรมประยุกต์เฉพาะที่โดยใช้พารามิเตอร์สตริงการสอบถาม ?theme=adventureworks (ตัวอย่างเช่น https://localhost:4000/?theme=adventureworks)