Χρήση παραμέτρων σε αναφορές

Άρθρο
03/22/2023

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

Σημείωμα

Το μέγιστο μήκος για τις τιμές των παραμέτρων που μεταβιβάζονται από το Microsoft Dynamics 365 Customer Engagement (on-premises) είναι 2000 χαρακτήρες. Για παράδειγμα, εάν μπορείτε να εκτελέσετε μια αναφορά και να δημιουργήσετε ένα φίλτρο δεδομένων μέσω του περιβάλλοντος εργασίας χρήστη Πρόσθετα κριτήρια εύρεσης, η παράσταση φίλτρου που προκύπτει και μεταβιβάζεται σε μια παράμετρο φίλτρου δεν είναι δυνατό να υπερβαίνει τους 2000 χαρακτήρες. Δεν υπάρχει μέγιστο όριο στον αριθμό των παραμέτρων που μπορείτε να ορίσετε. Ωστόσο, ίσως χρειαστεί να περιορίσετε το μήκος της συμβολοσειράς στη γραμμή διεύθυνσης URL και τον αριθμό των παραμέτρων για να ανταποκριθείτε στις απαιτήσεις ενός συγκεκριμένου προγράμματος περιήγησης.

Προσθήκη παραμέτρων

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

Το <ReportParameter> είναι ένα στοιχείο στο αρχείο ορισμού αναφοράς (RDL) που χρησιμοποιείται για την περιγραφή μιας μεμονωμένης παραμέτρου στην αναφορά. Το <QueryParameter> περιέχει πληροφορίες για μια μεμονωμένη παράμετρο που διαβιβάζεται στο αρχείο προέλευσης δεδομένων ως μέρος ενός ερωτήματος. Ο παρακάτω κώδικας XML που προέρχεται από την αρχείο σύνοψης λογαριασμού RDL της αναφοράς δείχνει πώς να χρησιμοποιήσετε τις παραμέτρους ReportParameter και QueryParameter.

<ReportParameter Name="CRM_FilteredAccount">  
  <DataType>String</DataType>  
    <Nullable>true</Nullable>  
    <DefaultValue>  
      <Values>  
         <Value>select * from FilteredAccount</Value>  
      </Values>  
    </DefaultValue>  
    <AllowBlank>true</AllowBlank>  
    <Prompt>CRM_FilteredAccount</Prompt>  
</ReportParameter>

