Ενοποίηση εφαρμογών καμβά σε τοποθεσίες web και άλλες υπηρεσίες

Οι εφαρμογές που δημιουργείτε είναι συχνά πιο χρήσιμες όταν είναι διαθέσιμες ακριβώς εκεί όπου οι χρήστες εκτελούν τις εργασίες τους. Ενσωματώνοντας εφαρμογές καμβά σε ένα iframe, μπορείτε να ενσωματώσετε αυτές τις εφαρμογές σε τοποθεσίες Web και άλλες υπηρεσίες, όπως Power BI ή SharePoint.

Σε αυτό το θέμα, θα σας δείξουμε πώς να ορίσετε παραμέτρους για την ενσωμάτωση εφαρμογών και, στη συνέχεια, θα ενσωματώσουμε την εφαρμογή μας Asset Ordering σε μια τοποθεσία Web.

Σημείωση

• Μόνο χρήστες του Power Apps στον ίδιο μισθωτή μπορούν να έχουν πρόσβαση στην ενσωματωμένη εφαρμογή.
• Η ενσωμάτωση εφαρμογών καμβά σε εγγενή εφαρμογή επιφάνειας εργασίας δεν υποστηρίζεται. Με αυτόν τον τρόπο εξαιρούνται οι ενσωματώσεις πρώτου μέρους, όπως το Power Apps στο Teams).

Μπορείτε επίσης να ενσωματώσετε εφαρμογές καμβά στο SharePoint Online χωρίς να χρησιμοποιήσετε ένα iframe. Περισσότερες πληροφορίες: Χρήση του τμήματος web Power Apps.

Ορισμός παραμέτρων URI για την εφαρμογή σας

Εάν έχετε μια εφαρμογή που θέλετε να ενσωματώσετε, το πρώτο βήμα είναι να ορίσετε παραμέτρους για το Ενιαίο Αναγνωριστικό Πόρου (URI), ώστε το iframe να γνωρίζει πού να βρει την εφαρμογή. Το URI έχει την ακόλουθη μορφή:

https://apps.powerapps.com/play/[AppID]?source=iframe

Για χρήστες GCC

https://apps.gov.powerapps.us/play/[AppID]?source=iframe

Σημαντικό

Από τον Αύγουστο του 2019, η μορφή URI έχει αλλάξει από https://web.powerapps.com/webplayer σε https://apps.powerapps.com/play. Ενημερώστε τυχόν ενσωματωμένα iframe για να χρησιμοποιήσετε τη νέα μορφή URI. Οι αναφορές στην προηγούμενη μορφή θα ανακατευθύνονται στο νέο URI για τη διασφάλιση της συμβατότητας.

Προηγούμενη μορφή:

https://web.powerapps.com/webplayer/iframeapp?source=iframe&appId=/providers/Microsoft.PowerApps/apps/[AppID]

Το μόνο που χρειάζεται να κάνετε είναι να αντικαταστήσετε το αναγνωριστικό της εφαρμογής σας στη θέση του [AppID] στο URI (συμπεριλαμβανομένου του "[' & ']"). Θα σας δείξουμε πώς να λάβετε αυτή την τιμή, όμως πρώτα δείτε όλες τις διαθέσιμους παραμέτρους στο URI:

• [appID] - Παρέχει το αναγνωριστικό της εφαρμογής για εκτέλεση.
• tenantid - είναι μια προαιρετική παράμετρος που υποστηρίζει την πρόσβαση των επισκεπτών και καθορίζει από ποιον μισθωτή θα ανοίξει η εφαρμογή.
• screenColor - χρησιμοποιείται για να παρέχει μια καλύτερη εμπειρία φόρτωσης της εφαρμογής για τους χρήστες σας. Αυτή η παράμετρος έχει τη μορφή RGBA (τιμή κόκκινου, τιμή πράσινου, τιμή μπλε, άλφα) και ελέγχει το χρώμα οθόνης ενώ φορτώνει η εφαρμογή. Είναι προτιμότερο να οριστεί στο ίδιο χρώμα με το εικονίδιο της εφαρμογής σας.
• source - δεν επηρεάζει την εφαρμογή, προτείνουμε όμως να προσθέσετε ένα περιγραφικό όνομα για να αναφερθείτε στην προέλευση της ενσωμάτωσης.
• Τέλος, μπορείτε να προσθέσετε τυχόν προσαρμοσμένες παραμέτρους που θέλετε χρησιμοποιώντας τη συνάρτηση Param() και αυτές οι τιμές μπορούν να καταναλωθούν από την εφαρμογή σας. Προστίθενται στο τέλος του URI, όπως [AppID]?source=iframe&param1=value1&param2=value2. Αυτές οι παράμετροι είναι μόνο για ανάγνωση κατά την έναρξη της εφαρμογής. Εάν χρειάζεται να τις αλλάξετε, θα πρέπει να επανεκκινήσετε την εφαρμογή. Λάβετε υπόψη σας ότι μόνο το πρώτο στοιχείο μετά το [appid] θα πρέπει να έχει ένα "?". Μετά από αυτό χρησιμοποιήστε το "&", όπως απεικονίζεται εδώ.

