Ορίστε το προσαρμοσμένο κανάλι
Ισχύοντα κανάλια: SMS, προσαρμοσμένο
Τώρα που έχετε ορίσει τα τμήματα του προσαρμοσμένου καναλιού σας, είναι ώρα να καθορίσετε το κανάλι. Αυτό το βήμα είναι το σημείο στο οποίο συνδέετε όλα τα προηγούμενα στοιχεία σε ένα αρχείο μετα-δεδομένων, το οποίο είναι μια καρτέλα της οντότητας Ορισμός καναλιών (msdyn_channeldefinition
).
Σημαντικό
Εάν ρυθμίζετε καρτέλες μετα-δεδομένων απευθείας στο αρχείο προσαρμογής, βεβαιωθείτε ότι τα GUID είναι με πεζά γράμματα.
Σύμβαση ορισμού καναλιού
Λογικό όνομα οντότητας: msdyn_channeldefinition
Καθορισμένο όνομα οντότητας: msdyn_channeldefinitions
Όνομα χαρακτηριστικού πρωτεύοντος αναγνωριστικού: msdyn_channeldefinitionid
- msdyn_displayname: συμβολοσειρά - Προαιρετικό. Εμφανιζόμενο όνομα του καναλιού.
- msdyn_description: συμβολοσειρά - Προαιρετικό. Περιγραφή του καναλιού.
- msdyn_channeltype: συμβολοσειρά - Υποχρεωτικό. Υποστηριζόμενες τιμές: Προσαρμοσμένο, SMS.
- msdyn_outboundendpointurltemplate: συμβολοσειρά – Υποχρεωτικό. Το όνομα του προσαρμοσμένου API για τη ροή εξερχομένων.
- msdyn_hasinbound: bit - Υποχρεωτικό. Δυαδική τιμή που υποδεικνύει αν το κανάλι υποστηρίζει εισερχόμενα μηνύματα.
- msdyn_hasdeliveryreceipt: bit - Υποχρεωτικό. Δυαδική τιμή που υποδεικνύει αν το κανάλι υποστηρίζει απόδειξη παράδοσης.
- msdyn_supportsaccount: bit - Υποχρεωτικό. Δυαδική τιμή που υποδεικνύει αν το κανάλι υποστηρίζει ρύθμιση παραμέτρων σε επίπεδο λογαριασμού. Για SMS, πρέπει να είναι true. Διαφορετικά, false.
- msdyn_channeldefinitionexternalentity: συμβολοσειρά - Υποχρεωτικό. Το όνομα της οντότητας CDS, που αντιπροσωπεύει μια εκτεταμένη ρύθμιση παραμέτρων της παρουσίας του καναλιού.
- msdyn_channeldefinitionexternalformid: GUID - Υποχρεωτικό. Το αναγνωριστικό της φόρμας που θα αποδοθεί για την εμφάνιση της ρύθμισης παραμέτρων του πίνακα παρουσίας εκτεταμένου καναλιού.
- msdyn_channeldefinitionaccountexternalentity: συμβολοσειρά - Προαιρετικό. Το όνομα της οντότητας CDS, που αντιπροσωπεύει μια εκτεταμένη ρύθμιση παραμέτρων του λογαριασμού παρουσίας του καναλιού.
- msdyn_channeldefinitionaccountexternalformid: συμβολοσειρά - Προαιρετικό. Το αναγνωριστικό της φόρμας που θα αποδοθεί για την εμφάνιση της ρύθμισης παραμέτρων του πίνακα λογαριασμού εκτεταμένου καναλιού.
- msdyn_messageformid: GUID - Προαιρετικό. Καθορίζει μια φόρμα που αντιπροσωπεύει το πρόγραμμα επεξεργασίας μηνυμάτων για το κανάλι.
Τα κανάλια ορίζονται στο customizations.xml ως στοιχεία λύσης. Τοποθετήστε κάθε msdyn_channeldefinition στα στοιχεία ImportExportXml>msdyn_channeldefinitions. Κάθε στοιχείο τμήματος μηνύματος msdyn_channeldefinition
πρέπει να περιλαμβάνει το δικό του μοναδικό αναγνωριστικό σε μορφή GUID ως το χαρακτηριστικού XML msdyn_channeldefinitionid. Όταν εισάγεται η λύση σας, δημιουργείται μια νέα γραμμή στον πίνακα msdyn_channeldefinition.
Στο παρακάτω παράδειγμα, προσέξτε ότι:
- Τα msdyn_channeldefinitionexternalentity και msdyn_channeldefinitionexternalformid περιέχουν το όνομα και το αναγνωριστικό φόρμας της οντότητας που δημιουργήσατε όταν ορίσατε την παρουσία καναλιού.
- Τα msdyn_channeldefinitionaccountexternalentity και msdyn_channeldefinitionaccountexternalformid περιέχουν το όνομα και το αναγνωριστικό φόρμας της οντότητας που δημιουργήσατε όταν ορίσατε τον λογαριασμό παρουσίας καναλιού.
- Το msdyn_messageformid περιέχει το αναγνωριστικό φόρμας που δημιουργήσατε, εάν έχετε ορίσει ένα προσαρμοσμένο πρόγραμμα επεξεργασίας μηνυμάτων.
- Το msdyn_outboundendpointurltemplate περιέχει το προσαρμοσμένο API που δημιουργήσατε όταν ορίσατε προσαρμοσμένα API.
Παράδειγμα customizations.xml συμπεριλαμβανομένου του ορισμού καναλιών:
<ImportExportXml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<msdyn_channeldefinitions>
<msdyn_channeldefinition msdyn_channeldefinitionid="af0c2a3c-85a5-43b3-84be-2a4a171249f3">
<msdyn_channeldefinitionaccountexternalentity>cr65f_samplechannelinstanceaccount</msdyn_channeldefinitionaccountexternalentity>
<msdyn_channeldefinitionaccountexternalformid>3071133f-1208-4dc1-8eba-4d4724961029</msdyn_channeldefinitionaccountexternalformid>
<msdyn_channeldefinitionexternalentity>cr65f_samplechannelinstance</msdyn_channeldefinitionexternalentity>
<msdyn_channeldefinitionexternalformid>7d2b885a-80eb-479d-b0c3-600bc41e9789</msdyn_channeldefinitionexternalformid>
<msdyn_channeltype>Custom</msdyn_channeltype>
<msdyn_description>Metadata definition for sample custom channel</msdyn_description>
<msdyn_displayname>Sample custom channel</msdyn_displayname>
<msdyn_hasdeliveryreceipt>0</msdyn_hasdeliveryreceipt>
<msdyn_hasinbound>0</msdyn_hasinbound>
<msdyn_messageformid>69723cfe-3835-4126-ab9a-a82a5b88c21d</msdyn_messageformid>
<msdyn_outboundendpointurltemplate>/cr65f_OutboundCustomApi</msdyn_outboundendpointurltemplate>
<msdyn_specialconsentrequired>0</msdyn_specialconsentrequired>
<msdyn_supportsaccount>0</msdyn_supportsaccount>
<msdyn_supportsattachment>0</msdyn_supportsattachment>
<msdyn_supportsbinary>0</msdyn_supportsbinary>
<statecode>0</statecode>
<statuscode>1</statuscode>
</msdyn_channeldefinition>
</msdyn_channeldefinitions>
</ImportExportXml>
Δείγματα λύσεων
Τα παρακάτω δείγματα περιλαμβάνουν αποσυμπιεσμένες λύσεις για Dataverse και έργα προσθηκών. Για να συσκευάσετε και να εισαγάγετε αυτές τις λύσεις, δημιουργήστε πρώτα το έργο προσθήκης. Το έργο αντιγράφει τη συγκρότηση στο έργο λύσης. Στη συνέχεια, συσκευάστε τη λύση χρησιμοποιώντας το Εργαλείο δημιουργίας πακέτου λύσεων.
Πώς να δημιουργήσετε το έργο προσθηκών και να συσκευάσετε τη λύση
Δημιουργήστε το έργο προσθηκών με το MSBuild ή το Visual Studio.
Η δημιουργία του έργου δημιουργεί ένα DLL στον φάκελο PluginAssemblies μέσα στον φάκελο λύσεων του Dataverse.
Συσκευάστε τον μη διαχειριζόμενο φάκελο με το Εργαλείο δημιουργίας πακέτου λύσεων χρησιμοποιώντας είτε:
- pac CLI (προτιμάται)
- Εργαλείο δημιουργίας πακέτου λύσεων
pac solution pack --zipfile C:\tmp\SampleCustomChannelSolution.zip -f src\Solutions\Samples\SampleCustomChannel\SampleCustomChannel.Solution\unmanaged --packagetype Both