<Query>  
   <rd:UseGenericDesigner>true</rd:UseGenericDesigner>  
   <CommandText>declare @sql as nVarchar(max)  
      set @sql = '  
      SELECT top 10 CAST(accountid as nvarchar(100)) as AccountID,  
      name, '''' as None  
      FROM (' + @FilteredAccount + ') as fa'  
      exec(@sql)  
   </CommandText>  
   <QueryParameters>  
      <QueryParameter Name="@FilteredAccount">  
         <Value>=Parameters!FilteredAccount.Value</Value>  
      </QueryParameter>  
   </QueryParameters>  
   <DataSourceName>CRM</DataSourceName>  
</Query>

Τα παρακάτω παραδείγματα δείχνουν πώς μπορείτε να χρησιμοποιήσετε τις παραμέτρους QueryParameter και ReportParameter σε μια αναφορά που βασίζεται σε Fetch.

<ReportParameter Name="FilteredAccount">  
      <DataType>String</DataType>  
      <Prompt>Filtered Account</Prompt>  
            <DefaultValue>  
                  <Values>  
                        <Value>  
                              <fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false">  
                              <entity name="account">  
                              <all-attributes/>  
                              </entity>  
                              </fetch>  
                        </Value>  
                  </Values>  
            </DefaultValue>  
    </ReportParameter>

<Query>  
        <DataSourceName>DataSource1</DataSourceName>  
        <CommandText>  
                  <fetch>   
                  <entity name="account" enableprefiltering="true" prefilterparametername="FilteredAccount">  
                  <attribute name="accountid" />  
                  <attribute name="name" />  
                  </entity>  
                  </fetch>  
            </CommandText>  
        <QueryParameters>  
          <QueryParameter Name="FilteredAccount">  
            <Value>=Parameters!FilteredAccount.Value</Value>  
          </QueryParameter>  
        </QueryParameters>  
        <rd:UseGenericDesigner>true</rd:UseGenericDesigner>  
      </Query>

Κρυφές παράμετροι

Η σχεδίαση αναφορών στο Visual Studio διαθέτει ενσωματωμένη υποστήριξη για κρυφές παραμέτρους. Επιπλέον, μπορείτε να αποκρύψετε παραμέτρους, προσθέτοντας ένα πρόθεμα CRM_ στο όνομα παραμέτρου σε μια αναφορά. Από προεπιλογή, οι παράμετροι με πρόθεμα CRM_ αποκρύπτονται όταν δημοσιεύετε την αναφορά. Κατά την εκτέλεση της αναφοράς, δεν θα σας ζητηθεί να καταχωρήσετε τιμές παραμέτρων για τις κρυφές παραμέτρους.

Ειδικές παράμετροι

Ο παρακάτω πίνακας εμφανίζει τις ειδικές κρυφές παραμέτρους που μπορείτε να χρησιμοποιήσετε στις αναφορές σας.

Παράμετρος	Περιγραφή
`CRM_FilterText`	Περιέχει την τιμή του κειμένου φίλτρου που ένας χρήστης αναφοράς δημιουργεί αλληλεπιδραστικά στην προβολή αναφορών, όταν ο χρήστης εκτελεί μια αναφορά. Η παράμετρος είναι ένα πλαίσιο κειμένου σύνοψης φίλτρου που βρίσκεται στην κεφαλίδα της αναφοράς. Η αρχική τιμή ορίζεται στο προεπιλεγμένο φίλτρο.
`CRM_URL`	Ορίζεται στη διεύθυνση URL της εφαρμογής. Χρησιμοποιήστε αυτήν την παράμετρο όταν κάνετε ανάλυση.
`CRM_FilteredEntity`	Χρησιμοποιήστε σε μια παράσταση ερωτήματος για να ενεργοποιήσετε το προ-φιλτράρισμα δεδομένων (μέσω του στοιχείου Πρόσθετα κριτήρια εύρεσης).

Πρέπει να δημιουργήσετε όλες τις παραμέτρους σε μια αναφορά για να μπορείτε να τις συμβουλεύεστε. Οι τιμές αυτών των ειδικών παραμέτρων συμπληρώνονται από το Customer Engagement (on-premises) κατά την εκτέλεση της αναφοράς.

Πρόσθετες παράμετροι μορφής

Ο παρακάτω πίνακας περιέχει επιπλέον παραμέτρους παραμέτρους που μπορείτε να χρησιμοποιήσετε στις αναφορές σας. Μεταξύ τους είναι παράμετροι που παρέχουν πρόσβαση σε πληροφορίες ρυθμίσεων αριθμού χρήστη. Μπορείτε να χρησιμοποιήσετε αυτές τις τιμές για τη διαμόρφωση και την εμφάνιση των αριθμητικών τιμών. Αυτές οι παράμετροι είναι παρόμοιες με τις τιμές που καθορίζονται στο NumberFormatInfo Class. Χρησιμοποιήστε αυτές τις παραμέτρους στις προσαρμοσμένες αναφορές για να μορφοποιήσετε τα δεδομένα σύμφωνα με τις ρυθμίσεις του χρήστη.

Παράμετρος	Περιγραφή
`CRM_FullName`	Το πλήρες όνομα του χρήστη για λογαριασμό του οποίου εκτελείται η αναφορά.
`CRM_UserTimeZone`	Όνομα ζώνης ώρας του χρήστη, για παράδειγμα, χειμερινή ώρα Ειρηνικού.
`CRM_UILanguageId`	Τρέχουσα τοπική ρύθμιση (LCID) του χρήστη.
`CRM_YearStartWeekCode`	Η πρώτη εβδομάδα του έτους που χρησιμοποιείται στις εφαρμογές Dynamics 365 for Customer Engagement.
`CRM_WeekStartDayCode`	Η πρώτη ημέρα της εβδομάδας που χρησιμοποιείται στο Customer Engagement.
`CRM_FiscalCalendarStart`	Η ημερομηνία έναρξης του οικονομικού έτους που χρησιμοποιείται στο Customer Engagement.
`CRM_FiscalPeriodType`	Καθορίζει τον τρόπο διαίρεσης του οικονομικού έτους — τριμηνιαία, μηνιαία, ετήσια και ούτω καθεξής.
`CRM_FiscalYearDisplayCode`	Καθορίζει εάν το όνομα του οικονομικού έτους θα εμφανίζεται με βάση την ημερομηνία έναρξης ή την ημερομηνία λήξης του.
`CRM_FiscalYearPeriodConnect`	Καθορίζει τον τρόπο με τον οποίο θα πρέπει να συνδέονται τα ονόματα του οικονομικού έτους και της οικονομικής περιόδου όταν εμφανίζονται μαζί.
`CRM_FiscalYearFormat`	Καθορίζει τον τρόπο που θα εμφανιστεί το όνομα του οικονομικού έτους.
`CRM_FiscalPeriodFormat`	Καθορίζει το πώς θα εμφανίζεται η οικονομική περίοδος.
`CRM_FiscalYearPrefixFormat`	Καθορίζει αν θα επισυνάπτεται ένα πρόθεμα για το οικονομικό έτος μέχρι να προβληθεί.
`CRM_FiscalYearSuffixFormat`	Καθορίζει αν θα επισυνάπτεται ένα επίθημα για το οικονομικό έτος μέχρι να προβληθεί.
`CRM_CurrencyDecimalPrecision`	Η ακρίβεια δεκαδικού νομίσματος.
`CRM_CurrencySymbol`	Σύμβολο νομίσματος για τον οργανισμό.
`CRM_CurrencyPositivePattern`	Το μοτίβο μορφής για τις θετικές νομισματικές τιμές.
`CRM_CurrencyNegativePattern`	Το μοτίβο μορφής για τις αρνητικές νομισματικές τιμές.
`CRM_NumberDecimalDigits`	Ο αριθμός των δεκαδικών ψηφίων που θα χρησιμοποιήσετε σε αριθμητικές τιμές.
`CRM_NumberDecimalSeperator`	Η συμβολοσειρά που χρησιμοποιείται ως υποδιαστολή σε αριθμητικές τιμές.
`CRM_NumberNegativePattern`	Το μοτίβο μορφής για τις αρνητικές αριθμητικές τιμές.
`CRM_NumberGroupSizes`	Ο αριθμός των ψηφίων σε κάθε ομάδα προς τα αριστερά της υποδιαστολής σε αριθμητικές τιμές.
`CRM_NumberGroupSeperator`	Η συμβολοσειρά που διαχωρίζει ομάδες ψηφίων προς τα αριστερά της υποδιαστολής σε αριθμητικές τιμές.
`CRM_DateSeparator`	Η συμβολοσειρά που διαχωρίζει τα στοιχεία μιας ημερομηνίας, όπως το έτος, το μήνα και την ημέρα.
`CRM_TimeSeparator`	Η συμβολοσειρά που διαχωρίζει τα στοιχεία του χρόνου, όπως ώρα, λεπτά και δευτερόλεπτα.
`CRM_AMDesignator`	Η συμβολοσειρά που διαχωρίζει τα στοιχεία του χρόνου, όπως ώρα, λεπτά και δευτερόλεπτα
`CRM_PMDesignator`	Το Προσδιοριστικό για τις ώρες που είναι "post meridiem" (μ.μ.).
`CRM_ShortDatePattern`	Το μοτίβο μορφής για μια τιμή σύντομης ημερομηνίας που σχετίζεται με το μοτίβο μορφής "d".
`CRM_LongDatePattern`	Το μοτίβο μορφής για μια τιμή πλήρους ημερομηνίας που σχετίζεται με το μοτίβο μορφής "D".
`CRM_ShortTimePattern`	Το μοτίβο μορφής για μια τιμή σύντομου χρόνου που σχετίζεται με το μοτίβο μορφής "t".
`CRM_MonthDayPattern`	Το μοτίβο μορφής για τις τιμές μήνα και ημέρας που σχετίζονται με τα μοτίβα μορφής "m" και "M".

Δείτε επίσης

Οδηγός αναφοράς και ανάλυσης
Δημοσίευση αναφορών

Κοινή χρήση μέσω