CoPlanner Link: Unterschied zwischen den Versionen

Aus CoPlanner 11
Zur Navigation springenZur Suche springen
Keine Bearbeitungszusammenfassung
H.Ludwig (Diskussion | Beiträge)
Keine Bearbeitungszusammenfassung
 
(16 dazwischenliegende Versionen von 2 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Unter einem CoPlanner-Link, auch CoP-Link, versteht man einen Link, der auf eine beliebige Maske im CoPlanner verweisen kann.
CoPlanner-Links (CoP-Links) sind Links, welche auf CoPlanner Objekte verweisen.


==Befehlssyntax==
Diese CoP-Links setzen sich aus allen Informationen zusammen, die zum Öffnen dieser Maske benötigt werden.
Diese CoP-Links setzen sich aus allen Informationen zusammen, die zum Öffnen dieser Maske benötigt werden.


==CoPlanner-Links generieren==
<code>cop://name=Name & aktion=Aktion & p1=Parameter 1 & p2=Parameter 2 & p3=Parameter 3 & p4=Parameter 4 & bild=Bild.ico & frmlocation=Work & info=Informationstext</code>
 
 
Beschreibung der einzelnen Parameter:
 
{| class="wikitable" width={{{breite|80%}}}
|-
! Parameter
! Beschreibung
! 'Optional
|-
| Name
| Der Name, welcher im Tool Fenster angezeigt wird
| Nein
|-
| Aktion:
| Der Name der auszuführenden Aktion
| Nein
|-
| Parameter 1:
| Der 1 von 4 String Parametern zur genaueren Befehlsübergabe
| Nein
|-
| Parameter 2:
| Der 2 von 4 String Parametern zur genaueren Befehlsübergabe
| Nein
|-
| Parameter 3:
| Der 3 von 4 String Parametern zur genaueren Befehlsübergabe
| Nein
|-
| Parameter 4:
| Der 4 von 4 String Parametern zur genaueren Befehlsübergabe
| Nein
|-
| Bild:
| Der Name eines zu verwendenden Icons inkl. Extension
| Ja
|-
| Frmlocation:
| Startbereich, in welchem sich das Fenster öffnen soll.
Mögliche Werte
:*Work: Das Fenster öffnet sich im Clientbereich des CoPlanners
:*Struktur: Das Fenster öffnet sich im linken Seitenbereich des CoPlanners
| Ja
|-
| Info:
| Ein Informationstext, der zurzeit noch nicht verwendet wird
| Ja
|-
| Systemdefinition:
| Name des MaskSkins der für die Darstellung der Maske verwendet werden soll
| Ja
|}
{{Hinweis|Text=Die Reihenfolge bei der Angabe der Parameter spielt ab dem cop:// keine Rolle.}}
 
==CoPlanner-Links automatisch generieren==
Zum Erstellen eines CoPlanner-Links, der auf eine bestimmte Maske verweisen soll, steht Ihnen ein Hilfsdialog ''Context Link Creator'' zur Verfügung.
Zum Erstellen eines CoPlanner-Links, der auf eine bestimmte Maske verweisen soll, steht Ihnen ein Hilfsdialog ''Context Link Creator'' zur Verfügung.


Zeile 10: Zeile 67:
[[Image:EE_CopContextLinkDialog.png|thumb|center|Context Link Creator]]  
[[Image:EE_CopContextLinkDialog.png|thumb|center|Context Link Creator]]  


===Context Link Creator===
====Context Link Creator====
Bei dem Context Link Creator handelt es sich um einen Hilfsdialog, welcher Sie beim Erstellen von CoPlanner-Links unterstützt.
Bei dem Context Link Creator handelt es sich um einen Hilfsdialog, welcher Sie beim Erstellen von CoPlanner-Links unterstützt.


Zeile 16: Zeile 73:


{| class="wikitable" width="1050px"
{| class="wikitable" width="1050px"
|- {{Tabellentitel}}
|-
| Konfiguration
! Konfiguration
| Beschreibung
! Beschreibung
|-
|-
|'''Kontext-Einstellungen'''
|'''Kontext-Einstellungen'''
Zeile 32: Zeile 89:
|Klickt man auf diese Fläche, können in einem Fenster Formatierungseinstellungen getroffen werden, mit welchen die Zielmaske geöffnet werden soll.
|Klickt man auf diese Fläche, können in einem Fenster Formatierungseinstellungen getroffen werden, mit welchen die Zielmaske geöffnet werden soll.
|}
|}
{{Hinweis|Text=Um einen korrekten Link zu erhalten, muss ''complete coplink'' aktiviert sein.}}


==CoPlanner-Links aufrufen==
==Aufruf von CoPlanner Links==
CoPlanner Links können aus Masken und aus Reports heraus geöffnet werden.
CoPlanner Links können aus folgenden Objekten aufgerufen werden:
:*aus Masken
:*aus Reports
:*aus dem Ribbon


===CoP-Links aus Masken aufrufen===
===CoP-Links aus Masken aufrufen===
Um aus einer Maske einen CoPlanner-Link zu öffnen, müssen Sie den oben generierten Link in ein Feld vom Typ Link einfügen.
Um aus einer Maske einen CoPlanner-Link zu öffnen, müssen Sie den gewünschten Link in ein Feld vom '''Datentyp Link''' einfügen.


{| {{Bausteindesign1}}
|-
| <span style="color: darkblue;">'''Hinweis'''</span> &nbsp;Um einen korrekten Link zu erhalten, muss ''complete coplink'' aktiviert sein.
|}


[[Image:EE_Datentyp_Link.png|thumb|center|Datentyp Link]]  
[[Image:EE_Datentyp_Link.png|thumb|center|Datentyp Link]]  


Der generierte Link kann nun von diesem Generator in die Maske, von welcher der Aufruf stattfinden soll, kopiert werden.
Der Link kann nun von diesem Generator in die Maske, von welcher der Aufruf stattfinden soll, kopiert werden.


[[Image:EE_CopLink_in_Maske.png|thumb|center|Zeilensicht, CoP-Link einfügen]]  
[[Image:EE_CopLink_in_Maske.png|thumb|center|Zeilensicht, CoP-Link einfügen]]  
Zeile 52: Zeile 109:
Beim Klick auf dieses Feld wird die jeweilige Maske im CoPlanner geöffnet.
Beim Klick auf dieses Feld wird die jeweilige Maske im CoPlanner geöffnet.


{{Hinweis|Text=Es besteht auch die Möglichkeit Links durch das Symbol [[Image:LinkIcon.png]] zu ersetzen. Dabei muss beim Property "ColumnWidth" des entsprechenden Measures die Größe zwischen 1 und 49 definiert werden.}}


===CoP-Links aus Reports aufrufen===
===CoP-Links aus Reports aufrufen===
Zeile 57: Zeile 116:


[[Image:ReportViewer_CopLink.png|thumb|center|Report, CoP-Link einfügen]]
[[Image:ReportViewer_CopLink.png|thumb|center|Report, CoP-Link einfügen]]
===CoP-Links aus Ribbon aufrufen===
CoPlanner-Links können auch über den [[Framework:Navigationsaktionen#Link|Navigationsdesigner]] eingebunden in den Ribbon eingebunden werden.
==CoPlanner Objekte über CoP-Links öffnen==
===Dimension öffnen===
Öffnen der Produkte Dimension über einen Cop Link:
<code>cop://name=Produkte & aktion=Dimension & p1=Produkte & p2= & p3= & p4= & bild=Dimension.ico & frmlocation=Work & info=</code>
oder (ohne die optionalen Parameter)
<code>cop://name=Produkte & aktion=Dimension & p1=Produkte & p2 = & p3= & p4= </code>
===Tabelle öffnen===
Öffnen einer [[Framework:Tabellen|Tabelle]]:
<code>cop://name=Umsatzerlöse_Plan & aktion=Tabelle & p1=Umsatzerloese_Jahr_PLAN & p2=MITDEFINITIONSTARTEN & p3=Umsatzerloese_Jahr_msk_PLAN & p4= & frmlocation=Work</code>
===Makro öffnen===
Öffnen eines [[Framework:Makros|Makros]] mit Kontextübergabe:
<code>cop://name=Name der Aktion & aktion=Makro & p1=TF39_mkr_Makro & p2= & p3= & p4=ContextFiltersetting:COPSYSID=636195485368033769=0=FilterText=COPSYS_ID & frmlocation=Struktur & bild=__PARAM_NOT_FOUND__ & info=__PARAM_NOT_FOUND__ & styledefinition=Blau Verlauf.maskskin & readonly=__PARAM_NOT_FOUND__</code>
====Übergabe eine Parameters an eine Stored Procedure im Makro====
In folgendem Beispiel Wird der Parameter API an einen Stored Procedure übergeben:
Link im CoPlanner:
<code>copaction://macro/?name=MKR_SAGE_Load&contextFilters=API eq /Employee/CEAbteilung/List</code>
Stored Procedure Parameter im Makro:
<code>@API=@Context.API@</code>
===Maske öffnen===
Öffnen einer Matrixmaske aus dem CoPlanner Arbeitsbereich:
<code><a href="CopNav.html?name=Umsatzerloese&amp;aktion=Matrix Builder Eingabemaske&amp;p1=EM&nbsp;Umsatzerloese&nbsp;Plan&amp"><img src="image.png" alt="Navaktion" align="right" /></a></code>
oder aus einem Eingabefeld vom Datentyp Link:
<code>cop://name=Name der Aktion & aktion=Matrix Builder Eingabemaske & p1=EM Umsatzerloese Plan & p2= & p3= & p4=ContextFiltersetting:Plan=635530397493272859=0=FilterPlan=Plan|Unternehmen=631835758818687263=2=FilterDim=Unternehmen|Umsatzerloesarten=1=2=FilterDim=Umsatzerloesarten|Vergleichsplan=635326393947795024=0=FilterPlan=Vergleichsplan|Regionen/Kunden=1=2=FilterDim=Regionen/Kunden|PC/KST=1=2=FilterDim=PC/KST|Zeit=2014010101=2=FilterDim=Zeit|Produkte=633970865437351422=2=FilterDim=Produkte & frmlocation=Struktur & bild=__PARAM_NOT_FOUND__ & info=__PARAM_NOT_FOUND__ & styledefinition=Blau Verlauf.maskskin & readonly=__PARAM_NOT_FOUND__</code>
===Dokumentenverwaltung öffnen===
Öffnen des Dialoges für die [[Allgemeine Module:Dokumentenverwaltung|Dokumentenverwaltung]]
<code>cop://name=Umsatzbereich & aktion=Sonstige & p1=FileUpDownLoad & p2=Data & p3=[COPSYS_ID] & p4= & frmlocation=Work</code>
:name= Diese Bezeichnung wird im Dialog '[[Allgemeine Module:Dokumentenverwaltung|Dokumentenverwaltung]]' als Überschrift angezeigt
:p2= BasisVerzeichnis im CoPlanner Serververzeichnis, darunter werden die einzelnen Unterverzeichnisse angelegt
:p3= Unterverzeichnis (In diesem Fall wird der eindeutige Schlüssel des Datensatzes verwendet.)
__NOEDITSECTION__
[[Category:Allgemeine Module|CoPlanner_Link]]
[[en:Enterprise_Edition:CoPlanner_Link]]

Aktuelle Version vom 11. April 2025, 12:10 Uhr

CoPlanner-Links (CoP-Links) sind Links, welche auf CoPlanner Objekte verweisen.

Befehlssyntax

Diese CoP-Links setzen sich aus allen Informationen zusammen, die zum Öffnen dieser Maske benötigt werden.

cop://name=Name & aktion=Aktion & p1=Parameter 1 & p2=Parameter 2 & p3=Parameter 3 & p4=Parameter 4 & bild=Bild.ico & frmlocation=Work & info=Informationstext


Beschreibung der einzelnen Parameter:

Parameter Beschreibung 'Optional
Name Der Name, welcher im Tool Fenster angezeigt wird Nein
Aktion: Der Name der auszuführenden Aktion Nein
Parameter 1: Der 1 von 4 String Parametern zur genaueren Befehlsübergabe Nein
Parameter 2: Der 2 von 4 String Parametern zur genaueren Befehlsübergabe Nein
Parameter 3: Der 3 von 4 String Parametern zur genaueren Befehlsübergabe Nein
Parameter 4: Der 4 von 4 String Parametern zur genaueren Befehlsübergabe Nein
Bild: Der Name eines zu verwendenden Icons inkl. Extension Ja
Frmlocation: Startbereich, in welchem sich das Fenster öffnen soll.

Mögliche Werte

  • Work: Das Fenster öffnet sich im Clientbereich des CoPlanners
  • Struktur: Das Fenster öffnet sich im linken Seitenbereich des CoPlanners
Ja
Info: Ein Informationstext, der zurzeit noch nicht verwendet wird Ja
Systemdefinition: Name des MaskSkins der für die Darstellung der Maske verwendet werden soll Ja
Hinweis  Die Reihenfolge bei der Angabe der Parameter spielt ab dem cop:// keine Rolle.

CoPlanner-Links automatisch generieren

Zum Erstellen eines CoPlanner-Links, der auf eine bestimmte Maske verweisen soll, steht Ihnen ein Hilfsdialog Context Link Creator zur Verfügung.

Öffnen Sie diesen Dialog über die Tastenkombination Strg+J aus der Maske, für welche Sie den Link generieren wollen.

Context Link Creator

Context Link Creator

Bei dem Context Link Creator handelt es sich um einen Hilfsdialog, welcher Sie beim Erstellen von CoPlanner-Links unterstützt.

Folgende Funktionalitäten sind in diesem Dialog hinterlegt:

Konfiguration Beschreibung
Kontext-Einstellungen Über diese Felder im linken Bereich können Sie alle kontextbezogenen Einstellungen konfigurieren.
Include invisible Filter Ist diese Einstellung aktiviert, werden auch nicht sichtbare Filter im Link mit übergeben.
complete Link Vervollständigt den CoPlanner-Link so weit, sodass er als Link in die Maske/den Report eingefügt werden kann.
build Klickt man auf diese Fläche, können in einem Fenster Formatierungseinstellungen getroffen werden, mit welchen die Zielmaske geöffnet werden soll.
Hinweis  Um einen korrekten Link zu erhalten, muss complete coplink aktiviert sein.

Aufruf von CoPlanner Links

CoPlanner Links können aus folgenden Objekten aufgerufen werden:

  • aus Masken
  • aus Reports
  • aus dem Ribbon

CoP-Links aus Masken aufrufen

Um aus einer Maske einen CoPlanner-Link zu öffnen, müssen Sie den gewünschten Link in ein Feld vom Datentyp Link einfügen.


Datentyp Link

Der Link kann nun von diesem Generator in die Maske, von welcher der Aufruf stattfinden soll, kopiert werden.

Zeilensicht, CoP-Link einfügen

Beim Klick auf dieses Feld wird die jeweilige Maske im CoPlanner geöffnet.


Hinweis  Es besteht auch die Möglichkeit Links durch das Symbol zu ersetzen. Dabei muss beim Property "ColumnWidth" des entsprechenden Measures die Größe zwischen 1 und 49 definiert werden.

CoP-Links aus Reports aufrufen

Um aus einem Report einen CoPlanner-Link zu öffnen, müssen Sie im Report vor dem Cop-Link ein "http://" hinzufügen, damit dieser korrekt interpretiert werden kann.

Report, CoP-Link einfügen


CoP-Links aus Ribbon aufrufen

CoPlanner-Links können auch über den Navigationsdesigner eingebunden in den Ribbon eingebunden werden.


CoPlanner Objekte über CoP-Links öffnen

Dimension öffnen

Öffnen der Produkte Dimension über einen Cop Link:

cop://name=Produkte & aktion=Dimension & p1=Produkte & p2= & p3= & p4= & bild=Dimension.ico & frmlocation=Work & info=

oder (ohne die optionalen Parameter)

cop://name=Produkte & aktion=Dimension & p1=Produkte & p2 = & p3= & p4=

Tabelle öffnen

Öffnen einer Tabelle:

cop://name=Umsatzerlöse_Plan & aktion=Tabelle & p1=Umsatzerloese_Jahr_PLAN & p2=MITDEFINITIONSTARTEN & p3=Umsatzerloese_Jahr_msk_PLAN & p4= & frmlocation=Work

Makro öffnen

Öffnen eines Makros mit Kontextübergabe:

cop://name=Name der Aktion & aktion=Makro & p1=TF39_mkr_Makro & p2= & p3= & p4=ContextFiltersetting:COPSYSID=636195485368033769=0=FilterText=COPSYS_ID & frmlocation=Struktur & bild=__PARAM_NOT_FOUND__ & info=__PARAM_NOT_FOUND__ & styledefinition=Blau Verlauf.maskskin & readonly=__PARAM_NOT_FOUND__

Übergabe eine Parameters an eine Stored Procedure im Makro

In folgendem Beispiel Wird der Parameter API an einen Stored Procedure übergeben:

Link im CoPlanner: copaction://macro/?name=MKR_SAGE_Load&contextFilters=API eq /Employee/CEAbteilung/List

Stored Procedure Parameter im Makro: @API=@Context.API@


Maske öffnen

Öffnen einer Matrixmaske aus dem CoPlanner Arbeitsbereich:

<a href="CopNav.html?name=Umsatzerloese&aktion=Matrix Builder Eingabemaske&p1=EM Umsatzerloese Plan&amp"><img src="image.png" alt="Navaktion" align="right" /></a>

oder aus einem Eingabefeld vom Datentyp Link:

cop://name=Name der Aktion & aktion=Matrix Builder Eingabemaske & p1=EM Umsatzerloese Plan & p2= & p3= & p4=ContextFiltersetting:Plan=635530397493272859=0=FilterPlan=Plan|Unternehmen=631835758818687263=2=FilterDim=Unternehmen|Umsatzerloesarten=1=2=FilterDim=Umsatzerloesarten|Vergleichsplan=635326393947795024=0=FilterPlan=Vergleichsplan|Regionen/Kunden=1=2=FilterDim=Regionen/Kunden|PC/KST=1=2=FilterDim=PC/KST|Zeit=2014010101=2=FilterDim=Zeit|Produkte=633970865437351422=2=FilterDim=Produkte & frmlocation=Struktur & bild=__PARAM_NOT_FOUND__ & info=__PARAM_NOT_FOUND__ & styledefinition=Blau Verlauf.maskskin & readonly=__PARAM_NOT_FOUND__

Dokumentenverwaltung öffnen

Öffnen des Dialoges für die Dokumentenverwaltung

cop://name=Umsatzbereich & aktion=Sonstige & p1=FileUpDownLoad & p2=Data & p3=[COPSYS_ID] & p4= & frmlocation=Work

name= Diese Bezeichnung wird im Dialog 'Dokumentenverwaltung' als Überschrift angezeigt
p2= BasisVerzeichnis im CoPlanner Serververzeichnis, darunter werden die einzelnen Unterverzeichnisse angelegt
p3= Unterverzeichnis (In diesem Fall wird der eindeutige Schlüssel des Datensatzes verwendet.)