Πληροφορίες για την ανάπτυξη συστατικών στοιχείων

Η ανάπτυξη των δικών σας προσαρμοσμένων συστατικών στοιχείων σάς επιτρέπει να αναπτύξετε σύνθετα στοιχεία που μπορούν να ενσωματωθούν στη σελίδα τοποθεσίας, με χρήση οποιασδήποτε τεχνολογίας σελίδων της επιλογής σας. Αυτό ουσιαστικά σας επιτρέπει να επεκτείνετε τη λίστα με τα συστατικά στοιχεία που παρέχονται με το Oracle Content Management.

Οι καταχωρίσεις για όλα τα εγγεγραμμένα συστατικά στοιχεία αποθηκεύονται στον Κατάλογο συστατικών στοιχείων, ο οποίος είναι ένας φάκελος στο Oracle Content Management που περιέχει τις καταχωρίσεις για όλα τα εγγεγραμμένα συστατικά στοιχεία.

Μη χρησιμοποιείτε τα παρακάτω ονόματα για πρότυπα, θέματα, συστατικά στοιχεία, τοποθεσίες ή σελίδες τοποθεσίας: authsite, content, pages, scstemplate_*, _comps, _components, _compsdelivery, _idcservice , _sitescloud, _sitesclouddelivery, _themes, _themesdelivery. Παρόλο που μπορείτε να χρησιμοποιήσετε τα παρακάτω ονόματα για σελίδες τοποθεσίας, δεν μπορείτε να τα χρησιμοποιήσετε για πρότυπα, θέματα, συστατικά στοιχεία ή τοποθεσίες: documents, sites.

Τύποι συστατικών στοιχείων

Ο Κατάλογος συστατικών στοιχείων υποστηρίζει αυτούς τους τύπους συστατικών στοιχείων:

Τοπικό συστατικό στοιχείο
Τοπικό συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαίσιο
Απομακρυσμένο συστατικό στοιχείο

Ο τύπος του συστατικού στοιχείου αποθηκεύεται ως χαρακτηριστικό επέκτασης, "xScsAppType", του φακέλου συστατικών στοιχείων. Ακολουθούν οι έγκυρες τιμές.

Τύπος	Περιγραφή
Τοπικό συστατικό στοιχείο	Όλες οι εξαρτήσεις αναμένονται να είναι τοπικές.
Τοπικό συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαίσιο	Το συστατικό στοιχείο εξυπηρετείται από τον ίδιο τομέα με το Oracle Content Management.
Απομακρυσμένο συστατικό στοιχείο	Το συστατικό στοιχείο εξυπηρετείται από απομακρυσμένη θέση.

Δομή αρχείου συστατικού στοιχείου

Κάθε ένας από τους τύπους συστατικών στοιχείων έχει ένα διαφορετικό σύνολο αρχείων όταν δημιουργείται στον Κατάλογο συστατικών στοιχείων, με βάση τον τρόπο υλοποίησής του.

Τοπικό συστατικό στοιχείο:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    assets
        settings.html
        render.js

Τοπικό συστατικό στοιχείο που χρησιμοποιεί ενσωματωμένο πλαίσιο:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    assets
        settings.html
        render.js
        js
            sites.min.js
            knockout.min.js
            jquery.min.js

Απομακρυσμένο συστατικό στοιχείο:

/Components/component-name
    appinfo.json
    _folder_icon.jpg
    keys.json

Μεταδεδομένα φακέλου

Τα δεδομένα εγγραφής συστατικού στοιχείου αποθηκεύονται στα μεταδεδομένα φακέλου. Οι ακόλουθες ιδιότητες χρησιμοποιούνται για τη μοναδικό ταυτοποίηση του συστατικού στοιχείου και του τύπου του.

Ιδιότητα	Περιγραφή
όνομα εφαρμογής	Το όνομα του φακέλου που προσδιορίζει το όνομα του συστατικού στοιχείου.
περιγραφή εφαρμογής	Περιγραφή του φακέλου.
guid εφαρμογής	Κάθε συστατικό στοιχείο είναι συσχετισμένο με ένα GUID και αποθηκεύεται ως χαρακτηριστικό επέκτασης `xScsItemGUID`. Το GUID δημιουργείται από τον server κατά τη δημιουργία του συστατικού στοιχείου.
τύπος εφαρμογής	Ιδιότητα που προσδιορίζει τον τύπο συστατικού στοιχείου. Αποθηκεύεται ως χαρακτηριστικό επέκτασης `xScsApType`.

Σημείωση:

Η ιδιότητα iconUrl, που αποθηκεύεται ως χαρακτηριστικό επέκτασης xScsAppIconUrl, έχει καταργηθεί.

Αρχείο appinfo.json

Το αρχείο εγγραφής appinfo.json για κάθε τύπο συστατικού στοιχείου περιέχει μόνο δεδομένα που δεν είναι διαθέσιμα στα μεταδεδομένα φακέλου. Οι ιδιότητες συστατικού στοιχείου που ορίζονται στα μεταδεδομένα φακέλου δεν αναπαράγονται στο αρχείο appinfo.json .

Τοπικό συστατικό στοιχείο:

{
        "settingsData":{
                "settingsHeight":80,
                "settingsRenderOption"; "dialog",
                "settingsWidth":300,
                "componentLayouts":[],
                "triggers":[],
                "actions":[]
        },
        "initialData":{
                "customSettingsData":[],
        }
}

Τοπικό συστατικό στοιχείο που αποδίδεται σε ένα ενσωματωμένο πλαίσιο:

{
        "endpoints": {
              "settings": {
                      "height": "300",
                      "width": "400"
              }
        }
        "initialData": {
                "customSettingsData": {}
        }
}

Απομακρυσμένο συστατικό στοιχείο:

{
        "endpoints": {
              "widget": {
                     "url": "http://www.externaldomain.com/app/render.html"
              }
              "settings": {
                      "url": "http://www.externaldomain.com/app/settings.html",
                      "height": "300",
                      "width": "400"
              }
        }
        "initialData": {
              "customSettingsData": {}
        }
}

Δεν υπάρχουν εγγεγραμμένες τιμές "url" για τοπικά συστατικά στοιχεία. Χρησιμοποιούν συγκεκριμένα αρχεία που μπορούν να υποστούν επεξεργασία για το περιεχόμενο, αλλά δεν μπορείτε να αλλάξετε τη θέση ή το όνομα.

Τα τοπικά συστατικά στοιχεία χρησιμοποιούν τα αρχεία assets/render.js και assets/settings.html.
Τα τοπικά συστατικά στοιχεία που αποδίδεται σε ένα ενσωματωμένο πλαίσιο χρησιμοποιήστε τα αρχεία assets/render.html και assets/settings.html.
Τα απομακρυσμένα συστατικά στοιχεία χρησιμοποιούν οποιεσδήποτε τιμές "url" έχουν καθοριστεί.