Inserting, Updating, and Dropping Members (XMLA)
Można użyć Wstawianie, Aktualizacja, and Upuść poleceń w języku XML for Analysis (XMLA) odpowiednio wstawiania, zaktualizować lub usunąć członków z zapisu wymiaru.Aby uzyskać więcej informacji na temat wymiary zapisu zobacz Write-Enabled Dimensions.
Wstawianie nowych członków
The Insert command inserts new members into specified attributes in a write-enabled dimension.
Przed konstruowania Insert polecenia, należy mieć następujące informacje dostępne dla nowych członków do wstawienia:
Wymiar, w którym chcesz wstawić nowe elementy.
Atrybut wymiaru, w którym chcesz wstawić nowe elementy.
Nazwy nowych członków, włączając w to wszelkich mających zastosowanie tłumaczenia nazwy.
Klucze nowych członków.Jeśli atrybut używa złożony klucz, klucz może wymagać wielu wartości.
Wartości dowolnej właściwości zastosowanie atrybut, które nie są implementowane jako innych atrybut w tym wymiarze.Takie właściwości atrybut obejmują jednoargumentowe operacji, tłumaczenia, niestandardowe pakiety zbiorcze, właściwości niestandardowe pakietu zbiorczego i pominięte poziomów.
The Insert command takes only two properties:
The Object właściwość, which contains an object reference for the dimension in which the members are to be inserted.Odwołanie do obiektu zawiera identyfikator bazy danych, identyfikator moduł i identyfikator wymiaru dla wymiaru.
The Attributes właściwość, which contains one or more atrybut elements to identify the attributes in which members are to be inserted.Każdy Attribute element członkowski identyfikuje atrybut i zapewnia nazwę, wartość, tłumaczenia, operator jednoargumentowy, zestawienie niestandardowe, właściwości niestandardowe pakietu zbiorczego i pominięto poziomów jeden składnik ma być dodany do określonego atrybut.
Uwaga
Wszystkie właściwości dla Attribute element musi być włączona. W przeciwnym razie może wystąpić błąd.
Aktualizowanie istniejących członków
The Update command updates existing members in specified attributes, based on relationships with other members in other attributes, in a write-enabled dimension.The Update command can move members to other levels in hierarchies contained by the dimension, and can be used to restructure parent-podrzędność hierarchies defined by parent attributes.
Przed konstruowania Update polecenia, powinien być dostępny dla elementów członkowskich należy zaktualizować następujące informacje:
Wymiar, w którym chcesz zaktualizować istniejące elementy członkowskie.
Atrybuty wymiaru, w którym chcesz zaktualizować istniejące elementy członkowskie.
Klucze istniejących członków.Jeśli atrybut używa złożony klucz, klucz może wymagać wielu wartości.
Wartości dowolnej właściwości zastosowanie atrybut, które nie są implementowane jako innych atrybut w tym wymiarze.Takie właściwości atrybut obejmują jednoargumentowe operacji, tłumaczenia, niestandardowe pakiety zbiorcze, właściwości niestandardowe pakietu zbiorczego i pominięte poziomów.
The Update command takes only three required properties:
The Object właściwość, which contains an object reference for the dimension in which the members are to be updated. Odwołanie do obiektu zawiera identyfikator bazy danych, identyfikator moduł i identyfikator wymiaru dla wymiaru.
The Attributes właściwość, which contains one or more Attribute elements to identify the attributes in which members are to be updated. The Attribute element członkowski identifies an atrybut and provides the name, value, translations, unary operator, zestawienie niestandardowe, zestawienie niestandardowe properties, and skipped levels for a single element członkowski updated for the identified atrybut.
Uwaga
Wszystkie właściwości dla Attribute element musi być włączona. W przeciwnym razie może wystąpić błąd.
The Where właściwość, which contains one or more Attribute elements that constrain the attributes in which members are to be updated. The Where właściwość is crucial to limiting an Update command to specific instances of a element członkowski. Jeśli Where Właściwość nie jest określony, wszystkie wystąpienia danego element członkowski są aktualizowane. Istnieją na przykład trzech klientów, dla którego chcesz zmienić nazwę miasta z Warszawa na Bellevue.Aby zmienić nazwę miasta, należy podać Where Właściwość określająca trzy elementy członkowskie w nabywcy atrybut dla których członkowie w mieście atrybut powinny być zmieniane. Jeśli nie zostanie określona ta Where właściwość każdego nabywcy, którego nazwa miasta jest obecnie Redmond miałyby nazwy miasta Bellevue po Update polecenie jest uruchamiane.
Uwaga
Z wyjątkiem nowych członków Update polecenie tylko może zaktualizować wartości klucz atrybut atrybuty nie są uwzględniane w Where Klauzula. Na przykład nie można zaktualizować nazwę miasta nabywcy po zaktualizowaniu; w przeciwnym razie zostanie zmieniona nazwa miasta dla wszystkich odbiorców.
Aktualizowanie elementów członkowskich w atrybuty obiektu nadrzędnego
Do obsługi atrybuty obiektu nadrzędnego, Update polecenie opcjonalny MoveWithDescendantsWłaściwości MovewithDescedants.Ustawianie MoveWithDescendants właściwość na wartość true wskazuje, że elementy potomne elementu nadrzędnego elementu członkowskiego również powinny zostać przeniesione z elementem nadrzędnym po zmianie identyfikatora tego element członkowski członkowski nadrzędnego. Jeśli ta wartość jest ustawiona na wartość false, przenoszenie nadrzędnego elementu członkowskiego powoduje bezpośrednie elementy podrzędne tego element członkowski członkowski nadrzędnego być podwyższony do poziom, w którym wcześniej znajdował się element członkowski nadrzędny.
Podczas aktualizowania członków z atrybut nadrzędnego Update polecenie nie może zaktualizować członków z innych atrybut.
Upuszczanie istniejące elementy członkowskie
Przed konstruowania Drop polecenia, należy mieć następujące informacje dostępne dla elementów członkowskich go usunąć:
Wymiar, w którym mają być umieszczane istniejących członków.
Atrybuty wymiaru, w którym mają być umieszczane istniejących członków.
Klucze istniejących składników do zostanie usunięty.Jeśli atrybut używa złożony klucz, klucz może wymagać wielu wartości.
The Drop command takes only two required properties:
The Object właściwość, which contains an object reference for the dimension in which the members are to be dropped. Odwołanie do obiektu zawiera identyfikator bazy danych, identyfikator moduł i identyfikator wymiaru dla wymiaru.
The Where właściwość, which contains one or more Attribute elements to constrain the attributes in which members are to be deleted. The Where właściwość is crucial to limiting a Drop command to specific instances of a element członkowski. Jeśli Where polecenie nie jest określony, wszystkie wystąpienia danego element członkowski są odrzucane. Istnieją na przykład trzech klientów, które chcesz usunąć z Warszawa.Aby usunąć tych nabywców, należy podać Where Właściwość identyfikująca trzy elementy członkowskie w atrybucie nabywca ma zostać usunięty z elementem Redmond atrybut Miasto, z którego mają zostać usunięte trzech klientów. Jeśli Where Właściwość określa tylko element członkowski członkowski Redmond atrybut Miasto, co odbiorcy skojarzony z Redmond czy zostanie usunięty Drop polecenie. Jeśli Where Właściwość określa tylko trzy elementy członkowskie w atrybucie klienta, trzech klientów, które będzie można usunąć całkowicie przez Drop polecenie.
Uwaga
The Attribute elements included in a Drop command must contain only the AttributeName and Keys properties.W przeciwnym razie może wystąpić błąd.
Upuszczanie elementów członkowskich w atrybuty obiektu nadrzędnego
Ustawianie DeleteWithDescendants właściwość wskazuje, że elementy podrzędne obiektu nadrzędnego element członkowski powinna również zostać usunięte z obiektu nadrzędnego element członkowski.Jeśli ta wartość jest zestaw na wartość false, bezpośrednie elementy podrzędne obiektu nadrzędnego elementu członkowskiego zamiast tego są podniesiony do poziom, w którym wcześniej znajdował się element członkowski nadrzędny.
Security Note: |
---|
Użytkownik musi tylko uprawnienia Usuń element członkowski nadrzędny usunąć składnik nadrzędny i jego elementy podrzędne.Użytkownik nie ma potrzeby usuwania uprawnień do obiektów podrzędnych. |