Engineer / Solution Architect / Dynamics 365-AX Technical Consultant / Instructor (MCT)

Merhaba

Ax 2012 ile finansal boyut yapısındaki bir çok değişiklikten eski yazılarımda bahsetmiştim. Boyut yapısındaki bu değişiklikler üzerine kodlarımızda boyutla işlem yapmamız gerektiğinde çok zorlanacağımız düşünmüştüm. Microsoft’taki arkadaşlarda aynı düşünceyi paylaşmışlar ki DimensionProvider sınıfını yazmışlar. Bu sınıf Query yapısında boyutla ilgili işlemleri yapmamızı kolaylaştırıyor ve bizi gereksiz bir çok Join ifadesinden kurtarıyor. Aşağıdaki örneği inceleyelim.

static void FD_AddDimensionRangeToCust(Args _args)
{
    Query                       query = new Query();
    QueryRun                    queryRun;
    QueryBuildDataSource        qbds;
    DimensionProvider           dimProvider = new DimensionProvider();
    CustTable                   custTable;
    ;

    qbds = query.addDataSource(tableNum(CustTable));

    dimProvider.addAttributeRangeToQuery(query, qbds.name(),
                        fieldStr(CustTable,DefaultDimension ),
                        DimensionComponent::DimensionAttribute,
                        "20",
                        "BusinessUnit", true );

    queryRun = new QueryRun(query);
    queryRun.prompt();

    while(queryRun.next())
    {
        CustTable = queryRun.get(tableNum(CustTable));
        info(strFmt("%1 ; %2 ; %3", CustTable.AccountNum ,
                    CustTable.name() , CustTable.DefaultDimension));
    }
}

Bu örnekte BusinessUnit boyutu 20 olan müşterileri listeleyen bir Query yazdım. DimensionProvider sınıfının bir çok metodu mevcut. İhtiyaç oldukça incelemek lazım.

Eski versiyonlarda bunu yazmak gayet  kolaydı çünkü boyut müşteri tablosunda dizi tipinde bir alan olarak bulunuyordu. Ax 2012′de ise tamamen farklı tablolarda tutulan bir veri artık. Bu yüzden 3-4 tablolu bir Join ifadesi yazmaktansa bu sınıfı kullanmak çok daha kolay.

Bu Query ifadesinin Select ile nasıl yazılabileceğini bir sonraki yazımda  ele alacağım.

Selamlar.

Merhaba

DefaultAccount DimensionAttributeValueCombination tablosunda LedgerDimensionType ‘ı  DefaultAccount olan kayıtlardır. MainAccount ile aslında çok bir farkı yok. Ancak benim anladığım bazı işlerde kolaylık olması açısından DefaultAccount kullanılıyor. AX 2009 ‘da LedgerAccount seçilen tanım formlarında ax 2012 ‘de MainAccount değilde DefaultAccount seçiliyor.

DefaultAccount için Segmented Entry Control kullanılıyor. Ancak sadece birinci kısmı yani MainAccount aktif. Boyut yapısı görünmüyor. Biz yeni bir tablo ve form oluşturup bu kontrolün nasıl eklenebileceğini bakalım. Adım adım ilerleyelim.

1. Öncelikle bir tablo yapalım ve EDT ‘si LedgerDimensionDefaultAccount olan  DefaultAccount isminde bir alan açalım. Bu işlemde EDT’yi tabloya sürüklediğinizde DimensionAttributeValueCombination tablosuyla ilişki kurmak için soru soracaktır. Bu ilişkinin kurulması şart. Eğer EDT ile ilgili bir sıkıntı çıkarsa elle de ekleyebilirsiniz.
2. Bir form yapalım ve veri kaynağına oluşturduğumuz tabloyu ekleyelim.
3. Tasarım kısmına bir Grid ekleyelim ve veri kaynağından DefaultAccount alanını sürükleyip Grid’e bırakalım. Otomatik olarak Segmented Entry Control oluşturulacaktır.
4. Kontrolün çalışabilmesi için biraz kod yazmamız gerekiyor. Formun ClassDecleration ve init metodlarına aşağıdaki kodları ekleyelim.

public class FormRun extends ObjectRun
{
   LedgerDimensionDefaultAccountController defaultAccountController;;
}

public void init()
{
    super();
    // hangi veri kaynağının hangi alanı için çalışacağını belirtiyoruz
    defaultAccountController =  LedgerDimensionDefaultAccountController::construct(
                   FDSegmentSEmple_DS, fieldstr(FDSegmentSEmple, DefaultAccount));
}

5. Veri kaynağındaki LedgerDimension alanına şu kodları ekleyelim

public Common resolveReference(FormReferenceControl _formReferenceControl)
{
    return defaultAccountController.resolveReference();
}

6. Grid altında oluşan Segmented Entry Control’e de şu kodları ekleyelim.

public void jumpRef()
{
    defaultAccountController.jumpRef();
}

public void loadAutoCompleteData(LoadAutoCompleteDataEventArgs _e)
{
    super(_e);
    defaultAccountController.loadAutoCompleteData(_e);
}

public void loadSegments()
{
    super();
    defaultAccountController.parmControl(this);
    defaultAccountController.loadSegments();
}