Λήψη του αναγνωριστικού εφαρμογής

Το αναγνωριστικό εφαρμογής είναι διαθέσιμο στο powerapps.com. Για την εφαρμογή που θέλετε να ενσωματώσετε:

1. Στο powerapps.com, στην καρτέλα Εφαρμογές, κάντε κλικ ή πατήστε τα αποσιωπητικά ( . . . ) και, στη συνέχεια, επιλέξτε Λεπτομέρειες.

   

2. Αντιγράψτε το Αναγνωριστικό εφαρμογής.

   

3. Αντικαταστήστε την [AppID] τιμή στο URI. Για την εφαρμογή μας Asset Ordering, το URI μοιάζει ως εξής:

   https://apps.powerapps.com/play/76897698-91a8-b2de-756e-fe2774f114f2?source=iframe
   

Μπορεί να χρειαστεί να επιτρέψετε αναδυόμενα παράθυρα στο πρόγραμμα περιήγησης κατά την ενσωμάτωση μιας εφαρμογής στην τοποθεσία Web που χρησιμοποιεί τη συνάρτηση Launch() για την έναρξη μιας ιστοσελίδας ή μιας εφαρμογής.

Ενσωμάτωση της εφαρμογής σας σε μια τοποθεσία Web

Η ενσωμάτωση της εφαρμογής σας είναι τώρα τόσο εύκολη όσο η προσθήκη του iframe στον κώδικα HTML για την τοποθεσία σας (ή οποιαδήποτε άλλη υπηρεσία που υποστηρίζει iframes, όπως το Power BI ή το SharePoint):

<iframe width="[W]" height="[H]" src="https://apps.powerapps.com/play/[AppID]?source=website&screenColor=rgba(165,34,55,1)" allow="geolocation; microphone; camera"/>

Καθορίστε τιμές για το πλάτος και ύψος του iframe και αντικαταστήστε το αναγνωριστικό της εφαρμογής σας με το [AppID].

Σημείωση

Συμπεριλάβετε το allow="geolocation; microphone; camera" στον κώδικα HTML του iframe για να επιτρέψετε στις εφαρμογές σας να χρησιμοποιήσουν αυτές τις δυνατότητες στο Google Chrome.

Η παρακάτω εικόνα δείχνει την εφαρμογή Asset Ordering ενσωματωμένη σε ένα δείγμα τοποθεσίας Web της Contoso.

Έχετε υπόψη τα παρακάτω σημεία για τον έλεγχο ταυτότητας χρηστών της εφαρμογής σας:

• Εάν η τοποθεσία Web σας χρησιμοποιεί τον έλεγχο ταυτότητας του Microsoft Entra ID, δεν απαιτείται άλλη είσοδος.
• Εάν η τοποθεσία σας στο Web χρησιμοποιεί οποιονδήποτε άλλο μηχανισμό εισόδου ή δεν γίνεται έλεγχος ταυτότητας, οι χρήστες σας βλέπουν ένα μήνυμα εισόδου στο iframe. Αφού εισέλθουν, θα μπορούν να εκτελέσουν την εφαρμογή εφόσον ο συντάκτης της εφαρμογής την έχει μοιραστεί με αυτούς.

Όπως βλέπετε, η ενσωμάτωση εφαρμογών είναι απλή και πανίσχυρη. Η ενσωμάτωση σάς επιτρέπει να φέρνετε τις εφαρμογές ακριβώς εκεί που εργάζεστε εσείς και οι πελάτες σας: τοποθεσίες Web, πίνακες εργαλείων Power BI, σελίδες SharePoint και άλλα.

Σημείωση

Μπορείτε να μας πείτε ποια γλώσσα προτιμάτε για την τεκμηρίωση; Πάρτε μέρος σε μια σύντομη έρευνα. (σημειώνεται ότι αυτή η έρευνα είναι στα Αγγλικά)

Η έρευνα θα διαρκέσει περίπου επτά λεπτά. Δεν συλλέγονται προσωπικά δεδομένα (δήλωση προστασίας προσωπικών δεδομένων).