Amazon Q Embedding Developer Business intelligence service
ເງື່ອນໄຂເບື້ອງຕົ້ນ
- ບັນຊີ AWS ທີ່ມີ QuickSight Q ຖືກເປີດໃຊ້
- ຢ່າງໜ້ອຍໜຶ່ງຫົວຂໍ້ທີ່ຕັ້ງດ້ວຍ QuickSight Q (ແລະ id ຫົວຂໍ້ຂອງຫົວຂໍ້ນັ້ນ)
- ເຊດຊັນ QuickSight ຝັງການຕິດຕັ້ງກອບກັບບັນຊີ AWS
- ກອງປະຊຸມສໍາລັບການນີ້: https://learnquicksight.workshop.aws/en/session-embedding.html
- ໃຫ້ແນ່ໃຈວ່າອະນຸຍາດໃຫ້ລາຍຊື່ໂດເມນຂອງທ່ານໃນຫນ້າຈັດການ QuickSight
ການກໍານົດຫົວຂໍ້ທີ່ຈະສະແດງ
ການຝັງ QuickSight Q ສະຫນັບສະຫນູນສອງກໍລະນີການນໍາໃຊ້ທີ່ແຕກຕ່າງກັນກ່ຽວກັບຫົວຂໍ້. ທໍາອິດແມ່ນເວລາທີ່ຫົວຂໍ້ດຽວຈະຖືກລະບຸ, ແລະພຽງແຕ່ຫົວຂໍ້ນັ້ນສາມາດຖືກສອບຖາມຜ່ານແຖບຄົ້ນຫາ. ອັນທີສອງແມ່ນປະສົບການມາດຕະຖານພາຍໃນຄໍາຮ້ອງສະຫມັກ QuickSight, ບ່ອນທີ່ຜູ້ໃຊ້ມີບັນຊີລາຍຊື່ຂອງຫົວຂໍ້ແລະສາມາດນໍາໃຊ້ແບບເລື່ອນລົງໃນແຖບຄົ້ນຫາເພື່ອເລືອກຫົວຂໍ້ທີ່ພວກເຂົາຕ້ອງການສອບຖາມ. ກ່ອນທີ່ຈະດໍາເນີນການ, ໃຫ້ແນ່ໃຈວ່າທ່ານຮູ້ວ່າກໍລະນີການນໍາໃຊ້ຂອງທ່ານຮຽກຮ້ອງໃຫ້ມີຫົວຂໍ້ຫນຶ່ງ, ຫຼືບັນຊີລາຍຊື່ຂອງຫົວຂໍ້ໃນປະສົບການຝັງ.
ອະນຸຍາດລາຍຊື່ໂດເມນ
ຕາມຄໍາແນະນໍາການຝັງ QuickSight, ທ່ານຈະສັງເກດເຫັນວ່າທ່ານຕ້ອງການອະນຸຍາດໃຫ້ລາຍຊື່ໂດເມນຂອງແອັບພລິເຄຊັນຂອງທ່ານໃນຫນ້າ 'ຈັດການ QuickSight'. ໂດຍປົກກະຕິ, ນີ້ແມ່ນທັງຫມົດທີ່ທ່ານຈໍາເປັນຕ້ອງເຮັດ, ແຕ່ໃນກໍລະນີຂອງ Q ພວກເຮົາຍັງຈະຕ້ອງເພີ່ມໂດເມນ QuickSight ເຂົ້າໃນບັນຊີລາຍຊື່ອະນຸຍາດ. ນີ້ເບິ່ງຄືວ່າແປກ, ແຕ່ເນື່ອງຈາກວ່າພາຍໃຕ້ການ hood Q ຍັງໃຊ້ iframe, ພວກເຮົາຕ້ອງການ, ຢ່າງຫນ້ອຍສໍາລັບໃນປັດຈຸບັນ, ອະນຸຍາດໃຫ້ລາຍຊື່ໂດເມນ 'ດຽວກັນ'. ໂດເມນ QuickSight ທີ່ທ່ານຕ້ອງການລາຍຊື່ອະນຸຍາດແມ່ນຂຶ້ນກັບພາກພື້ນທີ່ທ່ານກໍາລັງໃຊ້. ຕົວຢ່າງample, ຝັງໂດຍໃຊ້ພາກພື້ນ `us-east-1′, ຂອງພວກເຮົາ URL ບັນຊີລາຍຊື່ອະນຸຍາດຈະເປັນ:
https://us-east-1.quicksight.aws.amazon.com
ໄດ້ URL ຈະຄືກັນສໍາລັບພາກພື້ນອື່ນໆ, ກັບພາກສ່ວນພາກພື້ນທີ່ກ່ຽວຂ້ອງ (us-east-1) ມີການປ່ຽນແປງ.
ກຳລັງສ້າງເຊດຊັນໃໝ່ URL
ກ່ອນອື່ນ ໝົດ ແມ່ນພາກສ່ວນຂອງກອບການຝັງທີ່ສ້າງເຊດຊັນ URL ຜ່ານ getSessionEmbedURL API ຕ້ອງໄດ້ຮັບການດັດແກ້ເລັກນ້ອຍ. ການຝັງເຊດຊັນ QuickSight Q ແມ່ນຮອງຮັບໃນ 'ຈຸດເຂົ້າ' ທີ່ແຕກຕ່າງຈາກປະສົບການການຝັງຄອນໂຊນມາດຕະຖານ. ເອກະສານສໍາລັບ API ນີ້ສາມາດເປັນ ພົບຢູ່ທີ່ນີ້. ພາຣາມິເຕີຈຸດເຂົ້າສໍາລັບການເອີ້ນ API ນີ້ຈະຕ້ອງມີການປ່ຽນແປງ – ຈຸດເຂົ້າໃຫມ່ແມ່ນຂຶ້ນກັບກໍລະນີການນໍາໃຊ້ຫົວຂໍ້. ສໍາລັບກໍລະນີຫົວຂໍ້ດຽວ:
entry-point = /q/search/<topicId>
ເພື່ອສະແດງຫົວຂໍ້ທັງໝົດໃນຕົວເລືອກ, ພວກເຮົາຈະຍົກເລີກຫົວຂໍ້:
entry-point = /q/search
ອັນນີ້ຄວນສ້າງການຮັບຮອງຄວາມຖືກຕ້ອງຄັ້ງດຽວ URL ທີ່ຈະສະແດງຫນ້າພຽງແຕ່ແຖບຄົ້ນຫາ QuickSight Q.
ໃຊ້ JS SDK ເພື່ອຝັງ
ກັບ URL, ພວກເຮົາສາມາດໃຊ້ QuickSight Embedding Javascript SDK ທີ່ສະໜອງໃຫ້ເພື່ອຝັງແຖບຊອກຫາ Q ໃນແອັບພລິເຄຊັນ. ຫນ້າທໍາອິດ, ໃຫ້ແນ່ໃຈວ່າທ່ານມີ ສຳເນົາ SDK ຈາກທີມງານ QuickSight - ສັງເກດວ່ານີ້ແມ່ນກ່ອນview ຄຸນນະສົມບັດແລະບໍ່ໄດ້ຖືກປ່ອຍອອກມາຍັງ, SDK ຈະເປັນສະບັບທີ່ແຕກຕ່າງກັນກ່ວາທີ່ສາທາລະນະ SDK ໃນ github. ພວກເຮົາຈະຕ້ອງການໃຊ້ວິທີການ EmbedSession ຈາກ SDK ກັບເຊດຊັນທີ່ສ້າງຂຶ້ນ URL. ຕົວເລືອກທີ່ກ່ຽວຂ້ອງສໍາລັບຟັງຊັນ embedSession ແມ່ນ (ຍັງພົບເຫັນຢູ່ໃນ types.js ໃນ SDK):
url: url of the session or dashboard to embed container: parent html element or query selector string errorCallback: callback when error occurs loadCallback: callback when visualization data load complete className: optional className to be given to iframe element isQEmbedded: embeddable object is Q search bar flag maxHeightForQ: height for Q to resize to when it expands onQBarOpenCallback: optional callback for Q search bar open onQBarCloseCallback: optional callback for Q search bar close
ການໂຕ້ຖຽງທີ່ຕ້ອງການສອງອັນນີ້ແມ່ນ url ແລະຕູ້ຄອນເທນເນີ. ພວກເຮົາຈະໃຊ້ URL ສ້າງຂຶ້ນຈາກ getSessionEmbedURL ການໂທ API, ແລະສໍາລັບບັນຈຸນີ້ແມ່ນຂຶ້ນກັບຄໍາຮ້ອງສະຫມັກຂອງທ່ານ. ທ່ານຈະຕ້ອງການຢ່າງຫນ້ອຍທີ່ງ່າຍດາຍ ເປັນ 'container' ສໍາລັບ iframe ຝັງ; ໃຫ້ບັນຈຸນີ້ໃສ່ id ແລະຜ່ານ id ໃນ arguments SDK. ເຊດຊັນເລີ່ມຕົ້ນທີ່ຝັງການເອີ້ນຄືນ, errorCallback ແລະ loadCallback ເຮັດຕາມທີ່ຊື່ອາດຈະແນະນໍາ - ຖ້າທ່ານ
ຕ້ອງການພຶດຕິກໍາທີ່ກໍາຫນົດເອງໃນເວລາທີ່ຫນ້າຝັງຕິດໂຫຼດ, ຫຼືພົບຄວາມຜິດພາດ, ລະບຸເຫດຜົນໃນການໂທກັບຄືນໄປບ່ອນເຫຼົ່ານີ້. ເມື່ອໃຊ້ໂຫມດຝັງ Q ກັບ SDK, iframe ຈະເປັນຄວາມສູງຄົງທີ່ (ຄວາມສູງຂອງແຖບຄົ້ນຫາຕົວມັນເອງ) ແລະຄວາມກວ້າງ 100% ຂອງຕົວບັນຈຸ HTML ຫຼັກ. ນີ້ຫມາຍຄວາມວ່າແຖບຄົ້ນຫາພຽງແຕ່ຈະກວ້າງເທົ່າກັບຖັງ; ທ່ານຕ້ອງການໃຫ້ແນ່ໃຈວ່າແຖບຄົ້ນຫາມີຄວາມກວ້າງຢ່າງຫນ້ອຍ 600px (ບໍ່ວ່າຈະແປຈາກ view- width/percenttage ຫຼືມອບຫມາຍໂດຍກົງ). ສໍາລັບການຈັດຮູບແບບ iframe, ພາລາມິເຕີ className ສາມາດຖືກກໍານົດເປັນທາງເລືອກເຊັ່ນກັນ.
ສຳຄັນ:
A callout ທີ່ສໍາຄັນຢູ່ທີ່ນີ້ແມ່ນເພື່ອເຮັດໃຫ້ແນ່ໃຈວ່າໄດ້ ຫຼືອົງປະກອບທີ່ທ່ານກໍາລັງຖ່າຍທອດເປັນອົງປະກອບ html ບັນຈຸມີຮູບແບບຂອງ 'ຕໍາແຫນ່ງ: absolute'. ນີ້ແມ່ນສິ່ງທີ່ອະນຸຍາດໃຫ້ແຖບຄົ້ນຫາຂະຫຍາຍເປັນການຊ້ອນກັນແທນທີ່ຈະປ່ຽນເນື້ອຫາຂອງແອັບຯຂອງທ່ານລົງ.
QuickSight Q ການປ່ຽນແປງການຝັງ
ມີຄວາມແຕກຕ່າງທີ່ສໍາຄັນຈໍານວນຫນຶ່ງລະຫວ່າງການຝັງ session / dashboard ແລະການຝັງແຖບຄົ້ນຫາ Q (ເຖິງແມ່ນວ່າໃນປັດຈຸບັນ Q embedding ພຽງແຕ່ໃຊ້ session embedding). ດ້ວຍການຝັງ dashboard ແລະ session, ກອບໂດຍທົ່ວໄປແມ່ນຂະຫນາດດຽວ, ຂັດຂວາງການປັບຂະຫນາດໂດຍອີງໃສ່ຂະຫນາດຂອງ dashboard ຫຼືແຜ່ນການວິເຄາະ. ດ້ວຍ Q, ໃນເບື້ອງຕົ້ນກອບທີ່ຝັງຢູ່ໃນຫນ້າຂອງທ່ານແມ່ນຂ້ອນຂ້າງນ້ອຍ (ພວກເຮົາຕ້ອງການໃຫ້ແຖບຄົ້ນຫາຕົວຈິງສະແດງໃຫ້ເຫັນ). ເມື່ອແຖບຄົ້ນຫາຖືກໃຊ້, ກອບນີ້ຕ້ອງການຂະຫຍາຍ (ເພື່ອສະແດງອົງປະກອບແບບເລື່ອນລົງເພີ່ມເຕີມເຊັ່ນ: ຜົນໄດ້ຮັບທາງສາຍຕາ, ຄໍາແນະນໍາ, ແລະອື່ນໆ). ເພື່ອຂະຫຍາຍຂອບນີ້ໂດຍບໍ່ມີການປ່ຽນເນື້ອໃນຂອງແອັບພລິເຄຊັນຂອງທ່ານ, ພວກເຮົາພຽງແຕ່ຕັ້ງມັນເປັນການວາງຊ້ອນເທິງຫນ້າທີ່ມີຢູ່, ຄ້າຍຄືກັບວິທີທີ່ແຖບຄົ້ນຫາເຮັດວຽກຢູ່ໃນແອັບພລິເຄຊັນ QuickSight ໃນມື້ນີ້ - ເບິ່ງພາບຫນ້າຈໍຂ້າງລຸ່ມນີ້.
ມີພຽງເລັກນ້ອຍກ່ຽວກັບວິທີການຝັງ Q ເຮັດວຽກຢູ່ໃນໃຈ, ໃຫ້ພວກເຮົາເບິ່ງຕົວກໍານົດການ SDK ສະເພາະ QuickSight Q. ທໍາອິດ, ພວກເຮົາຈະຕ້ອງການ isQEmbedded ເພື່ອຖືກກໍານົດເປັນຄວາມຈິງ. maxHeightForQ ແມ່ນການໂຕ້ຖຽງທາງເລືອກທີ່ກໍານົດທີ່ໃຫຍ່ທີ່ສຸດທີ່ກອບ Q ສາມາດຢູ່ໃນຫນ້າຂອງທ່ານ; ດັ່ງທີ່ໄດ້ກ່າວມາກ່ອນຫນ້ານີ້, ພວກເຮົາຈະຕ້ອງການ iframe ແລະມັນບັນຈຸເພື່ອຂະຫຍາຍເນື້ອຫາຂອງຫນ້າ. ພວກເຮົາສາມາດໃຊ້ maxHeightForQ argument ເພື່ອຮັບປະກັນວ່າກອບ/container ບໍ່ໄດ້ປັບຂະໜາດເກີນຄວາມສູງສູງສຸດຂອງໜ້າຂອງທ່ານແລະເຮັດໃຫ້ການເລື່ອນປະກົດຂຶ້ນ ຫຼືພຶດຕິກຳທີ່ບໍ່ຕ້ອງການອື່ນໆ. ຖ້າບໍ່ໄດ້ຕັ້ງ, ກອບ Q ຈະປັບຂະຫນາດເປັນ 100vh.
ສອງຕົວກໍານົດການສະເພາະ Q ສຸດທ້າຍແມ່ນການເອີ້ນຄືນທີ່ເກີດຂຶ້ນເມື່ອກອບທີ່ຝັງຢູ່ປັບຂະຫນາດ. ພຶດຕິກຳເລີ່ມຕົ້ນແມ່ນເພື່ອສ້າງອົງປະກອບສາກຫຼັງ, ແລະໃຊ້ອັນນີ້ເພື່ອໃຫ້ພາບພື້ນຫຼັງທີ່ມືດກວ່າທີ່ພວກເຮົາເຫັນໃນຮູບໜ້າຈໍຂ້າງເທິງຈາກແອັບພລິເຄຊັນ QuickSight. ນີ້ແມ່ນການທໍາງານຂອງ 'ນອກກ່ອງ' ທີ່ພວກເຮົາຕ້ອງການທີ່ຈະສະຫນອງເພື່ອເຮັດໃຫ້ການຝັງ Q ງ່າຍທີ່ສຸດເທົ່າທີ່ເປັນໄປໄດ້ – ຢ່າງໃດກໍຕາມ, ພວກເຮົາຮູ້ວ່ານີ້ຈະບໍ່ເຮັດວຽກສໍາລັບທຸກຄໍາຮ້ອງສະຫມັກທີ່ Q ຈໍາເປັນຕ້ອງໄດ້ຝັງຢູ່ໃນ. override ພຶດຕິກໍານີ້, ພຽງແຕ່ຂຽນເຫດຜົນເຂົ້າໄປໃນ onQBarOpenCallback ແລະ onQBarCloseCallback. ນີ້ຈະເປັນການປ້ອງກັນບໍ່ໃຫ້ສາກຫຼັງເລີ່ມຕົ້ນຈາກການສະແດງຂຶ້ນເຊັ່ນກັນ.
QuickSight Q ຕົວເລືອກການຈັດຮູບແບບ
ມີຕົວເລືອກຄໍເຕົ້າໄຂ່ທີ່ / ເຄື່ອງສໍາອາງຈໍານວນຫນ້ອຍທີ່ພວກເຮົາສາມາດໃຊ້ເພື່ອປັບແຕ່ງຮູບລັກສະນະຂອງແຖບຄົ້ນຫາ Q.
qBarIconDisabled: option to hide the Q search bar
qBarTopicNameDisabled: option to hide the Q search bar topic name
themeId: option to apply Quicksight theme to Q search bar
ຖ້າທ່ານຕ້ອງການປິດການໃຊ້ງານໄອຄອນ `Q' (ຢູ່ເບື້ອງຊ້າຍຂອງແຖບຄົ້ນຫາ, ໃຫ້ໃຊ້ຕົວກໍານົດການ qBarIconDisabled. ເຊັ່ນດຽວກັນ, ເພື່ອປິດການທໍາງານຂອງຊື່ຫົວຂໍ້, ຖ້າທ່ານພຽງແຕ່ສະແດງຫົວຂໍ້ດຽວໃນໂຫມດຝັງ, ໃຫ້ໃຊ້ qBarTopicNameDisabled. ໃຫ້ສັງເກດວ່າການປັບແຕ່ງເຄື່ອງສໍາອາງເຫຼົ່ານີ້ແມ່ນມີພຽງແຕ່ສໍາລັບກໍລະນີໃນເວລາທີ່ທ່ານຝັງຫົວຂໍ້ດຽວ.
ຖ້າທ່ານຕ້ອງການໃສ່ຫົວຂໍ້ແຖບ Q ທີ່ຝັງໄວ້ເພື່ອເຮັດໃຫ້ຮູບລັກສະນະທີ່ສອດຄ່ອງກັບຄໍາຮ້ອງສະຫມັກຂອງທ່ານ, ທ່ານສາມາດເຮັດໄດ້ໂດຍການສ້າງຫົວຂໍ້ໃຫມ່ໃນ QuickSight ແລະສົ່ງ themeId ໄປ SDK (ເຊັ່ນ:ample ຂ້າງລຸ່ມນີ້).
Examples
ຕໍ່ໄປນີ້ examples ຈະສົມມຸດວ່າມີ container ທີ່ມີຢູ່ໃນ DOM ທີ່ມີ id `q-bar-container'.
ການຝັງກັບພຶດຕິກຳສາກຫຼັງເລີ່ມຕົ້ນ (ດ້ວຍເສັ້ນທາງການຊອກຫາ q/)
ໃຫ້ສົມມຸດວ່າບັນຈຸມີຂອບເທິງສຸດຂອງ 75px, ດັ່ງນັ້ນພວກເຮົາຈະຄິດໄລ່ການນໍາໃຊ້ພາລາມິເຕີ maxHeightForQ, ດັ່ງນັ້ນ iframe ບໍ່ຂະຫຍາຍໃຫຍ່ກວ່າຫນ້າທີ່ອະນຸຍາດໃຫ້, ການສ້າງແຖບເລື່ອນຫຼືພຶດຕິກໍາທີ່ບໍ່ຕ້ອງການອື່ນໆ.
function embedQSession(embedUrl) {
var containerDiv = document.getElementById("q-bar-container");
containerDiv.innerHTML = "";
var params = {
url: embedUrl, container: containerDiv,
isQEmbedded: true,
maxHeightForQ: "calc(100vh - 75px)",
};
QuickSightEmbedding.embedSession(params);
}
ຝັງກັບພຶດຕິກຳພື້ນຫຼັງທີ່ພິການ (ດ້ວຍ q/search path)
ສໍາລັບນີ້ example ພວກເຮົາຈະສົມມຸດວ່າບັນຈຸແມ່ນຢູ່ເທິງສຸດຂອງຫນ້າເພື່ອໃຫ້ມັນສາມາດຂະຫຍາຍໄດ້ເຖິງ 100% ໂດຍບໍ່ມີບັນຫາ; ພວກເຮົາຈະບໍ່ຕ້ອງການ maxHeightForQ. ພວກເຮົາຈະໃຊ້ onQBarOpenCallback ແລະ onQBarCloseCallback ເປັນຟັງຊັນ no-op ເພື່ອປ້ອງກັນບໍ່ໃຫ້ສາກຫຼັງເລີ່ມຕົ້ນປາກົດ.
function embedQSession(embedUrl) { var containerDiv = document.getElementById("q-bar-container"); containerDiv.innerHTML = "";
var params = {
url: embedUrl, container: containerDiv,
isQEmbedded: true,
onQBarOpenCallback: () => {},
onQBarCloseCallback: () => {},
};
QuickSightEmbedding.embedSession(params);
}
ຝັງກັບພຶດຕິກຳສາກຫຼັງແບບກຳນົດເອງ (ດ້ວຍ q/search path)
ອີກເທື່ອຫນຶ່ງພວກເຮົາຈະສົມມຸດວ່າບັນຈຸແມ່ນຢູ່ເທິງສຸດຂອງຫນ້າເພື່ອໃຫ້ມັນສາມາດຂະຫຍາຍໄດ້ 100% ໂດຍບໍ່ມີບັນຫາ; ພວກເຮົາຈະບໍ່ຕ້ອງການ maxHeightForQ. ພວກເຮົາຈະໃຊ້ onQBarOpenCallback ແລະ onQBarCloseCallback ເປັນການເອີ້ນຄືນທີ່ຈັດການອົງປະກອບສາກຫຼັງອື່ນໆ (customBackdropComponent) ໃນແອັບພລິເຄຊັນຂອງພວກເຮົາທີ່ພວກເຮົາຕ້ອງການໃຊ້ແທນຄ່າເລີ່ມຕົ້ນ. ກະລຸນາຮັບຊາບວ່າ backdrop backs ຂອງທ່ານອາດຈະສັບສົນຫຼາຍ, example ແມ່ນພຽງແຕ່ສໍາລັບຄວາມງ່າຍດາຍ.
function onQBarOpen() {
customBackdropComponent.style.height = "100%";
}
function onQBarClose() {
customBackdropComponent.style.height = 0;
}
function embedQSession(embedUrl) {
var containerDiv = document.getElementById("q-bar-container");
containerDiv.innerHTML = "";
var params = {
url: embedUrl,
container: containerDiv,
isQEmbedded: true,
onQBarOpenCallback: () => {},
onQBarCloseCallback: () => {},
};
QuickSightEmbedding.embedSession(params);
}
ການຝັງກັບພຶດຕິກຳສາກຫຼັງເລີ່ມຕົ້ນ (ດ້ວຍເສັ້ນທາງ q/search/topicId)
ພວກເຮົາຈະສົມມຸດວ່າກ່ອງບັນຈຸມີຂອບເທິງສຸດຂອງ 75px, ດັ່ງນັ້ນພວກເຮົາຈະຄິດໄລ່ມັນໂດຍໃຊ້ພາລາມິເຕີ maxHeightForQ, ດັ່ງນັ້ນ iframe ບໍ່ຂະຫຍາຍໃຫຍ່ກວ່າຫນ້າທີ່ອະນຸຍາດໃຫ້, ສ້າງແຖບເລື່ອນຫຼືພຶດຕິກໍາທີ່ບໍ່ຕ້ອງການອື່ນໆ. ເນື່ອງຈາກພວກເຮົາກໍາລັງໃຊ້ແຖບຄົ້ນຫາທີ່ຝັງຢູ່ໃນຫົວຂໍ້ດຽວ, ພວກເຮົາສາມາດນໍາໃຊ້ການປັບແຕ່ງ qBarIconDisabled ແລະ qBarTopicNameDisabled. ນີ້ example ຈະໃຫ້ພວກເຮົາແຖບຄົ້ນຫາທີ່ບໍ່ມີໄອຄອນຫຼືຊື່ຫົວຂໍ້, ກໍານົດໃຫ້ພ້ອມທີ່ຈະສອບຖາມກ່ຽວກັບຫົວຂໍ້ໃດກໍ່ຕາມທີ່ຜ່ານເຂົ້າ.
function embedQSession(embedUrl) {
var containerDiv = document.getElementById(“q-bar-container”);
containerDiv.innerHTML = “”;
var params = {
url: ຝັງUrl,
container: containerDiv,
isQEbedded: ຈິງ,
maxHeightForQ: “calc(100vh – 75px)”,
qBarIconDisabled: false,
qBarTopicNameDisabled: false,
};
QuickSightEmbedding.embedSession(params);
}
ການຝັງດ້ວຍ ID ຮູບແບບສີສັນ
ສ້າງຮູບແບບສີສັນໃໝ່ພາຍໃນ QuickSight ຖ້າເຈົ້າບໍ່ມີ. ເປີດການວິເຄາະ, ຫຼືສ້າງອັນໃຫມ່. ເລືອກຮູບແບບສີສັນຢູ່ເບື້ອງຊ້າຍ.
ແລະຫຼັງຈາກນັ້ນເລືອກເອົາຫນຶ່ງໃນຫົວຂໍ້ເລີ່ມຕົ້ນທີ່ທ່ານຕ້ອງການຫຼັງຈາກນັ້ນໃຫ້ຄລິກໃສ່ "ບັນທຶກເປັນ". ຖ້າທ່ານມີຫົວຂໍ້ຢູ່ແລ້ວ, ທ່ານອາດຈະຂ້າມຂັ້ນຕອນການສ້າງຫົວຂໍ້.
ມັນຈະພາທ່ານໄປທີ່ຫນ້າບັນນາທິການຮູບແບບ, ໃຫ້ຊື່ມັນ, ປັບສີຕາມທີ່ທ່ານຕ້ອງການຈາກນັ້ນບັນທຶກໄວ້ໃນດ້ານຂວາເທິງ.
ໃນປັດຈຸບັນທີ່ທ່ານມີຫົວຂໍ້, ທ່ານຈໍາເປັນຕ້ອງຊອກຫາ id ຂອງຫົວຂໍ້ນັ້ນແລະສົ່ງໄປທີ່ SDK. ເລືອກ "ແກ້ໄຂ" ໃນຫົວຂໍ້ທີ່ທ່ານສ້າງ.
ມັນອີກເທື່ອຫນຶ່ງຈະນໍາທ່ານໄປຫາຫນ້າບັນນາທິການຫົວຂໍ້, ແຕ່ເວລານີ້, ທ່ານຈະພົບເຫັນຫົວຂໍ້ຫົວຂໍ້ຢູ່ໃນ url ບາ. ໃນກໍລະນີນີ້ "d39c0065bf69-4b3d-927b-9dd3a241f094" ແມ່ນ id ຂອງຫົວຂໍ້ທີ່ຂ້ອຍສ້າງ.
ສຸດທ້າຍ, ທ່ານຜ່ານ id ຮູບແບບສີສັນເປັນພາລາມິເຕີໄປຫາ SDK, ຫຼັງຈາກນັ້ນທ່ານຈະໄດ້ຮັບແຖບ Q ທີ່ມີຫົວຂໍ້ຢູ່ໃນແອັບຯຂອງທ່ານ.
function embedQSession(embedUrl) {
var containerDiv = document.getElementById(“q-bar-container”);
containerDiv.innerHTML = “”;
var params = {
url: ຝັງUrl,
container: containerDiv,
isQEbedded: ຈິງ,
maxHeightForQ: “calc(100vh – 75px)“,
qBarIconDisabled: false,
qBarTopicNameDisabled: false,
ຫົວຂໍ້ຫົວຂໍ້: “d39c0065-bf69-4b3d-927b-9dd3a241f094”
};
QuickSightEmbedding.embedSession(params);
}
ອົງປະກອບຮູບແບບສີສັນ
ພວກເຮົາຕ້ອງການສະແດງໃຫ້ທ່ານເຫັນອົງປະກອບໃດພາຍໃນ Q bar ສາມາດເປັນຫົວຂໍ້, ແລະພວກເຮົາຈະເອົາຫົວຂໍ້ QuickSight Midnight ເປັນ ex.ample (ທ່ານສາມາດຊອກຫາມັນຢູ່ໃນຫົວຂໍ້ເລີ່ມຕົ້ນ)
ການແກ້ໄຂບັນຫາ
'ປະຕິເສດທີ່ຈະກອບ *.quicksight.aws.amazon.com ເນື່ອງຈາກວ່າບັນພະບຸລຸດລະເມີດ..' ຄວາມຜິດພາດ
ຄວາມຜິດພາດນີ້ແມ່ນເກີດມາຈາກການບໍ່ອະນຸຍາດໃຫ້ລາຍຊື່ໂດເມນຂອງທ່ານໃນໜ້າການຈັດການ QuickSight admin ໃນແອັບພລິເຄຊັນ QuickSight. ໃຫ້ແນ່ໃຈວ່າອະນຸຍາດໃຫ້ລາຍຊື່ທັງໂດເມນ QuickSight ພາກພື້ນ (ສໍາລັບ us-east-1, ນີ້ແມ່ນ https://us-east-1.quicksight.aws.amazon.com , ສໍາລັບການຍົກຕົວຢ່າງample), ເຊັ່ນດຽວກັນກັບໂດເມນຂອງແອັບພລິເຄຊັນຂອງທ່ານ.
ບໍ່ສາມາດເບິ່ງແຖບຄົ້ນຫາໄດ້ຫຼັງຈາກຝັງສຳເລັດແລ້ວ
ຖ້າທ່ານສາມາດສ້າງແລະເຂົ້າເຖິງແລະການຝັງເຊື່ອມຕໍ່ຢ່າງສໍາເລັດຜົນ (ໂດຍບໍ່ມີການອະນຸຍາດຫຼືຄວາມຜິດພາດທີ່ຊັດເຈນອື່ນໆ), ແຕ່ໄດ້ຮັບຫນ້າຈໍ 'ເປົ່າ' ທີ່ບໍ່ມີແຖບຄົ້ນຫາປາກົດ, ມີບາງສິ່ງທີ່ຕ້ອງກວດສອບ. ອັນຫນຶ່ງແມ່ນວ່າຕ້ອງມີຢ່າງຫນ້ອຍຫນຶ່ງຫົວຂໍ້ທີ່ແບ່ງປັນກັບຜູ້ໃຊ້ທີ່ທ່ານກໍາລັງຝັງຢູ່. ອັນທີສອງ, ທ່ານຕ້ອງການໃຫ້ແນ່ໃຈວ່າມີຢ່າງຫນ້ອຍຫນຶ່ງຫົວຂໍ້ທີ່ຖືກສ້າງຂື້ນຢ່າງສໍາເລັດຜົນແລະຢູ່ໃນສະຖານະ 'ສົບຜົນສໍາເລັດ' ຫຼັງຈາກການກໍ່ສ້າງໃນເບື້ອງຕົ້ນ. ວິທີທີ່ງ່າຍທີ່ຈະທົດສອບນີ້ແມ່ນພຽງແຕ່ໃຊ້ຫົວຂໍ້ໃນ Q ໃນແອັບພລິເຄຊັນ QuickSight; ຖ້າມັນເຮັດວຽກຕາມປົກກະຕິ, ມັນດີທີ່ຈະໃຊ້ໃນຮູບແບບຝັງ.
ເຫດຜົນອີກຢ່າງໜຶ່ງທີ່ແຖບຊອກຫາອາດຈະບໍ່ປະກົດຂຶ້ນແມ່ນກ່ອງບັນຈຸ iframe ທີ່ຝັງຢູ່ໃນນັ້ນອາດຈະບໍ່ມີຄວາມກວ້າງພຽງພໍ. ດັ່ງທີ່ເອີ້ນໄວ້ໃນເອກະສານ, ທ່ານຕ້ອງການໃຫ້ແນ່ໃຈວ່າແຖບຄົ້ນຫາໄດ້ຮັບຢ່າງຫນ້ອຍ 600px ຂອງຄວາມກວ້າງເພື່ອໃຫ້ມັນເຮັດວຽກຕາມປົກກະຕິ.
ແຖບຄົ້ນຫາຂະຫຍາຍແຕ່ປ່ຽນເນື້ອຫາລົງ
ແຖບຄົ້ນຫາທີ່ມີ SDK ຖືກອອກແບບມາເພື່ອຂະຫຍາຍເນື້ອຫາເພີ່ມເຕີມໃນຫນ້າ. ຖ້ານີ້ບໍ່ແມ່ນກໍລະນີ, ກະລຸນາໃຫ້ແນ່ໃຈວ່າກ່ອງບັນຈຸແຖບຄົ້ນຫາ ຖືກຈັດຮູບແບບດ້ວຍ 'ຕຳແໜ່ງ: ຢ່າງແທ້ຈິງ', ເຊິ່ງຈະເຮັດໃຫ້ມັນບໍ່ປ່ຽນເນື້ອໃນຂອງໜ້າລົງ. ຕົວຢ່າງample:
<div id="q-search-container" style="position: absolute; width: 100%"></div>
ບັນທຶກການປ່ຽນແປງການແກ້ໄຂ SDK
- V1(5/15/21): SDK ແບບກຳນົດເອງໃນເບື້ອງຕົ້ນ `Q-ready'
- V1.1 (5/25/21)
- ປ່ຽນຄວາມສູງ iframe ເພື່ອແກ້ໄຂກັບຄວາມສູງຂອງແຖບຄົ້ນຫາຕົວມັນເອງ, ຜູ້ໃຊ້ບໍ່ສາມາດລະບຸໃນໂຫມດ Q
- ຕັ້ງຄວາມກວ້າງ iframe ເປັນ 100% ຂອງຕົວບັນຈຸຫຼັກສຳລັບໂໝດ Q. ໃຫ້ສັງເກດວ່າຄວາມກວ້າງຂອງແຖບຄົ້ນຫາຍັງສາມາດຖືກຈໍາກັດໂດຍຂະຫນາດຂອງຖັງຕົ້ນຕໍ.
- V1.1 (5/25/21)
ເອກະສານ / ຊັບພະຍາກອນ
![]() |
Amazon Q Embedding Developer Business intelligence service [pdf] ຄູ່ມືຜູ້ໃຊ້ Q Embedding Developer Business intelligence service, Developer Business intelligence service, ການບໍລິການທາງປັນຍາ |