public void segmentValueChanged(SegmentValueChangedEventArgs _e)
{
    super(_e);
    defaultAccountController.segmentValueChanged(_e);
}

public boolean validate()
{
    boolean isValid;
    isValid = super();
    isValid = defaultAccountController.validate() && isValid;
    return isValid;
}

7. Şu anda kontrol hazır formu açtığınızda aşağıdaki gibi bir görüntü göreceksiniz.

Selamlar.

Merhaba

Ax 2012′ de bir diyaloğa boyut ekleyip geri dönüşünü alabilmek için şöyle bir kod yazdım.

static void FD_AddDimToDialog(Args _args)
{
    DialogFieldDimensionDefaultingController    dfDialogFieldDim;
    DimensionDefaultingFieldSet                 dimensions;
    Dialog                                      dialog;
    ;

    dialog = new dialog();

    dialog.caption("Diyaloğa boyut eklemek");
    dfDialogFieldDim = dialog.addDimensionDefaultingController();
    dfDialogFieldDim.initWithValues(false,false,true,0,"Boyutlar");

    if(dialog.run())
    {
        dfDialogFieldDim.save();
        dimensions = dfDialogFieldDim.value();

        info(strfmt("DimensionAttributeValueSet RecId = %1 ",dimensions[1]));
    }
}

DialogFieldDimensionDefaultingController sınıfında farklı metotlar mevcut. Bunlar incelenip ihtiyaca göre kullanılabilir. DimensionDefaultingFieldSet dizi tipinde bir EDT 3 elemanı var. diğer 2 elemanı sizin sınıfta kullandığınız metoda göre doluyor. Birinci elemanında DimensionAttributeValueSet tablosunun RecId ‘si var.

Selamlar.

Merhaba

Segmented Entry Control ax 2012 ile değişen finansal boyut yapısında hesap ve boyutları birlikte girebilme imkanı sağlayan bir yapıdır. Genel muhasebe günlüklerinde girişler bu şekilde yapılıyor. Bu yazımda yeni bir tablo ve form oluşturup bu kontrolün nasıl eklenebileceğini anlatacağım. Adım adım ilerleyelim.

1. Öncelikle bir tablo yapalım ve EDT ‘si LedgerDimensionAccount olan  LedgerDimension isminde bir alan açalım. Bu işlemde EDT’yi tabloya sürüklediğinizde DimensionAttributeValueCombination tablosuyla ilişki kurmak için soru soracaktır. Bu ilişkinin kurulması şart. Eğer EDT ile ilgili bir sıkıntı çıkarsa elle de ekleyebilirsiniz.
2. Bir form yapalım ve veri kaynağına oluşturduğumuz tabloyu ekleyelim.
3. Tasarım kısmına bir Grid ekleyelim ve veri kaynağından LedgerDimension alanını sürükleyip Grid’e bırakalım. Otomatik olarak Segmented Entry Control oluşturulacaktır.
4. Kontrolün çalışabilmesi için biraz kod yazmamız gerekiyor. Formun ClassDecleration ve init metodlarına aşağıdaki kodları ekleyelim.

public class FormRun extends ObjectRun
{
    LedgerDimensionAccountController ledgerDimensionAccountController;
}

public void init()
{
    super();
    // hangi veri kaynağının hangi alanı için çalışacağını belirtiyoruz
    ledgerDimensionAccountController =  LedgerDimensionAccountController::construct(
                                        FDSegmentSEmple_ds,
                                        fieldStr(FDSegmentSEmple,LedgerDimension));
}

5. Veri kaynağındaki LedgerDimension alanına şu kodları ekleyelim

public boolean validate()
{
    boolean ret;
    ret = super();
    ret = ledgerDimensionAccountController.validate() && ret;
    return ret;
}

public void jumpRef()
{
    super();
    ledgerDimensionAccountController.jumpRef();
}

public Common resolveReference(FormReferenceControl _formReferenceControl)
{
    return ledgerDimensionAccountController.resolveReference();
}

6. Grid altında oluşan Segmented Entry Control’e de şu kodları ekleyelim.

public void loadAutoCompleteData(LoadAutoCompleteDataEventArgs _e)
{
    super(_e);
    ledgerDimensionAccountController.loadAutoCompleteData(_e);
}

public void loadSegments()
{
    super();
    ledgerDimensionAccountController.parmControl(this);
    ledgerDimensionAccountController.loadSegments();
}

public void segmentValueChanged(SegmentValueChangedEventArgs _e)
{
    super(_e);
    ledgerDimensionAccountController.segmentValueChanged(_e);
}

7. Şu anda kontrol hazır formu açtığınızda aşağıdaki gibi bir görüntü göreceksiniz.

Üsteki oka tıkladığınızda ana hesap ve boyut yapısını görebilirsiniz.

Ana hesabı ve boyutları bir arada girebileceğiniz bir yapı oluştu. Burada girdiğiniz verilerden DimensionAttributeValueCombination tablosunda bir kayıt oluşturulur ve o kaydın RecId si oluşturduğumuz tablodaki LedgerDimension alanına yazılır. Tablodan baktığınızda sadece RecId görürsünüz ancak formdan baktığınızda bu kontrol sayesinde bütün veriyi görebilirsiniz. Bütün bu işlemleri LedgerDimensionAccountConroller sınıfı sizin için yapar.

