You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@syncope.apache.org by il...@apache.org on 2016/08/16 15:33:49 UTC
[1/2] syncope git commit: [SYNCOPE-700] Tasks
Repository: syncope
Updated Branches:
refs/heads/master 7a1197c67 -> 6d09957c4
[SYNCOPE-700] Tasks
Project: http://git-wip-us.apache.org/repos/asf/syncope/repo
Commit: http://git-wip-us.apache.org/repos/asf/syncope/commit/7b6bc61e
Tree: http://git-wip-us.apache.org/repos/asf/syncope/tree/7b6bc61e
Diff: http://git-wip-us.apache.org/repos/asf/syncope/diff/7b6bc61e
Branch: refs/heads/master
Commit: 7b6bc61e303c1b71faffec45b7be88002f906f2e
Parents: 7a1197c
Author: Francesco Chicchiricc� <il...@apache.org>
Authored: Tue Aug 16 17:19:23 2016 +0200
Committer: Francesco Chicchiricc� <il...@apache.org>
Committed: Tue Aug 16 17:19:23 2016 +0200
----------------------------------------------------------------------
.../reference-guide/concepts/concepts.adoc | 17 +-
.../reference-guide/concepts/entitlements.adoc | 2 +-
.../reference-guide/concepts/notifications.adoc | 2 +-
.../reference-guide/concepts/realms.adoc | 2 +-
.../reference-guide/concepts/roles.adoc | 4 +-
.../reference-guide/concepts/tasks.adoc | 191 +++++++++++++++++++
.../concepts/usersgroupsandanyobjects.adoc | 2 +-
7 files changed, 198 insertions(+), 22 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/concepts.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/concepts.adoc b/src/main/asciidoc/reference-guide/concepts/concepts.adoc
index 5bfe6e9..2688b5a 100644
--- a/src/main/asciidoc/reference-guide/concepts/concepts.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/concepts.adoc
@@ -38,22 +38,7 @@ include::workflow.adoc[]
include::notifications.adoc[]
-=== Tasks
-
-[[tasks-propagation]]
-==== Propagation
-
-[[tasks-pull]]
-==== Pull
-
-[[tasks-push]]
-==== Push
-
-[[tasks-notification]]
-==== Notification
-
-[[tasks-generic]]
-==== Generic
+include::tasks.adoc[]
=== Reports
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/entitlements.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/entitlements.adoc b/src/main/asciidoc/reference-guide/concepts/entitlements.adoc
index 4e61616..3a86200 100644
--- a/src/main/asciidoc/reference-guide/concepts/entitlements.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/entitlements.adoc
@@ -43,7 +43,7 @@ public List<RealmTO> list(final String fullPath) {
Entitlements are granted via <<roles, roles>> to Users, scoped under certain <<realms,realms>>, thus allowing
<<delegated-administration,delegated administration>>.
-[NOTE]
+[WARNING]
====
The set of available entitlements is
ifeval::["{snapshotOrRelease}" == "release"]
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/notifications.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/notifications.adoc b/src/main/asciidoc/reference-guide/concepts/notifications.adoc
index 605a3db..4e20160 100644
--- a/src/main/asciidoc/reference-guide/concepts/notifications.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/notifications.adoc
@@ -65,7 +65,7 @@ An event is identified by the following five coordinates:
** `PUSH`
** `CUSTOM`
. category - the possible values depend on the selected type: for `LOGIC` the <<logic>> components available,
-for `TASK` the various <<tasks-generic>> Tasks configured, for `PROPAGATION`, `PULL` and `PUSH` the defined Any Types
+for `TASK` the various <<tasks-custom>> Tasks configured, for `PROPAGATION`, `PULL` and `PUSH` the defined Any Types
. subcategory - completes category with external resource name, when selecting `PROPAGATION`, `PULL` or `PUSH`
. event type - the final identification of the event; depends on the other coordinates
. success or failure - whether the current event shall be considered in case of success or failure
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/realms.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/realms.adoc b/src/main/asciidoc/reference-guide/concepts/realms.adoc
index 5b5ecac..9e791e1 100644
--- a/src/main/asciidoc/reference-guide/concepts/realms.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/realms.adoc
@@ -54,7 +54,7 @@ a mechanism for setting default values for attributes or external resources on e
==== Realm Provisioning
<<provisioning>> can be enabled for realms: <<mapping,mapping>> information can be provided so that realms
-are considered during <<propagation,propagation>>, <<provisioning-pull,pull>> and <<provisioning-push,push>> tasks.
+are considered during <<propagation,propagation>>, <<provisioning-pull,pull>> and <<provisioning-push,push>> execution.
A typical use case for realm provisioning is to model an organization-like structure on Identity Stores, as
with LDAP and Active Directory.
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/roles.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/roles.adoc b/src/main/asciidoc/reference-guide/concepts/roles.adoc
index 8edb838..5cfc19e 100644
--- a/src/main/asciidoc/reference-guide/concepts/roles.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/roles.adoc
@@ -63,7 +63,7 @@ above:
====
Groups can designate a user or another group as _owner_.
-The practical consequence of this setting is that Users owning a group (either because they are directly set as owners
+The practical consequence of this setting is that Users owning a Group (either because they are directly set as owners
or members of the owning group) is that they are entitled to perform all operations (create, update, delete, ...) on the
-owned group, regardless of the realm.
+owned group, regardless of the Realm.
====
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/tasks.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/tasks.adoc b/src/main/asciidoc/reference-guide/concepts/tasks.adoc
new file mode 100644
index 0000000..2c50840
--- /dev/null
+++ b/src/main/asciidoc/reference-guide/concepts/tasks.adoc
@@ -0,0 +1,191 @@
+//
+// Licensed to the Apache Software Foundation (ASF) under one
+// or more contributor license agreements. See the NOTICE file
+// distributed with this work for additional information
+// regarding copyright ownership. The ASF licenses this file
+// to you under the Apache License, Version 2.0 (the
+// "License"); you may not use this file except in compliance
+// with the License. You may obtain a copy of the License at
+//
+// http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing,
+// software distributed under the License is distributed on an
+// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+// KIND, either express or implied. See the License for the
+// specific language governing permissions and limitations
+// under the License.
+//
+=== Tasks
+
+Tasks control the effective operations ongoing in the <<core>>.
+
+Whilst tasks define what and how to perform, they are supposed to be run by some entity (depending on the actual task
+type, see below for details); their execution result can be saved for later examination.
+
+[[tasks-propagation]]
+==== Propagation
+
+A propagation task encapsulates all the information required - according to the defined <<mapping,mapping>> - to create,
+update or delete a given User, Group or Any Object, to / from a certain Identity Store:
+
+* operation - `CREATE`, `UPDATE` or `DELETE`
+* connObjectKey - value for ConnId
+http://connid.tirasa.net/apidocs/1.4/org/identityconnectors/framework/common/objects/Uid.html[unique identifier^]
+on the Identity Store
+* oldConnObjectKey - the former unique identifier on the Identity Store: bears value only during updates involving the
+unique identifier
+* attributes - set of ConnId
+http://connid.tirasa.net/apidocs/1.4/org/identityconnectors/framework/common/objects/Attribute.html[attributes^] built
+upon internal identity data and configured mapping
+* resource - related <<external-resources,external resource>>
+* objectClass - ConnId
+http://connid.tirasa.net/apidocs/1.4/org/identityconnectors/framework/common/objects/ObjectClass.html[object class^]
+* entity - reference to the internal identity: User, Group or Any Object
+
+[NOTE]
+====
+Propagation tasks are automatically generated via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/propagation/PropagationManagerImpl.java[PropagationManager^],
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/propagation/PropagationManagerImpl.java[PropagationManager^],
+endif::[]
+executed (by default) via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/propagation/PriorityPropagationTaskExecutor.java[PriorityPropagationTaskExecutor^]
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/propagation/PriorityPropagationTaskExecutor.java[PriorityPropagationTaskExecutor^]
+endif::[]
+during the <<propagation,propagation>> process, and are permanently saved - for later re-execution or for examining
+the execution details - depending on the trace levels set on the related
+<<external-resource-details,external resource>>.
+====
+
+[[tasks-pull]]
+==== Pull
+
+Pull tasks are required to define and trigger the <<provisioning-pull,pull>> process from Identity Stores.
+
+When defining a pull task, the following information must be provided:
+
+* related <<external-resources,external resource>>
+* chosen <<pull-mode,pull mode>>
+* destination <<realms,Realm>> - where entities selected for creation are going to be placed
+* whether creation, update or deletion on internal storage are allowed or not
+* whether to synchronize the status information from the related identity store
+* selected <<provisioning-pull,matching and unmatching rules>>
+* optional <<pullactions,pull action(s)>>
+* <<pull-templates,entity templates>>
+* scheduling information:
+** when to start
+** http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/crontrigger.html[cron expression^]
+
+[NOTE]
+====
+Pull tasks are executed, either upon request or because scheduled, via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PullJobDelegate.java[PullJobDelegate^]
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PullJobDelegate.java[PullJobDelegate^]
+endif::[]
+during the <<provisioning-pull,pull>> process, and are permanently saved - for later re-execution or for examining
+the execution details - depending on the trace level set on the related
+<<external-resource-details,external resource>>.
+====
+
+[[tasks-push]]
+==== Push
+
+Push tasks are required to define and trigger the <<provisioning-push,push>> process to Identity Stores.
+
+When defining a push task, the following information must be provided:
+
+* related <<external-resources,external resource>>
+* filter information for selecting which internal entities will be pushed onto the identity store
+* whether creation, update or deletion on the identity store are allowed or not
+* whether to synchronize the status information with internal storage
+* selected <<provisioning-push,matching and unmatching rules>>
+* optional <<pushactions,push action(s)>>
+* scheduling information:
+** when to start
+** http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/crontrigger.html[cron expression^]
+
+[NOTE]
+====
+Push tasks are executed, either upon request or because scheduled, via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PushJobDelegate.java[PushJobDelegate^]
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/pushpull/PushJobDelegate.java[PushJobDelegate^]
+endif::[]
+during the <<provisioning-push,push>> process, and are permanently saved - for later re-execution or for examining
+the execution details - depending on the trace level set on the related
+<<external-resource-details,external resource>>.
+====
+
+[[tasks-notification]]
+==== Notification
+
+A notification tasks encapsulates all the information required for sending out a notification e-mail, according to the
+specification provided in a given <<notifications,notification>>:
+
+* entity - reference to the internal identity - User, Group or Any Object - the notification task refers to
+* sender e-mail address
+* e-mail subject
+* effective e-mail recipient(s)
+* e-mail body as plaintext and / or HTML
+
+[NOTE]
+====
+Notification tasks are automatically generated via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/notification/NotificationManagerImpl.java[NotificationManager^],
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/notification/NotificationManagerImpl.java[NotificationManager^],
+endif::[]
+executed via the
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/logic/src/main/java/org/apache/syncope/core/logic/notification/NotificationJob.java[NotificationJob^]
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/logic/src/main/java/org/apache/syncope/core/logic/notification/NotificationJob.java[NotificationJob^]
+endif::[]
+and are permanently saved - for later re-execution or for examining the execution details - depending on the trace level
+ set on the related <<notifications,notification>>.
+====
+
+[[tasks-custom]]
+==== Custom
+
+Custom tasks allow to inject logic into the <<core>>, available for execution and scheduling.
+
+When defining a custom task, the following information must be provided:
+
+* job delegate class: Java class extending
+ifeval::["{snapshotOrRelease}" == "release"]
+https://github.com/apache/syncope/blob/syncope-{docVersion}/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/job/AbstractSchedTaskJobDelegate.java[AbstractSchedTaskJobDelegate^]
+endif::[]
+ifeval::["{snapshotOrRelease}" == "snapshot"]
+https://github.com/apache/syncope/blob/master/core/provisioning-java/src/main/java/org/apache/syncope/core/provisioning/java/job/AbstractSchedTaskJobDelegate.java[AbstractSchedTaskJobDelegate^]
+endif::[]
+providing the custom logic to execute
+* scheduling information:
+** when to start
+** http://www.quartz-scheduler.org/documentation/quartz-2.2.x/tutorials/crontrigger.html[cron expression^]
+
+[TIP]
+====
+Custom tasks are ideal for implementing periodic checks or clean-up operations, possibly in coordination with other
+components; some examples:
+
+* move users from "peding delete" to "deleted" status 15 days after they reached the "pending delete" status (requires
+interaction with <<activiti-user-workflow-adapter>>)
+* send out notification e-mails to users whose password is about to expire on an Identity Store
+* disable all users not logging in into the system for the past 6 months
+====
http://git-wip-us.apache.org/repos/asf/syncope/blob/7b6bc61e/src/main/asciidoc/reference-guide/concepts/usersgroupsandanyobjects.adoc
----------------------------------------------------------------------
diff --git a/src/main/asciidoc/reference-guide/concepts/usersgroupsandanyobjects.adoc b/src/main/asciidoc/reference-guide/concepts/usersgroupsandanyobjects.adoc
index 5b7db98..456abde 100644
--- a/src/main/asciidoc/reference-guide/concepts/usersgroupsandanyobjects.adoc
+++ b/src/main/asciidoc/reference-guide/concepts/usersgroupsandanyobjects.adoc
@@ -49,7 +49,7 @@ value (i.e. _plain_, _derived_ and _virtual_);
====
Each user / group / any object will be able to hold values for all schemas:
-. defined in the <<AnyTypeClass,Any Type classes>> associated to their <<AnyType, any type>>;
+. defined in the <<AnyTypeClass,Any Type classes>> associated to their <<AnyType, Any Type>>;
. defined in the <<AnyTypeClass,Any Type classes>> configured as *_auxiliary_* for the specific instance.
====
[2/2] syncope git commit: Upgrading Wicket Bootstrap
Posted by il...@apache.org.
Upgrading Wicket Bootstrap
Project: http://git-wip-us.apache.org/repos/asf/syncope/repo
Commit: http://git-wip-us.apache.org/repos/asf/syncope/commit/6d09957c
Tree: http://git-wip-us.apache.org/repos/asf/syncope/tree/6d09957c
Diff: http://git-wip-us.apache.org/repos/asf/syncope/diff/6d09957c
Branch: refs/heads/master
Commit: 6d09957c4f9a8d10633cf36bec87d912ab774c8b
Parents: 7b6bc61
Author: Francesco Chicchiricc� <il...@apache.org>
Authored: Tue Aug 16 17:33:38 2016 +0200
Committer: Francesco Chicchiricc� <il...@apache.org>
Committed: Tue Aug 16 17:33:38 2016 +0200
----------------------------------------------------------------------
pom.xml | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/syncope/blob/6d09957c/pom.xml
----------------------------------------------------------------------
diff --git a/pom.xml b/pom.xml
index 0205c6c..d90f430 100644
--- a/pom.xml
+++ b/pom.xml
@@ -411,7 +411,7 @@ under the License.
<wicket.version>7.4.0</wicket.version>
<wicket-jqueryui.version>7.4.0</wicket-jqueryui.version>
- <wicket-bootstrap.version>0.10.7</wicket-bootstrap.version>
+ <wicket-bootstrap.version>0.10.8</wicket-bootstrap.version>
<wicket-chartjs.version>7.0.1</wicket-chartjs.version>
<angular.version>1.5.8</angular.version>