Repository.Task.GetScheduledTask: Difference between revisions

From ReliaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>{{Template:API}}{{Template:APIBreadcrumb|10|Repository}}</noinclude>
{{Template:API}}{{Template:APIBreadcrumb|.[[Repository Class|Repository]]}}
 
 
<onlyinclude>Returns a '''[[CScheduledTask Class|cScheduledTask]]''' object that represents a given scheduled task resource in the current project. Returns nothing if the task does not exist or is not in the current project.</onlyinclude>  


Gets the scheduled task with the designated ID number and returns it as a '''[[CScheduledTask Class|cScheduledTask]]''' object. Returns nothing if the task does not exist or is not in the current project.
<noinclude>
== Syntax ==
== Syntax ==
''object''.'''Task.GetScheduledTask(''ID'')'''
'''.Task.GetScheduledTask'''(''ID'')
 
where ''object'' is a variable that represents a Repository object.


=== Parameters ===
=== Parameters ===
{| {{APITable}}
''ID''
|-
:Required. Integer. The ID number of the scheduled task to retrieve.
|ID{{APIParam|Required}}||'''Integer'''. The ID number of the scheduled task to retrieve.
|}




== Example ==
== Example ==
This example assumes that a scheduled task with ID#1 exists in a repository.
This example assumes that a scheduled task with ID #1 exists in the first project of a Synthesis repository.
  '''VBA'''
  '''VBA'''
   
   
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
{{APIComment|'Declare a new Repository object and connect to a Synthesis repository.}}
{{APIComment|...'Add code to connect to a Synthesis repository.}}
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  MyRepository.ConnectToAccessRepository({{APIString|"C:\RSRepository1.rsr10"}})
 
  {{APIComment|'Get scheduled task #1 from project #1.}}
  {{APIComment|'Get scheduled task #1 from project #1.}}
  {{APIPrefix|Dim}} MyTask {{APIPrefix|As}} cScheduledTask
  {{APIPrefix|Dim}} MyTask {{APIPrefix|As}} cScheduledTask
  MyRepository.Project.SetCurrentProject(1)
  MyRepository.Project.SetCurrentProject(1)
  {{APIPrefix|Set}} MyTask = MyRepository.Task.GetScheduledTask(1)
  {{APIPrefix|Set}} MyTask = MyRepository.Task.GetScheduledTask(1)
   
   
  {{APIComment|'Output sample: Display the name and ID of the task.}}
  {{APIComment|'Output sample: Display the name and ID of the task.}}
  {{APIPrefix|Dim}} TaskName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} TaskName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} TaskID {{APIPrefix|As}} Integer
  {{APIPrefix|Dim}} TaskID {{APIPrefix|As}} Integer
  TaskName = MyTask.Name
  TaskName = MyTask.Name
  TaskID = MyTask.ID
  TaskID = MyTask.ID
  MsgBox ({{APIString|"You got "}} & TaskName & {{APIString|", ID#"}} & TaskID)
  MsgBox ({{APIString|"You got "}} & TaskName & {{APIString|", ID#"}} & TaskID)


  '''VB.NET'''
  '''VB.NET'''
   
   
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
{{APIComment|'Declare a new Repository object and connect to a Synthesis repository.}}
{{APIComment|...'Add code to connect to a Synthesis repository.}}
  {{APIPrefix|Dim}} MyRepository {{APIPrefix|As New}} Repository
  MyRepository.ConnectToAccessRepository({{APIString|"C:\RSRepository1.rsr10"}})
 
  {{APIComment|'Get scheduled task #1 from project #1.}}
  {{APIComment|'Get scheduled task #1 from project #1.}}
  {{APIPrefix|Dim}} MyTask {{APIPrefix|As}} cScheduledTask
  {{APIPrefix|Dim}} MyTask {{APIPrefix|As}} cScheduledTask
  MyRepository.Project.SetCurrentProject(1)
  MyRepository.Project.SetCurrentProject(1)
  MyTask = MyRepository.Task.GetScheduledTask(1)
  MyTask = MyRepository.Task.GetScheduledTask(1)
   
   
  {{APIComment|'Output sample: Display the name and ID of the task.}}
  {{APIComment|'Output sample: Display the name and ID of the task.}}
  {{APIPrefix|Dim}} TaskName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} TaskName {{APIPrefix|As}} String
  {{APIPrefix|Dim}} TaskID {{APIPrefix|As}} Integer
  {{APIPrefix|Dim}} TaskID {{APIPrefix|As}} Integer
  TaskName = MyTask.Name
  TaskName = MyTask.Name
  TaskID = MyTask.ID
  TaskID = MyTask.ID
  MsgBox ({{APIString|"You got "}} & TaskName & {{APIString|", ID#"}} & TaskID)
  MsgBox ({{APIString|"You got "}} & TaskName & {{APIString|", ID#"}} & TaskID)
</noinclude>

Latest revision as of 18:55, 9 June 2016

APIWiki.png


Member of: SynthesisAPI.Repository


Returns a cScheduledTask object that represents a given scheduled task resource in the current project. Returns nothing if the task does not exist or is not in the current project.

Syntax

.Task.GetScheduledTask(ID)

Parameters

ID

Required. Integer. The ID number of the scheduled task to retrieve.


Example

This example assumes that a scheduled task with ID #1 exists in the first project of a Synthesis repository.

VBA

 'Declare a new Repository object and connect to a Synthesis repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToAccessRepository("C:\RSRepository1.rsr10")
  
 'Get scheduled task #1 from project #1. 
  Dim MyTask As cScheduledTask
  MyRepository.Project.SetCurrentProject(1)
  Set MyTask = MyRepository.Task.GetScheduledTask(1)

 'Output sample: Display the name and ID of the task. 
  Dim TaskName As String
  Dim TaskID As Integer
  TaskName = MyTask.Name
  TaskID = MyTask.ID
  MsgBox ("You got " & TaskName & ", ID#" & TaskID)
VB.NET

 'Declare a new Repository object and connect to a Synthesis repository. 
  Dim MyRepository As New Repository
  MyRepository.ConnectToAccessRepository("C:\RSRepository1.rsr10") 
 
 'Get scheduled task #1 from project #1. 
  Dim MyTask As cScheduledTask
  MyRepository.Project.SetCurrentProject(1)
  MyTask = MyRepository.Task.GetScheduledTask(1)

 'Output sample: Display the name and ID of the task. 
  Dim TaskName As String
  Dim TaskID As Integer
  TaskName = MyTask.Name
  TaskID = MyTask.ID
  MsgBox ("You got " & TaskName & ", ID#" & TaskID)