Eski alışkanlıklara biraz ters ancak yeni boyut yapısında veri girişini kolaylaştırması açısında bence kullanışlı bir yapı olmuş.

Selamlar.

Merhaba,

Ax 2012 ile birlikte form yapısında bir çok değişiklik oldu. Fırsat buldukça bunlardan bahsedeceğim. Bu yazımda form şablonlarından (Form Templates) bahsetmek istiyorum. Ax 2012 ile form arayüzü daha zengin bir yapıya kavuştu. Son kullanıcı için iyi olan bu değişiklik geliştiriciler için fazladan mesai anlamına geliyor. Üstelik standart formlardaki görüntüye benzer bir görüntüyü yakalamak oldukça zor. İşte bu zorluktan dolayı en temel form yapıları için şablonlar hazırlanmış. Şablonları kullanarak kolayca standart form yapısına uygun formlar hazırlanabiliyor.  Şablonlar SysBPStyle_<Şablon ismi> ile başlayan formlar. Siz şablondan  bir form oluşturduğunuzda bu formlar çoğaltılıp yeni pencerede açılıyor. Sekiz  farklı şablon mevcut. AOT de Forms düğümüne sağ tıkladığınızda aşağıdaki resimde görünen liste karşınıza çıkıyor.

Bunlar da AOT deki şablon formlar.

Şimdi tek tek bu şablonları inceleyelim.

• ListPage

Bir modülün giriş formları genelde ListPage lerdir. ListPage lerde sadece ana veriler görüntülenir. Veri güncelleme eklem gibi işlemler için Edit formalara ihtiyaç vardır. ListPage formaları Enterprise Portale (EP) deploy edilebilir. ListPage formlarında direk kod yazılamaz. ListPageInteraction sınıfı yardımıyla bazı kontroller yazılır. Örnek olarak CustTableListPage ve SalesTableListPage verilebilir. ListPage ile alakalı oluşturduğunuz bütün nesnelerin sonun “ListPage” eklemek en iyi yöntem olarak tavsiye ediliyor.

• DetailsFormMaster

Ana veri girişi ve güncellemesi yapılan formlar genelde bu şablon tipindedir. CustTable ve VendTable gibi.

• DetailsFormTransaction

Hareket girişi yapılan formlar bu tiptedir. SalesTable ve PurchTable gibi. Eskiden bir ana veri ve satırları tipinde bir formu biz iki grid yapıp gösteriyorduk. Eski SalesTable formunda olduğu gibi. Ax 2012 de ise SalesTableListPage ile SalesTable tablosunun kayıtlarını görebilir bu formdan güncelle , yeni kayıt veye grid üzerinde güncelle diyerek SalesTable formunu geçebilirsiniz.

• SimpleListDetails

Bu şablonda ise bir ana veri ve ona ait detay verilerin listelenir. Sol tarafta bir grid liste var. Sağ tarafta ise o listede hangi satır üzerinde iseniz onun detay bilgileri var. DimensionDetails ve MainAccount formları gibi.

• SimpleList

Bir grid içinde verilerin listelendiği ve  Grid dışında bir eklentisi olmayan basit bir şablon. MainAccountCategory gibi.

• TableOfContents

Ax 2012 deki parametre formları bu tiptedir. Sol tarafta tablar listelenir. Bir taba tıkladığınızda sağ tarafta içeriği görürsünüz. SalesParemeters gibi.

• Dialog

Belli bir veriyi göstermek veye bazı basit bilgileri kullanıcıdan almak için kullanılan şablondur. Ok ve Cancel butonları vardır. EcoResProductCreate formu gibi.

• DropDialog

Kullanıcıdan basit verileri almaya yaran bir şablon. Sadece Ok butonu vardır. EcoResCategoryHierarchyCreate gibi.

Bir şablondan form oluşturduğunuzda Design kısmındaki Style özelliğinde şablonun ismi yazılır. Style Auto ise bir şablondan oluşturulmamış demektir. Şablon ile oluşturulmuş bir formun yapısını aşağıdaki resimde görünen Check form style best practices butonu ile kontrol edebilirsiniz.

Açıkça söylemek gerekirse ilk yaptığım formlarda çok vakit kaybettim. Neyin ne olduğunu nereye ne gelmesi gerektiğini anlayana kadar çalışmam gerekti. Özellikle ListPage ve   DetailsFormTransaction tiplerinde form yaparken ciddi uğraşmam gerekti. Yapıyı kavradıktan sonra ise işler basitleşiyor ve hızlanıyor. Şablonlar sizin için tasarımın büyük bir kısmını hallediyor. Siz sadece Datasource’ları belirleyip gerekli alanları forma yerleştiriyorsunuz.

Bence bu yapı standart oluşturması ve tasarım bütünlüğü açısından iyi olmuş. Son kullanıcıların hoşuna gider mi bilmiyorum ama ben beğendim.

Selamlar.